@btc-embedded/cdk-extensions 0.20.10 → 0.21.0

package/API.md

@@ -1562,6 +1562,933 @@ public readonly targetGroup: IApplicationTargetGroup;
 ---
 
 
+### ApplicationStack <a name="ApplicationStack" id="@btc-embedded/cdk-extensions.ApplicationStack"></a>
+
+#### Initializers <a name="Initializers" id="@btc-embedded/cdk-extensions.ApplicationStack.Initializer"></a>
+
+```typescript
+import { ApplicationStack } from '@btc-embedded/cdk-extensions'
+
+new ApplicationStack(scope: Construct, id: string, props: ApplicationStackProps)
+```
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.Initializer.parameter.scope">scope</a></code> | <code>constructs.Construct</code> | *No description.* |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.Initializer.parameter.id">id</a></code> | <code>string</code> | *No description.* |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.Initializer.parameter.props">props</a></code> | <code><a href="#@btc-embedded/cdk-extensions.ApplicationStackProps">ApplicationStackProps</a></code> | *No description.* |
+
+---
+
+##### `scope`<sup>Required</sup> <a name="scope" id="@btc-embedded/cdk-extensions.ApplicationStack.Initializer.parameter.scope"></a>
+
+- *Type:* constructs.Construct
+
+---
+
+##### `id`<sup>Required</sup> <a name="id" id="@btc-embedded/cdk-extensions.ApplicationStack.Initializer.parameter.id"></a>
+
+- *Type:* string
+
+---
+
+##### `props`<sup>Required</sup> <a name="props" id="@btc-embedded/cdk-extensions.ApplicationStack.Initializer.parameter.props"></a>
+
+- *Type:* <a href="#@btc-embedded/cdk-extensions.ApplicationStackProps">ApplicationStackProps</a>
+
+---
+
+#### Methods <a name="Methods" id="Methods"></a>
+
+| **Name** | **Description** |
+| --- | --- |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.toString">toString</a></code> | Returns a string representation of this construct. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.addDependency">addDependency</a></code> | Add a dependency between this stack and another stack. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.addMetadata">addMetadata</a></code> | Adds an arbitrary key-value pair, with information you want to record about the stack. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.addStackTag">addStackTag</a></code> | Configure a stack tag. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.addTransform">addTransform</a></code> | Add a Transform to this stack. A Transform is a macro that AWS CloudFormation uses to process your template. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.exportStringListValue">exportStringListValue</a></code> | Create a CloudFormation Export for a string list value. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.exportValue">exportValue</a></code> | Create a CloudFormation Export for a string value. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.formatArn">formatArn</a></code> | Creates an ARN from components. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.getLogicalId">getLogicalId</a></code> | Allocates a stack-unique CloudFormation-compatible logical identity for a specific resource. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.regionalFact">regionalFact</a></code> | Look up a fact value for the given fact for the region of this stack. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.removeStackTag">removeStackTag</a></code> | Remove a stack tag. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.renameLogicalId">renameLogicalId</a></code> | Rename a generated logical identities. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.reportMissingContextKey">reportMissingContextKey</a></code> | Indicate that a context key was expected. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.resolve">resolve</a></code> | Resolve a tokenized value in the context of the current stack. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.splitArn">splitArn</a></code> | Splits the provided ARN into its components. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.toJsonString">toJsonString</a></code> | Convert an object, potentially containing tokens, to a JSON string. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.toYamlString">toYamlString</a></code> | Convert an object, potentially containing tokens, to a YAML string. |
+
+---
+
+##### `toString` <a name="toString" id="@btc-embedded/cdk-extensions.ApplicationStack.toString"></a>
+
+```typescript
+public toString(): string
+```
+
+Returns a string representation of this construct.
+
+##### `addDependency` <a name="addDependency" id="@btc-embedded/cdk-extensions.ApplicationStack.addDependency"></a>
+
+```typescript
+public addDependency(target: Stack, reason?: string): void
+```
+
+Add a dependency between this stack and another stack.
+
+This can be used to define dependencies between any two stacks within an
+app, and also supports nested stacks.
+
+###### `target`<sup>Required</sup> <a name="target" id="@btc-embedded/cdk-extensions.ApplicationStack.addDependency.parameter.target"></a>
+
+- *Type:* aws-cdk-lib.Stack
+
+---
+
+###### `reason`<sup>Optional</sup> <a name="reason" id="@btc-embedded/cdk-extensions.ApplicationStack.addDependency.parameter.reason"></a>
+
+- *Type:* string
+
+---
+
+##### `addMetadata` <a name="addMetadata" id="@btc-embedded/cdk-extensions.ApplicationStack.addMetadata"></a>
+
+```typescript
+public addMetadata(key: string, value: any): void
+```
+
+Adds an arbitrary key-value pair, with information you want to record about the stack.
+
+These get translated to the Metadata section of the generated template.
+
+> [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/metadata-section-structure.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/metadata-section-structure.html)
+
+###### `key`<sup>Required</sup> <a name="key" id="@btc-embedded/cdk-extensions.ApplicationStack.addMetadata.parameter.key"></a>
+
+- *Type:* string
+
+---
+
+###### `value`<sup>Required</sup> <a name="value" id="@btc-embedded/cdk-extensions.ApplicationStack.addMetadata.parameter.value"></a>
+
+- *Type:* any
+
+---
+
+##### `addStackTag` <a name="addStackTag" id="@btc-embedded/cdk-extensions.ApplicationStack.addStackTag"></a>
+
+```typescript
+public addStackTag(tagName: string, tagValue: string): void
+```
+
+Configure a stack tag.
+
+At deploy time, CloudFormation will automatically apply all stack tags to all resources in the stack.
+
+###### `tagName`<sup>Required</sup> <a name="tagName" id="@btc-embedded/cdk-extensions.ApplicationStack.addStackTag.parameter.tagName"></a>
+
+- *Type:* string
+
+---
+
+###### `tagValue`<sup>Required</sup> <a name="tagValue" id="@btc-embedded/cdk-extensions.ApplicationStack.addStackTag.parameter.tagValue"></a>
+
+- *Type:* string
+
+---
+
+##### `addTransform` <a name="addTransform" id="@btc-embedded/cdk-extensions.ApplicationStack.addTransform"></a>
+
+```typescript
+public addTransform(transform: string): void
+```
+
+Add a Transform to this stack. A Transform is a macro that AWS CloudFormation uses to process your template.
+
+Duplicate values are removed when stack is synthesized.
+
+> [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-section-structure.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-section-structure.html)
+
+*Example*
+
+```typescript
+declare const stack: Stack;
+
+stack.addTransform('AWS::Serverless-2016-10-31')
+```
+
+
+###### `transform`<sup>Required</sup> <a name="transform" id="@btc-embedded/cdk-extensions.ApplicationStack.addTransform.parameter.transform"></a>
+
+- *Type:* string
+
+The transform to add.
+
+---
+
+##### `exportStringListValue` <a name="exportStringListValue" id="@btc-embedded/cdk-extensions.ApplicationStack.exportStringListValue"></a>
+
+```typescript
+public exportStringListValue(exportedValue: any, options?: ExportValueOptions): string[]
+```
+
+Create a CloudFormation Export for a string list value.
+
+Returns a string list representing the corresponding `Fn.importValue()`
+expression for this Export. The export expression is automatically wrapped with an
+`Fn::Join` and the import value with an `Fn::Split`, since CloudFormation can only
+export strings. You can control the name for the export by passing the `name` option.
+
+If you don't supply a value for `name`, the value you're exporting must be
+a Resource attribute (for example: `bucket.bucketName`) and it will be
+given the same name as the automatic cross-stack reference that would be created
+if you used the attribute in another Stack.
+
+One of the uses for this method is to *remove* the relationship between
+two Stacks established by automatic cross-stack references. It will
+temporarily ensure that the CloudFormation Export still exists while you
+remove the reference from the consuming stack. After that, you can remove
+the resource and the manual export.
+
+See `exportValue` for an example of this process.
+
+###### `exportedValue`<sup>Required</sup> <a name="exportedValue" id="@btc-embedded/cdk-extensions.ApplicationStack.exportStringListValue.parameter.exportedValue"></a>
+
+- *Type:* any
+
+---
+
+###### `options`<sup>Optional</sup> <a name="options" id="@btc-embedded/cdk-extensions.ApplicationStack.exportStringListValue.parameter.options"></a>
+
+- *Type:* aws-cdk-lib.ExportValueOptions
+
+---
+
+##### `exportValue` <a name="exportValue" id="@btc-embedded/cdk-extensions.ApplicationStack.exportValue"></a>
+
+```typescript
+public exportValue(exportedValue: any, options?: ExportValueOptions): string
+```
+
+Create a CloudFormation Export for a string value.
+
+Returns a string representing the corresponding `Fn.importValue()`
+expression for this Export. You can control the name for the export by
+passing the `name` option.
+
+If you don't supply a value for `name`, the value you're exporting must be
+a Resource attribute (for example: `bucket.bucketName`) and it will be
+given the same name as the automatic cross-stack reference that would be created
+if you used the attribute in another Stack.
+
+One of the uses for this method is to *remove* the relationship between
+two Stacks established by automatic cross-stack references. It will
+temporarily ensure that the CloudFormation Export still exists while you
+remove the reference from the consuming stack. After that, you can remove
+the resource and the manual export.
+
+Here is how the process works. Let's say there are two stacks,
+`producerStack` and `consumerStack`, and `producerStack` has a bucket
+called `bucket`, which is referenced by `consumerStack` (perhaps because
+an AWS Lambda Function writes into it, or something like that).
+
+It is not safe to remove `producerStack.bucket` because as the bucket is being
+deleted, `consumerStack` might still be using it.
+
+Instead, the process takes two deployments:
+
+**Deployment 1: break the relationship**:
+
+- Make sure `consumerStack` no longer references `bucket.bucketName` (maybe the consumer
+  stack now uses its own bucket, or it writes to an AWS DynamoDB table, or maybe you just
+  remove the Lambda Function altogether).
+- In the `ProducerStack` class, call `this.exportValue(this.bucket.bucketName)`. This
+  will make sure the CloudFormation Export continues to exist while the relationship
+  between the two stacks is being broken.
+- Deploy (this will effectively only change the `consumerStack`, but it's safe to deploy both).
+
+**Deployment 2: remove the bucket resource**:
+
+- You are now free to remove the `bucket` resource from `producerStack`.
+- Don't forget to remove the `exportValue()` call as well.
+- Deploy again (this time only the `producerStack` will be changed -- the bucket will be deleted).
+
+###### `exportedValue`<sup>Required</sup> <a name="exportedValue" id="@btc-embedded/cdk-extensions.ApplicationStack.exportValue.parameter.exportedValue"></a>
+
+- *Type:* any
+
+---
+
+###### `options`<sup>Optional</sup> <a name="options" id="@btc-embedded/cdk-extensions.ApplicationStack.exportValue.parameter.options"></a>
+
+- *Type:* aws-cdk-lib.ExportValueOptions
+
+---
+
+##### `formatArn` <a name="formatArn" id="@btc-embedded/cdk-extensions.ApplicationStack.formatArn"></a>
+
+```typescript
+public formatArn(components: ArnComponents): string
+```
+
+Creates an ARN from components.
+
+If `partition`, `region` or `account` are not specified, the stack's
+partition, region and account will be used.
+
+If any component is the empty string, an empty string will be inserted
+into the generated ARN at the location that component corresponds to.
+
+The ARN will be formatted as follows:
+
+  arn:{partition}:{service}:{region}:{account}:{resource}{sep}{resource-name}
+
+The required ARN pieces that are omitted will be taken from the stack that
+the 'scope' is attached to. If all ARN pieces are supplied, the supplied scope
+can be 'undefined'.
+
+###### `components`<sup>Required</sup> <a name="components" id="@btc-embedded/cdk-extensions.ApplicationStack.formatArn.parameter.components"></a>
+
+- *Type:* aws-cdk-lib.ArnComponents
+
+---
+
+##### `getLogicalId` <a name="getLogicalId" id="@btc-embedded/cdk-extensions.ApplicationStack.getLogicalId"></a>
+
+```typescript
+public getLogicalId(element: CfnElement): string
+```
+
+Allocates a stack-unique CloudFormation-compatible logical identity for a specific resource.
+
+This method is called when a `CfnElement` is created and used to render the
+initial logical identity of resources. Logical ID renames are applied at
+this stage.
+
+This method uses the protected method `allocateLogicalId` to render the
+logical ID for an element. To modify the naming scheme, extend the `Stack`
+class and override this method.
+
+###### `element`<sup>Required</sup> <a name="element" id="@btc-embedded/cdk-extensions.ApplicationStack.getLogicalId.parameter.element"></a>
+
+- *Type:* aws-cdk-lib.CfnElement
+
+The CloudFormation element for which a logical identity is needed.
+
+---
+
+##### `regionalFact` <a name="regionalFact" id="@btc-embedded/cdk-extensions.ApplicationStack.regionalFact"></a>
+
+```typescript
+public regionalFact(factName: string, defaultValue?: string): string
+```
+
+Look up a fact value for the given fact for the region of this stack.
+
+Will return a definite value only if the region of the current stack is resolved.
+If not, a lookup map will be added to the stack and the lookup will be done at
+CDK deployment time.
+
+What regions will be included in the lookup map is controlled by the
+`@aws-cdk/core:target-partitions` context value: it must be set to a list
+of partitions, and only regions from the given partitions will be included.
+If no such context key is set, all regions will be included.
+
+This function is intended to be used by construct library authors. Application
+builders can rely on the abstractions offered by construct libraries and do
+not have to worry about regional facts.
+
+If `defaultValue` is not given, it is an error if the fact is unknown for
+the given region.
+
+###### `factName`<sup>Required</sup> <a name="factName" id="@btc-embedded/cdk-extensions.ApplicationStack.regionalFact.parameter.factName"></a>
+
+- *Type:* string
+
+---
+
+###### `defaultValue`<sup>Optional</sup> <a name="defaultValue" id="@btc-embedded/cdk-extensions.ApplicationStack.regionalFact.parameter.defaultValue"></a>
+
+- *Type:* string
+
+---
+
+##### `removeStackTag` <a name="removeStackTag" id="@btc-embedded/cdk-extensions.ApplicationStack.removeStackTag"></a>
+
+```typescript
+public removeStackTag(tagName: string): void
+```
+
+Remove a stack tag.
+
+At deploy time, CloudFormation will automatically apply all stack tags to all resources in the stack.
+
+###### `tagName`<sup>Required</sup> <a name="tagName" id="@btc-embedded/cdk-extensions.ApplicationStack.removeStackTag.parameter.tagName"></a>
+
+- *Type:* string
+
+---
+
+##### `renameLogicalId` <a name="renameLogicalId" id="@btc-embedded/cdk-extensions.ApplicationStack.renameLogicalId"></a>
+
+```typescript
+public renameLogicalId(oldId: string, newId: string): void
+```
+
+Rename a generated logical identities.
+
+To modify the naming scheme strategy, extend the `Stack` class and
+override the `allocateLogicalId` method.
+
+###### `oldId`<sup>Required</sup> <a name="oldId" id="@btc-embedded/cdk-extensions.ApplicationStack.renameLogicalId.parameter.oldId"></a>
+
+- *Type:* string
+
+---
+
+###### `newId`<sup>Required</sup> <a name="newId" id="@btc-embedded/cdk-extensions.ApplicationStack.renameLogicalId.parameter.newId"></a>
+
+- *Type:* string
+
+---
+
+##### `reportMissingContextKey` <a name="reportMissingContextKey" id="@btc-embedded/cdk-extensions.ApplicationStack.reportMissingContextKey"></a>
+
+```typescript
+public reportMissingContextKey(report: MissingContext): void
+```
+
+Indicate that a context key was expected.
+
+Contains instructions which will be emitted into the cloud assembly on how
+the key should be supplied.
+
+###### `report`<sup>Required</sup> <a name="report" id="@btc-embedded/cdk-extensions.ApplicationStack.reportMissingContextKey.parameter.report"></a>
+
+- *Type:* aws-cdk-lib.cloud_assembly_schema.MissingContext
+
+The set of parameters needed to obtain the context.
+
+---
+
+##### `resolve` <a name="resolve" id="@btc-embedded/cdk-extensions.ApplicationStack.resolve"></a>
+
+```typescript
+public resolve(obj: any): any
+```
+
+Resolve a tokenized value in the context of the current stack.
+
+###### `obj`<sup>Required</sup> <a name="obj" id="@btc-embedded/cdk-extensions.ApplicationStack.resolve.parameter.obj"></a>
+
+- *Type:* any
+
+---
+
+##### `splitArn` <a name="splitArn" id="@btc-embedded/cdk-extensions.ApplicationStack.splitArn"></a>
+
+```typescript
+public splitArn(arn: string, arnFormat: ArnFormat): ArnComponents
+```
+
+Splits the provided ARN into its components.
+
+Works both if 'arn' is a string like 'arn:aws:s3:::bucket',
+and a Token representing a dynamic CloudFormation expression
+(in which case the returned components will also be dynamic CloudFormation expressions,
+encoded as Tokens).
+
+###### `arn`<sup>Required</sup> <a name="arn" id="@btc-embedded/cdk-extensions.ApplicationStack.splitArn.parameter.arn"></a>
+
+- *Type:* string
+
+the ARN to split into its components.
+
+---
+
+###### `arnFormat`<sup>Required</sup> <a name="arnFormat" id="@btc-embedded/cdk-extensions.ApplicationStack.splitArn.parameter.arnFormat"></a>
+
+- *Type:* aws-cdk-lib.ArnFormat
+
+the expected format of 'arn' - depends on what format the service 'arn' represents uses.
+
+---
+
+##### `toJsonString` <a name="toJsonString" id="@btc-embedded/cdk-extensions.ApplicationStack.toJsonString"></a>
+
+```typescript
+public toJsonString(obj: any, space?: number): string
+```
+
+Convert an object, potentially containing tokens, to a JSON string.
+
+###### `obj`<sup>Required</sup> <a name="obj" id="@btc-embedded/cdk-extensions.ApplicationStack.toJsonString.parameter.obj"></a>
+
+- *Type:* any
+
+---
+
+###### `space`<sup>Optional</sup> <a name="space" id="@btc-embedded/cdk-extensions.ApplicationStack.toJsonString.parameter.space"></a>
+
+- *Type:* number
+
+---
+
+##### `toYamlString` <a name="toYamlString" id="@btc-embedded/cdk-extensions.ApplicationStack.toYamlString"></a>
+
+```typescript
+public toYamlString(obj: any): string
+```
+
+Convert an object, potentially containing tokens, to a YAML string.
+
+###### `obj`<sup>Required</sup> <a name="obj" id="@btc-embedded/cdk-extensions.ApplicationStack.toYamlString.parameter.obj"></a>
+
+- *Type:* any
+
+---
+
+#### Static Functions <a name="Static Functions" id="Static Functions"></a>
+
+| **Name** | **Description** |
+| --- | --- |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.isConstruct">isConstruct</a></code> | Checks if `x` is a construct. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.isStack">isStack</a></code> | Return whether the given object is a Stack. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.of">of</a></code> | Looks up the first stack scope in which `construct` is defined. |
+
+---
+
+##### `isConstruct` <a name="isConstruct" id="@btc-embedded/cdk-extensions.ApplicationStack.isConstruct"></a>
+
+```typescript
+import { ApplicationStack } from '@btc-embedded/cdk-extensions'
+
+ApplicationStack.isConstruct(x: any)
+```
+
+Checks if `x` is a construct.
+
+Use this method instead of `instanceof` to properly detect `Construct`
+instances, even when the construct library is symlinked.
+
+Explanation: in JavaScript, multiple copies of the `constructs` library on
+disk are seen as independent, completely different libraries. As a
+consequence, the class `Construct` in each copy of the `constructs` library
+is seen as a different class, and an instance of one class will not test as
+`instanceof` the other class. `npm install` will not create installations
+like this, but users may manually symlink construct libraries together or
+use a monorepo tool: in those cases, multiple copies of the `constructs`
+library can be accidentally installed, and `instanceof` will behave
+unpredictably. It is safest to avoid using `instanceof`, and using
+this type-testing method instead.
+
+###### `x`<sup>Required</sup> <a name="x" id="@btc-embedded/cdk-extensions.ApplicationStack.isConstruct.parameter.x"></a>
+
+- *Type:* any
+
+Any object.
+
+---
+
+##### `isStack` <a name="isStack" id="@btc-embedded/cdk-extensions.ApplicationStack.isStack"></a>
+
+```typescript
+import { ApplicationStack } from '@btc-embedded/cdk-extensions'
+
+ApplicationStack.isStack(x: any)
+```
+
+Return whether the given object is a Stack.
+
+We do attribute detection since we can't reliably use 'instanceof'.
+
+###### `x`<sup>Required</sup> <a name="x" id="@btc-embedded/cdk-extensions.ApplicationStack.isStack.parameter.x"></a>
+
+- *Type:* any
+
+---
+
+##### `of` <a name="of" id="@btc-embedded/cdk-extensions.ApplicationStack.of"></a>
+
+```typescript
+import { ApplicationStack } from '@btc-embedded/cdk-extensions'
+
+ApplicationStack.of(construct: IConstruct)
+```
+
+Looks up the first stack scope in which `construct` is defined.
+
+Fails if there is no stack up the tree.
+
+###### `construct`<sup>Required</sup> <a name="construct" id="@btc-embedded/cdk-extensions.ApplicationStack.of.parameter.construct"></a>
+
+- *Type:* constructs.IConstruct
+
+The construct to start the search from.
+
+---
+
+#### Properties <a name="Properties" id="Properties"></a>
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.property.node">node</a></code> | <code>constructs.Node</code> | The tree node. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.property.account">account</a></code> | <code>string</code> | The AWS account into which this stack will be deployed. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.property.artifactId">artifactId</a></code> | <code>string</code> | The ID of the cloud assembly artifact for this stack. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.property.availabilityZones">availabilityZones</a></code> | <code>string[]</code> | Returns the list of AZs that are available in the AWS environment (account/region) associated with this stack. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.property.bundlingRequired">bundlingRequired</a></code> | <code>boolean</code> | Indicates whether the stack requires bundling or not. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.property.dependencies">dependencies</a></code> | <code>aws-cdk-lib.Stack[]</code> | Return the stacks this stack depends on. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.property.environment">environment</a></code> | <code>string</code> | The environment coordinates in which this stack is deployed. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.property.nested">nested</a></code> | <code>boolean</code> | Indicates if this is a nested stack, in which case `parentStack` will include a reference to it's parent. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.property.notificationArns">notificationArns</a></code> | <code>string[]</code> | Returns the list of notification Amazon Resource Names (ARNs) for the current stack. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.property.partition">partition</a></code> | <code>string</code> | The partition in which this stack is defined. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.property.region">region</a></code> | <code>string</code> | The AWS region into which this stack will be deployed (e.g. `us-west-2`). |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.property.stackId">stackId</a></code> | <code>string</code> | The ID of the stack. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.property.stackName">stackName</a></code> | <code>string</code> | The concrete CloudFormation physical stack name. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.property.synthesizer">synthesizer</a></code> | <code>aws-cdk-lib.IStackSynthesizer</code> | Synthesis method for this stack. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.property.tags">tags</a></code> | <code>aws-cdk-lib.TagManager</code> | Tags to be applied to the stack. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.property.templateFile">templateFile</a></code> | <code>string</code> | The name of the CloudFormation template file emitted to the output directory during synthesis. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.property.templateOptions">templateOptions</a></code> | <code>aws-cdk-lib.ITemplateOptions</code> | Options for CloudFormation template (like version, transform, description). |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.property.urlSuffix">urlSuffix</a></code> | <code>string</code> | The Amazon domain suffix for the region in which this stack is defined. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.property.nestedStackParent">nestedStackParent</a></code> | <code>aws-cdk-lib.Stack</code> | If this is a nested stack, returns it's parent stack. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.property.nestedStackResource">nestedStackResource</a></code> | <code>aws-cdk-lib.CfnResource</code> | If this is a nested stack, this represents its `AWS::CloudFormation::Stack` resource. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStack.property.terminationProtection">terminationProtection</a></code> | <code>boolean</code> | Whether termination protection is enabled for this stack. |
+
+---
+
+##### `node`<sup>Required</sup> <a name="node" id="@btc-embedded/cdk-extensions.ApplicationStack.property.node"></a>
+
+```typescript
+public readonly node: Node;
+```
+
+- *Type:* constructs.Node
+
+The tree node.
+
+---
+
+##### `account`<sup>Required</sup> <a name="account" id="@btc-embedded/cdk-extensions.ApplicationStack.property.account"></a>
+
+```typescript
+public readonly account: string;
+```
+
+- *Type:* string
+
+The AWS account into which this stack will be deployed.
+
+This value is resolved according to the following rules:
+
+1. The value provided to `env.account` when the stack is defined. This can
+   either be a concrete account (e.g. `585695031111`) or the
+   `Aws.ACCOUNT_ID` token.
+3. `Aws.ACCOUNT_ID`, which represents the CloudFormation intrinsic reference
+   `{ "Ref": "AWS::AccountId" }` encoded as a string token.
+
+Preferably, you should use the return value as an opaque string and not
+attempt to parse it to implement your logic. If you do, you must first
+check that it is a concrete value an not an unresolved token. If this
+value is an unresolved token (`Token.isUnresolved(stack.account)` returns
+`true`), this implies that the user wishes that this stack will synthesize
+into an **account-agnostic template**. In this case, your code should either
+fail (throw an error, emit a synth error using `Annotations.of(construct).addError()`) or
+implement some other account-agnostic behavior.
+
+---
+
+##### `artifactId`<sup>Required</sup> <a name="artifactId" id="@btc-embedded/cdk-extensions.ApplicationStack.property.artifactId"></a>
+
+```typescript
+public readonly artifactId: string;
+```
+
+- *Type:* string
+
+The ID of the cloud assembly artifact for this stack.
+
+---
+
+##### `availabilityZones`<sup>Required</sup> <a name="availabilityZones" id="@btc-embedded/cdk-extensions.ApplicationStack.property.availabilityZones"></a>
+
+```typescript
+public readonly availabilityZones: string[];
+```
+
+- *Type:* string[]
+
+Returns the list of AZs that are available in the AWS environment (account/region) associated with this stack.
+
+If the stack is environment-agnostic (either account and/or region are
+tokens), this property will return an array with 2 tokens that will resolve
+at deploy-time to the first two availability zones returned from CloudFormation's
+`Fn::GetAZs` intrinsic function.
+
+If they are not available in the context, returns a set of dummy values and
+reports them as missing, and let the CLI resolve them by calling EC2
+`DescribeAvailabilityZones` on the target environment.
+
+To specify a different strategy for selecting availability zones override this method.
+
+---
+
+##### `bundlingRequired`<sup>Required</sup> <a name="bundlingRequired" id="@btc-embedded/cdk-extensions.ApplicationStack.property.bundlingRequired"></a>
+
+```typescript
+public readonly bundlingRequired: boolean;
+```
+
+- *Type:* boolean
+
+Indicates whether the stack requires bundling or not.
+
+---
+
+##### `dependencies`<sup>Required</sup> <a name="dependencies" id="@btc-embedded/cdk-extensions.ApplicationStack.property.dependencies"></a>
+
+```typescript
+public readonly dependencies: Stack[];
+```
+
+- *Type:* aws-cdk-lib.Stack[]
+
+Return the stacks this stack depends on.
+
+---
+
+##### `environment`<sup>Required</sup> <a name="environment" id="@btc-embedded/cdk-extensions.ApplicationStack.property.environment"></a>
+
+```typescript
+public readonly environment: string;
+```
+
+- *Type:* string
+
+The environment coordinates in which this stack is deployed.
+
+In the form
+`aws://account/region`. Use `stack.account` and `stack.region` to obtain
+the specific values, no need to parse.
+
+You can use this value to determine if two stacks are targeting the same
+environment.
+
+If either `stack.account` or `stack.region` are not concrete values (e.g.
+`Aws.ACCOUNT_ID` or `Aws.REGION`) the special strings `unknown-account` and/or
+`unknown-region` will be used respectively to indicate this stack is
+region/account-agnostic.
+
+---
+
+##### `nested`<sup>Required</sup> <a name="nested" id="@btc-embedded/cdk-extensions.ApplicationStack.property.nested"></a>
+
+```typescript
+public readonly nested: boolean;
+```
+
+- *Type:* boolean
+
+Indicates if this is a nested stack, in which case `parentStack` will include a reference to it's parent.
+
+---
+
+##### `notificationArns`<sup>Required</sup> <a name="notificationArns" id="@btc-embedded/cdk-extensions.ApplicationStack.property.notificationArns"></a>
+
+```typescript
+public readonly notificationArns: string[];
+```
+
+- *Type:* string[]
+
+Returns the list of notification Amazon Resource Names (ARNs) for the current stack.
+
+---
+
+##### `partition`<sup>Required</sup> <a name="partition" id="@btc-embedded/cdk-extensions.ApplicationStack.property.partition"></a>
+
+```typescript
+public readonly partition: string;
+```
+
+- *Type:* string
+
+The partition in which this stack is defined.
+
+---
+
+##### `region`<sup>Required</sup> <a name="region" id="@btc-embedded/cdk-extensions.ApplicationStack.property.region"></a>
+
+```typescript
+public readonly region: string;
+```
+
+- *Type:* string
+
+The AWS region into which this stack will be deployed (e.g. `us-west-2`).
+
+This value is resolved according to the following rules:
+
+1. The value provided to `env.region` when the stack is defined. This can
+   either be a concrete region (e.g. `us-west-2`) or the `Aws.REGION`
+   token.
+3. `Aws.REGION`, which is represents the CloudFormation intrinsic reference
+   `{ "Ref": "AWS::Region" }` encoded as a string token.
+
+Preferably, you should use the return value as an opaque string and not
+attempt to parse it to implement your logic. If you do, you must first
+check that it is a concrete value an not an unresolved token. If this
+value is an unresolved token (`Token.isUnresolved(stack.region)` returns
+`true`), this implies that the user wishes that this stack will synthesize
+into a **region-agnostic template**. In this case, your code should either
+fail (throw an error, emit a synth error using `Annotations.of(construct).addError()`) or
+implement some other region-agnostic behavior.
+
+---
+
+##### `stackId`<sup>Required</sup> <a name="stackId" id="@btc-embedded/cdk-extensions.ApplicationStack.property.stackId"></a>
+
+```typescript
+public readonly stackId: string;
+```
+
+- *Type:* string
+
+The ID of the stack.
+
+---
+
+*Example*
+
+```typescript
+// After resolving, looks like
+'arn:aws:cloudformation:us-west-2:123456789012:stack/teststack/51af3dc0-da77-11e4-872e-1234567db123'
+```
+
+
+##### `stackName`<sup>Required</sup> <a name="stackName" id="@btc-embedded/cdk-extensions.ApplicationStack.property.stackName"></a>
+
+```typescript
+public readonly stackName: string;
+```
+
+- *Type:* string
+
+The concrete CloudFormation physical stack name.
+
+This is either the name defined explicitly in the `stackName` prop or
+allocated based on the stack's location in the construct tree. Stacks that
+are directly defined under the app use their construct `id` as their stack
+name. Stacks that are defined deeper within the tree will use a hashed naming
+scheme based on the construct path to ensure uniqueness.
+
+If you wish to obtain the deploy-time AWS::StackName intrinsic,
+you can use `Aws.STACK_NAME` directly.
+
+---
+
+##### `synthesizer`<sup>Required</sup> <a name="synthesizer" id="@btc-embedded/cdk-extensions.ApplicationStack.property.synthesizer"></a>
+
+```typescript
+public readonly synthesizer: IStackSynthesizer;
+```
+
+- *Type:* aws-cdk-lib.IStackSynthesizer
+
+Synthesis method for this stack.
+
+---
+
+##### `tags`<sup>Required</sup> <a name="tags" id="@btc-embedded/cdk-extensions.ApplicationStack.property.tags"></a>
+
+```typescript
+public readonly tags: TagManager;
+```
+
+- *Type:* aws-cdk-lib.TagManager
+
+Tags to be applied to the stack.
+
+---
+
+##### `templateFile`<sup>Required</sup> <a name="templateFile" id="@btc-embedded/cdk-extensions.ApplicationStack.property.templateFile"></a>
+
+```typescript
+public readonly templateFile: string;
+```
+
+- *Type:* string
+
+The name of the CloudFormation template file emitted to the output directory during synthesis.
+
+Example value: `MyStack.template.json`
+
+---
+
+##### `templateOptions`<sup>Required</sup> <a name="templateOptions" id="@btc-embedded/cdk-extensions.ApplicationStack.property.templateOptions"></a>
+
+```typescript
+public readonly templateOptions: ITemplateOptions;
+```
+
+- *Type:* aws-cdk-lib.ITemplateOptions
+
+Options for CloudFormation template (like version, transform, description).
+
+---
+
+##### `urlSuffix`<sup>Required</sup> <a name="urlSuffix" id="@btc-embedded/cdk-extensions.ApplicationStack.property.urlSuffix"></a>
+
+```typescript
+public readonly urlSuffix: string;
+```
+
+- *Type:* string
+
+The Amazon domain suffix for the region in which this stack is defined.
+
+---
+
+##### `nestedStackParent`<sup>Optional</sup> <a name="nestedStackParent" id="@btc-embedded/cdk-extensions.ApplicationStack.property.nestedStackParent"></a>
+
+```typescript
+public readonly nestedStackParent: Stack;
+```
+
+- *Type:* aws-cdk-lib.Stack
+
+If this is a nested stack, returns it's parent stack.
+
+---
+
+##### `nestedStackResource`<sup>Optional</sup> <a name="nestedStackResource" id="@btc-embedded/cdk-extensions.ApplicationStack.property.nestedStackResource"></a>
+
+```typescript
+public readonly nestedStackResource: CfnResource;
+```
+
+- *Type:* aws-cdk-lib.CfnResource
+
+If this is a nested stack, this represents its `AWS::CloudFormation::Stack` resource.
+
+`undefined` for top-level (non-nested) stacks.
+
+---
+
+##### `terminationProtection`<sup>Required</sup> <a name="terminationProtection" id="@btc-embedded/cdk-extensions.ApplicationStack.property.terminationProtection"></a>
+
+```typescript
+public readonly terminationProtection: boolean;
+```
+
+- *Type:* boolean
+
+Whether termination protection is enabled for this stack.
+
+---
+
+
 ### BTCLogGroup <a name="BTCLogGroup" id="@btc-embedded/cdk-extensions.BTCLogGroup"></a>
 
 A log group with sensible defaults.
@@ -2322,7 +3249,7 @@ Any object.
 ```typescript
 import { CognitoUserPool } from '@btc-embedded/cdk-extensions'
 
-CognitoUserPool.fromBasePlatform(scope: Construct, id: string, basePlatform: string)
+CognitoUserPool.fromBasePlatform(scope: Construct, id: string, basePlatformStackName?: string)
 ```
 
 ###### `scope`<sup>Required</sup> <a name="scope" id="@btc-embedded/cdk-extensions.CognitoUserPool.fromBasePlatform.parameter.scope"></a>
@@ -2337,7 +3264,7 @@ CognitoUserPool.fromBasePlatform(scope: Construct, id: string, basePlatform: str
 
 ---
 
-###### `basePlatform`<sup>Required</sup> <a name="basePlatform" id="@btc-embedded/cdk-extensions.CognitoUserPool.fromBasePlatform.parameter.basePlatform"></a>
+###### `basePlatformStackName`<sup>Optional</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.CognitoUserPool.fromBasePlatform.parameter.basePlatformStackName"></a>
 
 - *Type:* string
 
@@ -2871,7 +3798,7 @@ Any object.
 ```typescript
 import { DocumentDB } from '@btc-embedded/cdk-extensions'
 
-DocumentDB.fromBasePlatform(scope: Construct, id: string, name: string)
+DocumentDB.fromBasePlatform(scope: Construct, id: string, name?: string)
 ```
 
 ###### `scope`<sup>Required</sup> <a name="scope" id="@btc-embedded/cdk-extensions.DocumentDB.fromBasePlatform.parameter.scope"></a>
@@ -2886,7 +3813,7 @@ DocumentDB.fromBasePlatform(scope: Construct, id: string, name: string)
 
 ---
 
-###### `name`<sup>Required</sup> <a name="name" id="@btc-embedded/cdk-extensions.DocumentDB.fromBasePlatform.parameter.name"></a>
+###### `name`<sup>Optional</sup> <a name="name" id="@btc-embedded/cdk-extensions.DocumentDB.fromBasePlatform.parameter.name"></a>
 
 - *Type:* string
 
@@ -4067,7 +4994,7 @@ Any object.
 ```typescript
 import { PrivateDnsNamespace } from '@btc-embedded/cdk-extensions'
 
-PrivateDnsNamespace.fromBasePlatform(scope: Construct, id: string, stackName: string)
+PrivateDnsNamespace.fromBasePlatform(scope: Construct, id: string, stackName?: string)
 ```
 
 ###### `scope`<sup>Required</sup> <a name="scope" id="@btc-embedded/cdk-extensions.PrivateDnsNamespace.fromBasePlatform.parameter.scope"></a>
@@ -4082,7 +5009,7 @@ PrivateDnsNamespace.fromBasePlatform(scope: Construct, id: string, stackName: st
 
 ---
 
-###### `stackName`<sup>Required</sup> <a name="stackName" id="@btc-embedded/cdk-extensions.PrivateDnsNamespace.fromBasePlatform.parameter.stackName"></a>
+###### `stackName`<sup>Optional</sup> <a name="stackName" id="@btc-embedded/cdk-extensions.PrivateDnsNamespace.fromBasePlatform.parameter.stackName"></a>
 
 - *Type:* string
 
@@ -5962,7 +6889,7 @@ Any object.
 ```typescript
 import { Vpc } from '@btc-embedded/cdk-extensions'
 
-Vpc.fromBasePlatform(scope: Construct, id: string, stackName: string)
+Vpc.fromBasePlatform(scope: Construct, id: string, stackName?: string)
 ```
 
 ###### `scope`<sup>Required</sup> <a name="scope" id="@btc-embedded/cdk-extensions.Vpc.fromBasePlatform.parameter.scope"></a>
@@ -5977,7 +6904,7 @@ Vpc.fromBasePlatform(scope: Construct, id: string, stackName: string)
 
 ---
 
-###### `stackName`<sup>Required</sup> <a name="stackName" id="@btc-embedded/cdk-extensions.Vpc.fromBasePlatform.parameter.stackName"></a>
+###### `stackName`<sup>Optional</sup> <a name="stackName" id="@btc-embedded/cdk-extensions.Vpc.fromBasePlatform.parameter.stackName"></a>
 
 - *Type:* string
 
@@ -6247,45 +7174,45 @@ const apiGatewayExtensionProps: ApiGatewayExtensionProps = { ... }
 
 | **Name** | **Type** | **Description** |
 | --- | --- | --- |
-| <code><a href="#@btc-embedded/cdk-extensions.ApiGatewayExtensionProps.property.platformStackName">platformStackName</a></code> | <code>string</code> | The name of the base platform stack. |
 | <code><a href="#@btc-embedded/cdk-extensions.ApiGatewayExtensionProps.property.prefix">prefix</a></code> | <code>string</code> | The prefix for the API Gateway endpoint. |
 | <code><a href="#@btc-embedded/cdk-extensions.ApiGatewayExtensionProps.property.securityGroupId">securityGroupId</a></code> | <code>string</code> | The security group ID of the API Gateway which should be allowed to connect to the service. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApiGatewayExtensionProps.property.basePlatformStackName">basePlatformStackName</a></code> | <code>string</code> | The name of the base platform stack. |
 
 ---
 
-##### `platformStackName`<sup>Required</sup> <a name="platformStackName" id="@btc-embedded/cdk-extensions.ApiGatewayExtensionProps.property.platformStackName"></a>
+##### `prefix`<sup>Required</sup> <a name="prefix" id="@btc-embedded/cdk-extensions.ApiGatewayExtensionProps.property.prefix"></a>
 
 ```typescript
-public readonly platformStackName: string;
+public readonly prefix: string;
 ```
 
 - *Type:* string
 
-The name of the base platform stack.
+The prefix for the API Gateway endpoint.
 
 ---
 
-##### `prefix`<sup>Required</sup> <a name="prefix" id="@btc-embedded/cdk-extensions.ApiGatewayExtensionProps.property.prefix"></a>
+##### `securityGroupId`<sup>Required</sup> <a name="securityGroupId" id="@btc-embedded/cdk-extensions.ApiGatewayExtensionProps.property.securityGroupId"></a>
 
 ```typescript
-public readonly prefix: string;
+public readonly securityGroupId: string;
 ```
 
 - *Type:* string
 
-The prefix for the API Gateway endpoint.
+The security group ID of the API Gateway which should be allowed to connect to the service.
 
 ---
 
-##### `securityGroupId`<sup>Required</sup> <a name="securityGroupId" id="@btc-embedded/cdk-extensions.ApiGatewayExtensionProps.property.securityGroupId"></a>
+##### `basePlatformStackName`<sup>Optional</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.ApiGatewayExtensionProps.property.basePlatformStackName"></a>
 
 ```typescript
-public readonly securityGroupId: string;
+public readonly basePlatformStackName: string;
 ```
 
 - *Type:* string
 
-The security group ID of the API Gateway which should be allowed to connect to the service.
+The name of the base platform stack.
 
 ---
 
@@ -6411,28 +7338,28 @@ const apiGatewayVpcLinkLookupOptions: ApiGatewayVpcLinkLookupOptions = { ... }
 
 | **Name** | **Type** | **Description** |
 | --- | --- | --- |
-| <code><a href="#@btc-embedded/cdk-extensions.ApiGatewayVpcLinkLookupOptions.property.basePlatform">basePlatform</a></code> | <code>string</code> | *No description.* |
 | <code><a href="#@btc-embedded/cdk-extensions.ApiGatewayVpcLinkLookupOptions.property.vpc">vpc</a></code> | <code>aws-cdk-lib.aws_ec2.IVpc</code> | *No description.* |
+| <code><a href="#@btc-embedded/cdk-extensions.ApiGatewayVpcLinkLookupOptions.property.basePlatformStackName">basePlatformStackName</a></code> | <code>string</code> | *No description.* |
 
 ---
 
-##### `basePlatform`<sup>Required</sup> <a name="basePlatform" id="@btc-embedded/cdk-extensions.ApiGatewayVpcLinkLookupOptions.property.basePlatform"></a>
+##### `vpc`<sup>Required</sup> <a name="vpc" id="@btc-embedded/cdk-extensions.ApiGatewayVpcLinkLookupOptions.property.vpc"></a>
 
 ```typescript
-public readonly basePlatform: string;
+public readonly vpc: IVpc;
 ```
 
-- *Type:* string
+- *Type:* aws-cdk-lib.aws_ec2.IVpc
 
 ---
 
-##### `vpc`<sup>Required</sup> <a name="vpc" id="@btc-embedded/cdk-extensions.ApiGatewayVpcLinkLookupOptions.property.vpc"></a>
+##### `basePlatformStackName`<sup>Optional</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.ApiGatewayVpcLinkLookupOptions.property.basePlatformStackName"></a>
 
 ```typescript
-public readonly vpc: IVpc;
+public readonly basePlatformStackName: string;
 ```
 
-- *Type:* aws-cdk-lib.aws_ec2.IVpc
+- *Type:* string
 
 ---
 
@@ -6823,9 +7750,9 @@ const applicationLoadBalancerExtensionProps: ApplicationLoadBalancerExtensionPro
 | **Name** | **Type** | **Description** |
 | --- | --- | --- |
 | <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerExtensionProps.property.clientScope">clientScope</a></code> | <code>string</code> | *No description.* |
-| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerExtensionProps.property.platformStackName">platformStackName</a></code> | <code>string</code> | *No description.* |
 | <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerExtensionProps.property.securityGroupId">securityGroupId</a></code> | <code>string</code> | *No description.* |
 | <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerExtensionProps.property.userPoolClientSecret">userPoolClientSecret</a></code> | <code>string</code> | *No description.* |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerExtensionProps.property.basePlatformStackName">basePlatformStackName</a></code> | <code>string</code> | *No description.* |
 | <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerExtensionProps.property.healtCheckPath">healtCheckPath</a></code> | <code>string</code> | *No description.* |
 | <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerExtensionProps.property.listener">listener</a></code> | <code>aws-cdk-lib.aws_elasticloadbalancingv2.IApplicationListener</code> | *No description.* |
 | <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerExtensionProps.property.path">path</a></code> | <code>string</code> | *No description.* |
@@ -6842,30 +7769,30 @@ public readonly clientScope: string;
 
 ---
 
-##### `platformStackName`<sup>Required</sup> <a name="platformStackName" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerExtensionProps.property.platformStackName"></a>
+##### `securityGroupId`<sup>Required</sup> <a name="securityGroupId" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerExtensionProps.property.securityGroupId"></a>
 
 ```typescript
-public readonly platformStackName: string;
+public readonly securityGroupId: string;
 ```
 
 - *Type:* string
 
 ---
 
-##### `securityGroupId`<sup>Required</sup> <a name="securityGroupId" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerExtensionProps.property.securityGroupId"></a>
+##### `userPoolClientSecret`<sup>Required</sup> <a name="userPoolClientSecret" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerExtensionProps.property.userPoolClientSecret"></a>
 
 ```typescript
-public readonly securityGroupId: string;
+public readonly userPoolClientSecret: string;
 ```
 
 - *Type:* string
 
 ---
 
-##### `userPoolClientSecret`<sup>Required</sup> <a name="userPoolClientSecret" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerExtensionProps.property.userPoolClientSecret"></a>
+##### `basePlatformStackName`<sup>Optional</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerExtensionProps.property.basePlatformStackName"></a>
 
 ```typescript
-public readonly userPoolClientSecret: string;
+public readonly basePlatformStackName: string;
 ```
 
 - *Type:* string
@@ -6916,8 +7843,18 @@ const applicationLoadBalancerExtensionPropsV2: ApplicationLoadBalancerExtensionP
 
 | **Name** | **Type** | **Description** |
 | --- | --- | --- |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerExtensionPropsV2.property.basePlatformStackName">basePlatformStackName</a></code> | <code>string</code> | *No description.* |
 | <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerExtensionPropsV2.property.loadBalancer">loadBalancer</a></code> | <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerV2">ApplicationLoadBalancerV2</a></code> | *No description.* |
-| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerExtensionPropsV2.property.platformStackName">platformStackName</a></code> | <code>string</code> | *No description.* |
+
+---
+
+##### `basePlatformStackName`<sup>Optional</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerExtensionPropsV2.property.basePlatformStackName"></a>
+
+```typescript
+public readonly basePlatformStackName: string;
+```
+
+- *Type:* string
 
 ---
 
@@ -6927,224 +7864,498 @@ const applicationLoadBalancerExtensionPropsV2: ApplicationLoadBalancerExtensionP
 public readonly loadBalancer: ApplicationLoadBalancerV2;
 ```
 
-- *Type:* <a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerV2">ApplicationLoadBalancerV2</a>
+- *Type:* <a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerV2">ApplicationLoadBalancerV2</a>
+
+---
+
+### ApplicationLoadBalancerProps <a name="ApplicationLoadBalancerProps" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps"></a>
+
+#### Initializer <a name="Initializer" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.Initializer"></a>
+
+```typescript
+import { ApplicationLoadBalancerProps } from '@btc-embedded/cdk-extensions'
+
+const applicationLoadBalancerProps: ApplicationLoadBalancerProps = { ... }
+```
+
+#### Properties <a name="Properties" id="Properties"></a>
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.fqdn">fqdn</a></code> | <code>string</code> | *No description.* |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.hostedZone">hostedZone</a></code> | <code>aws-cdk-lib.aws_route53.IHostedZone</code> | *No description.* |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.userPool">userPool</a></code> | <code>aws-cdk-lib.aws_cognito.IUserPool</code> | *No description.* |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.userPoolClient">userPoolClient</a></code> | <code>aws-cdk-lib.aws_cognito.IUserPoolClient</code> | *No description.* |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.userPoolDomain">userPoolDomain</a></code> | <code>aws-cdk-lib.aws_cognito.IUserPoolDomain</code> | *No description.* |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.vpc">vpc</a></code> | <code>aws-cdk-lib.aws_ec2.IVpc</code> | *No description.* |
+
+---
+
+##### `fqdn`<sup>Required</sup> <a name="fqdn" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.fqdn"></a>
+
+```typescript
+public readonly fqdn: string;
+```
+
+- *Type:* string
+
+---
+
+##### `hostedZone`<sup>Required</sup> <a name="hostedZone" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.hostedZone"></a>
+
+```typescript
+public readonly hostedZone: IHostedZone;
+```
+
+- *Type:* aws-cdk-lib.aws_route53.IHostedZone
+
+---
+
+##### `userPool`<sup>Required</sup> <a name="userPool" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.userPool"></a>
+
+```typescript
+public readonly userPool: IUserPool;
+```
+
+- *Type:* aws-cdk-lib.aws_cognito.IUserPool
+
+---
+
+##### `userPoolClient`<sup>Required</sup> <a name="userPoolClient" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.userPoolClient"></a>
+
+```typescript
+public readonly userPoolClient: IUserPoolClient;
+```
+
+- *Type:* aws-cdk-lib.aws_cognito.IUserPoolClient
+
+---
+
+##### `userPoolDomain`<sup>Required</sup> <a name="userPoolDomain" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.userPoolDomain"></a>
+
+```typescript
+public readonly userPoolDomain: IUserPoolDomain;
+```
+
+- *Type:* aws-cdk-lib.aws_cognito.IUserPoolDomain
+
+---
+
+##### `vpc`<sup>Required</sup> <a name="vpc" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.vpc"></a>
+
+```typescript
+public readonly vpc: IVpc;
+```
+
+- *Type:* aws-cdk-lib.aws_ec2.IVpc
+
+---
+
+### ApplicationLoadBalancerPropsV2 <a name="ApplicationLoadBalancerPropsV2" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2"></a>
+
+#### Initializer <a name="Initializer" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.Initializer"></a>
+
+```typescript
+import { ApplicationLoadBalancerPropsV2 } from '@btc-embedded/cdk-extensions'
+
+const applicationLoadBalancerPropsV2: ApplicationLoadBalancerPropsV2 = { ... }
+```
+
+#### Properties <a name="Properties" id="Properties"></a>
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.healtCheckPath">healtCheckPath</a></code> | <code>string</code> | The health check path for the target group. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.hostedZone">hostedZone</a></code> | <code>aws-cdk-lib.aws_route53.IHostedZone</code> | The Route 53 hosted zone where the ALB's DNS record will be created. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.trafficPort">trafficPort</a></code> | <code>number</code> | The port on which the target group will receive traffic. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.userPool">userPool</a></code> | <code><a href="#@btc-embedded/cdk-extensions.ICognitoUserPool">ICognitoUserPool</a></code> | The Cognito User Pool of this base platform. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.vpc">vpc</a></code> | <code>aws-cdk-lib.aws_ec2.IVpc</code> | The VPC in which the Application Load Balancer will be deployed. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.recordName">recordName</a></code> | <code>string</code> | The domain prefix or record name for configuring the ALB domain. |
+
+---
+
+##### `healtCheckPath`<sup>Required</sup> <a name="healtCheckPath" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.healtCheckPath"></a>
+
+```typescript
+public readonly healtCheckPath: string;
+```
+
+- *Type:* string
+
+The health check path for the target group.
+
+---
+
+##### `hostedZone`<sup>Required</sup> <a name="hostedZone" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.hostedZone"></a>
+
+```typescript
+public readonly hostedZone: IHostedZone;
+```
+
+- *Type:* aws-cdk-lib.aws_route53.IHostedZone
+
+The Route 53 hosted zone where the ALB's DNS record will be created.
+
+---
+
+##### `trafficPort`<sup>Required</sup> <a name="trafficPort" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.trafficPort"></a>
+
+```typescript
+public readonly trafficPort: number;
+```
+
+- *Type:* number
+
+The port on which the target group will receive traffic.
+
+---
+
+##### `userPool`<sup>Required</sup> <a name="userPool" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.userPool"></a>
+
+```typescript
+public readonly userPool: ICognitoUserPool;
+```
+
+- *Type:* <a href="#@btc-embedded/cdk-extensions.ICognitoUserPool">ICognitoUserPool</a>
+
+The Cognito User Pool of this base platform.
+
+---
+
+##### `vpc`<sup>Required</sup> <a name="vpc" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.vpc"></a>
+
+```typescript
+public readonly vpc: IVpc;
+```
+
+- *Type:* aws-cdk-lib.aws_ec2.IVpc
+
+The VPC in which the Application Load Balancer will be deployed.
+
+---
+
+##### `recordName`<sup>Optional</sup> <a name="recordName" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.recordName"></a>
+
+```typescript
+public readonly recordName: string;
+```
+
+- *Type:* string
+- *Default:* zone root
+
+The domain prefix or record name for configuring the ALB domain.
+
+This name is used to register an A record in the given hosted zone. If not
+provided, the zone's root will be used.
+
+---
+
+### ApplicationLoadBalancerV2LookupOptions <a name="ApplicationLoadBalancerV2LookupOptions" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerV2LookupOptions"></a>
+
+#### Initializer <a name="Initializer" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerV2LookupOptions.Initializer"></a>
+
+```typescript
+import { ApplicationLoadBalancerV2LookupOptions } from '@btc-embedded/cdk-extensions'
+
+const applicationLoadBalancerV2LookupOptions: ApplicationLoadBalancerV2LookupOptions = { ... }
+```
+
+#### Properties <a name="Properties" id="Properties"></a>
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerV2LookupOptions.property.basePlatformStackName">basePlatformStackName</a></code> | <code>string</code> | *No description.* |
 
 ---
 
-##### `platformStackName`<sup>Optional</sup> <a name="platformStackName" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerExtensionPropsV2.property.platformStackName"></a>
+##### `basePlatformStackName`<sup>Optional</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerV2LookupOptions.property.basePlatformStackName"></a>
 
 ```typescript
-public readonly platformStackName: string;
+public readonly basePlatformStackName: string;
 ```
 
 - *Type:* string
 
 ---
 
-### ApplicationLoadBalancerProps <a name="ApplicationLoadBalancerProps" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps"></a>
+### ApplicationStackProps <a name="ApplicationStackProps" id="@btc-embedded/cdk-extensions.ApplicationStackProps"></a>
 
-#### Initializer <a name="Initializer" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.Initializer"></a>
+#### Initializer <a name="Initializer" id="@btc-embedded/cdk-extensions.ApplicationStackProps.Initializer"></a>
 
 ```typescript
-import { ApplicationLoadBalancerProps } from '@btc-embedded/cdk-extensions'
+import { ApplicationStackProps } from '@btc-embedded/cdk-extensions'
 
-const applicationLoadBalancerProps: ApplicationLoadBalancerProps = { ... }
+const applicationStackProps: ApplicationStackProps = { ... }
 ```
 
 #### Properties <a name="Properties" id="Properties"></a>
 
 | **Name** | **Type** | **Description** |
 | --- | --- | --- |
-| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.fqdn">fqdn</a></code> | <code>string</code> | *No description.* |
-| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.hostedZone">hostedZone</a></code> | <code>aws-cdk-lib.aws_route53.IHostedZone</code> | *No description.* |
-| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.userPool">userPool</a></code> | <code>aws-cdk-lib.aws_cognito.IUserPool</code> | *No description.* |
-| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.userPoolClient">userPoolClient</a></code> | <code>aws-cdk-lib.aws_cognito.IUserPoolClient</code> | *No description.* |
-| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.userPoolDomain">userPoolDomain</a></code> | <code>aws-cdk-lib.aws_cognito.IUserPoolDomain</code> | *No description.* |
-| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.vpc">vpc</a></code> | <code>aws-cdk-lib.aws_ec2.IVpc</code> | *No description.* |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStackProps.property.analyticsReporting">analyticsReporting</a></code> | <code>boolean</code> | Include runtime versioning information in this Stack. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStackProps.property.crossRegionReferences">crossRegionReferences</a></code> | <code>boolean</code> | Enable this flag to allow native cross region stack references. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStackProps.property.description">description</a></code> | <code>string</code> | A description of the stack. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStackProps.property.env">env</a></code> | <code>aws-cdk-lib.Environment</code> | The AWS environment (account/region) where this stack will be deployed. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStackProps.property.notificationArns">notificationArns</a></code> | <code>string[]</code> | SNS Topic ARNs that will receive stack events. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStackProps.property.permissionsBoundary">permissionsBoundary</a></code> | <code>aws-cdk-lib.PermissionsBoundary</code> | Options for applying a permissions boundary to all IAM Roles and Users created within this Stage. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStackProps.property.propertyInjectors">propertyInjectors</a></code> | <code>aws-cdk-lib.IPropertyInjector[]</code> | A list of IPropertyInjector attached to this Stack. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStackProps.property.stackName">stackName</a></code> | <code>string</code> | Name to deploy the stack with. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStackProps.property.suppressTemplateIndentation">suppressTemplateIndentation</a></code> | <code>boolean</code> | Enable this flag to suppress indentation in generated CloudFormation templates. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStackProps.property.synthesizer">synthesizer</a></code> | <code>aws-cdk-lib.IStackSynthesizer</code> | Synthesis method to use while deploying this stack. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStackProps.property.tags">tags</a></code> | <code>{[ key: string ]: string}</code> | Tags that will be applied to the Stack. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStackProps.property.terminationProtection">terminationProtection</a></code> | <code>boolean</code> | Whether to enable termination protection for this stack. |
+| <code><a href="#@btc-embedded/cdk-extensions.ApplicationStackProps.property.basePlatformStackName">basePlatformStackName</a></code> | <code>string</code> | *No description.* |
 
 ---
 
-##### `fqdn`<sup>Required</sup> <a name="fqdn" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.fqdn"></a>
+##### `analyticsReporting`<sup>Optional</sup> <a name="analyticsReporting" id="@btc-embedded/cdk-extensions.ApplicationStackProps.property.analyticsReporting"></a>
 
 ```typescript
-public readonly fqdn: string;
+public readonly analyticsReporting: boolean;
 ```
 
-- *Type:* string
+- *Type:* boolean
+- *Default:* `analyticsReporting` setting of containing `App`, or value of 'aws:cdk:version-reporting' context key
+
+Include runtime versioning information in this Stack.
 
 ---
 
-##### `hostedZone`<sup>Required</sup> <a name="hostedZone" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.hostedZone"></a>
+##### `crossRegionReferences`<sup>Optional</sup> <a name="crossRegionReferences" id="@btc-embedded/cdk-extensions.ApplicationStackProps.property.crossRegionReferences"></a>
 
 ```typescript
-public readonly hostedZone: IHostedZone;
+public readonly crossRegionReferences: boolean;
 ```
 
-- *Type:* aws-cdk-lib.aws_route53.IHostedZone
+- *Type:* boolean
+- *Default:* false
+
+Enable this flag to allow native cross region stack references.
+
+Enabling this will create a CloudFormation custom resource
+in both the producing stack and consuming stack in order to perform the export/import
+
+This feature is currently experimental
 
 ---
 
-##### `userPool`<sup>Required</sup> <a name="userPool" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.userPool"></a>
+##### `description`<sup>Optional</sup> <a name="description" id="@btc-embedded/cdk-extensions.ApplicationStackProps.property.description"></a>
 
 ```typescript
-public readonly userPool: IUserPool;
+public readonly description: string;
 ```
 
-- *Type:* aws-cdk-lib.aws_cognito.IUserPool
+- *Type:* string
+- *Default:* No description.
+
+A description of the stack.
 
 ---
 
-##### `userPoolClient`<sup>Required</sup> <a name="userPoolClient" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.userPoolClient"></a>
+##### `env`<sup>Optional</sup> <a name="env" id="@btc-embedded/cdk-extensions.ApplicationStackProps.property.env"></a>
 
 ```typescript
-public readonly userPoolClient: IUserPoolClient;
+public readonly env: Environment;
 ```
 
-- *Type:* aws-cdk-lib.aws_cognito.IUserPoolClient
+- *Type:* aws-cdk-lib.Environment
+- *Default:* The environment of the containing `Stage` if available, otherwise create the stack will be environment-agnostic.
 
----
+The AWS environment (account/region) where this stack will be deployed.
 
-##### `userPoolDomain`<sup>Required</sup> <a name="userPoolDomain" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.userPoolDomain"></a>
+Set the `region`/`account` fields of `env` to either a concrete value to
+select the indicated environment (recommended for production stacks), or to
+the values of environment variables
+`CDK_DEFAULT_REGION`/`CDK_DEFAULT_ACCOUNT` to let the target environment
+depend on the AWS credentials/configuration that the CDK CLI is executed
+under (recommended for development stacks).
 
-```typescript
-public readonly userPoolDomain: IUserPoolDomain;
-```
+If the `Stack` is instantiated inside a `Stage`, any undefined
+`region`/`account` fields from `env` will default to the same field on the
+encompassing `Stage`, if configured there.
 
-- *Type:* aws-cdk-lib.aws_cognito.IUserPoolDomain
+If either `region` or `account` are not set nor inherited from `Stage`, the
+Stack will be considered "*environment-agnostic*"". Environment-agnostic
+stacks can be deployed to any environment but may not be able to take
+advantage of all features of the CDK. For example, they will not be able to
+use environmental context lookups such as `ec2.Vpc.fromLookup` and will not
+automatically translate Service Principals to the right format based on the
+environment's AWS partition, and other such enhancements.
 
 ---
 
-##### `vpc`<sup>Required</sup> <a name="vpc" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerProps.property.vpc"></a>
+*Example*
 
 ```typescript
-public readonly vpc: IVpc;
-```
+// Use a concrete account and region to deploy this stack to:
+// `.account` and `.region` will simply return these values.
+new Stack(app, 'Stack1', {
+  env: {
+    account: '123456789012',
+    region: 'us-east-1'
+  },
+});
 
-- *Type:* aws-cdk-lib.aws_ec2.IVpc
+// Use the CLI's current credentials to determine the target environment:
+// `.account` and `.region` will reflect the account+region the CLI
+// is configured to use (based on the user CLI credentials)
+new Stack(app, 'Stack2', {
+  env: {
+    account: process.env.CDK_DEFAULT_ACCOUNT,
+    region: process.env.CDK_DEFAULT_REGION
+  },
+});
 
----
+// Define multiple stacks stage associated with an environment
+const myStage = new Stage(app, 'MyStage', {
+  env: {
+    account: '123456789012',
+    region: 'us-east-1'
+  }
+});
 
-### ApplicationLoadBalancerPropsV2 <a name="ApplicationLoadBalancerPropsV2" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2"></a>
+// both of these stacks will use the stage's account/region:
+// `.account` and `.region` will resolve to the concrete values as above
+new MyStack(myStage, 'Stack1');
+new YourStack(myStage, 'Stack2');
 
-#### Initializer <a name="Initializer" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.Initializer"></a>
+// Define an environment-agnostic stack:
+// `.account` and `.region` will resolve to `{ "Ref": "AWS::AccountId" }` and `{ "Ref": "AWS::Region" }` respectively.
+// which will only resolve to actual values by CloudFormation during deployment.
+new MyStack(app, 'Stack1');
+```
 
-```typescript
-import { ApplicationLoadBalancerPropsV2 } from '@btc-embedded/cdk-extensions'
 
-const applicationLoadBalancerPropsV2: ApplicationLoadBalancerPropsV2 = { ... }
+##### `notificationArns`<sup>Optional</sup> <a name="notificationArns" id="@btc-embedded/cdk-extensions.ApplicationStackProps.property.notificationArns"></a>
+
+```typescript
+public readonly notificationArns: string[];
 ```
 
-#### Properties <a name="Properties" id="Properties"></a>
+- *Type:* string[]
+- *Default:* no notification arns.
 
-| **Name** | **Type** | **Description** |
-| --- | --- | --- |
-| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.healtCheckPath">healtCheckPath</a></code> | <code>string</code> | The health check path for the target group. |
-| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.hostedZone">hostedZone</a></code> | <code>aws-cdk-lib.aws_route53.IHostedZone</code> | The Route 53 hosted zone where the ALB's DNS record will be created. |
-| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.trafficPort">trafficPort</a></code> | <code>number</code> | The port on which the target group will receive traffic. |
-| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.userPool">userPool</a></code> | <code><a href="#@btc-embedded/cdk-extensions.ICognitoUserPool">ICognitoUserPool</a></code> | The Cognito User Pool of this base platform. |
-| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.vpc">vpc</a></code> | <code>aws-cdk-lib.aws_ec2.IVpc</code> | The VPC in which the Application Load Balancer will be deployed. |
-| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.recordName">recordName</a></code> | <code>string</code> | The domain prefix or record name for configuring the ALB domain. |
+SNS Topic ARNs that will receive stack events.
 
 ---
 
-##### `healtCheckPath`<sup>Required</sup> <a name="healtCheckPath" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.healtCheckPath"></a>
+##### `permissionsBoundary`<sup>Optional</sup> <a name="permissionsBoundary" id="@btc-embedded/cdk-extensions.ApplicationStackProps.property.permissionsBoundary"></a>
 
 ```typescript
-public readonly healtCheckPath: string;
+public readonly permissionsBoundary: PermissionsBoundary;
 ```
 
-- *Type:* string
+- *Type:* aws-cdk-lib.PermissionsBoundary
+- *Default:* no permissions boundary is applied
 
-The health check path for the target group.
+Options for applying a permissions boundary to all IAM Roles and Users created within this Stage.
 
 ---
 
-##### `hostedZone`<sup>Required</sup> <a name="hostedZone" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.hostedZone"></a>
+##### `propertyInjectors`<sup>Optional</sup> <a name="propertyInjectors" id="@btc-embedded/cdk-extensions.ApplicationStackProps.property.propertyInjectors"></a>
 
 ```typescript
-public readonly hostedZone: IHostedZone;
+public readonly propertyInjectors: IPropertyInjector[];
 ```
 
-- *Type:* aws-cdk-lib.aws_route53.IHostedZone
+- *Type:* aws-cdk-lib.IPropertyInjector[]
+- *Default:* no PropertyInjectors
 
-The Route 53 hosted zone where the ALB's DNS record will be created.
+A list of IPropertyInjector attached to this Stack.
 
 ---
 
-##### `trafficPort`<sup>Required</sup> <a name="trafficPort" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.trafficPort"></a>
+##### `stackName`<sup>Optional</sup> <a name="stackName" id="@btc-embedded/cdk-extensions.ApplicationStackProps.property.stackName"></a>
 
 ```typescript
-public readonly trafficPort: number;
+public readonly stackName: string;
 ```
 
-- *Type:* number
+- *Type:* string
+- *Default:* Derived from construct path.
 
-The port on which the target group will receive traffic.
+Name to deploy the stack with.
 
 ---
 
-##### `userPool`<sup>Required</sup> <a name="userPool" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.userPool"></a>
+##### `suppressTemplateIndentation`<sup>Optional</sup> <a name="suppressTemplateIndentation" id="@btc-embedded/cdk-extensions.ApplicationStackProps.property.suppressTemplateIndentation"></a>
 
 ```typescript
-public readonly userPool: ICognitoUserPool;
+public readonly suppressTemplateIndentation: boolean;
 ```
 
-- *Type:* <a href="#@btc-embedded/cdk-extensions.ICognitoUserPool">ICognitoUserPool</a>
+- *Type:* boolean
+- *Default:* the value of `@aws-cdk/core:suppressTemplateIndentation`, or `false` if that is not set.
 
-The Cognito User Pool of this base platform.
+Enable this flag to suppress indentation in generated CloudFormation templates.
+
+If not specified, the value of the `@aws-cdk/core:suppressTemplateIndentation`
+context key will be used. If that is not specified, then the
+default value `false` will be used.
 
 ---
 
-##### `vpc`<sup>Required</sup> <a name="vpc" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.vpc"></a>
+##### `synthesizer`<sup>Optional</sup> <a name="synthesizer" id="@btc-embedded/cdk-extensions.ApplicationStackProps.property.synthesizer"></a>
 
 ```typescript
-public readonly vpc: IVpc;
+public readonly synthesizer: IStackSynthesizer;
 ```
 
-- *Type:* aws-cdk-lib.aws_ec2.IVpc
+- *Type:* aws-cdk-lib.IStackSynthesizer
+- *Default:* The synthesizer specified on `App`, or `DefaultStackSynthesizer` otherwise.
 
-The VPC in which the Application Load Balancer will be deployed.
+Synthesis method to use while deploying this stack.
+
+The Stack Synthesizer controls aspects of synthesis and deployment,
+like how assets are referenced and what IAM roles to use. For more
+information, see the README of the main CDK package.
+
+If not specified, the `defaultStackSynthesizer` from `App` will be used.
+If that is not specified, `DefaultStackSynthesizer` is used if
+`@aws-cdk/core:newStyleStackSynthesis` is set to `true` or the CDK major
+version is v2. In CDK v1 `LegacyStackSynthesizer` is the default if no
+other synthesizer is specified.
 
 ---
 
-##### `recordName`<sup>Optional</sup> <a name="recordName" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerPropsV2.property.recordName"></a>
+##### `tags`<sup>Optional</sup> <a name="tags" id="@btc-embedded/cdk-extensions.ApplicationStackProps.property.tags"></a>
 
 ```typescript
-public readonly recordName: string;
+public readonly tags: {[ key: string ]: string};
 ```
 
-- *Type:* string
-- *Default:* zone root
+- *Type:* {[ key: string ]: string}
+- *Default:* {}
 
-The domain prefix or record name for configuring the ALB domain.
+Tags that will be applied to the Stack.
 
-This name is used to register an A record in the given hosted zone. If not
-provided, the zone's root will be used.
+These tags are applied to the CloudFormation Stack itself. They will not
+appear in the CloudFormation template.
 
----
+However, at deployment time, CloudFormation will apply these tags to all
+resources in the stack that support tagging. You will not be able to exempt
+resources from tagging (using the `excludeResourceTypes` property of
+`Tags.of(...).add()`) for tags applied in this way.
 
-### ApplicationLoadBalancerV2LookupOptions <a name="ApplicationLoadBalancerV2LookupOptions" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerV2LookupOptions"></a>
+---
 
-#### Initializer <a name="Initializer" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerV2LookupOptions.Initializer"></a>
+##### `terminationProtection`<sup>Optional</sup> <a name="terminationProtection" id="@btc-embedded/cdk-extensions.ApplicationStackProps.property.terminationProtection"></a>
 
 ```typescript
-import { ApplicationLoadBalancerV2LookupOptions } from '@btc-embedded/cdk-extensions'
-
-const applicationLoadBalancerV2LookupOptions: ApplicationLoadBalancerV2LookupOptions = { ... }
+public readonly terminationProtection: boolean;
 ```
 
-#### Properties <a name="Properties" id="Properties"></a>
+- *Type:* boolean
+- *Default:* false
 
-| **Name** | **Type** | **Description** |
-| --- | --- | --- |
-| <code><a href="#@btc-embedded/cdk-extensions.ApplicationLoadBalancerV2LookupOptions.property.basePlatform">basePlatform</a></code> | <code>string</code> | *No description.* |
+Whether to enable termination protection for this stack.
 
 ---
 
-##### `basePlatform`<sup>Required</sup> <a name="basePlatform" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerV2LookupOptions.property.basePlatform"></a>
+##### `basePlatformStackName`<sup>Required</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.ApplicationStackProps.property.basePlatformStackName"></a>
 
 ```typescript
-public readonly basePlatform: string;
+public readonly basePlatformStackName: string;
 ```
 
 - *Type:* string
@@ -7226,14 +8437,14 @@ const bTCLogGroupLookupOptions: BTCLogGroupLookupOptions = { ... }
 
 | **Name** | **Type** | **Description** |
 | --- | --- | --- |
-| <code><a href="#@btc-embedded/cdk-extensions.BTCLogGroupLookupOptions.property.basePlatform">basePlatform</a></code> | <code>string</code> | *No description.* |
+| <code><a href="#@btc-embedded/cdk-extensions.BTCLogGroupLookupOptions.property.basePlatformStackName">basePlatformStackName</a></code> | <code>string</code> | *No description.* |
 
 ---
 
-##### `basePlatform`<sup>Required</sup> <a name="basePlatform" id="@btc-embedded/cdk-extensions.BTCLogGroupLookupOptions.property.basePlatform"></a>
+##### `basePlatformStackName`<sup>Optional</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.BTCLogGroupLookupOptions.property.basePlatformStackName"></a>
 
 ```typescript
-public readonly basePlatform: string;
+public readonly basePlatformStackName: string;
 ```
 
 - *Type:* string
@@ -7389,15 +8600,15 @@ const cloudMapExtensionProps: CloudMapExtensionProps = { ... }
 
 | **Name** | **Type** | **Description** |
 | --- | --- | --- |
-| <code><a href="#@btc-embedded/cdk-extensions.CloudMapExtensionProps.property.platformStackName">platformStackName</a></code> | <code>string</code> | The name of the platform stack to import the namespace parameter details from. |
+| <code><a href="#@btc-embedded/cdk-extensions.CloudMapExtensionProps.property.basePlatformStackName">basePlatformStackName</a></code> | <code>string</code> | The name of the platform stack to import the namespace parameter details from. |
 | <code><a href="#@btc-embedded/cdk-extensions.CloudMapExtensionProps.property.exportService">exportService</a></code> | <code>boolean</code> | Whether to export this service for cross-stack consumption. |
 
 ---
 
-##### `platformStackName`<sup>Required</sup> <a name="platformStackName" id="@btc-embedded/cdk-extensions.CloudMapExtensionProps.property.platformStackName"></a>
+##### `basePlatformStackName`<sup>Optional</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.CloudMapExtensionProps.property.basePlatformStackName"></a>
 
 ```typescript
-public readonly platformStackName: string;
+public readonly basePlatformStackName: string;
 ```
 
 - *Type:* string
@@ -9189,25 +10400,25 @@ const documentDbAccessExtensionProps: DocumentDbAccessExtensionProps = { ... }
 
 | **Name** | **Type** | **Description** |
 | --- | --- | --- |
-| <code><a href="#@btc-embedded/cdk-extensions.DocumentDbAccessExtensionProps.property.basePlatformStackName">basePlatformStackName</a></code> | <code>string</code> | *No description.* |
 | <code><a href="#@btc-embedded/cdk-extensions.DocumentDbAccessExtensionProps.property.securityGroupId">securityGroupId</a></code> | <code>string</code> | *No description.* |
+| <code><a href="#@btc-embedded/cdk-extensions.DocumentDbAccessExtensionProps.property.basePlatformStackName">basePlatformStackName</a></code> | <code>string</code> | *No description.* |
 
 ---
 
-##### `basePlatformStackName`<sup>Required</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.DocumentDbAccessExtensionProps.property.basePlatformStackName"></a>
+##### `securityGroupId`<sup>Required</sup> <a name="securityGroupId" id="@btc-embedded/cdk-extensions.DocumentDbAccessExtensionProps.property.securityGroupId"></a>
 
 ```typescript
-public readonly basePlatformStackName: string;
+public readonly securityGroupId: string;
 ```
 
 - *Type:* string
 
 ---
 
-##### `securityGroupId`<sup>Required</sup> <a name="securityGroupId" id="@btc-embedded/cdk-extensions.DocumentDbAccessExtensionProps.property.securityGroupId"></a>
+##### `basePlatformStackName`<sup>Optional</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.DocumentDbAccessExtensionProps.property.basePlatformStackName"></a>
 
 ```typescript
-public readonly securityGroupId: string;
+public readonly basePlatformStackName: string;
 ```
 
 - *Type:* string
@@ -9291,38 +10502,38 @@ const ecsClusterAttributes: EcsClusterAttributes = { ... }
 
 | **Name** | **Type** | **Description** |
 | --- | --- | --- |
-| <code><a href="#@btc-embedded/cdk-extensions.EcsClusterAttributes.property.stackName">stackName</a></code> | <code>string</code> | The name of the stack where the ECS cluster is defined. |
 | <code><a href="#@btc-embedded/cdk-extensions.EcsClusterAttributes.property.vpcId">vpcId</a></code> | <code>string</code> | The ID of the VPC where the ECS cluster is located. |
+| <code><a href="#@btc-embedded/cdk-extensions.EcsClusterAttributes.property.basePlatformStackName">basePlatformStackName</a></code> | <code>string</code> | The name of the stack where the ECS cluster is defined. |
 
 ---
 
-##### `stackName`<sup>Required</sup> <a name="stackName" id="@btc-embedded/cdk-extensions.EcsClusterAttributes.property.stackName"></a>
+##### `vpcId`<sup>Required</sup> <a name="vpcId" id="@btc-embedded/cdk-extensions.EcsClusterAttributes.property.vpcId"></a>
 
 ```typescript
-public readonly stackName: string;
+public readonly vpcId: string;
 ```
 
 - *Type:* string
 
-The name of the stack where the ECS cluster is defined.
+The ID of the VPC where the ECS cluster is located.
 
-This is usually the
-base platform stack.
+This id used to look
+up the VPC when importing the cluster.
 
 ---
 
-##### `vpcId`<sup>Required</sup> <a name="vpcId" id="@btc-embedded/cdk-extensions.EcsClusterAttributes.property.vpcId"></a>
+##### `basePlatformStackName`<sup>Optional</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.EcsClusterAttributes.property.basePlatformStackName"></a>
 
 ```typescript
-public readonly vpcId: string;
+public readonly basePlatformStackName: string;
 ```
 
 - *Type:* string
 
-The ID of the VPC where the ECS cluster is located.
+The name of the stack where the ECS cluster is defined.
 
-This id used to look
-up the VPC when importing the cluster.
+This is usually the
+base platform stack.
 
 ---
 
@@ -9424,32 +10635,32 @@ const efsFileSystemLookupOptions: EfsFileSystemLookupOptions = { ... }
 
 | **Name** | **Type** | **Description** |
 | --- | --- | --- |
-| <code><a href="#@btc-embedded/cdk-extensions.EfsFileSystemLookupOptions.property.basePlatformName">basePlatformName</a></code> | <code>string</code> | The name of the base platform. |
 | <code><a href="#@btc-embedded/cdk-extensions.EfsFileSystemLookupOptions.property.filesystemName">filesystemName</a></code> | <code>string</code> | The name of the filesystem to be imported. |
+| <code><a href="#@btc-embedded/cdk-extensions.EfsFileSystemLookupOptions.property.basePlatformStackName">basePlatformStackName</a></code> | <code>string</code> | The name of the base platform stack. |
 
 ---
 
-##### `basePlatformName`<sup>Required</sup> <a name="basePlatformName" id="@btc-embedded/cdk-extensions.EfsFileSystemLookupOptions.property.basePlatformName"></a>
+##### `filesystemName`<sup>Required</sup> <a name="filesystemName" id="@btc-embedded/cdk-extensions.EfsFileSystemLookupOptions.property.filesystemName"></a>
 
 ```typescript
-public readonly basePlatformName: string;
+public readonly filesystemName: string;
 ```
 
 - *Type:* string
 
-The name of the base platform.
+The name of the filesystem to be imported.
 
 ---
 
-##### `filesystemName`<sup>Required</sup> <a name="filesystemName" id="@btc-embedded/cdk-extensions.EfsFileSystemLookupOptions.property.filesystemName"></a>
+##### `basePlatformStackName`<sup>Optional</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.EfsFileSystemLookupOptions.property.basePlatformStackName"></a>
 
 ```typescript
-public readonly filesystemName: string;
+public readonly basePlatformStackName: string;
 ```
 
 - *Type:* string
 
-The name of the filesystem to be imported.
+The name of the base platform stack.
 
 ---
 
@@ -10035,14 +11246,14 @@ const hostedZoneAttributes: HostedZoneAttributes = { ... }
 
 | **Name** | **Type** | **Description** |
 | --- | --- | --- |
-| <code><a href="#@btc-embedded/cdk-extensions.HostedZoneAttributes.property.stackName">stackName</a></code> | <code>string</code> | The name of the stack where the hosted zone is defined. |
+| <code><a href="#@btc-embedded/cdk-extensions.HostedZoneAttributes.property.basePlatformStackName">basePlatformStackName</a></code> | <code>string</code> | The name of the stack where the hosted zone is defined. |
 
 ---
 
-##### `stackName`<sup>Required</sup> <a name="stackName" id="@btc-embedded/cdk-extensions.HostedZoneAttributes.property.stackName"></a>
+##### `basePlatformStackName`<sup>Optional</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.HostedZoneAttributes.property.basePlatformStackName"></a>
 
 ```typescript
-public readonly stackName: string;
+public readonly basePlatformStackName: string;
 ```
 
 - *Type:* string
@@ -10177,7 +11388,7 @@ const hTTPApiExtensionProps: HTTPApiExtensionProps = { ... }
 
 | **Name** | **Type** | **Description** |
 | --- | --- | --- |
-| <code><a href="#@btc-embedded/cdk-extensions.HTTPApiExtensionProps.property.platformStackName">platformStackName</a></code> | <code>string</code> | The name of the base platform stack. |
+| <code><a href="#@btc-embedded/cdk-extensions.HTTPApiExtensionProps.property.basePlatformStackName">basePlatformStackName</a></code> | <code>string</code> | The name of the base platform stack. |
 | <code><a href="#@btc-embedded/cdk-extensions.HTTPApiExtensionProps.property.domainPrefix">domainPrefix</a></code> | <code>string</code> | Domain prefix for the API Gateway endpoint. |
 | <code><a href="#@btc-embedded/cdk-extensions.HTTPApiExtensionProps.property.enableAccessLogs">enableAccessLogs</a></code> | <code>boolean</code> | Enable access logs for the API Gateway. |
 | <code><a href="#@btc-embedded/cdk-extensions.HTTPApiExtensionProps.property.endpointPrefix">endpointPrefix</a></code> | <code>string</code> | The prefix for the API Gateway endpoint. |
@@ -10186,10 +11397,10 @@ const hTTPApiExtensionProps: HTTPApiExtensionProps = { ... }
 
 ---
 
-##### `platformStackName`<sup>Required</sup> <a name="platformStackName" id="@btc-embedded/cdk-extensions.HTTPApiExtensionProps.property.platformStackName"></a>
+##### `basePlatformStackName`<sup>Optional</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.HTTPApiExtensionProps.property.basePlatformStackName"></a>
 
 ```typescript
-public readonly platformStackName: string;
+public readonly basePlatformStackName: string;
 ```
 
 - *Type:* string
@@ -10277,14 +11488,14 @@ const importLogGroupOption: ImportLogGroupOption = { ... }
 
 | **Name** | **Type** | **Description** |
 | --- | --- | --- |
-| <code><a href="#@btc-embedded/cdk-extensions.ImportLogGroupOption.property.basePlatformName">basePlatformName</a></code> | <code>string</code> | *No description.* |
+| <code><a href="#@btc-embedded/cdk-extensions.ImportLogGroupOption.property.basePlatformStackName">basePlatformStackName</a></code> | <code>string</code> | *No description.* |
 
 ---
 
-##### `basePlatformName`<sup>Required</sup> <a name="basePlatformName" id="@btc-embedded/cdk-extensions.ImportLogGroupOption.property.basePlatformName"></a>
+##### `basePlatformStackName`<sup>Optional</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.ImportLogGroupOption.property.basePlatformStackName"></a>
 
 ```typescript
-public readonly basePlatformName: string;
+public readonly basePlatformStackName: string;
 ```
 
 - *Type:* string
@@ -10321,15 +11532,15 @@ const openIdExtensionProps: OpenIdExtensionProps = { ... }
 
 | **Name** | **Type** | **Description** |
 | --- | --- | --- |
-| <code><a href="#@btc-embedded/cdk-extensions.OpenIdExtensionProps.property.platformStackName">platformStackName</a></code> | <code>string</code> | The name of the base platform stack. |
+| <code><a href="#@btc-embedded/cdk-extensions.OpenIdExtensionProps.property.basePlatformStackName">basePlatformStackName</a></code> | <code>string</code> | The name of the base platform stack. |
 | <code><a href="#@btc-embedded/cdk-extensions.OpenIdExtensionProps.property.redirectUri">redirectUri</a></code> | <code>string</code> | Adds OIDC_REDIRECT_URI environment variable to the container if set. |
 
 ---
 
-##### `platformStackName`<sup>Required</sup> <a name="platformStackName" id="@btc-embedded/cdk-extensions.OpenIdExtensionProps.property.platformStackName"></a>
+##### `basePlatformStackName`<sup>Optional</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.OpenIdExtensionProps.property.basePlatformStackName"></a>
 
 ```typescript
-public readonly platformStackName: string;
+public readonly basePlatformStackName: string;
 ```
 
 - *Type:* string
@@ -10435,8 +11646,8 @@ const postgresDbAccessExtensionProps: PostgresDbAccessExtensionProps = { ... }
 
 | **Name** | **Type** | **Description** |
 | --- | --- | --- |
-| <code><a href="#@btc-embedded/cdk-extensions.PostgresDbAccessExtensionProps.property.basePlatformStackName">basePlatformStackName</a></code> | <code>string</code> | The name of the base platform stack. |
 | <code><a href="#@btc-embedded/cdk-extensions.PostgresDbAccessExtensionProps.property.dbName">dbName</a></code> | <code>string</code> | The name of the database. |
+| <code><a href="#@btc-embedded/cdk-extensions.PostgresDbAccessExtensionProps.property.basePlatformStackName">basePlatformStackName</a></code> | <code>string</code> | The name of the base platform stack. |
 | <code><a href="#@btc-embedded/cdk-extensions.PostgresDbAccessExtensionProps.property.dbConnectionProperties">dbConnectionProperties</a></code> | <code>{[ key: string ]: string}</code> | Additional connection properties to be added to the database connection string as query parameters. |
 | <code><a href="#@btc-embedded/cdk-extensions.PostgresDbAccessExtensionProps.property.enableMigration">enableMigration</a></code> | <code>boolean</code> | Enable database migration by calling the default image with the migration parameter. |
 | <code><a href="#@btc-embedded/cdk-extensions.PostgresDbAccessExtensionProps.property.environmentVariableNames">environmentVariableNames</a></code> | <code><a href="#@btc-embedded/cdk-extensions.EnvironmentVariableNames">EnvironmentVariableNames</a></code> | Adjust the environment variables. |
@@ -10445,30 +11656,30 @@ const postgresDbAccessExtensionProps: PostgresDbAccessExtensionProps = { ... }
 
 ---
 
-##### `basePlatformStackName`<sup>Required</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.PostgresDbAccessExtensionProps.property.basePlatformStackName"></a>
+##### `dbName`<sup>Required</sup> <a name="dbName" id="@btc-embedded/cdk-extensions.PostgresDbAccessExtensionProps.property.dbName"></a>
 
 ```typescript
-public readonly basePlatformStackName: string;
+public readonly dbName: string;
 ```
 
 - *Type:* string
 
-The name of the base platform stack.
-
-This name is used to look up output
-parameters.
+The name of the database.
 
 ---
 
-##### `dbName`<sup>Required</sup> <a name="dbName" id="@btc-embedded/cdk-extensions.PostgresDbAccessExtensionProps.property.dbName"></a>
+##### `basePlatformStackName`<sup>Optional</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.PostgresDbAccessExtensionProps.property.basePlatformStackName"></a>
 
 ```typescript
-public readonly dbName: string;
+public readonly basePlatformStackName: string;
 ```
 
 - *Type:* string
 
-The name of the database.
+The name of the base platform stack.
+
+This name is used to look up output
+parameters.
 
 ---
 
@@ -10734,8 +11945,8 @@ const secureRestApiProps: SecureRestApiProps = { ... }
 | **Name** | **Type** | **Description** |
 | --- | --- | --- |
 | <code><a href="#@btc-embedded/cdk-extensions.SecureRestApiProps.property.apiSubDomain">apiSubDomain</a></code> | <code>string</code> | Subdomain that is used for REST API props. |
-| <code><a href="#@btc-embedded/cdk-extensions.SecureRestApiProps.property.basePlatformStackName">basePlatformStackName</a></code> | <code>string</code> | The name of the Base platform Stack. |
 | <code><a href="#@btc-embedded/cdk-extensions.SecureRestApiProps.property.restApiProps">restApiProps</a></code> | <code>aws-cdk-lib.aws_apigateway.RestApiProps</code> | Props forwarded to the RestApi construct. |
+| <code><a href="#@btc-embedded/cdk-extensions.SecureRestApiProps.property.basePlatformStackName">basePlatformStackName</a></code> | <code>string</code> | The name of the Base platform Stack. |
 | <code><a href="#@btc-embedded/cdk-extensions.SecureRestApiProps.property.hostedZone">hostedZone</a></code> | <code>aws-cdk-lib.aws_route53.IHostedZone</code> | hosted zone for the subdomain An optional parameter. |
 
 ---
@@ -10752,27 +11963,27 @@ Subdomain that is used for REST API props.
 
 ---
 
-##### `basePlatformStackName`<sup>Required</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.SecureRestApiProps.property.basePlatformStackName"></a>
+##### `restApiProps`<sup>Required</sup> <a name="restApiProps" id="@btc-embedded/cdk-extensions.SecureRestApiProps.property.restApiProps"></a>
 
 ```typescript
-public readonly basePlatformStackName: string;
+public readonly restApiProps: RestApiProps;
 ```
 
-- *Type:* string
+- *Type:* aws-cdk-lib.aws_apigateway.RestApiProps
 
-The name of the Base platform Stack.
+Props forwarded to the RestApi construct.
 
 ---
 
-##### `restApiProps`<sup>Required</sup> <a name="restApiProps" id="@btc-embedded/cdk-extensions.SecureRestApiProps.property.restApiProps"></a>
+##### `basePlatformStackName`<sup>Optional</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.SecureRestApiProps.property.basePlatformStackName"></a>
 
 ```typescript
-public readonly restApiProps: RestApiProps;
+public readonly basePlatformStackName: string;
 ```
 
-- *Type:* aws-cdk-lib.aws_apigateway.RestApiProps
+- *Type:* string
 
-Props forwarded to the RestApi construct.
+The name of the Base platform Stack.
 
 ---
 
@@ -10804,8 +12015,8 @@ const secureRestApiPropsV2: SecureRestApiPropsV2 = { ... }
 | **Name** | **Type** | **Description** |
 | --- | --- | --- |
 | <code><a href="#@btc-embedded/cdk-extensions.SecureRestApiPropsV2.property.apiSubDomain">apiSubDomain</a></code> | <code>string</code> | Subdomain that is used for REST API props. |
-| <code><a href="#@btc-embedded/cdk-extensions.SecureRestApiPropsV2.property.basePlatformStackName">basePlatformStackName</a></code> | <code>string</code> | The name of the Base platform Stack. |
 | <code><a href="#@btc-embedded/cdk-extensions.SecureRestApiPropsV2.property.restApiProps">restApiProps</a></code> | <code>aws-cdk-lib.aws_apigateway.RestApiProps</code> | Props forwarded to the RestApi construct. |
+| <code><a href="#@btc-embedded/cdk-extensions.SecureRestApiPropsV2.property.basePlatformStackName">basePlatformStackName</a></code> | <code>string</code> | The name of the Base platform Stack. |
 | <code><a href="#@btc-embedded/cdk-extensions.SecureRestApiPropsV2.property.hostedZone">hostedZone</a></code> | <code>aws-cdk-lib.aws_route53.IHostedZone</code> | hosted zone for the subdomain. |
 
 ---
@@ -10822,27 +12033,27 @@ Subdomain that is used for REST API props.
 
 ---
 
-##### `basePlatformStackName`<sup>Required</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.SecureRestApiPropsV2.property.basePlatformStackName"></a>
+##### `restApiProps`<sup>Required</sup> <a name="restApiProps" id="@btc-embedded/cdk-extensions.SecureRestApiPropsV2.property.restApiProps"></a>
 
 ```typescript
-public readonly basePlatformStackName: string;
+public readonly restApiProps: RestApiProps;
 ```
 
-- *Type:* string
+- *Type:* aws-cdk-lib.aws_apigateway.RestApiProps
 
-The name of the Base platform Stack.
+Props forwarded to the RestApi construct.
 
 ---
 
-##### `restApiProps`<sup>Required</sup> <a name="restApiProps" id="@btc-embedded/cdk-extensions.SecureRestApiPropsV2.property.restApiProps"></a>
+##### `basePlatformStackName`<sup>Optional</sup> <a name="basePlatformStackName" id="@btc-embedded/cdk-extensions.SecureRestApiPropsV2.property.basePlatformStackName"></a>
 
 ```typescript
-public readonly restApiProps: RestApiProps;
+public readonly basePlatformStackName: string;
 ```
 
-- *Type:* aws-cdk-lib.aws_apigateway.RestApiProps
+- *Type:* string
 
-Props forwarded to the RestApi construct.
+The name of the Base platform Stack.
 
 ---
 
@@ -12153,6 +13364,52 @@ connected to the service.
 ---
 
 
+### BasePlatformStackResolver <a name="BasePlatformStackResolver" id="@btc-embedded/cdk-extensions.BasePlatformStackResolver"></a>
+
+#### Initializers <a name="Initializers" id="@btc-embedded/cdk-extensions.BasePlatformStackResolver.Initializer"></a>
+
+```typescript
+import { BasePlatformStackResolver } from '@btc-embedded/cdk-extensions'
+
+new BasePlatformStackResolver()
+```
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+
+---
+
+
+#### Static Functions <a name="Static Functions" id="Static Functions"></a>
+
+| **Name** | **Description** |
+| --- | --- |
+| <code><a href="#@btc-embedded/cdk-extensions.BasePlatformStackResolver.resolve">resolve</a></code> | *No description.* |
+
+---
+
+##### `resolve` <a name="resolve" id="@btc-embedded/cdk-extensions.BasePlatformStackResolver.resolve"></a>
+
+```typescript
+import { BasePlatformStackResolver } from '@btc-embedded/cdk-extensions'
+
+BasePlatformStackResolver.resolve(scope: Construct, propsValue?: string)
+```
+
+###### `scope`<sup>Required</sup> <a name="scope" id="@btc-embedded/cdk-extensions.BasePlatformStackResolver.resolve.parameter.scope"></a>
+
+- *Type:* constructs.Construct
+
+---
+
+###### `propsValue`<sup>Optional</sup> <a name="propsValue" id="@btc-embedded/cdk-extensions.BasePlatformStackResolver.resolve.parameter.propsValue"></a>
+
+- *Type:* string
+
+---
+
+
+
 ### CloudMapExtension <a name="CloudMapExtension" id="@btc-embedded/cdk-extensions.CloudMapExtension"></a>
 
 #### Initializers <a name="Initializers" id="@btc-embedded/cdk-extensions.CloudMapExtension.Initializer"></a>
@@ -16071,17 +17328,30 @@ v{version} is only emitted when the version is greater than 1.
 ##### `import` <a name="import" id="@btc-embedded/cdk-extensions.StackParameter.import"></a>
 
 ```typescript
-public import(stackName: string): string
+public import(scope: Construct, stackName?: string): string
 ```
 
 Import the parameter as {stackName}:{prefix}-v{version}:{key}.
 
-v{version} is only emitted when the version is greater than 1.
+The stack name can be provided explicitly, or resolved from the construct tree
+context (set by ApplicationStack).
 
-###### `stackName`<sup>Required</sup> <a name="stackName" id="@btc-embedded/cdk-extensions.StackParameter.import.parameter.stackName"></a>
+###### `scope`<sup>Required</sup> <a name="scope" id="@btc-embedded/cdk-extensions.StackParameter.import.parameter.scope"></a>
+
+- *Type:* constructs.Construct
+
+The construct scope for context resolution.
+
+---
+
+###### `stackName`<sup>Optional</sup> <a name="stackName" id="@btc-embedded/cdk-extensions.StackParameter.import.parameter.stackName"></a>
 
 - *Type:* string
 
+Optional explicit stack name.
+
+If not provided, will resolve from context.
+
 ---