@kensio/yulin 1.6.0 → 1.7.0

package/dist/service/cloudformation/stack/report/sim-cfn-stack-resource-report.js

@@ -0,0 +1,49 @@
+/**
+ * What a Stack's Resources say happened to them.
+ *
+ * Everything here is read off the Resources rather than collected while the
+ * Stack ran, so the Stack and its Resources cannot disagree, and a Stack whose
+ * Resources changed under an update reports the Resources it holds now.
+ *
+ * It does not create, delete, or order Resources.
+ */
+export class SimCfnStackResourceReport {
+    resources;
+    constructor(resources) {
+        this.resources = resources;
+    }
+    /**
+     * Resources that were skipped because their sim implementation is not yet
+     * available.
+     */
+    get skipped() {
+        return this.matching((resource) => resource.skipped);
+    }
+    /**
+     * Resources a teardown recorded rather than deleted, because sim
+     * CloudFormation has no way to delete their Resource type.
+     */
+    get deletionSkipped() {
+        return this.matching((resource) => resource.deletionSkipped);
+    }
+    /**
+     * Resources a teardown left in simulated AWS because their DeletionPolicy
+     * says to keep them.
+     */
+    get retained() {
+        return this.matching((resource) => resource.retained);
+    }
+    /**
+     * Every property a Resource was created without acting on.
+     */
+    get ignoredProperties() {
+        return this.resources
+            .values()
+            .flatMap((resource) => resource.ignoredProperties)
+            .toArray();
+    }
+    matching(predicate) {
+        return this.resources.values().filter(predicate).toArray();
+    }
+}
+//# sourceMappingURL=sim-cfn-stack-resource-report.js.map

package/dist/service/cloudformation/stack/report/sim-cfn-stack-resource-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cfn-stack-resource-report.js","sourceRoot":"","sources":["../../../../../src/service/cloudformation/stack/report/sim-cfn-stack-resource-report.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,OAAO,yBAAyB;IACnB,SAAS,CAAsC;IAEhE,YAAY,SAA8C;QACxD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;IAED;;;OAGG;IACH,IAAW,eAAe;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAC/D,CAAC;IAED;;;OAGG;IACH,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,IAAW,iBAAiB;QAC1B,OAAO,IAAI,CAAC,SAAS;aAClB,MAAM,EAAE;aACR,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;aACjD,OAAO,EAAE,CAAC;IACf,CAAC;IAEO,QAAQ,CACd,SAAgD;QAEhD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IAC7D,CAAC;CACF"}

package/dist/service/cloudformation/stack/sim-cfn-stack-operation-scheduler.d.ts

@@ -0,0 +1,47 @@
+import type { BackgroundScheduler } from "../../../util/background/background.js";
+interface SimCfnStackOperationSchedulerProperties {
+    readonly background: BackgroundScheduler;
+    readonly failureMessage: string;
+}
+interface ScheduleOperationProperties {
+    readonly operation: () => Promise<void>;
+    readonly onSuccess: () => void;
+    readonly onFailure: (error: Error) => void;
+}
+/**
+ * Coordinates when a whole-Stack operation runs on the background scheduler.
+ *
+ * Stack deployment and Stack deletion both start quickly and finish later, so
+ * both are scheduled the same way. This class does not create or delete
+ * CloudFormation Resources, resolve Resource dependencies, or update Stack
+ * lifecycle state. SimCfnStackResourceCreator and SimCfnStackResourceDeleter
+ * own dependency-ordered Resource work, while the deployment and deletion
+ * lifecycles own Stack status, completion tracking, and captured errors.
+ *
+ * This scheduler only wraps an operation with background scheduling, completion
+ * notification callbacks, and consistent non-Error conversion.
+ */
+export declare class SimCfnStackOperationScheduler {
+    private readonly background;
+    private readonly failureMessage;
+    constructor(properties: SimCfnStackOperationSchedulerProperties);
+    /**
+     * Wait for already-scheduled background work before starting this operation.
+     *
+     * A simulated Stack operation should begin only after previously queued
+     * background tasks have had a chance to run, matching the broader simulator's
+     * deterministic sequencing model.
+     */
+    sequence(): Promise<void>;
+    /**
+     * Schedule the supplied operation and return a promise for its completion.
+     *
+     * The supplied `operation` callback performs the actual Stack work. This
+     * scheduler only decides when that callback runs, then reports the outcome
+     * via onSuccess or onFailure so the Stack can update its own status.
+     */
+    schedule(properties: ScheduleOperationProperties): Promise<void>;
+    private operationError;
+}
+export {};
+//# sourceMappingURL=sim-cfn-stack-operation-scheduler.d.ts.map

