@btc-embedded/cdk-extensions 0.14.8 → 0.14.10

package/API.md

@@ -83,6 +83,20 @@ ApiGateway.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.ApiGateway.isConstruct.parameter.x"></a>
 
 - *Type:* any
@@ -212,7 +226,7 @@ public addSgRule(source: IConnectable, port: number, description?: string): void
 
 ---
 
-##### ~~`isConstruct`~~ <a name="isConstruct" id="@btc-embedded/cdk-extensions.ApiGatewayV2.isConstruct"></a>
+##### `isConstruct` <a name="isConstruct" id="@btc-embedded/cdk-extensions.ApiGatewayV2.isConstruct"></a>
 
 ```typescript
 import { ApiGatewayV2 } from '@btc-embedded/cdk-extensions'
@@ -222,6 +236,20 @@ ApiGatewayV2.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.ApiGatewayV2.isConstruct.parameter.x"></a>
 
 - *Type:* any
@@ -387,7 +415,7 @@ public addSgRule(source: IConnectable, port: number, description?: string): void
 
 ---
 
-##### ~~`isConstruct`~~ <a name="isConstruct" id="@btc-embedded/cdk-extensions.ApiGatewayV2Base.isConstruct"></a>
+##### `isConstruct` <a name="isConstruct" id="@btc-embedded/cdk-extensions.ApiGatewayV2Base.isConstruct"></a>
 
 ```typescript
 import { ApiGatewayV2Base } from '@btc-embedded/cdk-extensions'
@@ -397,6 +425,20 @@ ApiGatewayV2Base.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.ApiGatewayV2Base.isConstruct.parameter.x"></a>
 
 - *Type:* any
@@ -518,6 +560,20 @@ ApplicationLoadBalancer.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.ApplicationLoadBalancer.isConstruct.parameter.x"></a>
 
 - *Type:* any
@@ -657,7 +713,7 @@ public addTarget(target: IApplicationLoadBalancerTarget): void
 
 ---
 
-##### ~~`isConstruct`~~ <a name="isConstruct" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerV2.isConstruct"></a>
+##### `isConstruct` <a name="isConstruct" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerV2.isConstruct"></a>
 
 ```typescript
 import { ApplicationLoadBalancerV2 } from '@btc-embedded/cdk-extensions'
@@ -667,6 +723,20 @@ ApplicationLoadBalancerV2.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.ApplicationLoadBalancerV2.isConstruct.parameter.x"></a>
 
 - *Type:* any
@@ -809,7 +879,7 @@ public addTarget(target: IApplicationLoadBalancerTarget): void
 
 ---
 
-##### ~~`isConstruct`~~ <a name="isConstruct" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerV2Base.isConstruct"></a>
+##### `isConstruct` <a name="isConstruct" id="@btc-embedded/cdk-extensions.ApplicationLoadBalancerV2Base.isConstruct"></a>
 
 ```typescript
 import { ApplicationLoadBalancerV2Base } from '@btc-embedded/cdk-extensions'
@@ -819,6 +889,20 @@ ApplicationLoadBalancerV2Base.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.ApplicationLoadBalancerV2Base.isConstruct.parameter.x"></a>
 
 - *Type:* any
@@ -1210,7 +1294,7 @@ Configuration options for the metric.
 
 ---
 
-##### ~~`isConstruct`~~ <a name="isConstruct" id="@btc-embedded/cdk-extensions.BTCLogGroup.isConstruct"></a>
+##### `isConstruct` <a name="isConstruct" id="@btc-embedded/cdk-extensions.BTCLogGroup.isConstruct"></a>
 
 ```typescript
 import { BTCLogGroup } from '@btc-embedded/cdk-extensions'
@@ -1220,6 +1304,20 @@ BTCLogGroup.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.BTCLogGroup.isConstruct.parameter.x"></a>
 
 - *Type:* any
@@ -1497,7 +1595,7 @@ public createHttpUserPoolAuthorizer(): HttpUserPoolAuthorizer
 
 ---
 
-##### ~~`isConstruct`~~ <a name="isConstruct" id="@btc-embedded/cdk-extensions.CognitoUserPool.isConstruct"></a>
+##### `isConstruct` <a name="isConstruct" id="@btc-embedded/cdk-extensions.CognitoUserPool.isConstruct"></a>
 
 ```typescript
 import { CognitoUserPool } from '@btc-embedded/cdk-extensions'
