概要
AWS CDK v2.232.1は、TypeScriptの型定義に関する重要なバグを修正するパッチリリースです。以前のバージョンで導入されたstripInternal設定により、内部インターフェースを継承する外部向け型の型定義が欠落してしまう問題が発生していましたが、このリリースで修正されました。
バグ修正
core: TypeScript型定義の欠落を修正
(#36313)
問題の詳細:
v2.232.0で導入されたstripInternal設定により、TypeScriptコンパイラが内部型を型定義ファイル（.d.ts）から除外するようになりました。しかし、この変更により、内部インターフェースを継承している外部向けの型定義まで欠落してしまう問題が発生していました。
具体的には、以下のような構造で問題が発生していました：
// 内部インターフェース（@internal タグ付き）
/**
* @internal
*/
interface InternalBaseInterface {
internalProperty: string;
}
// 外部公開インターフェース（内部インターフェースを継承）
export interface PublicInterface extends InternalBaseInterface {
publicProperty: string;
}stripInternal: trueの設定により、InternalBaseInterfaceが型定義ファイルから除外されると、PublicInterfaceの型定義も不完全になってしまい、TypeScriptの型チェックやIDE補完が正しく機能しなくなる問題が発生していました。
修正内容:
この問題を解決するため、stripInternal設定の導入を完全にリバートしました。これにより、すべてのモジュールで内部型も型定義ファイルに含まれるようになり、外部向け型の定義が欠落する問題が解消されました。
影響範囲:
この修正は以下のすべてのモジュールに適用されています：
aws-cdk-lib（メインライブラリ）- すべてのAlphaモジュール（40以上のモジュール）
- コアパッケージ（
cx-api,region-infoなど）
影響を受けるユーザー:
v2.232.0を使用していて、以下のような症状が出ていた場合、このリリースで問題が解決されます：
- TypeScriptの型チェックエラーが発生する
- IDEの型補完が正しく機能しない
- 型定義ファイル（
.d.ts）に期待される型が含まれていない
推奨アクション:
v2.232.0を使用している場合は、できるだけ早くv2.232.1にアップグレードすることを推奨します：
npm install aws-cdk-lib@2.232.1または、yarn/pnpmを使用している場合：
yarn upgrade aws-cdk-lib@2.232.1
# または
pnpm update aws-cdk-lib@2.232.1Alpha モジュール
このリリースには、Alphaモジュール向けの変更は含まれていません（v2.232.1-alpha.0）。
まとめ
AWS CDK v2.232.1は、v2.232.0で発生したTypeScript型定義の重大な問題を修正するパッチリリースです。stripInternal設定の導入により、内部インターフェースを継承する外部向け型の型定義が欠落してしまう問題が発生していましたが、この設定をリバートすることで問題が解決されました。
v2.232.0を使用していて型定義関連の問題が発生している場合は、速やかにv2.232.1にアップグレードすることを強く推奨します。このリリースにより、TypeScriptの型チェックとIDE補完が正常に機能するようになります。