@kensio/yulin 1.21.3 → 1.21.5

package/dist/service/cloudformation/command/delete-stack/delete-stack.handler.d.ts

@@ -1,9 +1,12 @@
 import type { CommandHandler } from "../../../../command/command-handler.js";
 import type { BackgroundCompleter, BackgroundScheduler } from "../../../../util/background/background.js";
 import type { SimCfnStack, SimCloudFormationStackName } from "../../stack/sim-cfn-stack.js";
+import type { SimCfnDeletedStacks } from "../../stack/sim-cfn-deleted-stacks.js";
 import type { SimDeleteStackCommand, SimDeleteStackCommandOutput } from "./delete-stack.command.js";
 interface DeleteStackCommandHandlerProperties {
     readonly stacks: Map<SimCloudFormationStackName, SimCfnStack>;
+    /** Where a Stack that has finished deleting is kept, to stay describable. */
+    readonly deleted: SimCfnDeletedStacks;
     readonly background: BackgroundScheduler & BackgroundCompleter;
 }
 /**
@@ -13,6 +16,7 @@ interface DeleteStackCommandHandlerProperties {
  */
 export declare class DeleteStackCommandHandler implements CommandHandler<SimDeleteStackCommand, SimDeleteStackCommandOutput> {
     private readonly stacks;
+    private readonly deleted;
     private readonly background;
     constructor(properties: DeleteStackCommandHandlerProperties);
     /**
@@ -27,6 +31,13 @@ export declare class DeleteStackCommandHandler implements CommandHandler<SimDele
      * the background, and the Stack name is only released when that finishes, so
      * a CreateStack that reuses the name should follow a wait for deletion to
      * complete.
+     *
+     * The Stack itself is kept once its name has gone, so DescribeStacks can
+     * still answer for it by Stack ID, as CloudFormation does for 90 days.
+     *
+     * RetainResources names Resources to leave behind. They stay in simulated AWS
+     * and are reported as retained on the deleted Stack, and the Stack still
+     * reaches DELETE_COMPLETE around them.
      */
     handle(command: SimDeleteStackCommand): Promise<SimDeleteStackCommandOutput>;
 }

package/dist/service/cloudformation/command/delete-stack/delete-stack.handler.js

