@aws-cdk/toolkit-lib 0.1.6 → 0.1.7

package/lib/api/shared-public.d.ts

@@ -876,24 +876,77 @@ interface CcApiContextQuery extends ContextLookupRoleOptions {
 	 */
 	readonly typeName: string;
 	/**
-	 * exactIdentifier of the resource.
-	 * Specifying exactIdentifier will return at most one result.
-	 * Either exactIdentifier or propertyMatch should be specified.
-	 * @default - None
+	 * Identifier of the resource to look up using `GetResource`.
+	 *
+	 * Specifying exactIdentifier will return exactly one result, or throw an error.
+	 *
+	 *
+	 * @default - Either exactIdentifier or propertyMatch should be specified.
 	 */
 	readonly exactIdentifier?: string;
 	/**
-	 * This indicates the property to search for.
-	 * If both exactIdentifier and propertyMatch are specified, then exactIdentifier is used.
+	 * Returns any resources matching these properties, using `ListResources`.
+	 *
 	 * Specifying propertyMatch will return 0 or more results.
-	 * Either exactIdentifier or propertyMatch should be specified.
-	 * @default - None
+	 *
+	 * ## Notes on property completeness
+	 *
+	 * CloudControl API's `ListResources` may return fewer properties than
+	 * `GetResource` would, depending on the resource implementation.
+	 *
+	 * The resources that `propertyMatch` matches against will *only ever* be the
+	 * properties returned by the `ListResources` call.
+	 *
+	 * @default - Either exactIdentifier or propertyMatch should be specified.
 	 */
 	readonly propertyMatch?: Record<string, unknown>;
 	/**
 	 * This is a set of properties returned from CC API that we want to return from ContextQuery.
+	 *
+	 * If any properties listed here are absent from the target resource, an error will be thrown.
+	 *
+	 * The returned object will always include the key `Identifier` with the CC-API returned
+	 * field `Identifier`.
+	 *
+	 * ## Notes on property completeness
+	 *
+	 * CloudControl API's `ListResources` may return fewer properties than
+	 * `GetResource` would, depending on the resource implementation.
+	 *
+	 * The returned properties here are *currently* selected from the response
+	 * object that CloudControl API returns to the CDK CLI.
+	 *
+	 * However, if we find there is need to do so, we may decide to change this
+	 * behavior in the future: we might change it to perform an additional
+	 * `GetResource` call for resources matched by `propertyMatch`.
 	 */
 	readonly propertiesToReturn: string[];
+	/**
+	 * The value to return if the resource was not found and `ignoreErrorOnMissingContext` is true.
+	 *
+	 * If supplied, `dummyValue` should be an array of objects.
+	 *
+	 * `dummyValue` does not have to have elements, and it may have objects with
+	 * different properties than the properties in `propertiesToReturn`, but it
+	 * will be easiest for downstream code if the `dummyValue` conforms to
+	 * the expected response shape.
+	 *
+	 * @default - No dummy value available
+	 */
+	readonly dummyValue?: any;
+	/**
+	 * Ignore an error and return the `dummyValue` instead if the resource was not found.
+	 *
+	 * - In case of an `exactIdentifier` lookup, return the `dummyValue` if the resource with
+	 *   that identifier was not found.
+	 * - In case of a `propertyMatch` lookup, this setting currently does not have any effect,
+	 *   as `propertyMatch` queries can legally return 0 resources.
+	 *
+	 * if `ignoreErrorOnMissingContext` is set, `dummyValue` should be set and be an array.
+	 *
+	 * @default false
+	 */
+	readonly ignoreErrorOnMissingContext?: boolean;
 }
 interface PluginContextQuery {
 	/**
@@ -2075,6 +2128,12 @@ export interface ConfirmationRequest {
 	 */
 	readonly concurrency?: number;
 }
+export interface ContextProviderMessageSource {
+	/**
+	 * The name of the context provider sending the message
+	 */
+	readonly provider: string;
+}
 export interface StackDeployProgress {
 	/**
 	 * The total number of stacks being deployed
@@ -2467,6 +2526,13 @@ export interface AffectedResource {
 	 * A physical name is not always available, e.g. new resources will not have one until after the deployment
 	 */
 	readonly physicalName?: string;
+	/**
+	 * Resource metadata attached to the logical id from the cloud assembly
+	 *
+	 * This is only present if the resource is present in the current Cloud Assembly,
+	 * i.e. resource deletions will not have metadata.
+	 */
+	readonly metadata?: ResourceMetadata;
 }
 /**
  * Represents a change in a resource
@@ -2488,6 +2554,13 @@ export interface ResourceChange {
 	 * The changes made to the resource properties
 	 */
 	readonly propertyUpdates: Record<string, PropertyDifference<unknown>>;
+	/**
+	 * Resource metadata attached to the logical id from the cloud assembly
+	 *
+	 * This is only present if the resource is present in the current Cloud Assembly,
+	 * i.e. resource deletions will not have metadata.
+	 */
+	readonly metadata?: ResourceMetadata;
 }
 /**
  * A change that can be hotswapped
@@ -2497,11 +2570,118 @@ export interface HotswappableChange {
 	 * The resource change that is causing the hotswap.
 	 */
 	readonly cause: ResourceChange;