@@ -1507,6 +1605,20 @@ CognitoUserPool.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.CognitoUserPool.isConstruct.parameter.x"></a>
 
 - *Type:* any
@@ -1672,7 +1784,7 @@ public createHttpUserPoolAuthorizer(): HttpUserPoolAuthorizer
 
 ---
 
-##### ~~`isConstruct`~~ <a name="isConstruct" id="@btc-embedded/cdk-extensions.CognitoUserPoolBase.isConstruct"></a>
+##### `isConstruct` <a name="isConstruct" id="@btc-embedded/cdk-extensions.CognitoUserPoolBase.isConstruct"></a>
 
 ```typescript
 import { CognitoUserPoolBase } from '@btc-embedded/cdk-extensions'
@@ -1682,6 +1794,20 @@ CognitoUserPoolBase.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.CognitoUserPoolBase.isConstruct.parameter.x"></a>
 
 - *Type:* any
@@ -1816,6 +1942,20 @@ DefaultUserPoolClients.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.DefaultUserPoolClients.isConstruct.parameter.x"></a>
 
 - *Type:* any
@@ -1934,7 +2074,7 @@ Returns a string representation of this construct.
 
 ---
 
-##### ~~`isConstruct`~~ <a name="isConstruct" id="@btc-embedded/cdk-extensions.DocumentDB.isConstruct"></a>
+##### `isConstruct` <a name="isConstruct" id="@btc-embedded/cdk-extensions.DocumentDB.isConstruct"></a>
 
 ```typescript
 import { DocumentDB } from '@btc-embedded/cdk-extensions'
@@ -1944,6 +2084,20 @@ DocumentDB.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.DocumentDB.isConstruct.parameter.x"></a>
 
 - *Type:* any
@@ -2075,7 +2229,7 @@ public allowAccess(service: IConnectable): void
 
 ---
 
-##### ~~`isConstruct`~~ <a name="isConstruct" id="@btc-embedded/cdk-extensions.DocumentDBBase.isConstruct"></a>
+##### `isConstruct` <a name="isConstruct" id="@btc-embedded/cdk-extensions.DocumentDBBase.isConstruct"></a>
 
 ```typescript
 import { DocumentDBBase } from '@btc-embedded/cdk-extensions'
@@ -2085,6 +2239,20 @@ DocumentDBBase.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.DocumentDBBase.isConstruct.parameter.x"></a>
 
 - *Type:* any
@@ -2198,7 +2366,7 @@ Returns a string representation of this construct.
 
 ---
 
-##### ~~`isConstruct`~~ <a name="isConstruct" id="@btc-embedded/cdk-extensions.EventPipe.isConstruct"></a>
+##### `isConstruct` <a name="isConstruct" id="@btc-embedded/cdk-extensions.EventPipe.isConstruct"></a>
 
 ```typescript
 import { EventPipe } from '@btc-embedded/cdk-extensions'
@@ -2208,6 +2376,20 @@ EventPipe.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.EventPipe.isConstruct.parameter.x"></a>
 
 - *Type:* any
@@ -2311,7 +2493,7 @@ Returns a string representation of this construct.
 
 ---
 
-##### ~~`isConstruct`~~ <a name="isConstruct" id="@btc-embedded/cdk-extensions.PrivateDnsNamespace.isConstruct"></a>
+##### `isConstruct` <a name="isConstruct" id="@btc-embedded/cdk-extensions.PrivateDnsNamespace.isConstruct"></a>
 
 ```typescript
 import { PrivateDnsNamespace } from '@btc-embedded/cdk-extensions'
@@ -2321,6 +2503,20 @@ PrivateDnsNamespace.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.PrivateDnsNamespace.isConstruct.parameter.x"></a>
 
 - *Type:* any
@@ -2462,7 +2658,7 @@ public createOAuthScopes(): OAuthScope[]
 
 ---
 
-##### ~~`isConstruct`~~ <a name="isConstruct" id="@btc-embedded/cdk-extensions.ResourceServer.isConstruct"></a>
+##### `isConstruct` <a name="isConstruct" id="@btc-embedded/cdk-extensions.ResourceServer.isConstruct"></a>
 
 ```typescript
 import { ResourceServer } from '@btc-embedded/cdk-extensions'