package/dist/service/cloudformation/stack/sim-cfn-stack-operation-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cfn-stack-operation-scheduler.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudformation/stack/sim-cfn-stack-operation-scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAElF,UAAU,uCAAuC;IAC/C,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,UAAU,2BAA2B;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC5C;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,6BAA6B;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,YAAY,UAAU,EAAE,uCAAuC,EAK9D;IAED;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9B;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CAe/D;IAED,OAAO,CAAC,cAAc;CAQvB"}

package/dist/service/cloudformation/stack/sim-cfn-stack-operation-scheduler.js

@@ -0,0 +1,64 @@
+/**
+ * Coordinates when a whole-Stack operation runs on the background scheduler.
+ *
+ * Stack deployment and Stack deletion both start quickly and finish later, so
+ * both are scheduled the same way. This class does not create or delete
+ * CloudFormation Resources, resolve Resource dependencies, or update Stack
+ * lifecycle state. SimCfnStackResourceCreator and SimCfnStackResourceDeleter
+ * own dependency-ordered Resource work, while the deployment and deletion
+ * lifecycles own Stack status, completion tracking, and captured errors.
+ *
+ * This scheduler only wraps an operation with background scheduling, completion
+ * notification callbacks, and consistent non-Error conversion.
+ */
+export class SimCfnStackOperationScheduler {
+    background;
+    failureMessage;
+    constructor(properties) {
+        const { background, failureMessage } = properties;
+        this.background = background;
+        this.failureMessage = failureMessage;
+    }
+    /**
+     * Wait for already-scheduled background work before starting this operation.
+     *
+     * A simulated Stack operation should begin only after previously queued
+     * background tasks have had a chance to run, matching the broader simulator's
+     * deterministic sequencing model.
+     */
+    async sequence() {
+        await this.background.sequence();
+    }
+    /**
+     * Schedule the supplied operation and return a promise for its completion.
+     *
+     * The supplied `operation` callback performs the actual Stack work. This
+     * scheduler only decides when that callback runs, then reports the outcome
+     * via onSuccess or onFailure so the Stack can update its own status.
+     */
+    schedule(properties) {
+        const { operation, onSuccess, onFailure } = properties;
+        return new Promise((resolve) => {
+            this.background.schedule(async () => {
+                try {
+                    await operation();
+                    onSuccess();
+                }
+                catch (error) {
+                    onFailure(this.operationError(error));
+                }
+                finally {
+                    resolve();
+                }
+            });
+        });
+    }
+    operationError(error) {
+        if (error instanceof Error) {
+            return error;
+        }
+        /* v8 ignore next -- redundant fallback */
+        return new Error(`${this.failureMessage}: ${String(error)}`);
+    }
+}
+//# sourceMappingURL=sim-cfn-stack-operation-scheduler.js.map

package/dist/service/cloudformation/stack/sim-cfn-stack-operation-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cfn-stack-operation-scheduler.js","sourceRoot":"","sources":["../../../../src/service/cloudformation/stack/sim-cfn-stack-operation-scheduler.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,6BAA6B;IACvB,UAAU,CAAsB;IAChC,cAAc,CAAS;IAExC,YAAY,UAAmD;QAC7D,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,UAAU,CAAC;QAElD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;IACnC,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,UAAuC;QAC9C,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC;QAEvD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;gBAClC,IAAI,CAAC;oBACH,MAAM,SAAS,EAAE,CAAC;oBAClB,SAAS,EAAE,CAAC;gBACd,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;gBACxC,CAAC;wBAAS,CAAC;oBACT,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,cAAc,CAAC,KAAc;QACnC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,0CAA0C;QAC1C,OAAO,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,cAAc,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/dist/service/cloudformation/stack/sim-cfn-stack-resource-operations.d.ts