+	/**
+	 * A list of resources that are being hotswapped as part of the change
+	 */
+	readonly resources: AffectedResource[];
+}
+export declare enum NonHotswappableReason {
+	/**
+	 * Tags are not hotswappable
+	 */
+	TAGS = "tags",
+	/**
+	 * Changed resource properties are not hotswappable on this resource type
+	 */
+	PROPERTIES = "properties",
+	/**
+	 * A stack output has changed
+	 */
+	OUTPUT = "output",
+	/**
+	 * A dependant resource is not hotswappable
+	 */
+	DEPENDENCY_UNSUPPORTED = "dependency-unsupported",
+	/**
+	 * The resource type is not hotswappable
+	 */
+	RESOURCE_UNSUPPORTED = "resource-unsupported",
+	/**
+	 * The resource is created in the deployment
+	 */
+	RESOURCE_CREATION = "resource-creation",
+	/**
+	 * The resource is removed in the deployment
+	 */
+	RESOURCE_DELETION = "resource-deletion",
+	/**
+	 * The resource identified by the logical id has its type changed
+	 */
+	RESOURCE_TYPE_CHANGED = "resource-type-changed",
+	/**
+	 * The nested stack is created in the deployment
+	 */
+	NESTED_STACK_CREATION = "nested-stack-creation"
+}
+export interface RejectionSubject {
+	/**
+	 * The type of the rejection subject, e.g. Resource or Output
+	 */
+	readonly type: string;
+	/**
+	 * The logical ID of the change that is not hotswappable
+	 */
+	readonly logicalId: string;
+	/**
+	 * Resource metadata attached to the logical id from the cloud assembly
+	 *
+	 * This is only present if the resource is present in the current Cloud Assembly,
+	 * i.e. resource deletions will not have metadata.
+	 */
+	readonly metadata?: ResourceMetadata;
+}
+export interface ResourceSubject extends RejectionSubject {
+	/**
+	 * A rejected resource
+	 */
+	readonly type: "Resource";
+	/**
+	 * The type of the rejected resource
+	 */
+	readonly resourceType: string;
+	/**
+	 * The list of properties that are cause for the rejection
+	 */
+	readonly rejectedProperties?: string[];
+}
+export interface OutputSubject extends RejectionSubject {
+	/**
+	 * A rejected output
+	 */
+	readonly type: "Output";
+}
+/**
+ * A change that can not be hotswapped
+ */
+export interface NonHotswappableChange {
+	/**
+	 * The subject of the change that was rejected
+	 */
+	readonly subject: ResourceSubject | OutputSubject;
+	/**
+	 * Why was this change was deemed non-hotswappable
+	 */
+	readonly reason: NonHotswappableReason;
+	/**
+	 * Tells the user exactly why this change was deemed non-hotswappable and what its logical ID is.
+	 * If not specified, `displayReason` default to state that the properties listed in `rejectedChanges` are not hotswappable.
+	 */
+	readonly description: string;
+}
+export interface HotswapDeploymentAttempt {
+	/**
+	 * The stack that's currently being deployed
+	 */
+	readonly stack: cxapi.CloudFormationStackArtifact;
+	/**
+	 * The mode the hotswap deployment was initiated with.
+	 */
+	readonly mode: "hotswap-only" | "fall-back";
 }
 /**
  * Information about a hotswap deployment
  */