@@ -2472,6 +2668,20 @@ ResourceServer.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.ResourceServer.isConstruct.parameter.x"></a>
 
 - *Type:* any
@@ -3280,7 +3490,7 @@ The metric configuration to add.
 
 ---
 
-##### ~~`isConstruct`~~ <a name="isConstruct" id="@btc-embedded/cdk-extensions.S3Bucket.isConstruct"></a>
+##### `isConstruct` <a name="isConstruct" id="@btc-embedded/cdk-extensions.S3Bucket.isConstruct"></a>
 
 ```typescript
 import { S3Bucket } from '@btc-embedded/cdk-extensions'
@@ -3290,6 +3500,20 @@ S3Bucket.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.S3Bucket.isConstruct.parameter.x"></a>
 
 - *Type:* any
@@ -3718,6 +3942,20 @@ SecureRestApi.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.SecureRestApi.isConstruct.parameter.x"></a>
 
 - *Type:* any
@@ -3873,7 +4111,7 @@ public addMethod(httpMethod: string, target?: Integration, options?: MethodOptio
 
 ---
 
-##### ~~`isConstruct`~~ <a name="isConstruct" id="@btc-embedded/cdk-extensions.SecureRestApiV2.isConstruct"></a>
+##### `isConstruct` <a name="isConstruct" id="@btc-embedded/cdk-extensions.SecureRestApiV2.isConstruct"></a>
 
 ```typescript
 import { SecureRestApiV2 } from '@btc-embedded/cdk-extensions'
@@ -3883,6 +4121,20 @@ SecureRestApiV2.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.SecureRestApiV2.isConstruct.parameter.x"></a>
 
 - *Type:* any
@@ -3984,7 +4236,7 @@ Returns a string representation of this construct.
 
 ---
 
-##### ~~`isConstruct`~~ <a name="isConstruct" id="@btc-embedded/cdk-extensions.Vpc.isConstruct"></a>
+##### `isConstruct` <a name="isConstruct" id="@btc-embedded/cdk-extensions.Vpc.isConstruct"></a>
 
 ```typescript
 import { Vpc } from '@btc-embedded/cdk-extensions'
@@ -3994,6 +4246,20 @@ Vpc.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.Vpc.isConstruct.parameter.x"></a>
 
 - *Type:* any
@@ -7632,6 +7898,8 @@ Default: SHARED.
 
 ### StackParameterOptions <a name="StackParameterOptions" id="@btc-embedded/cdk-extensions.StackParameterOptions"></a>
 
+Options for creating a StackParameter.
+
 #### Initializer <a name="Initializer" id="@btc-embedded/cdk-extensions.StackParameterOptions.Initializer"></a>
 
 ```typescript
@@ -7644,10 +7912,11 @@ const stackParameterOptions: StackParameterOptions = { ... }
 
 | **Name** | **Type** | **Description** |
 | --- | --- | --- |
-| <code><a href="#@btc-embedded/cdk-extensions.StackParameterOptions.property.key">key</a></code> | <code>string</code> | *No description.* |
-| <code><a href="#@btc-embedded/cdk-extensions.StackParameterOptions.property.name">name</a></code> | <code>string</code> | *No description.* |
-| <code><a href="#@btc-embedded/cdk-extensions.StackParameterOptions.property.prefix">prefix</a></code> | <code>string \| string[]</code> | *No description.* |
-| <code><a href="#@btc-embedded/cdk-extensions.StackParameterOptions.property.version">version</a></code> | <code>number</code> | *No description.* |
+| <code><a href="#@btc-embedded/cdk-extensions.StackParameterOptions.property.key">key</a></code> | <code>string</code> | The key for the stack parameter. |
+| <code><a href="#@btc-embedded/cdk-extensions.StackParameterOptions.property.prefix">prefix</a></code> | <code>string \| string[]</code> | The prefix(es) for the stack parameter. |
+| <code><a href="#@btc-embedded/cdk-extensions.StackParameterOptions.property.description">description</a></code> | <code>string</code> | Description for the exported parameter. |
+| <code><a href="#@btc-embedded/cdk-extensions.StackParameterOptions.property.name">name</a></code> | <code>string</code> | Name used for the export construct logical ID. |
+| <code><a href="#@btc-embedded/cdk-extensions.StackParameterOptions.property.version">version</a></code> | <code>number</code> | Version for the stack parameter. |
 
 ---
 