@@ -0,0 +1,78 @@
+import type { BackgroundScheduler } from "../../../util/background/background.js";
+import type { SimAws } from "../../aws/sim-aws.js";
+import type { SimAwsAccountRegionScope } from "../../aws/sim-aws-account-region-scope.js";
+import type { SimCfnExecutableResourceBinding } from "../bind/sim-cfn-exec-binding.type.js";
+import type { SimCdkOutContext } from "../cdk/sim-cdk-out-context.js";
+import type { SimCfnResource } from "../resource/sim-cfn-resource.js";
+import type { SimCfnTemplate } from "../template/sim-cfn-template.js";
+import { SimCfnStackUpdater } from "./update/sim-cfn-stack-updater.js";
+import type { SimCloudFormationStackName } from "./sim-cfn-stack.js";
+interface SimCfnStackUpdateProperties {
+    readonly background: BackgroundScheduler;
+    readonly resources: Map<string, SimCfnResource>;
+    readonly current: SimCfnTemplate;
+    readonly updated: SimCfnTemplate;
+}
+interface SimCfnStackResourceOperationsProperties {
+    readonly simAws: SimAws;
+    readonly accountRegionScope: SimAwsAccountRegionScope;
+    readonly stackName: SimCloudFormationStackName;
+    readonly cdkOutContext?: SimCdkOutContext | undefined;
+    readonly bindings?: readonly SimCfnExecutableResourceBinding[] | undefined;
+}
+/**
+ * What a Stack can ask simulated AWS to do with its Resources.
+ *
+ * Deploying, updating and tearing down all create or delete Resources against
+ * the same simulated AWS, in the same Stack scope, so the scope is held here
+ * once rather than assembled at each of them. Creating also publishes the CDK
+ * cloud assembly assets first, as a real `cdk deploy` publishes them before
+ * CloudFormation processes the template that references them.
+ *
+ * It does not own Stack status or decide what an update changes.
+ * SimCfnStackResourceCreator and SimCfnStackResourceDeleter own the dependency
+ * ordering of the work itself.
+ */
+export declare class SimCfnStackResourceOperations {
+    private readonly simAws;
+    private readonly accountRegionScope;
+    private readonly stackName;
+    private readonly bindings;
+    private cdkOutContext;
+    constructor(properties: SimCfnStackResourceOperationsProperties);
+    /**
+     * Read Resources from a different CDK cloud assembly from now on.
+     *
+     * A synthesis writes the template and the assets manifest beside it together,
+     * so a Stack updated from a re-synthesized template needs the manifest that
+     * came with it. Keeping the one the Stack was deployed from would look up the
+     * asset a replaced Resource names in a manifest written before it existed.
+     */
+    useCdkOutContext(cdkOutContext: SimCdkOutContext): void;
+    /**
+     * Create every Resource in the given Stack Resource map.
+     */
+    createAll(resources: ReadonlyMap<string, SimCfnResource>): Promise<void>;
+    /**
+     * Create the given Resources, in dependency order among the whole Stack.
+     */
+    create(resources: ReadonlyMap<string, SimCfnResource>, creating: readonly SimCfnResource[]): Promise<void>;
+    /**
+     * Delete every Resource in the given Stack Resource map.
+     */
+    deleteAll(resources: ReadonlyMap<string, SimCfnResource>): Promise<void>;
+    /**
+     * Delete the given Resources, in reverse dependency order among the whole
+     * Stack.
+     */
+    delete(resources: ReadonlyMap<string, SimCfnResource>, deleting: readonly SimCfnResource[]): Promise<void>;
+    /**
+     * An update of this Stack from a changed template, in the same scope.
+     */
+    updater(properties: SimCfnStackUpdateProperties): SimCfnStackUpdater;
+    private publishAssets;
+    private creator;
+    private deleter;
+}
+export {};
+//# sourceMappingURL=sim-cfn-stack-resource-operations.d.ts.map