-export interface HotswapDeployment {
+export interface HotswapDeploymentDetails {
 	/**
 	 * The stack that's currently being deployed
 	 */
@@ -2510,6 +2690,25 @@ export interface HotswapDeployment {
 	 * The mode the hotswap deployment was initiated with.
 	 */
 	readonly mode: "hotswap-only" | "fall-back";
+	/**
+	 * The changes that were deemed hotswappable
+	 */
+	readonly hotswappableChanges: HotswappableChange[];
+	/**
+	 * The changes that were deemed not hotswappable
+	 */
+	readonly nonHotswappableChanges: NonHotswappableChange[];
+}
+/**
+ * The result of an attempted hotswap deployment
+ */
+export interface HotswapResult extends Duration, HotswapDeploymentDetails {
+	/**
+	 * Whether hotswapping happened or not.
+	 *
+	 * `false` indicates that the deployment could not be hotswapped and full deployment may be attempted as fallback.
+	 */
+	readonly hotswapped: boolean;
 }
 /**
  * Represents a general toolkit error in the AWS CDK Toolkit.
@@ -2531,6 +2730,10 @@ export declare class ToolkitError extends Error {
 	 * Determines if a given error is an instance of AssemblyError.
 	 */
 	static isContextProviderError(x: any): x is ContextProviderError;
+	/**
+	 * An AssemblyError with an original error as cause
+	 */
+	static withCause(message: string, error: unknown): ToolkitError;
 	/**
 	 * The type of the error, defaults to "toolkit".
 	 */
@@ -2539,7 +2742,11 @@ export declare class ToolkitError extends Error {
 	 * Denotes the source of the error as the toolkit.
 	 */
 	readonly source: "toolkit" | "user";
-	constructor(message: string, type?: string);
+	/**
+	 * The specific original cause of the error, if available
+	 */
+	readonly cause?: unknown;
+	constructor(message: string, type?: string, cause?: unknown);
 }
 /**
  * Represents an authentication-specific error in the AWS CDK Toolkit.
@@ -2576,10 +2783,6 @@ export declare class AssemblyError extends ToolkitError {
 	 * Absence indicates synthesis didn't fully complete.
 	 */
 	readonly stacks?: cxapi.CloudFormationStackArtifact[];
-	/**
-	 * The specific original cause of the error, if available
-	 */
-	readonly cause?: unknown;
 	private constructor();
 }
 /**

package/lib/api/shared-public.js

@@ -24,6 +24,7 @@ __export(shared_public_exports, {
   AuthenticationError: () => AuthenticationError,
   ContextProviderError: () => ContextProviderError,
   ExpandStackSelection: () => ExpandStackSelection,
+  NonHotswappableReason: () => NonHotswappableReason,
   PermissionChangeType: () => PermissionChangeType,
   RequireApproval: () => RequireApproval,
   StackSelectionStrategy: () => StackSelectionStrategy,
@@ -56,6 +57,20 @@ var PermissionChangeType = /* @__PURE__ */ ((PermissionChangeType2) => {
   return PermissionChangeType2;
 })(PermissionChangeType || {});
 
+// ../tmp-toolkit-helpers/src/api/io/payloads/hotswap.ts
+var NonHotswappableReason = /* @__PURE__ */ ((NonHotswappableReason2) => {
+  NonHotswappableReason2["TAGS"] = "tags";
+  NonHotswappableReason2["PROPERTIES"] = "properties";
+  NonHotswappableReason2["OUTPUT"] = "output";
+  NonHotswappableReason2["DEPENDENCY_UNSUPPORTED"] = "dependency-unsupported";
+  NonHotswappableReason2["RESOURCE_UNSUPPORTED"] = "resource-unsupported";
+  NonHotswappableReason2["RESOURCE_CREATION"] = "resource-creation";
+  NonHotswappableReason2["RESOURCE_DELETION"] = "resource-deletion";
+  NonHotswappableReason2["RESOURCE_TYPE_CHANGED"] = "resource-type-changed";
+  NonHotswappableReason2["NESTED_STACK_CREATION"] = "nested-stack-creation";
+  return NonHotswappableReason2;
+})(NonHotswappableReason || {});
+
 // ../tmp-toolkit-helpers/src/api/toolkit-error.ts
 var TOOLKIT_ERROR_SYMBOL = Symbol.for("@aws-cdk/toolkit-lib.ToolkitError");
 var AUTHENTICATION_ERROR_SYMBOL = Symbol.for("@aws-cdk/toolkit-lib.AuthenticationError");
@@ -86,6 +101,12 @@ var ToolkitError = class _ToolkitError extends Error {
   static isContextProviderError(x) {
     return this.isToolkitError(x) && CONTEXT_PROVIDER_ERROR_SYMBOL in x;
   }
+  /**
+   * An AssemblyError with an original error as cause
+   */
+  static withCause(message, error) {
+    return new _ToolkitError(message, "toolkit", error);
+  }
   /**
    * The type of the error, defaults to "toolkit".
    */
@@ -94,13 +115,18 @@ var ToolkitError = class _ToolkitError extends Error {
    * Denotes the source of the error as the toolkit.
    */
   source;
-  constructor(message, type = "toolkit") {
+  /**
+   * The specific original cause of the error, if available
+   */
+  cause;
+  constructor(message, type = "toolkit", cause) {
     super(message);
     Object.setPrototypeOf(this, _ToolkitError.prototype);
     Object.defineProperty(this, TOOLKIT_ERROR_SYMBOL, { value: true });
     this.name = new.target.name;
     this.type = type;
     this.source = "toolkit";
+    this.cause = cause;
   }
 };
 var AuthenticationError = class _AuthenticationError extends ToolkitError {
@@ -138,16 +164,11 @@ var AssemblyError = class _AssemblyError extends ToolkitError {
    * Absence indicates synthesis didn't fully complete.
    */
   stacks;
-  /**
-   * The specific original cause of the error, if available
-   */
-  cause;
   constructor(message, stacks, cause) {
-    super(message, "assembly");
+    super(message, "assembly", cause);
     Object.setPrototypeOf(this, _AssemblyError.prototype);
     Object.defineProperty(this, ASSEMBLY_ERROR_SYMBOL, { value: true });
     this.stacks = stacks;
-    this.cause = cause;
   }
 };
 var ContextProviderError = class _ContextProviderError extends ToolkitError {
@@ -175,6 +196,7 @@ var RequireApproval = /* @__PURE__ */ ((RequireApproval2) => {
   AuthenticationError,
   ContextProviderError,
   ExpandStackSelection,
+  NonHotswappableReason,
   PermissionChangeType,
   RequireApproval,
   StackSelectionStrategy,

package/lib/api/shared-public.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["shared-public.ts", "../../../tmp-toolkit-helpers/src/api/cloud-assembly/stack-selector.ts", "../../../tmp-toolkit-helpers/src/api/io/payloads/diff.ts", "../../../tmp-toolkit-helpers/src/api/toolkit-error.ts", "../../../tmp-toolkit-helpers/src/api/require-approval.ts"],
-  "sourcesContent": ["/* eslint-disable import/no-restricted-paths */\n\nexport * from '../../../tmp-toolkit-helpers/src/api';\n", "/**\n * Which stacks should be selected from a cloud assembly\n */\nexport enum StackSelectionStrategy {\n  /**\n   * Returns all stacks in the app regardless of patterns,\n   * including stacks inside nested assemblies.\n   */\n  ALL_STACKS = 'all-stacks',\n\n  /**\n   * Returns all stacks in the main (top level) assembly only.\n   */\n  MAIN_ASSEMBLY = 'main-assembly',\n\n  /**\n   * If the assembly includes a single stack, returns it.\n   * Otherwise throws an exception.\n   */\n  ONLY_SINGLE = 'only-single',\n\n  /**\n   * Return stacks matched by patterns.\n   * If no stacks are found, execution is halted successfully.\n   * Most likely you don't want to use this but `StackSelectionStrategy.MUST_MATCH_PATTERN`\n   */\n  PATTERN_MATCH = 'pattern-match',\n\n  /**\n   * Return stacks matched by patterns.\n   * Throws an exception if the patterns don't match at least one stack in the assembly.\n   */\n  PATTERN_MUST_MATCH = 'pattern-must-match',\n\n  /**\n   * Returns if exactly one stack is matched by the pattern(s).\n   * Throws an exception if no stack, or more than exactly one stack are matched.\n   */\n  PATTERN_MUST_MATCH_SINGLE = 'pattern-must-match-single',\n}\n\n/**\n * When selecting stacks, what other stacks to include because of dependencies\n */\nexport enum ExpandStackSelection {\n  /**\n   * Don't select any extra stacks\n   */\n  NONE = 'none',\n\n  /**\n   * Include stacks that this stack depends on\n   */\n  UPSTREAM = 'upstream',\n\n  /**\n   * Include stacks that depend on this stack\n   */\n  DOWNSTREAM = 'downstream',\n\n  /**\n   * @TODO\n   * Include both directions.\n   * I.e. stacks that this stack depends on, and stacks that depend on this stack.\n   */\n  // FULL = 'full',\n}\n\n/**\n * A specification of which stacks should be selected\n */\nexport interface StackSelector {\n  /**\n   * The behavior if if no selectors are provided.\n   */\n  strategy: StackSelectionStrategy;\n\n  /**\n   * A list of patterns to match the stack hierarchical ids\n   * Only used with `PATTERN_*` selection strategies.\n   */\n  patterns?: string[];\n\n  /**\n   * Expand the selection to upstream/downstream stacks.\n   * @default ExpandStackSelection.None only select the specified/matched stacks\n   */\n  expand?: ExpandStackSelection;\n\n  /**\n   * By default, we throw an exception if the assembly contains no stacks.\n   * Set to `false`, to halt execution for empty assemblies without error.\n   *\n   * Note that actions can still throw if a stack selection result is empty,\n   * but the assembly contains stacks in principle.\n   *\n   * @default true\n   */\n  failOnEmpty?: boolean;\n}\n", "/**\n * Different types of permission related changes in a diff\n */\nexport enum PermissionChangeType {\n  /**\n   * No permission changes\n   */\n  NONE = 'none',\n\n  /**\n   * Permissions are broadening\n   */\n  BROADENING = 'broadening',\n\n  /**\n   * Permissions are changed but not broadening\n   */\n  NON_BROADENING = 'non-broadening',\n}\n", "import type * as cxapi from '@aws-cdk/cx-api';\n\nconst TOOLKIT_ERROR_SYMBOL = Symbol.for('@aws-cdk/toolkit-lib.ToolkitError');\nconst AUTHENTICATION_ERROR_SYMBOL = Symbol.for('@aws-cdk/toolkit-lib.AuthenticationError');\nconst ASSEMBLY_ERROR_SYMBOL = Symbol.for('@aws-cdk/toolkit-lib.AssemblyError');\nconst CONTEXT_PROVIDER_ERROR_SYMBOL = Symbol.for('@aws-cdk/toolkit-lib.ContextProviderError');\n\n/**\n * Represents a general toolkit error in the AWS CDK Toolkit.\n */\nexport class ToolkitError extends Error {\n  /**\n   * Determines if a given error is an instance of ToolkitError.\n   */\n  public static isToolkitError(x: any): x is ToolkitError {\n    return x !== null && typeof(x) === 'object' && TOOLKIT_ERROR_SYMBOL in x;\n  }\n\n  /**\n   * Determines if a given error is an instance of AuthenticationError.\n   */\n  public static isAuthenticationError(x: any): x is AuthenticationError {\n    return this.isToolkitError(x) && AUTHENTICATION_ERROR_SYMBOL in x;\n  }\n\n  /**\n   * Determines if a given error is an instance of AssemblyError.\n   */\n  public static isAssemblyError(x: any): x is AssemblyError {\n    return this.isToolkitError(x) && ASSEMBLY_ERROR_SYMBOL in x;\n  }\n\n  /**\n   * Determines if a given error is an instance of AssemblyError.\n   */\n  public static isContextProviderError(x: any): x is ContextProviderError {\n    return this.isToolkitError(x) && CONTEXT_PROVIDER_ERROR_SYMBOL in x;\n  }\n\n  /**\n   * The type of the error, defaults to \"toolkit\".\n   */\n  public readonly type: string;\n\n  /**\n   * Denotes the source of the error as the toolkit.\n   */\n  public readonly source: 'toolkit' | 'user';\n\n  constructor(message: string, type: string = 'toolkit') {\n    super(message);\n    Object.setPrototypeOf(this, ToolkitError.prototype);\n    Object.defineProperty(this, TOOLKIT_ERROR_SYMBOL, { value: true });\n    this.name = new.target.name;\n    this.type = type;\n    this.source = 'toolkit';\n  }\n}\n\n/**\n * Represents an authentication-specific error in the AWS CDK Toolkit.\n */\nexport class AuthenticationError extends ToolkitError {\n  /**\n   * Denotes the source of the error as user.\n   */\n  public readonly source = 'user';\n\n  constructor(message: string) {\n    super(message, 'authentication');\n    Object.setPrototypeOf(this, AuthenticationError.prototype);\n    Object.defineProperty(this, AUTHENTICATION_ERROR_SYMBOL, { value: true });\n  }\n}\n\n/**\n * Represents an error causes by cloud assembly synthesis\n *\n * This includes errors thrown during app execution, as well as failing annotations.\n */\nexport class AssemblyError extends ToolkitError {\n  /**\n   * An AssemblyError with an original error as cause\n   */\n  public static withCause(message: string, error: unknown): AssemblyError {\n    return new AssemblyError(message, undefined, error);\n  }\n\n  /**\n   * An AssemblyError with a list of stacks as cause\n   */\n  public static withStacks(message: string, stacks?: cxapi.CloudFormationStackArtifact[]): AssemblyError {\n    return new AssemblyError(message, stacks);\n  }\n\n  /**\n   * Denotes the source of the error as user.\n   */\n  public readonly source = 'user';\n\n  /**\n   * The stacks that caused the error, if available\n   *\n   * The `messages` property of each `cxapi.CloudFormationStackArtifact` will contain the respective errors.\n   * Absence indicates synthesis didn't fully complete.\n   */\n  public readonly stacks?: cxapi.CloudFormationStackArtifact[];\n\n  /**\n   * The specific original cause of the error, if available\n   */\n  public readonly cause?: unknown;\n\n  private constructor(message: string, stacks?: cxapi.CloudFormationStackArtifact[], cause?: unknown) {\n    super(message, 'assembly');\n    Object.setPrototypeOf(this, AssemblyError.prototype);\n    Object.defineProperty(this, ASSEMBLY_ERROR_SYMBOL, { value: true });\n    this.stacks = stacks;\n    this.cause = cause;\n  }\n}\n\n/**\n * Represents an error originating from a Context Provider\n */\nexport class ContextProviderError extends ToolkitError {\n  /**\n   * Denotes the source of the error as user.\n   */\n  public readonly source = 'user';\n\n  constructor(message: string) {\n    super(message, 'context-provider');\n    Object.setPrototypeOf(this, ContextProviderError.prototype);\n    Object.defineProperty(this, CONTEXT_PROVIDER_ERROR_SYMBOL, { value: true });\n  }\n}\n", "/**\n * @deprecated\n */\nexport enum RequireApproval {\n  /**\n   * Never require any security approvals\n   */\n  NEVER = 'never',\n  /**\n   * Any security changes require an approval\n   */\n  ANY_CHANGE = 'any-change',\n  /**\n   * Require approval only for changes that are access broadening\n   */\n  BROADENING = 'broadening',\n}\n"],
-  "mappings": "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",
-  "names": ["StackSelectionStrategy", "ExpandStackSelection", "PermissionChangeType", "RequireApproval"]
+  "sources": ["shared-public.ts", "../../../tmp-toolkit-helpers/src/api/cloud-assembly/stack-selector.ts", "../../../tmp-toolkit-helpers/src/api/io/payloads/diff.ts", "../../../tmp-toolkit-helpers/src/api/io/payloads/hotswap.ts", "../../../tmp-toolkit-helpers/src/api/toolkit-error.ts", "../../../tmp-toolkit-helpers/src/api/require-approval.ts"],
+  "sourcesContent": ["/* eslint-disable import/no-restricted-paths */\n\nexport * from '../../../tmp-toolkit-helpers/src/api';\n", "/**\n * Which stacks should be selected from a cloud assembly\n */\nexport enum StackSelectionStrategy {\n  /**\n   * Returns all stacks in the app regardless of patterns,\n   * including stacks inside nested assemblies.\n   */\n  ALL_STACKS = 'all-stacks',\n\n  /**\n   * Returns all stacks in the main (top level) assembly only.\n   */\n  MAIN_ASSEMBLY = 'main-assembly',\n\n  /**\n   * If the assembly includes a single stack, returns it.\n   * Otherwise throws an exception.\n   */\n  ONLY_SINGLE = 'only-single',\n\n  /**\n   * Return stacks matched by patterns.\n   * If no stacks are found, execution is halted successfully.\n   * Most likely you don't want to use this but `StackSelectionStrategy.MUST_MATCH_PATTERN`\n   */\n  PATTERN_MATCH = 'pattern-match',\n\n  /**\n   * Return stacks matched by patterns.\n   * Throws an exception if the patterns don't match at least one stack in the assembly.\n   */\n  PATTERN_MUST_MATCH = 'pattern-must-match',\n\n  /**\n   * Returns if exactly one stack is matched by the pattern(s).\n   * Throws an exception if no stack, or more than exactly one stack are matched.\n   */\n  PATTERN_MUST_MATCH_SINGLE = 'pattern-must-match-single',\n}\n\n/**\n * When selecting stacks, what other stacks to include because of dependencies\n */\nexport enum ExpandStackSelection {\n  /**\n   * Don't select any extra stacks\n   */\n  NONE = 'none',\n\n  /**\n   * Include stacks that this stack depends on\n   */\n  UPSTREAM = 'upstream',\n\n  /**\n   * Include stacks that depend on this stack\n   */\n  DOWNSTREAM = 'downstream',\n\n  /**\n   * @TODO\n   * Include both directions.\n   * I.e. stacks that this stack depends on, and stacks that depend on this stack.\n   */\n  // FULL = 'full',\n}\n\n/**\n * A specification of which stacks should be selected\n */\nexport interface StackSelector {\n  /**\n   * The behavior if if no selectors are provided.\n   */\n  strategy: StackSelectionStrategy;\n\n  /**\n   * A list of patterns to match the stack hierarchical ids\n   * Only used with `PATTERN_*` selection strategies.\n   */\n  patterns?: string[];\n\n  /**\n   * Expand the selection to upstream/downstream stacks.\n   * @default ExpandStackSelection.None only select the specified/matched stacks\n   */\n  expand?: ExpandStackSelection;\n\n  /**\n   * By default, we throw an exception if the assembly contains no stacks.\n   * Set to `false`, to halt execution for empty assemblies without error.\n   *\n   * Note that actions can still throw if a stack selection result is empty,\n   * but the assembly contains stacks in principle.\n   *\n   * @default true\n   */\n  failOnEmpty?: boolean;\n}\n", "/**\n * Different types of permission related changes in a diff\n */\nexport enum PermissionChangeType {\n  /**\n   * No permission changes\n   */\n  NONE = 'none',\n\n  /**\n   * Permissions are broadening\n   */\n  BROADENING = 'broadening',\n\n  /**\n   * Permissions are changed but not broadening\n   */\n  NON_BROADENING = 'non-broadening',\n}\n", "import type { PropertyDifference, Resource } from '@aws-cdk/cloudformation-diff';\nimport type * as cxapi from '@aws-cdk/cx-api';\nimport type { Duration } from './types';\nimport type { ResourceMetadata } from '../../resource-metadata/resource-metadata';\n\n/**\n * A resource affected by a change\n */\nexport interface AffectedResource {\n  /**\n   * The logical ID of the affected resource in the template\n   */\n  readonly logicalId: string;\n  /**\n   * The CloudFormation type of the resource\n   * This could be a custom type.\n   */\n  readonly resourceType: string;\n  /**\n   * The friendly description of the affected resource\n   */\n  readonly description?: string;\n  /**\n   * The physical name of the resource when deployed.\n   *\n   * A physical name is not always available, e.g. new resources will not have one until after the deployment\n   */\n  readonly physicalName?: string;\n  /**\n   * Resource metadata attached to the logical id from the cloud assembly\n   *\n   * This is only present if the resource is present in the current Cloud Assembly,\n   * i.e. resource deletions will not have metadata.\n   */\n  readonly metadata?: ResourceMetadata;\n}\n\n/**\n * Represents a change in a resource\n */\nexport interface ResourceChange {\n  /**\n   * The logical ID of the resource which is being changed\n   */\n  readonly logicalId: string;\n  /**\n   * The value the resource is being updated from\n   */\n  readonly oldValue: Resource;\n  /**\n   * The value the resource is being updated to\n   */\n  readonly newValue: Resource;\n  /**\n   * The changes made to the resource properties\n   */\n  readonly propertyUpdates: Record<string, PropertyDifference<unknown>>;\n  /**\n   * Resource metadata attached to the logical id from the cloud assembly\n   *\n   * This is only present if the resource is present in the current Cloud Assembly,\n   * i.e. resource deletions will not have metadata.\n   */\n  readonly metadata?: ResourceMetadata;\n}\n\n/**\n * A change that can be hotswapped\n */\nexport interface HotswappableChange {\n  /**\n   * The resource change that is causing the hotswap.\n   */\n  readonly cause: ResourceChange;\n  /**\n   * A list of resources that are being hotswapped as part of the change\n   */\n  readonly resources: AffectedResource[];\n}\n\nexport enum NonHotswappableReason {\n  /**\n   * Tags are not hotswappable\n   */\n  TAGS = 'tags',\n  /**\n   * Changed resource properties are not hotswappable on this resource type\n   */\n  PROPERTIES = 'properties',\n  /**\n   * A stack output has changed\n   */\n  OUTPUT = 'output',\n  /**\n   * A dependant resource is not hotswappable\n   */\n  DEPENDENCY_UNSUPPORTED = 'dependency-unsupported',\n  /**\n   * The resource type is not hotswappable\n   */\n  RESOURCE_UNSUPPORTED = 'resource-unsupported',\n  /**\n   * The resource is created in the deployment\n   */\n  RESOURCE_CREATION = 'resource-creation',\n  /**\n   * The resource is removed in the deployment\n   */\n  RESOURCE_DELETION = 'resource-deletion',\n  /**\n   * The resource identified by the logical id has its type changed\n   */\n  RESOURCE_TYPE_CHANGED = 'resource-type-changed',\n  /**\n   * The nested stack is created in the deployment\n   */\n  NESTED_STACK_CREATION = 'nested-stack-creation',\n}\n\nexport interface RejectionSubject {\n  /**\n   * The type of the rejection subject, e.g. Resource or Output\n   */\n  readonly type: string;\n\n  /**\n   * The logical ID of the change that is not hotswappable\n   */\n  readonly logicalId: string;\n  /**\n   * Resource metadata attached to the logical id from the cloud assembly\n   *\n   * This is only present if the resource is present in the current Cloud Assembly,\n   * i.e. resource deletions will not have metadata.\n   */\n  readonly metadata?: ResourceMetadata;\n}\n\nexport interface ResourceSubject extends RejectionSubject {\n  /**\n   * A rejected resource\n   */\n  readonly type: 'Resource';\n  /**\n   * The type of the rejected resource\n   */\n  readonly resourceType: string;\n  /**\n   * The list of properties that are cause for the rejection\n   */\n  readonly rejectedProperties?: string[];\n}\n\nexport interface OutputSubject extends RejectionSubject {\n  /**\n   * A rejected output\n   */\n  readonly type: 'Output';\n}\n\n/**\n * A change that can not be hotswapped\n */\nexport interface NonHotswappableChange {\n  /**\n   * The subject of the change that was rejected\n   */\n  readonly subject: ResourceSubject | OutputSubject;\n  /**\n   * Why was this change was deemed non-hotswappable\n   */\n  readonly reason: NonHotswappableReason;\n  /**\n   * Tells the user exactly why this change was deemed non-hotswappable and what its logical ID is.\n   * If not specified, `displayReason` default to state that the properties listed in `rejectedChanges` are not hotswappable.\n   */\n  readonly description: string;\n}\n\nexport interface HotswapDeploymentAttempt {\n  /**\n   * The stack that's currently being deployed\n   */\n  readonly stack: cxapi.CloudFormationStackArtifact;\n\n  /**\n   * The mode the hotswap deployment was initiated with.\n   */\n  readonly mode: 'hotswap-only' | 'fall-back';\n}\n\n/**\n * Information about a hotswap deployment\n */\nexport interface HotswapDeploymentDetails {\n  /**\n   * The stack that's currently being deployed\n   */\n  readonly stack: cxapi.CloudFormationStackArtifact;\n\n  /**\n   * The mode the hotswap deployment was initiated with.\n   */\n  readonly mode: 'hotswap-only' | 'fall-back';\n  /**\n   * The changes that were deemed hotswappable\n   */\n  readonly hotswappableChanges: HotswappableChange[];\n  /**\n   * The changes that were deemed not hotswappable\n   */\n  readonly nonHotswappableChanges: NonHotswappableChange[];\n}\n\n/**\n * The result of an attempted hotswap deployment\n */\nexport interface HotswapResult extends Duration, HotswapDeploymentDetails {\n  /**\n   * Whether hotswapping happened or not.\n   *\n   * `false` indicates that the deployment could not be hotswapped and full deployment may be attempted as fallback.\n   */\n  readonly hotswapped: boolean;\n}\n", "import type * as cxapi from '@aws-cdk/cx-api';\n\nconst TOOLKIT_ERROR_SYMBOL = Symbol.for('@aws-cdk/toolkit-lib.ToolkitError');\nconst AUTHENTICATION_ERROR_SYMBOL = Symbol.for('@aws-cdk/toolkit-lib.AuthenticationError');\nconst ASSEMBLY_ERROR_SYMBOL = Symbol.for('@aws-cdk/toolkit-lib.AssemblyError');\nconst CONTEXT_PROVIDER_ERROR_SYMBOL = Symbol.for('@aws-cdk/toolkit-lib.ContextProviderError');\n\n/**\n * Represents a general toolkit error in the AWS CDK Toolkit.\n */\nexport class ToolkitError extends Error {\n  /**\n   * Determines if a given error is an instance of ToolkitError.\n   */\n  public static isToolkitError(x: any): x is ToolkitError {\n    return x !== null && typeof(x) === 'object' && TOOLKIT_ERROR_SYMBOL in x;\n  }\n\n  /**\n   * Determines if a given error is an instance of AuthenticationError.\n   */\n  public static isAuthenticationError(x: any): x is AuthenticationError {\n    return this.isToolkitError(x) && AUTHENTICATION_ERROR_SYMBOL in x;\n  }\n\n  /**\n   * Determines if a given error is an instance of AssemblyError.\n   */\n  public static isAssemblyError(x: any): x is AssemblyError {\n    return this.isToolkitError(x) && ASSEMBLY_ERROR_SYMBOL in x;\n  }\n\n  /**\n   * Determines if a given error is an instance of AssemblyError.\n   */\n  public static isContextProviderError(x: any): x is ContextProviderError {\n    return this.isToolkitError(x) && CONTEXT_PROVIDER_ERROR_SYMBOL in x;\n  }\n\n  /**\n   * An AssemblyError with an original error as cause\n   */\n  public static withCause(message: string, error: unknown): ToolkitError {\n    return new ToolkitError(message, 'toolkit', error);\n  }\n\n  /**\n   * The type of the error, defaults to \"toolkit\".\n   */\n  public readonly type: string;\n\n  /**\n   * Denotes the source of the error as the toolkit.\n   */\n  public readonly source: 'toolkit' | 'user';\n\n  /**\n   * The specific original cause of the error, if available\n   */\n  public readonly cause?: unknown;\n\n  constructor(message: string, type: string = 'toolkit', cause?: unknown) {\n    super(message);\n    Object.setPrototypeOf(this, ToolkitError.prototype);\n    Object.defineProperty(this, TOOLKIT_ERROR_SYMBOL, { value: true });\n    this.name = new.target.name;\n    this.type = type;\n    this.source = 'toolkit';\n    this.cause = cause;\n  }\n}\n\n/**\n * Represents an authentication-specific error in the AWS CDK Toolkit.\n */\nexport class AuthenticationError extends ToolkitError {\n  /**\n   * Denotes the source of the error as user.\n   */\n  public readonly source = 'user';\n\n  constructor(message: string) {\n    super(message, 'authentication');\n    Object.setPrototypeOf(this, AuthenticationError.prototype);\n    Object.defineProperty(this, AUTHENTICATION_ERROR_SYMBOL, { value: true });\n  }\n}\n\n/**\n * Represents an error causes by cloud assembly synthesis\n *\n * This includes errors thrown during app execution, as well as failing annotations.\n */\nexport class AssemblyError extends ToolkitError {\n  /**\n   * An AssemblyError with an original error as cause\n   */\n  public static withCause(message: string, error: unknown): AssemblyError {\n    return new AssemblyError(message, undefined, error);\n  }\n\n  /**\n   * An AssemblyError with a list of stacks as cause\n   */\n  public static withStacks(message: string, stacks?: cxapi.CloudFormationStackArtifact[]): AssemblyError {\n    return new AssemblyError(message, stacks);\n  }\n\n  /**\n   * Denotes the source of the error as user.\n   */\n  public readonly source = 'user';\n\n  /**\n   * The stacks that caused the error, if available\n   *\n   * The `messages` property of each `cxapi.CloudFormationStackArtifact` will contain the respective errors.\n   * Absence indicates synthesis didn't fully complete.\n   */\n  public readonly stacks?: cxapi.CloudFormationStackArtifact[];\n\n  private constructor(message: string, stacks?: cxapi.CloudFormationStackArtifact[], cause?: unknown) {\n    super(message, 'assembly', cause);\n    Object.setPrototypeOf(this, AssemblyError.prototype);\n    Object.defineProperty(this, ASSEMBLY_ERROR_SYMBOL, { value: true });\n    this.stacks = stacks;\n  }\n}\n\n/**\n * Represents an error originating from a Context Provider\n */\nexport class ContextProviderError extends ToolkitError {\n  /**\n   * Denotes the source of the error as user.\n   */\n  public readonly source = 'user';\n\n  constructor(message: string) {\n    super(message, 'context-provider');\n    Object.setPrototypeOf(this, ContextProviderError.prototype);\n    Object.defineProperty(this, CONTEXT_PROVIDER_ERROR_SYMBOL, { value: true });\n  }\n}\n", "/**\n * @deprecated\n */\nexport enum RequireApproval {\n  /**\n   * Never require any security approvals\n   */\n  NEVER = 'never',\n  /**\n   * Any security changes require an approval\n   */\n  ANY_CHANGE = 'any-change',\n  /**\n   * Require approval only for changes that are access broadening\n   */\n  BROADENING = 'broadening',\n}\n"],
+  "mappings": "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",
+  "names": ["StackSelectionStrategy", "ExpandStackSelection", "PermissionChangeType", "NonHotswappableReason", "RequireApproval"]
 }

package/lib/private/util.js

@@ -55,6 +55,7 @@ __export(util_exports, {
   isEmpty: () => isEmpty,
   isObject: () => isObject,
   loadStructuredFile: () => loadStructuredFile,
+  lowerCaseFirstCharacter: () => lowerCaseFirstCharacter,
   makeObject: () => makeObject,
   mapObject: () => mapObject,
   maxResourceTypeLength: () => maxResourceTypeLength,
@@ -71,6 +72,7 @@ __export(util_exports, {
   splitBySize: () => splitBySize,
   stackEventHasErrorMessage: () => stackEventHasErrorMessage,
   toYAML: () => toYAML,
+  transformObjectKeys: () => transformObjectKeys,
   validateSnsTopicArn: () => validateSnsTopicArn,
   zipDirectory: () => zipDirectory
 });
@@ -276,6 +278,12 @@ var ToolkitError = class _ToolkitError extends Error {
   static isContextProviderError(x) {
     return this.isToolkitError(x) && CONTEXT_PROVIDER_ERROR_SYMBOL in x;
   }
+  /**
+   * An AssemblyError with an original error as cause
+   */
+  static withCause(message, error2) {
+    return new _ToolkitError(message, "toolkit", error2);
+  }
   /**
    * The type of the error, defaults to "toolkit".
    */
@@ -284,13 +292,18 @@ var ToolkitError = class _ToolkitError extends Error {
    * Denotes the source of the error as the toolkit.
    */
   source;
-  constructor(message, type = "toolkit") {
+  /**
+   * The specific original cause of the error, if available
+   */
+  cause;
+  constructor(message, type = "toolkit", cause) {
     super(message);
     Object.setPrototypeOf(this, _ToolkitError.prototype);
     Object.defineProperty(this, TOOLKIT_ERROR_SYMBOL, { value: true });
     this.name = new.target.name;
     this.type = type;
     this.source = "toolkit";
+    this.cause = cause;
   }
 };
 
@@ -490,6 +503,24 @@ function splitBySize(data, maxSizeBytes) {
     ];
   }
 }
+function transformObjectKeys(val, transform, exclude = {}) {
+  if (val == null || typeof val !== "object") {
+    return val;
+  }
+  if (Array.isArray(val)) {
+    return val.map((input) => transformObjectKeys(input, transform, exclude));
+  }
+  const ret = {};
+  for (const [k, v] of Object.entries(val)) {
+    const childExclude = exclude[k];
+    if (childExclude === true) {
+      ret[transform(k)] = v;
+    } else {
+      ret[transform(k)] = transformObjectKeys(v, transform, childExclude);
+    }
+  }
+  return ret;
+}
 
 // ../tmp-toolkit-helpers/src/util/parallel.ts
 async function parallelPromises(n, promises) {
@@ -645,6 +676,9 @@ function roundPercentage(num) {
 function millisecondsToSeconds(num) {
   return num / 1e3;
 }
+function lowerCaseFirstCharacter(str) {
+  return str.length > 0 ? `${str[0].toLowerCase()}${str.slice(1)}` : str;
+}
 
 // ../tmp-toolkit-helpers/src/util/type-brands.ts
 function createBranded(value) {
@@ -708,6 +742,7 @@ function rangeFromSemver(ver, targetType) {
   isEmpty,
   isObject,
   loadStructuredFile,
+  lowerCaseFirstCharacter,
   makeObject,
   mapObject,
   maxResourceTypeLength,
@@ -724,6 +759,7 @@ function rangeFromSemver(ver, targetType) {
   splitBySize,
   stackEventHasErrorMessage,
   toYAML,
+  transformObjectKeys,
   validateSnsTopicArn,
   zipDirectory
 });