feat(cli): Add hotswap support for QuickSight resources

[awsmadi]

Summary

This PR adds hotswap deployment support for Amazon QuickSight resources, enabling faster iterative development when working with QuickSight dashboards, analyses, datasets, data sources, and templates.

Motivation

QuickSight resources often require frequent updates during development, particularly when iterating on dashboard definitions, data mappings, and visualizations. Full CloudFormation deployments for these changes can be slow. Hotswap allows developers to bypass CloudFormation and update resources directly
via the AWS API, significantly reducing deployment time during development.

Changes

New QuickSight Hotswap Handler (lib/api/hotswap/quicksight.ts)

Adds hotswap support for five QuickSight resource types:

• AWS::QuickSight::DataSet - Hotswappable properties: PhysicalTableMap, LogicalTableMap, Name
• AWS::QuickSight::DataSource - Hotswappable properties: DataSourceParameters, Name, Credentials
• AWS::QuickSight::Dashboard - Hotswappable properties: Definition, Name, SourceEntity
• AWS::QuickSight::Analysis - Hotswappable properties: Definition, Name, SourceEntity
• AWS::QuickSight::Template - Hotswappable properties: Definition, Name, SourceEntity

The implementation:

• Evaluates CloudFormation expressions for changed properties
• Resolves resource physical IDs from logical IDs
• Calls the appropriate QuickSight Update API for each resource type
• Falls back to CloudFormation for non-hotswappable property changes (e.g., ImportMode)

SDK Integration (lib/api/aws-auth/sdk.ts)

Adds IQuickSightClient interface and quickSight() method to the SDK class with support for:

• updateAnalysis
• updateDashboard
• updateDataSet
• updateDataSource
• updateTemplate

Hotswap Registration (lib/api/hotswap/hotswap-deployments.ts)

Registers the QuickSight detector for all five resource types in the RESOURCE_DETECTORS map.

Test Infrastructure (test/_helpers/mock-sdk.ts)

Adds mockQuickSightClient for testing QuickSight hotswap operations.

Testing

Added comprehensive test suite (test/api/hotswap/quicksight-hotswap-deployments.test.ts) covering:

• New resource additions (no hotswap, falls back to CFN)
• Property changes for all five resource types
• Non-hotswappable property changes (correctly falls back)
• Both FALL_BACK and HOTSWAP_ONLY modes

Usage Example

bash

Deploy with hotswap enabled - QuickSight changes will be applied directly

cdk deploy --hotswap

Or hotswap-only mode (skip non-hotswappable changes)

cdk deploy --hotswap-fallback

---

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 87.70%. Comparing base (e553d85) to head (3c8af69).

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #1055   +/-   ##
=======================================
  Coverage   87.70%   87.70%           
=======================================
  Files          72       72           
  Lines       10121    10121           
  Branches     1336     1337    +1     
=======================================
  Hits         8877     8877           
  Misses       1219     1219           
  Partials       25       25           

Flag	Coverage Δ
suite.unit	87.70% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[dgandhi62]

ImportMode here is passed as raw props.ImportMode without evaluation, unlike other properties that use evaluatedProps

What is the reason this is raw CFN and not being evaluated like the other properties?

[dgandhi62]

Is it safe to allow hotswapping credentials? I'm unsure if there is any extra consideration here but want to clarify

[dgandhi62]

I think there could be tests for

1. CFN intrinsic functions existing on the properties
2. Both hotswappable and non-hotswappable properties changing together

[dgandhi62]

Clarifying questions