package/dist/service/cloudformation/stack/sim-cfn-stack-resource-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cfn-stack-resource-operations.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudformation/stack/sim-cfn-stack-resource-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AAC5F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAErE,UAAU,2BAA2B;IACnC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CAClC;AAED,UAAU,uCAAuC;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC;IAC/C,QAAQ,CAAC,aAAa,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,+BAA+B,EAAE,GAAG,SAAS,CAAC;CAC5E;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,6BAA6B;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA2B;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CACgC;IACzD,OAAO,CAAC,aAAa,CAA+B;IAEpD,YAAY,UAAU,EAAE,uCAAuC,EAS9D;IAED;;;;;;;OAOG;IACH,gBAAgB,CAAC,aAAa,EAAE,gBAAgB,GAAG,IAAI,CAEtD;IAED;;OAEG;IACG,SAAS,CACb,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,GAC7C,OAAO,CAAC,IAAI,CAAC,CAGf;IAED;;OAEG;IACG,MAAM,CACV,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,EAC9C,QAAQ,EAAE,SAAS,cAAc,EAAE,GAClC,OAAO,CAAC,IAAI,CAAC,CAGf;IAED;;OAEG;IACG,SAAS,CACb,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,GAC7C,OAAO,CAAC,IAAI,CAAC,CAEf;IAED;;;OAGG;IACG,MAAM,CACV,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,EAC9C,QAAQ,EAAE,SAAS,cAAc,EAAE,GAClC,OAAO,CAAC,IAAI,CAAC,CAEf;IAED;;OAEG;IACH,OAAO,CAAC,UAAU,EAAE,2BAA2B,GAAG,kBAAkB,CAWnE;YAEa,aAAa;IAS3B,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,OAAO;CAShB"}

package/dist/service/cloudformation/stack/sim-cfn-stack-resource-operations.js

@@ -0,0 +1,109 @@
+import { SimCdkAssetsPublisher } from "../cdk/assets/sim-cdk-assets-publisher.js";
+import { SimCfnStackResourceCreator } from "./deploy/sim-cfn-stack-resource-creator.js";
+import { SimCfnStackResourceDeleter } from "./teardown/sim-cfn-stack-resource-deleter.js";
+import { SimCfnStackUpdater } from "./update/sim-cfn-stack-updater.js";
+/**
+ * What a Stack can ask simulated AWS to do with its Resources.
+ *
+ * Deploying, updating and tearing down all create or delete Resources against
+ * the same simulated AWS, in the same Stack scope, so the scope is held here
+ * once rather than assembled at each of them. Creating also publishes the CDK
+ * cloud assembly assets first, as a real `cdk deploy` publishes them before
+ * CloudFormation processes the template that references them.
+ *
+ * It does not own Stack status or decide what an update changes.
+ * SimCfnStackResourceCreator and SimCfnStackResourceDeleter own the dependency
+ * ordering of the work itself.
+ */
+export class SimCfnStackResourceOperations {
+    simAws;
+    accountRegionScope;
+    stackName;
+    bindings;
+    cdkOutContext;
+    constructor(properties) {
+        const { simAws, accountRegionScope, stackName, cdkOutContext, bindings } = properties;
+        this.simAws = simAws;
+        this.accountRegionScope = accountRegionScope;
+        this.stackName = stackName;
+        this.cdkOutContext = cdkOutContext;
+        this.bindings = bindings;
+    }
+    /**
+     * Read Resources from a different CDK cloud assembly from now on.
+     *
+     * A synthesis writes the template and the assets manifest beside it together,
+     * so a Stack updated from a re-synthesized template needs the manifest that
+     * came with it. Keeping the one the Stack was deployed from would look up the
+     * asset a replaced Resource names in a manifest written before it existed.
+     */
+    useCdkOutContext(cdkOutContext) {
+        this.cdkOutContext = cdkOutContext;
+    }
+    /**
+     * Create every Resource in the given Stack Resource map.
+     */
+    async createAll(resources) {
+        await this.publishAssets();
+        await this.creator(resources).createAll();
+    }
+    /**
+     * Create the given Resources, in dependency order among the whole Stack.
+     */
+    async create(resources, creating) {
+        await this.publishAssets();
+        await this.creator(resources).create(creating);
+    }
+    /**
+     * Delete every Resource in the given Stack Resource map.
+     */
+    async deleteAll(resources) {
+        await this.deleter(resources).deleteAll();
+    }
+    /**
+     * Delete the given Resources, in reverse dependency order among the whole
+     * Stack.
+     */
+    async delete(resources, deleting) {
+        await this.deleter(resources).delete(deleting);
+    }
+    /**
+     * An update of this Stack from a changed template, in the same scope.
+     */
+    updater(properties) {
+        const { background, resources, current, updated } = properties;
+        return new SimCfnStackUpdater({
+            accountRegionScope: this.accountRegionScope,
+            operations: this,
+            background,
+            resources,
+            current,
+            updated,
+        });
+    }
+    async publishAssets() {
+        await new SimCdkAssetsPublisher({
+            simAws: this.simAws,
+            accountRegionScope: this.accountRegionScope,
+            stackName: this.stackName,
+            cdkOutContext: this.cdkOutContext,
+        }).publish();
+    }
+    creator(resources) {
+        return new SimCfnStackResourceCreator({
+            simAws: this.simAws,
+            resources,
+            stackName: this.stackName,
+            cdkOutContext: this.cdkOutContext,
+            bindings: this.bindings,
+        });
+    }
+    deleter(resources) {
+        return new SimCfnStackResourceDeleter({
+            simAws: this.simAws,
+            resources,
+            stackName: this.stackName,
+        });
+    }
+}
+//# sourceMappingURL=sim-cfn-stack-resource-operations.js.map