@@ -7659,25 +7928,46 @@ public readonly key: string;
 
 - *Type:* string
 
+The key for the stack parameter.
+
 ---
 
-##### `name`<sup>Required</sup> <a name="name" id="@btc-embedded/cdk-extensions.StackParameterOptions.property.name"></a>
+##### `prefix`<sup>Required</sup> <a name="prefix" id="@btc-embedded/cdk-extensions.StackParameterOptions.property.prefix"></a>
 
 ```typescript
-public readonly name: string;
+public readonly prefix: string | string[];
+```
+
+- *Type:* string | string[]
+
+The prefix(es) for the stack parameter.
+
+Prefixes must be kebab-case (lowercase letters, numbers, and hyphens). If
+multiple prefixes are provided, they will be joined with colons.
+
+---
+
+##### `description`<sup>Optional</sup> <a name="description" id="@btc-embedded/cdk-extensions.StackParameterOptions.property.description"></a>
+
+```typescript
+public readonly description: string;
 ```
 
 - *Type:* string
 
+Description for the exported parameter.
+
 ---
 
-##### `prefix`<sup>Required</sup> <a name="prefix" id="@btc-embedded/cdk-extensions.StackParameterOptions.property.prefix"></a>
+##### `name`<sup>Optional</sup> <a name="name" id="@btc-embedded/cdk-extensions.StackParameterOptions.property.name"></a>
 
 ```typescript
-public readonly prefix: string | string[];
+public readonly name: string;
 ```
 
-- *Type:* string | string[]
+- *Type:* string
+
+Name used for the export construct logical ID.
 
 ---
 
@@ -7689,6 +7979,11 @@ public readonly version: number;
 
 - *Type:* number
 
+Version for the stack parameter.
+
+If provided and greater than 1, the version will be appended to the
+parameter name during export and import as `-v{version}`.
+
 ---
 
 ### SuffixFilterRule <a name="SuffixFilterRule" id="@btc-embedded/cdk-extensions.SuffixFilterRule"></a>
@@ -11849,16 +12144,16 @@ Provides means to export and import stack parameters.
 ```typescript
 import { StackParameter } from '@btc-embedded/cdk-extensions'
 
-new StackParameter(__0: StackParameterOptions)
+new StackParameter(options: StackParameterOptions)
 ```
 
 | **Name** | **Type** | **Description** |
 | --- | --- | --- |
-| <code><a href="#@btc-embedded/cdk-extensions.StackParameter.Initializer.parameter.__0">__0</a></code> | <code><a href="#@btc-embedded/cdk-extensions.StackParameterOptions">StackParameterOptions</a></code> | *No description.* |
+| <code><a href="#@btc-embedded/cdk-extensions.StackParameter.Initializer.parameter.options">options</a></code> | <code><a href="#@btc-embedded/cdk-extensions.StackParameterOptions">StackParameterOptions</a></code> | *No description.* |
 
 ---
 
-##### `__0`<sup>Required</sup> <a name="__0" id="@btc-embedded/cdk-extensions.StackParameter.Initializer.parameter.__0"></a>
+##### `options`<sup>Required</sup> <a name="options" id="@btc-embedded/cdk-extensions.StackParameter.Initializer.parameter.options"></a>
 
 - *Type:* <a href="#@btc-embedded/cdk-extensions.StackParameterOptions">StackParameterOptions</a>
 

package/CHANGELOG.md

@@ -1,4 +1,18 @@
 
+## [0.14.9](https://github.com/btc-embedded/cdk-extensions/compare/v0.14.8...v0.14.9) (2025-11-18)
+
+
+### Bug Fixes
+
+* make sure OTel sidecar has necessary permissions ([a6b0c88](https://github.com/btc-embedded/cdk-extensions/commit/a6b0c88ac1c4061f7c1da00bb13fec168b1cb682))
+
+## [0.14.8](https://github.com/btc-embedded/cdk-extensions/compare/v0.14.7...v0.14.8) (2025-10-08)
+
+
+### Bug Fixes
+
+* revert the flag for agw arecord creation ([7f5eaea](https://github.com/btc-embedded/cdk-extensions/commit/7f5eaeafed2427589429d968b147ea005867d31a))
+
 ## [0.14.7](https://github.com/btc-embedded/cdk-extensions/compare/v0.14.6...v0.14.7) (2025-10-07)