@@ -6,9 +6,11 @@ import { assertDefined } from "../../../../util/type-guard/defined.js";
  */
 export class DeleteStackCommandHandler {
     stacks;
+    deleted;
     background;
     constructor(properties) {
         this.stacks = properties.stacks;
+        this.deleted = properties.deleted;
         this.background = properties.background;
     }
     /**
@@ -23,6 +25,13 @@ export class DeleteStackCommandHandler {
      * the background, and the Stack name is only released when that finishes, so
      * a CreateStack that reuses the name should follow a wait for deletion to
      * complete.
+     *
+     * The Stack itself is kept once its name has gone, so DescribeStacks can
+     * still answer for it by Stack ID, as CloudFormation does for 90 days.
+     *
+     * RetainResources names Resources to leave behind. They stay in simulated AWS
+     * and are reported as retained on the deleted Stack, and the Stack still
+     * reaches DELETE_COMPLETE around them.
      */
     async handle(command) {
         assertDefined(command.input.StackName, "DeleteStackCommand.input.StackName");
@@ -30,9 +39,14 @@ export class DeleteStackCommandHandler {
         await this.background.sequence();
         const stackName = command.input.StackName;
         const stack = this.stacks.get(stackName);
-        await stack?.delete({
+        if (stack === undefined) {
+            return { $metadata: {} };
+        }
+        await stack.delete({
+            retainResources: command.input.RetainResources,
             onDeleteComplete: () => {
                 this.stacks.delete(stackName);
+                this.deleted.record(stack);
             },
         });
         return { $metadata: {} };

package/dist/service/cloudformation/command/describe-change-set/describe-change-set.command.d.ts

@@ -0,0 +1,48 @@
+import type { SimResponseMetadata } from "../../../aws/metadata/response-metadata.type.js";
+import type { SimCfnChangeSetExecutionStatus, SimCfnChangeSetStatus, SimCfnResourceChangeAction } from "../../changeset/sim-cfn-change-set.type.js";
+/**
+ * Minimal structural sim CloudFormation DescribeChangeSet command.
+ */
+export interface SimDescribeChangeSetCommand {
+    readonly input: SimDescribeChangeSetCommandInput;
+}
+/**
+ * Minimal structural sim CloudFormation DescribeChangeSet input.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudformation/command/DescribeChangeSetCommand/
+ */
+export interface SimDescribeChangeSetCommandInput {
+    readonly ChangeSetName?: string | undefined;
+    readonly StackName?: string | undefined;
+}
+/**
+ * Minimal structural sim CloudFormation DescribeChangeSet output.
+ */
+export interface SimDescribeChangeSetCommandOutput {
+    readonly ChangeSetId?: string | undefined;
+    readonly ChangeSetName?: string | undefined;
+    readonly StackId?: string | undefined;
+    readonly StackName?: string | undefined;
+    readonly Description?: string | undefined;
+    readonly Status?: SimCfnChangeSetStatus | undefined;
+    readonly StatusReason?: string | undefined;
+    readonly ExecutionStatus?: SimCfnChangeSetExecutionStatus | undefined;
+    readonly Changes?: SimCfnChangeDescription[] | undefined;
+    readonly $metadata: SimResponseMetadata;
+}
+/**
+ * Minimal structural sim CloudFormation Change description.
+ */
+export interface SimCfnChangeDescription {
+    readonly Type: "Resource";
+    readonly ResourceChange: SimCfnResourceChangeDescription;
+}
+/**
+ * Minimal structural sim CloudFormation ResourceChange description.
+ */
+export interface SimCfnResourceChangeDescription {
+    readonly Action?: SimCfnResourceChangeAction | undefined;
+    readonly LogicalResourceId?: string | undefined;
+    readonly ResourceType?: string | undefined;
+    readonly Replacement?: string | undefined;
+}

package/dist/service/cloudformation/command/describe-change-set/describe-change-set.command.js

@@ -0,0 +1 @@
+export {};

package/dist/service/cloudformation/command/describe-change-set/describe-change-set.handler.d.ts

@@ -0,0 +1,23 @@
+import type { CommandHandler } from "../../../../command/command-handler.js";
+import type { BackgroundScheduler } from "../../../../util/background/background.js";
+import type { SimCfnChangeSets } from "../../changeset/sim-cfn-change-sets.js";
+import type { SimDescribeChangeSetCommand, SimDescribeChangeSetCommandOutput } from "./describe-change-set.command.js";
+interface DescribeChangeSetCommandHandlerProperties {
+    readonly changeSets: SimCfnChangeSets;
+    readonly background: BackgroundScheduler;
+}
+/**
+ * Simulated CloudFormation DescribeChangeSetCommand handler.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudformation/command/DescribeChangeSetCommand/
+ */
+export declare class DescribeChangeSetCommandHandler implements CommandHandler<SimDescribeChangeSetCommand, SimDescribeChangeSetCommandOutput> {
+    private readonly changeSets;
+    private readonly background;
+    constructor(properties: DescribeChangeSetCommandHandlerProperties);
+    /**
+     * Report what a change set would do to its Stack.
+     */
+    handle(command: SimDescribeChangeSetCommand): Promise<SimDescribeChangeSetCommandOutput>;
+}
+export {};

package/dist/service/cloudformation/command/describe-change-set/describe-change-set.handler.js

@@ -0,0 +1,52 @@
+import { assertDefined } from "../../../../util/type-guard/defined.js";
+/**
+ * Simulated CloudFormation DescribeChangeSetCommand handler.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudformation/command/DescribeChangeSetCommand/
+ */
+export class DescribeChangeSetCommandHandler {
+    changeSets;
+    background;
+    constructor(properties) {
+        this.changeSets = properties.changeSets;
+        this.background = properties.background;
+    }
+    /**
+     * Report what a change set would do to its Stack.
+     */
+    async handle(command) {
+        assertDefined(command.input.ChangeSetName, "DescribeChangeSetCommand.input.ChangeSetName");
+        // Allow for potential non-deterministic sequencing of async events.
+        await this.background.sequence();
+        const changeSet = this.changeSets.require({
+            changeSetName: command.input.ChangeSetName,
+            stackName: command.input.StackName,
+        });
+        return {
+            ChangeSetId: changeSet.changeSetId,
+            ChangeSetName: changeSet.changeSetName,
+            StackId: changeSet.stackId,
+            StackName: changeSet.stackName,
+            Description: changeSet.description,
+            Status: changeSet.status,
+            StatusReason: changeSet.statusReason,
+            ExecutionStatus: changeSet.executionStatus,
+            Changes: describedChanges(changeSet),
+            $metadata: {},
+        };
+    }
+}
+/**
+ * The Resource changes in the shape DescribeChangeSet answers with.
+ */
+function describedChanges(changeSet) {
+    return changeSet.changes.map((change) => ({
+        Type: "Resource",
+        ResourceChange: {
+            Action: change.action,
+            LogicalResourceId: change.logicalResourceId,
+            ResourceType: change.resourceType,
+            Replacement: change.replacement,
+        },
+    }));
+}

package/dist/service/cloudformation/command/describe-stacks/describe-stacks.handler.d.ts

@@ -2,9 +2,11 @@ import type { CommandHandler } from "../../../../command/command-handler.js";
 import { type BackgroundScheduler } from "../../../../util/background/background.js";
 import type { SimCfnStack, SimCloudFormationStackName } from "../../stack/sim-cfn-stack.js";
 import type { SimDescribeStacksCommand, SimDescribeStacksCommandOutput } from "./describe-stacks.command.js";
+import type { SimCfnDeletedStacks } from "../../stack/sim-cfn-deleted-stacks.js";
 import { SimCfnStackDescriber } from "./sim-cfn-stack-describer.js";
 interface DescribeStacksCommandHandlerProperties {
     readonly stacks: Map<SimCloudFormationStackName, SimCfnStack>;
+    readonly deleted: SimCfnDeletedStacks;
     readonly background?: BackgroundScheduler;
     readonly describer?: SimCfnStackDescriber;
 }
@@ -15,6 +17,7 @@ interface DescribeStacksCommandHandlerProperties {
  */
 export declare class DescribeStacksCommandHandler implements CommandHandler<SimDescribeStacksCommand, SimDescribeStacksCommandOutput> {
     private readonly stacks;
+    private readonly deleted;
     private readonly background;
     private readonly describer;
     constructor(properties: DescribeStacksCommandHandlerProperties);

package/dist/service/cloudformation/command/describe-stacks/describe-stacks.handler.js

@@ -8,11 +8,13 @@ import { SimCfnDescribedStacks } from "./sim-cfn-described-stacks.js";
  */
 export class DescribeStacksCommandHandler {
     stacks;
+    deleted;
     background;
     describer;
     constructor(properties) {
-        const { stacks, background = new BackgroundTasks(), describer = new SimCfnStackDescriber(), } = properties;
+        const { stacks, deleted, background = new BackgroundTasks(), describer = new SimCfnStackDescriber(), } = properties;
         this.stacks = stacks;
+        this.deleted = deleted;
         this.background = background;
         this.describer = describer;
     }
@@ -22,10 +24,12 @@ export class DescribeStacksCommandHandler {
     async handle(command) {
         // Allow for potential non-deterministic sequencing of async events.
         await this.background.sequence();
-        const stackName = command.input.StackName;
         return {
-            Stacks: new SimCfnDescribedStacks(this.stacks)
-                .matching(stackName)
+            Stacks: new SimCfnDescribedStacks({
+                stacks: this.stacks,
+                deleted: this.deleted,
+            })
+                .matching(command.input.StackName)
                 .map((stack) => this.describer.describe(stack)),
             $metadata: {},
         };

package/dist/service/cloudformation/command/describe-stacks/sim-cfn-described-stacks.d.ts

@@ -1,4 +1,9 @@
 import type { SimCfnStack, SimCloudFormationStackName } from "../../stack/sim-cfn-stack.js";
+import type { SimCfnDeletedStacks } from "../../stack/sim-cfn-deleted-stacks.js";
+interface SimCfnDescribedStacksProperties {
+    readonly stacks: ReadonlyMap<SimCloudFormationStackName, SimCfnStack>;
+    readonly deleted: SimCfnDeletedStacks;
+}
 /**
  * Chooses which Stacks a DescribeStacks request is about.
  *
@@ -11,15 +16,22 @@ import type { SimCfnStack, SimCloudFormationStackName } from "../../stack/sim-cf
  */
 export declare class SimCfnDescribedStacks {
     private readonly stacks;
-    constructor(stacks: ReadonlyMap<SimCloudFormationStackName, SimCfnStack>);
+    private readonly deleted;
+    constructor(properties: SimCfnDescribedStacksProperties);
     /**
      * The Stacks to describe for a request naming this Stack, or all of them if
      * it names none.
      *
-     * A named Stack that is not there is refused with the ValidationError
-     * CloudFormation answers with. A deleted Stack name reaches this too:
-     * CloudFormation only describes a deleted Stack by its unique Stack ID, and
-     * answers its name the same way as a name that never existed.
+     * `StackName` carries either a Stack name or a Stack ID, as it does in
+     * CloudFormation, and a Stack ID reaches a deleted Stack as well as a live
+     * one. A deleted Stack's name does not: the name is back in circulation, and
+     * is refused the same way as a name that never existed.
+     *
+     * An unnamed request answers with the live Stacks alone. CloudFormation
+     * leaves deleted Stacks out of it too.
      */
-    matching(stackName: SimCloudFormationStackName | undefined): SimCfnStack[];
+    matching(stackName: string | undefined): SimCfnStack[];
+    private find;
+    private withStackId;
 }
+export {};

package/dist/service/cloudformation/command/describe-stacks/sim-cfn-described-stacks.js

@@ -1,3 +1,4 @@
+import { isSimCfnStackId } from "../../stack/sim-cfn-stack-id.js";
 import { SimCloudFormationValidationError } from "../../error/sim-cloudformation.error.js";
 /**
  * Chooses which Stacks a DescribeStacks request is about.
@@ -11,26 +12,40 @@ import { SimCloudFormationValidationError } from "../../error/sim-cloudformation
  */
 export class SimCfnDescribedStacks {
     stacks;
-    constructor(stacks) {
-        this.stacks = stacks;
+    deleted;
+    constructor(properties) {
+        this.stacks = properties.stacks;
+        this.deleted = properties.deleted;
     }
     /**
      * The Stacks to describe for a request naming this Stack, or all of them if
      * it names none.
      *
-     * A named Stack that is not there is refused with the ValidationError
-     * CloudFormation answers with. A deleted Stack name reaches this too:
-     * CloudFormation only describes a deleted Stack by its unique Stack ID, and
-     * answers its name the same way as a name that never existed.
+     * `StackName` carries either a Stack name or a Stack ID, as it does in
+     * CloudFormation, and a Stack ID reaches a deleted Stack as well as a live
+     * one. A deleted Stack's name does not: the name is back in circulation, and
+     * is refused the same way as a name that never existed.
+     *
+     * An unnamed request answers with the live Stacks alone. CloudFormation
+     * leaves deleted Stacks out of it too.
      */
     matching(stackName) {
         if (stackName === undefined) {
             return this.stacks.values().toArray();
         }
-        const stack = this.stacks.get(stackName);
+        const stack = this.find(stackName);
         if (stack === undefined) {
             throw new SimCloudFormationValidationError(`Stack with id ${stackName} does not exist`);
         }
         return [stack];
     }
+    find(stackName) {
+        if (isSimCfnStackId(stackName)) {
+            return this.withStackId(stackName) ?? this.deleted.get(stackName);
+        }
+        return this.stacks.get(stackName);
+    }
+    withStackId(stackId) {
+        return this.stacks.values().find((stack) => stack.stackId === stackId);
+    }
 }

package/dist/service/cloudformation/command/describe-stacks/sim-cfn-stack-describer.js

@@ -18,7 +18,7 @@ export class SimCfnStackDescriber {
      */
     describe(stack) {
         return {
-            StackId: stack.stackName,
+            StackId: stack.stackId,
             StackName: stack.stackName,
             StackStatus: stack.status,
             StackStatusReason: stack.error?.message,

package/dist/service/cloudformation/command/execute-change-set/execute-change-set.command.d.ts

@@ -0,0 +1,25 @@
+import type { SimResponseMetadata } from "../../../aws/metadata/response-metadata.type.js";
+/**
+ * Minimal structural sim CloudFormation ExecuteChangeSet command.
+ */
+export interface SimExecuteChangeSetCommand {
+    readonly input: SimExecuteChangeSetCommandInput;
+}
+/**
+ * Minimal structural sim CloudFormation ExecuteChangeSet input.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudformation/command/ExecuteChangeSetCommand/
+ */
+export interface SimExecuteChangeSetCommandInput {
+    readonly ChangeSetName?: string | undefined;
+    readonly StackName?: string | undefined;
+}
+/**
+ * Minimal structural sim CloudFormation ExecuteChangeSet output.
+ *
+ * CloudFormation returns nothing beyond response metadata. The Stack is only
+ * starting to change when the call returns.
+ */
+export interface SimExecuteChangeSetCommandOutput {
+    readonly $metadata: SimResponseMetadata;
+}

package/dist/service/cloudformation/command/execute-change-set/execute-change-set.command.js

@@ -0,0 +1 @@
+export {};

package/dist/service/cloudformation/command/execute-change-set/execute-change-set.handler.d.ts

@@ -0,0 +1,31 @@
+import type { CommandHandler } from "../../../../command/command-handler.js";
+import type { BackgroundCompleter, BackgroundScheduler } from "../../../../util/background/background.js";
+import type { SimAwsCaller } from "../../../aws/caller/sim-aws-caller.js";
+import type { SimCfnStack } from "../../stack/sim-cfn-stack.js";
+import type { SimCloudFormationStackName } from "../../stack/sim-cfn-stack.type.js";
+import type { SimCfnChangeSets } from "../../changeset/sim-cfn-change-sets.js";
+import type { SimExecuteChangeSetCommand, SimExecuteChangeSetCommandOutput } from "./execute-change-set.command.js";
+interface ExecuteChangeSetCommandHandlerProperties {
+    readonly stacks: Map<SimCloudFormationStackName, SimCfnStack>;
+    readonly changeSets: SimCfnChangeSets;
+    readonly background: BackgroundScheduler & BackgroundCompleter;
+    readonly caller?: SimAwsCaller | undefined;
+}
+/**
+ * Simulated CloudFormation ExecuteChangeSetCommand handler.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudformation/command/ExecuteChangeSetCommand/
+ */
+export declare class ExecuteChangeSetCommandHandler implements CommandHandler<SimExecuteChangeSetCommand, SimExecuteChangeSetCommandOutput> {
+    private readonly properties;
+    constructor(properties: ExecuteChangeSetCommandHandlerProperties);
+    /**
+     * Apply what a change set describes to its Stack.
+     *
+     * The call returns once the Stack operation has started, as CreateStack and
+     * UpdateStack do. A caller that needs the result should follow this with
+     * waitForStackDeployComplete(...) or waitForStackUpdateComplete(...).
+     */
+    handle(command: SimExecuteChangeSetCommand): Promise<SimExecuteChangeSetCommandOutput>;
+}
+export {};

package/dist/service/cloudformation/command/execute-change-set/execute-change-set.handler.js

@@ -0,0 +1,37 @@
+import { assertDefined } from "../../../../util/type-guard/defined.js";
+import { simCfnChangeSetDeployedStack } from "../../changeset/sim-cfn-change-set-stack.js";
+import { runSimCfnChangeSet } from "../../changeset/sim-cfn-change-set-execution.js";
+/**
+ * Simulated CloudFormation ExecuteChangeSetCommand handler.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudformation/command/ExecuteChangeSetCommand/
+ */
+export class ExecuteChangeSetCommandHandler {
+    properties;
+    constructor(properties) {
+        this.properties = properties;
+    }
+    /**
+     * Apply what a change set describes to its Stack.
+     *
+     * The call returns once the Stack operation has started, as CreateStack and
+     * UpdateStack do. A caller that needs the result should follow this with
+     * waitForStackDeployComplete(...) or waitForStackUpdateComplete(...).
+     */
+    async handle(command) {
+        const { ChangeSetName, StackName } = command.input;
+        assertDefined(ChangeSetName, "ExecuteChangeSetCommand.input.ChangeSetName");
+        // Allow for potential non-deterministic sequencing of async events.
+        await this.properties.background.sequence();
+        const changeSet = this.properties.changeSets.requireExecutable({
+            changeSetName: ChangeSetName,
+            stackName: StackName,
+        });
+        await runSimCfnChangeSet({
+            ...this.properties,
+            changeSet,
+            stack: simCfnChangeSetDeployedStack(this.properties.stacks, changeSet),
+        });
+        return { $metadata: {} };
+    }
+}

package/dist/service/cloudformation/command/list-change-sets/list-change-sets.command.d.ts

@@ -0,0 +1,36 @@
+import type { SimResponseMetadata } from "../../../aws/metadata/response-metadata.type.js";
+import type { SimCfnChangeSetExecutionStatus, SimCfnChangeSetStatus } from "../../changeset/sim-cfn-change-set.type.js";
+/**
+ * Minimal structural sim CloudFormation ListChangeSets command.
+ */
+export interface SimListChangeSetsCommand {
+    readonly input: SimListChangeSetsCommandInput;
+}
+/**
+ * Minimal structural sim CloudFormation ListChangeSets input.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudformation/command/ListChangeSetsCommand/
+ */
+export interface SimListChangeSetsCommandInput {
+    readonly StackName?: string | undefined;
+}
+/**
+ * Minimal structural sim CloudFormation ListChangeSets output.
+ */
+export interface SimListChangeSetsCommandOutput {
+    readonly Summaries?: SimCfnChangeSetSummary[] | undefined;
+    readonly $metadata: SimResponseMetadata;
+}
+/**
+ * Minimal structural sim CloudFormation ChangeSetSummary.
+ */
+export interface SimCfnChangeSetSummary {
+    readonly ChangeSetId?: string | undefined;
+    readonly ChangeSetName?: string | undefined;
+    readonly StackId?: string | undefined;
+    readonly StackName?: string | undefined;
+    readonly Description?: string | undefined;
+    readonly Status?: SimCfnChangeSetStatus | undefined;
+    readonly StatusReason?: string | undefined;
+    readonly ExecutionStatus?: SimCfnChangeSetExecutionStatus | undefined;
+}

package/dist/service/cloudformation/command/list-change-sets/list-change-sets.command.js

@@ -0,0 +1 @@
+export {};

package/dist/service/cloudformation/command/list-change-sets/list-change-sets.handler.d.ts

@@ -0,0 +1,26 @@
+import type { CommandHandler } from "../../../../command/command-handler.js";
+import type { BackgroundScheduler } from "../../../../util/background/background.js";
+import type { SimCfnChangeSets } from "../../changeset/sim-cfn-change-sets.js";
+import type { SimListChangeSetsCommand, SimListChangeSetsCommandOutput } from "./list-change-sets.command.js";
+interface ListChangeSetsCommandHandlerProperties {
+    readonly changeSets: SimCfnChangeSets;
+    readonly background: BackgroundScheduler;
+}
+/**
+ * Simulated CloudFormation ListChangeSetsCommand handler.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudformation/command/ListChangeSetsCommand/
+ */
+export declare class ListChangeSetsCommandHandler implements CommandHandler<SimListChangeSetsCommand, SimListChangeSetsCommandOutput> {
+    private readonly changeSets;
+    private readonly background;
+    constructor(properties: ListChangeSetsCommandHandlerProperties);
+    /**
+     * List the change sets held against one Stack.
+     *
+     * A change set DeleteChangeSet has taken away is gone from here, as it is in
+     * CloudFormation.
+     */
+    handle(command: SimListChangeSetsCommand): Promise<SimListChangeSetsCommandOutput>;
+}
+export {};

package/dist/service/cloudformation/command/list-change-sets/list-change-sets.handler.js

@@ -0,0 +1,39 @@
+import { assertDefined } from "../../../../util/type-guard/defined.js";
+/**
+ * Simulated CloudFormation ListChangeSetsCommand handler.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudformation/command/ListChangeSetsCommand/
+ */
+export class ListChangeSetsCommandHandler {
+    changeSets;
+    background;
+    constructor(properties) {
+        this.changeSets = properties.changeSets;
+        this.background = properties.background;
+    }
+    /**
+     * List the change sets held against one Stack.
+     *
+     * A change set DeleteChangeSet has taken away is gone from here, as it is in
+     * CloudFormation.
+     */
+    async handle(command) {
+        assertDefined(command.input.StackName, "ListChangeSetsCommand.input.StackName");
+        // Allow for potential non-deterministic sequencing of async events.
+        await this.background.sequence();
+        const stackName = command.input.StackName;
+        return {
+            Summaries: this.changeSets.forStack(stackName).map((changeSet) => ({
+                ChangeSetId: changeSet.changeSetId,
+                ChangeSetName: changeSet.changeSetName,
+                StackId: changeSet.stackId,
+                StackName: changeSet.stackName,
+                Description: changeSet.description,
+                Status: changeSet.status,
+                StatusReason: changeSet.statusReason,
+                ExecutionStatus: changeSet.executionStatus,
+            })),
+            $metadata: {},
+        };
+    }
+}

package/dist/service/cloudformation/command/update-stack/update-stack-previous-values.d.ts

@@ -0,0 +1,31 @@
+import type { SimCfnParameters } from "../../parameters/sim-cfn-parameters.js";
+import type { SimCreateStackParameter } from "../create-stack/create-stack.command.js";
+import type { SimUpdateStackCommandInput } from "./update-stack.command.js";
+interface SimCfnUpdateStackParametersProperties {
+    readonly input: SimUpdateStackCommandInput;
+    /** The Parameters of the template the Stack is deployed from. */
+    readonly deployed: SimCfnParameters;
+}
+/**
+ * Refuse an update that says where its template comes from twice.
+ *
+ * `UsePreviousTemplate` reads the template off the Stack, so a body alongside
+ * it leaves nothing to say which one is being applied. CloudFormation refuses
+ * the pair rather than choosing, and so does this.
+ */
+export declare function assertSimCfnUpdateStackTemplateSource(input: SimUpdateStackCommandInput): void;
+/**
+ * The Parameter values an update is applying, with the previous ones filled in.
+ *
+ * An update names every Parameter its template declares, so one whose value has
+ * not changed is carried as `UsePreviousValue: true` rather than written out
+ * again. Each of those takes the value the Stack was deployed with. A Parameter
+ * the Stack was deployed without is left out, which takes the template Default
+ * again as the deployment did.
+ *
+ * A Parameter carrying `UsePreviousValue: true` and a `ParameterValue` is
+ * refused, for the same reason the template pair is: it says two things about
+ * one value.
+ */
+export declare function simCfnUpdateStackParameters(properties: SimCfnUpdateStackParametersProperties): readonly SimCreateStackParameter[] | undefined;
+export {};

package/dist/service/cloudformation/command/update-stack/update-stack-previous-values.js

@@ -0,0 +1,52 @@
+import { SimCloudFormationValidationError } from "../../error/sim-cloudformation.error.js";
+/**
+ * Refuse an update that says where its template comes from twice.
+ *
+ * `UsePreviousTemplate` reads the template off the Stack, so a body alongside
+ * it leaves nothing to say which one is being applied. CloudFormation refuses
+ * the pair rather than choosing, and so does this.
+ */
+export function assertSimCfnUpdateStackTemplateSource(input) {
+    if (input.UsePreviousTemplate === true && input.TemplateBody !== undefined) {
+        throw new SimCloudFormationValidationError("You cannot specify both TemplateBody and UsePreviousTemplate");
+    }
+}
+/**
+ * The Parameter values an update is applying, with the previous ones filled in.
+ *
+ * An update names every Parameter its template declares, so one whose value has
+ * not changed is carried as `UsePreviousValue: true` rather than written out
+ * again. Each of those takes the value the Stack was deployed with. A Parameter
+ * the Stack was deployed without is left out, which takes the template Default
+ * again as the deployment did.
+ *
+ * A Parameter carrying `UsePreviousValue: true` and a `ParameterValue` is
+ * refused, for the same reason the template pair is: it says two things about
+ * one value.
+ */
+export function simCfnUpdateStackParameters(properties) {
+    const { input, deployed } = properties;
+    if (input.Parameters === undefined) {
+        return undefined;
+    }
+    return input.Parameters.flatMap((parameter) => {
+        const { ParameterKey: key, ParameterValue: value } = parameter;
+        if (parameter.UsePreviousValue !== true) {
+            return [{ ParameterKey: key, ParameterValue: value }];
+        }
+        assertNoValueAlongsidePrevious(parameter);
+        const previous = key === undefined ? undefined : deployed.suppliedValue(key);
+        return previous === undefined
+            ? []
+            : [{ ParameterKey: key, ParameterValue: previous }];
+    });
+}
+function assertNoValueAlongsidePrevious(parameter) {
+    // An empty string is no value, which is what an SDK writes for a Parameter
+    // carrying UsePreviousValue and nothing else.
+    if (parameter.ParameterValue === undefined ||
+        parameter.ParameterValue === "") {
+        return;
+    }
+    throw new SimCloudFormationValidationError(`Invalid input for parameter key ${parameter.ParameterKey ?? "unknown"}. Cannot specify usePreviousValue as true and non empty value for a parameter.`);
+}