package/dist/service/cloudformation/stack/sim-cfn-stack-resource-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cfn-stack-resource-operations.js","sourceRoot":"","sources":["../../../../src/service/cloudformation/stack/sim-cfn-stack-resource-operations.ts"],"names":[],"mappings":"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"}

package/dist/service/cloudformation/stack/sim-cfn-stack.d.ts

@@ -5,12 +5,23 @@ import type { SimAwsAccountRegionScope } from "../../aws/sim-aws-account-region-
 import type { SimCfnResource } from "../resource/sim-cfn-resource.js";
 import type { SimCfnIgnoredProperty } from "../resource/ignore/sim-cfn-ignored-property.type.js";
 import type { CfnTemplateBodyRecord, SimCfnTemplate } from "../template/sim-cfn-template.js";
+import { SimCfnStackDeletionLifecycle, type SimCfnStackDeleteProperties } from "./teardown/sim-cfn-stack-deletion-lifecycle.js";
 import { SimCfnStackDeploymentLifecycle } from "./deploy/sim-cfn-stack-deployment-lifecycle.js";
+import { SimCfnStackUpdateLifecycle } from "./update/sim-cfn-stack-update-lifecycle.js";
 import type { SimCdkOutContext } from "../cdk/sim-cdk-out-context.js";
 import type { SimCfnExecutableResourceBinding } from "../bind/sim-cfn-exec-binding.type.js";
 import type { SimCfnStackOutput } from "./output/sim-cfn-stack-output.js";
 export type SimCloudFormationStackName = Brand<string, "SimCloudFormationStackName">;
-export type SimCloudFormationStackStatus = "REVIEW_IN_PROGRESS" | "CREATE_IN_PROGRESS" | "CREATE_COMPLETE" | "CREATE_FAILED";
+export type SimCloudFormationStackStatus = "REVIEW_IN_PROGRESS" | "CREATE_IN_PROGRESS" | "CREATE_COMPLETE" | "CREATE_FAILED" | "UPDATE_IN_PROGRESS" | "UPDATE_COMPLETE" | "UPDATE_FAILED" | "DELETE_IN_PROGRESS" | "DELETE_COMPLETE" | "DELETE_FAILED";
+export interface SimCfnStackUpdateProperties {
+    /**
+     * The CDK cloud assembly the new template was synthesized into, when it came
+     * from a template file that has been synthesized again. The Stack reads
+     * assets from it from then on, since the manifest it was deployed with
+     * describes the assembly the previous template came from.
+     */
+    readonly cdkOutContext?: SimCdkOutContext | undefined;
+}
 interface SimCloudFormationStackProperties {
     readonly simAws: SimAws;
     readonly accountRegionScope: SimAwsAccountRegionScope;
@@ -24,28 +35,34 @@ interface SimCloudFormationStackProperties {
  * Lightweight simulated CloudFormation Stack.
  *
  * This class owns the externally visible Stack lifecycle: identity, template
- * body, resources, deployment status, deployment error, and wait-for-completion
- * behavior. It delegates lower-level deployment mechanics to smaller
- * collaborators:
+ * body, resources, status, error, and wait-for-completion behavior for
+ * deploying, updating and deleting. It delegates the mechanics of each to
+ * smaller collaborators:
  *
  * - makeSimCfnStackResourceMap converts the template into runtime resources.
- * - SimCfnStackDeploymentScheduler controls when deployment runs in the
- *   background.
- * - SimCfnStackResourceCreator creates resources in dependency order.
+ * - A lifecycle per Stack operation owns that operation's status and
+ *   completion, and SimCfnStackOperationScheduler decides when each runs.
+ * - SimCfnStackResourceOperations creates and deletes resources against
+ *   simulated AWS, and SimCfnStackUpdater does some of each at once against a
+ *   changed template.
  */
 export declare class SimCfnStack {
     readonly lifecycle: SimCfnStackDeploymentLifecycle;
+    readonly updating: SimCfnStackUpdateLifecycle;
+    readonly deletion: SimCfnStackDeletionLifecycle;
     readonly stackName: SimCloudFormationStackName;
-    readonly template: CfnTemplateBodyRecord;
     readonly resources: Map<string, SimCfnResource>;
+    template: CfnTemplateBodyRecord;
     outputs: Map<string, SimCfnStackOutput>;
-    private readonly simAws;
-    private readonly accountRegionScope;
-    private readonly cfnTemplate;
-    private readonly cdkOutContext;
-    private readonly bindings;
-    private readonly skippedResourceList;
+    private readonly background;
+    private readonly operations;
+    private readonly operationStatus;
+    private cfnTemplate;
     constructor(properties: SimCloudFormationStackProperties);
+    /** The externally visible Stack status. */
+    get status(): SimCloudFormationStackStatus;
+    /** The error the operation the status reports failed with, if it failed. */
+    get error(): Error | undefined;
     /**
      * Start deploying this simulated Stack into simulated AWS.
      */
@@ -55,30 +72,59 @@ export declare class SimCfnStack {
      */
     waitForDeployComplete(): Promise<void>;
     /**
-     * Get a Stack Resource by logical ID.
+     * Apply a changed template to this deployed Stack.
+     *
+     * The Resources the new template adds are created, the ones it drops are
+     * deleted, and the ones whose resolved template changed are replaced.
+     * Everything else is left alone, holding whatever it holds in simulated AWS.
+     *
+     * An update that would do nothing, and one asked for while another is still
+     * running, are both refused the way CloudFormation refuses them, before the
+     * Stack's template moves on. The Resource work is scheduled in the
+     * background, as a deployment is, so callers that need the final state should
+     * use waitForUpdateComplete().
+     *
+     * A template that came from a synthesis of its own brings the cloud assembly
+     * it was written into with it, so Resources it replaces read the assets that
+     * synthesis staged rather than the ones the Stack was deployed with.
      */
-    getResource(logicalId: string): SimCfnResource | undefined;
+    update(template: SimCfnTemplate, properties?: SimCfnStackUpdateProperties): Promise<void>;
     /**
-     * Resources that were skipped because their sim implementation is not yet
-     * available.
+     * Wait for the scheduled Stack update to finish.
      */
-    get skippedResources(): readonly SimCfnResource[];
+    waitForUpdateComplete(): Promise<void>;
     /**
-     * Every property the deployment created a Resource without acting on.
+     * Start deleting this Stack from simulated AWS.
      *
-     * Read from the Resources rather than collected during deployment, so a
-     * Resource created outside a stack deployment still reports its own, and the
-     * two never disagree.
+     * Deletion is scheduled in the background, as deployment is, so this returns
+     * before the Resources have gone. The optional onDeleteComplete callback runs
+     * once the teardown has finished successfully, which is when the Stack name
+     * becomes free to use again.
      */
-    get ignoredProperties(): readonly SimCfnIgnoredProperty[];
+    delete(properties?: SimCfnStackDeleteProperties): Promise<void>;
+    /**
+     * Wait for the scheduled Stack deletion to finish.
+     */
+    waitForDeleteComplete(): Promise<void>;
     /**
-     * Delegate resource dependency ordering and creation to the resource
-     * creator.
+     * Delete this Stack's Resources from simulated AWS, in reverse dependency
+     * order.
      *
-     * CDK cloud assembly assets are published into sim S3 first, as a real
-     * `cdk deploy` publishes them before CloudFormation processes the template
-     * that references them.
+     * The Resource half of deleting a Stack, without the Stack-level status or
+     * the Stack name release that delete() puts on top of it.
      */
+    teardown(): Promise<void>;
+    /** Get a Stack Resource by logical ID. */
+    getResource(logicalId: string): SimCfnResource | undefined;
+    /** Resources skipped because their sim implementation is not available. */
+    get skippedResources(): readonly SimCfnResource[];
+    /** Resources a teardown recorded rather than deleted. */
+    get skippedResourceDeletions(): readonly SimCfnResource[];
+    /** Resources a teardown left in simulated AWS, as their policy says to. */
+    get retainedResources(): readonly SimCfnResource[];
+    /** Every property a Resource was created without acting on. */
+    get ignoredProperties(): readonly SimCfnIgnoredProperty[];
+    private get report();
     private createResources;
     private resolveOutputs;
 }

package/dist/service/cloudformation/stack/sim-cfn-stack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sim-cfn-stack.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudformation/stack/sim-cfn-stack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAC;AACjG,OAAO,KAAK,EACV,qBAAqB,EACrB,cAAc,EACf,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAE,8BAA8B,EAAE,MAAM,gDAAgD,CAAC;AAChG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AAC5F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAI1E,MAAM,MAAM,0BAA0B,GAAG,KAAK,CAC5C,MAAM,EACN,4BAA4B,CAC7B,CAAC;AAEF,MAAM,MAAM,4BAA4B,GACpC,oBAAoB,GACpB,oBAAoB,GACpB,iBAAiB,GACjB,eAAe,CAAC;AAEpB,UAAU,gCAAgC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,CAAC;IACtD,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,+BAA+B,EAAE,GAAG,SAAS,CAAC;CAC5E;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAW;IACtB,SAAgB,SAAS,EAAE,8BAA8B,CAAC;IAC1D,SAAgB,SAAS,EAAE,0BAA0B,CAAC;IACtD,SAAgB,QAAQ,EAAE,qBAAqB,CAAC;IAChD,SAAgB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAChD,OAAO,iCAAwC;IAEtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA2B;IAC9D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiB;IAC7C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA+B;IAC7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CACgC;IACzD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAwB;IAE5D,YAAY,UAAU,EAAE,gCAAgC,EAmCvD;IAED;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAE5B;IAED;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3C;IAED;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEzD;IAED;;;OAGG;IACH,IAAW,gBAAgB,IAAI,SAAS,cAAc,EAAE,CAEvD;IAED;;;;;;OAMG;IACH,IAAW,iBAAiB,IAAI,SAAS,qBAAqB,EAAE,CAK/D;IAED;;;;;;;OAOG;YACW,eAAe;IAqB7B,OAAO,CAAC,cAAc;CAOvB"}
+{"version":3,"file":"sim-cfn-stack.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudformation/stack/sim-cfn-stack.ts"],"names":[],"mappings":"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"}