@kensio/yulin 1.5.0 → 1.6.1

package/dist/service/cloudformation/resource/sim-cfn-resource-record.js

@@ -0,0 +1,145 @@
+import { SimCfnIgnoredProperties } from "./ignore/sim-cfn-ignored-properties.js";
+import { SimCfnResourceTemplateReader } from "./template/sim-cfn-resource-template-reader.js";
+import { SimCfnResourcePropertyResolver } from "./resolve/property/sim-cfn-resource-property-resolver.js";
+import { simCfnResourceValueAdapter, } from "./cfn/sim-cfn-resource-value-adapter.js";
+import { simAwsAccountRegionScopeFactory } from "../../aws/sim-aws-account-region-scope.factory.js";
+/**
+ * What one CloudFormation Resource entry is, apart from what has happened to
+ * it.
+ *
+ * This half of `SimCfnResource` is fixed when the Stack reads its
+ * template: which Resource this is, what the template says about it, which
+ * other Resources it names, and how it answers Ref and Fn::GetAtt. None of it
+ * changes as the Stack deploys or tears down.
+ *
+ * The lifecycle half lives on SimCfnResource, which extends this. Keeping the
+ * two apart is what lets the record stay readable while creation and deletion
+ * each carry a full set of states, and it puts the Resource's identity where a
+ * service factory can read it without seeing lifecycle controls it should not
+ * be calling.
+ */
+export class SimCfnResourceRecord {
+    accountRegionScope;
+    logicalId;
+    /** The Stack this Resource belongs to, where a generated name comes from. */
+    stackName;
+    template;
+    ignoredPropertyList = new SimCfnIgnoredProperties();
+    resourceTemplateReader;
+    propertyResolver;
+    resourceLogicalIds;
+    constructor(properties = {}) {
+        const { accountRegionScope = simAwsAccountRegionScopeFactory.make(), logicalId = "Resource", stackName, template = {}, parameters, resourceLogicalIds = new Set(), } = properties;
+        this.accountRegionScope = accountRegionScope;
+        this.logicalId = logicalId;
+        this.stackName = stackName;
+        this.template = template;
+        this.resourceTemplateReader = new SimCfnResourceTemplateReader(template);
+        this.propertyResolver = new SimCfnResourcePropertyResolver({ parameters });
+        this.resourceLogicalIds = resourceLogicalIds;
+    }
+    /**
+     * The properties this Resource was created without acting on.
+     */
+    get ignoredProperties() {
+        return this.ignoredPropertyList.all;
+    }
+    /**
+     * The CloudFormation Resource type from the Resource template.
+     *
+     * E.g. AWS::S3::Bucket
+     */
+    get type() {
+        return this.resourceTemplateReader.type();
+    }
+    /**
+     * The CloudFormation Resource properties object from the Resource template.
+     *
+     * Missing or non-object Properties are treated as an empty object by the
+     * Resource template reader.
+     */
+    get properties() {
+        return this.resourceTemplateReader.properties();
+    }
+    /**
+     * The DeletionPolicy attribute from the Resource template, if it has one.
+     */
+    get deletionPolicy() {
+        return this.resourceTemplateReader.deletionPolicy();
+    }
+    /**
+     * Whether a Stack teardown should leave this Resource where it is.
+     *
+     * RetainExceptOnCreate differs from Retain only in what a rolled back
+     * creation does, and sim CloudFormation does not roll a deployment back, so
+     * the two are the same thing here.
+     */
+    get retainedOnDelete() {
+        return (this.deletionPolicy === "Retain" ||
+            this.deletionPolicy === "RetainExceptOnCreate");
+    }
+    /**
+     * The value returned when this Resource is referenced via { "Ref": logicalId }.
+     *
+     * Mirroring CloudFormation, Resource Ref behavior is Resource-type specific.
+     * CloudFormation-specific value behavior is delegated to a Resource adapter so
+     * simulated service objects do not need to know about CloudFormation.
+     */
+    get refValue() {
+        return this.cfnValueAdapter().refValue();
+    }
+    /**
+     * Record that this Resource is being created without acting on a property.
+     * Called by the service parsing this Resource's properties, which is the
+     * only thing that knows whether a property changes behaviour it simulates.
+     */
+    ignoreProperty(path, reason) {
+        this.ignoredPropertyList.record(this, path, reason);
+    }
+    /**
+     * The value returned when this Resource is referenced via Fn::GetAtt.
+     *
+     * Mirroring CloudFormation, Resource attributes are Resource-type specific.
+     * CloudFormation-specific value behavior is delegated to a Resource adapter so
+     * simulated service objects do not need to know about CloudFormation.
+     */
+    attributeValue(attributeName) {
+        return this.cfnValueAdapter().attributeValue(attributeName);
+    }
+    /**
+     * Logical IDs of Resources that must complete before this Resource can
+     * create.
+     *
+     * Includes both explicit DependsOn entries and implicit dependencies from Ref
+     * expressions that target other Resources.
+     */
+    dependencies() {
+        return this.resourceTemplateReader.dependencies(this.resourceLogicalIds);
+    }
+    /**
+     * Resolve this Resource's Properties, including Refs to other Resources.
+     *
+     * Called by the creation operation once every dependency has reached
+     * CREATE_COMPLETE, and by the deletion operation while everything this
+     * Resource names is still there, so referenced Resources have valid Ref
+     * values either way.
+     */
+    resolvedProperties(context) {
+        return this.propertyResolver.resolve(this.properties, context);
+    }
+    /**
+     * Forget the properties recorded as ignored, for a Resource being created
+     * again.
+     */
+    clearIgnoredProperties() {
+        this.ignoredPropertyList.clear();
+    }
+    cfnValueAdapter() {
+        return simCfnResourceValueAdapter({
+            logicalId: this.logicalId,
+            type: this.type,
+            simResource: this.simResource,
+        });
+    }
+}
+//# sourceMappingURL=sim-cfn-resource-record.js.map

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

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

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

@@ -1,67 +1,36 @@
-import type { SimAws } from "../../aws/sim-aws.js";
-import type { SimAwsAccountRegionScope } from "../../aws/sim-aws-account-region-scope.js";
-import { type BackgroundScheduler } from "../../../util/background/background.js";
-import type { SimCfnServiceResourceFactory } from "./factory/sim-cfn-resource-factory.type.js";
-import type { SimCfnTemplateValue, SimCfnTemplateValueRecord } from "../template/value/sim-cfn-template-value.js";
-import type { SimCfnParameters } from "../parameters/sim-cfn-parameters.js";
-import type { SimCdkOutContext } from "../cdk/sim-cdk-out-context.js";
-import type { SimCfnExecutableResourceBinding } from "../bind/sim-cfn-exec-binding.type.js";
-export interface SimCloudFormationResourceProperties {
-    readonly accountRegionScope?: SimAwsAccountRegionScope;
-    readonly background?: BackgroundScheduler;
-    readonly logicalId?: string;
-    readonly stackName?: string | undefined;
-    readonly template?: SimCfnTemplateValueRecord;
-    readonly cfnResourceFactory?: SimCfnServiceResourceFactory | undefined;
-    readonly parameters?: SimCfnParameters | undefined;
-    readonly resourceLogicalIds?: ReadonlySet<string> | undefined;
-}
-/**
- * Simulated CloudFormation Resource status.
- *
- * These states model the CloudFormation creation lifecycle for one Resource
- * entry, not the lifecycle of the underlying simulated AWS service object.
- */
-export type SimCloudFormationResourceStatus = "CREATE_PENDING" | "CREATE_IN_PROGRESS" | "CREATE_COMPLETE" | "CREATE_FAILED";
-export interface SimCloudFormationResourceCreateContext {
-    readonly simAws: SimAws;
-    readonly resources: ReadonlyMap<string, SimCfnResource>;
-    readonly resolvedProperties?: SimCfnTemplateValueRecord | undefined;
-    readonly cdkOutContext?: SimCdkOutContext | undefined;
-    readonly bindings?: readonly SimCfnExecutableResourceBinding[] | undefined;
-}
+import { SimCfnResourceRecord } from "./sim-cfn-resource-record.js";
+import type { SimCloudFormationResourceCreateContext, SimCloudFormationResourceDeleteContext, SimCloudFormationResourceProperties, SimCloudFormationResourceStatus } from "./sim-cfn-resource.type.js";
 /**
  * Runtime representation of one CloudFormation Resource entry.
  *
  * A SimCfnResource is created from one item in a stack template's Resources map.
  * It keeps the Resource logical ID, account/region scope, original Resource
- * template object, CloudFormation creation state, and the simulated AWS object
+ * template object, CloudFormation lifecycle state, and the simulated AWS object
  * produced by Resource creation.
  *
  * This class stays small:
+ * - what the Resource is, rather than what has happened to it, belongs to
+ *   SimCfnResourceRecord, which this extends;
  * - whole-template validation and Parameter resolution belong to SimCfnTemplate;
- * - Resource-field reading belongs to SimCfnResourceTemplateReader;
- * - asynchronous creation orchestration belongs to SimCfnResourceCreateOperation;
- * - service-specific object construction belongs to SimCfnServiceResourceFactory.
- *
+ * - asynchronous creation and deletion orchestration belong to
+ *   SimCfnResourceCreateOperation and SimCfnResourceDeleteOperation;
+ * - service-specific object construction and removal belong to
+ *   SimCfnServiceResourceFactory.
  * As a result, SimCfnResource acts as the stable Resource record passed between
- * stack creation, dependency resolution, and service-specific factories.
+ * stack deployment, dependency resolution, and service-specific factories.
  */
-export declare class SimCfnResource<T extends object = object> {
-    readonly accountRegionScope: SimAwsAccountRegionScope;
-    readonly logicalId: string;
-    /** The Stack this Resource belongs to, where a generated name comes from. */
-    readonly stackName: string | undefined;
-    readonly template: SimCfnTemplateValueRecord;
+export declare class SimCfnResource<T extends object = object> extends SimCfnResourceRecord {
     private readonly creationState;
-    private readonly resourceTemplateReader;
-    private readonly propertyResolver;
+    private readonly deletionState;
     private readonly background;
     private readonly cfnResourceFactory;
-    private readonly resourceLogicalIds;
     constructor(properties?: SimCloudFormationResourceProperties);
     /**
-     * Get the current CloudFormation creation status for this Resource.
+     * Get the current CloudFormation status for this Resource.
+     *
+     * A Resource keeps the status its creation left it with until the Stack asks
+     * for it to be deleted, so the status reads as the last thing CloudFormation
+     * did to the Resource.
      */
     get status(): SimCloudFormationResourceStatus;
     /**
@@ -82,34 +51,22 @@ export declare class SimCfnResource<T extends object = object> {
      */
     get createComplete(): boolean;
     /**
-     * The CloudFormation Resource type from the Resource template.
-     *
-     * E.g. AWS::S3::Bucket
+     * Whether this Resource has reached a terminal deletion status.
      */
-    get type(): string | undefined;
+    get deleteComplete(): boolean;
     /**
-     * The CloudFormation Resource properties object from the Resource template.
-     *
-     * Missing or non-object Properties are treated as an empty object by the
-     * Resource template reader.
+     * Whether this Resource was removed from simulated AWS.
      */
-    get properties(): SimCfnTemplateValueRecord;
+    get deleted(): boolean;
     /**
-     * The value returned when this Resource is referenced via { "Ref": logicalId }.
-     *
-     * Mirroring CloudFormation, Resource Ref behavior is Resource-type specific.
-     * CloudFormation-specific value behavior is delegated to a Resource adapter so
-     * simulated service objects do not need to know about CloudFormation.
+     * Whether this Resource's deletion was recorded rather than carried out,
+     * because sim CloudFormation has no way to delete its Resource type.
      */
-    get refValue(): SimCfnTemplateValue;
+    get deletionSkipped(): boolean;
     /**
-     * The value returned when this Resource is referenced via Fn::GetAtt.
-     *
-     * Mirroring CloudFormation, Resource attributes are Resource-type specific.
-     * CloudFormation-specific value behavior is delegated to a Resource adapter so
-     * simulated service objects do not need to know about CloudFormation.
+     * The reason this Resource's deletion was skipped, if it was skipped.
      */
-    attributeValue(attributeName: string): SimCfnTemplateValue;
+    get deletionSkippedReason(): string | undefined;
     /**
      * The simulated AWS object created for this CloudFormation Resource.
      *
@@ -119,24 +76,9 @@ export declare class SimCfnResource<T extends object = object> {
      */
     get simResource(): T | undefined;
     /**
-     * The creation failure captured for this Resource, if creation failed.
+     * The failure captured for this Resource, if creation or deletion failed.
      */
     get error(): Error | undefined;
-    /**
-     * Logical IDs of Resources that must complete before this Resource can
-     * create.
-     *
-     * Includes both explicit DependsOn entries and implicit dependencies from Ref
-     * expressions that target other Resources.
-     */
-    dependencies(): string[];
-    /**
-     * Resolve this Resource's Properties, including Refs to other Resources.
-     *
-     * Called by the creation operation once every dependency has reached
-     * CREATE_COMPLETE, so referenced Resources have valid Ref values.
-     */
-    resolvedProperties(context: SimCloudFormationResourceCreateContext): SimCfnTemplateValueRecord;
     /**
      * Whether every declared dependency has reached CREATE_COMPLETE.
      *
@@ -151,6 +93,22 @@ export declare class SimCfnResource<T extends object = object> {
      * remains a lifecycle record rather than an async workflow implementation.
      */
     create(context: SimCloudFormationResourceCreateContext): Promise<void>;
+    /**
+     * Whether this Resource was left in simulated AWS by a Stack teardown,
+     * because its DeletionPolicy says to keep it.
+     */
+    get retained(): boolean;
+    /**
+     * Start deleting this Resource from simulated AWS.
+     *
+     * A Resource whose DeletionPolicy retains it never reaches the delete
+     * operation. CloudFormation leaves it where it is and reports it as
+     * DELETE_SKIPPED, so the Stack can finish deleting around it.
+     *
+     * The actual work is delegated to SimCfnResourceDeleteOperation, for the same
+     * reason creation is.
+     */
+    delete(context: SimCloudFormationResourceDeleteContext): Promise<void>;
     /**
      * Mark this Resource as creation in progress.
      *
@@ -159,9 +117,8 @@ export declare class SimCfnResource<T extends object = object> {
      */
     markCreateInProgress(): void;
     /**
-     * Mark this Resource as successfully created and store its simulated AWS object.
-     *
-     * Intended for use by the creation operation after the appropriate
+     * Mark this Resource as successfully created and store its simulated AWS
+     * object. Intended for use by the creation operation after the appropriate
      * service-specific factory has created the simulated resource.
      */
     markCreateComplete(simResource?: T): void;
@@ -175,11 +132,27 @@ export declare class SimCfnResource<T extends object = object> {
     markCreateSkipped(reason: string): void;
     /**
      * Mark this Resource as failed to create and store the failure reason.
-     *
      * Intended for use by the creation operation when service-specific creation
      * throws or rejects.
      */
     markCreateFailed(error?: Error): void;
-    private cfnValueAdapter;
+    /**
+     * Mark this Resource as deletion in progress.
+     */
+    markDeleteInProgress(): void;
+    /**
+     * Mark this Resource as successfully deleted.
+     */
+    markDeleteComplete(): void;
+    /**
+     * Mark this Resource's deletion as skipped because sim CloudFormation has no
+     * way to delete its service or Resource type.
+     */
+    markDeleteSkipped(reason: string): void;
+    /**
+     * Mark this Resource as failed to delete and store the failure reason.
+     */
+    markDeleteFailed(error?: Error): void;
 }
+export { type SimCloudFormationResourceCreateContext, type SimCloudFormationResourceDeleteContext, type SimCloudFormationResourceProperties, type SimCloudFormationResourceStatus, } from "./sim-cfn-resource.type.js";
 //# sourceMappingURL=sim-cfn-resource.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sim-cfn-resource.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudformation/resource/sim-cfn-resource.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sim-cfn-resource.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudformation/resource/sim-cfn-resource.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EACV,sCAAsC,EACtC,sCAAsC,EACtC,mCAAmC,EACnC,+BAA+B,EAChC,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,cAAc,CACzB,CAAC,SAAS,MAAM,GAAG,MAAM,CACzB,SAAQ,oBAAoB;IAC5B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwC;IACtE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqC;IACnE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA2C;IAE9E,YAAY,UAAU,GAAE,mCAAwC,EAQ/D;IAED;;;;;;OAMG;IACH,IAAW,MAAM,IAAI,+BAA+B,CAEnD;IAED;;OAEG;IACH,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED;;;OAGG;IACH,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED;;OAEG;IACH,IAAW,aAAa,IAAI,MAAM,GAAG,SAAS,CAE7C;IAED;;OAEG;IACH,IAAW,cAAc,IAAI,OAAO,CAEnC;IAED;;OAEG;IACH,IAAW,cAAc,IAAI,OAAO,CAEnC;IAED;;OAEG;IACH,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED;;;OAGG;IACH,IAAW,eAAe,IAAI,OAAO,CAEpC;IAED;;OAEG;IACH,IAAW,qBAAqB,IAAI,MAAM,GAAG,SAAS,CAErD;IAED;;;;;;OAMG;IACH,IAAoB,WAAW,IAAI,CAAC,GAAG,SAAS,CAE/C;IAED;;OAEG;IACH,IAAW,KAAK,IAAI,KAAK,GAAG,SAAS,CAEpC;IAED;;;;;OAKG;IACH,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,OAAO,CAIjE;IAED;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,sCAAsC,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrE;IAED;;;OAGG;IACH,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,OAAO,EAAE,sCAAsC,GAAG,OAAO,CAAC,IAAI,CAAC,CAYrE;IAED;;;;;OAKG;IACH,oBAAoB,IAAI,IAAI,CAG3B;IAED;;;;OAIG;IACH,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,CAExC;IAED;;;;;;OAMG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEtC;IAED;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAEpC;IAED;;OAEG;IACH,oBAAoB,IAAI,IAAI,CAE3B;IAED;;OAEG;IACH,kBAAkB,IAAI,IAAI,CAEzB;IAED;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEtC;IAED;;OAEG;IACH,gBAAgB,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAEpC;CACF;AAED,OAAO,EACL,KAAK,sCAAsC,EAC3C,KAAK,sCAAsC,EAC3C,KAAK,mCAAmC,EACxC,KAAK,+BAA+B,GACrC,MAAM,4BAA4B,CAAC"}

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

@@ -1,56 +1,48 @@
 import { BackgroundTasks, } from "../../../util/background/background.js";
 import { SimCfnResourceCreateOperation } from "./create/sim-cfn-resource-create-operation.js";
+import { SimCfnResourceDeleteOperation } from "./delete/sim-cfn-resource-delete-operation.js";
 import { SimCfnResourceCreationState } from "./state/sim-cfn-resource-creation-state.js";
-import { SimCfnResourceTemplateReader } from "./template/sim-cfn-resource-template-reader.js";
-import { SimCfnResourcePropertyResolver } from "./resolve/property/sim-cfn-resource-property-resolver.js";
-import { simCfnResourceValueAdapter, } from "./cfn/sim-cfn-resource-value-adapter.js";
-import { simAwsAccountRegionScopeFactory } from "../../aws/sim-aws-account-region-scope.factory.js";
+import { SimCfnResourceDeletionState } from "./state/sim-cfn-resource-deletion-state.js";
+import { SimCfnResourceRecord } from "./sim-cfn-resource-record.js";
 /**
  * Runtime representation of one CloudFormation Resource entry.
  *
  * A SimCfnResource is created from one item in a stack template's Resources map.
  * It keeps the Resource logical ID, account/region scope, original Resource
- * template object, CloudFormation creation state, and the simulated AWS object
+ * template object, CloudFormation lifecycle state, and the simulated AWS object
  * produced by Resource creation.
  *
  * This class stays small:
+ * - what the Resource is, rather than what has happened to it, belongs to
+ *   SimCfnResourceRecord, which this extends;
  * - whole-template validation and Parameter resolution belong to SimCfnTemplate;
- * - Resource-field reading belongs to SimCfnResourceTemplateReader;
- * - asynchronous creation orchestration belongs to SimCfnResourceCreateOperation;
- * - service-specific object construction belongs to SimCfnServiceResourceFactory.
- *
+ * - asynchronous creation and deletion orchestration belong to
+ *   SimCfnResourceCreateOperation and SimCfnResourceDeleteOperation;
+ * - service-specific object construction and removal belong to
+ *   SimCfnServiceResourceFactory.
  * As a result, SimCfnResource acts as the stable Resource record passed between
- * stack creation, dependency resolution, and service-specific factories.
+ * stack deployment, dependency resolution, and service-specific factories.
  */
-export class SimCfnResource {
-    accountRegionScope;
-    logicalId;
-    /** The Stack this Resource belongs to, where a generated name comes from. */
-    stackName;
-    template;
+export class SimCfnResource extends SimCfnResourceRecord {
     creationState = new SimCfnResourceCreationState();
-    resourceTemplateReader;
-    propertyResolver;
+    deletionState = new SimCfnResourceDeletionState();
     background;
     cfnResourceFactory;
-    resourceLogicalIds;
     constructor(properties = {}) {
-        const { accountRegionScope = simAwsAccountRegionScopeFactory.make(), background = new BackgroundTasks(), logicalId = "Resource", stackName, template = {}, cfnResourceFactory, parameters, resourceLogicalIds = new Set(), } = properties;
-        this.accountRegionScope = accountRegionScope;
+        super(properties);
+        const { background = new BackgroundTasks(), cfnResourceFactory } = properties;
         this.background = background;
-        this.logicalId = logicalId;
-        this.stackName = stackName;
-        this.template = template;
-        this.resourceTemplateReader = new SimCfnResourceTemplateReader(template);
-        this.propertyResolver = new SimCfnResourcePropertyResolver({ parameters });
         this.cfnResourceFactory = cfnResourceFactory;
-        this.resourceLogicalIds = resourceLogicalIds;
     }
     /**
-     * Get the current CloudFormation creation status for this Resource.
+     * Get the current CloudFormation status for this Resource.
+     *
+     * A Resource keeps the status its creation left it with until the Stack asks
+     * for it to be deleted, so the status reads as the last thing CloudFormation
+     * did to the Resource.
      */
     get status() {
-        return this.creationState.status;
+        return this.deletionState.status ?? this.creationState.status;
     }
     /**
      * Whether this Resource has been deployed into simulated AWS.
@@ -78,41 +70,29 @@ export class SimCfnResource {
         return this.creationState.createComplete;
     }
     /**
-     * The CloudFormation Resource type from the Resource template.
-     *
-     * E.g. AWS::S3::Bucket
+     * Whether this Resource has reached a terminal deletion status.
      */
-    get type() {
-        return this.resourceTemplateReader.type();
+    get deleteComplete() {
+        return this.deletionState.deleteComplete;
     }
     /**
-     * The CloudFormation Resource properties object from the Resource template.
-     *
-     * Missing or non-object Properties are treated as an empty object by the
-     * Resource template reader.
+     * Whether this Resource was removed from simulated AWS.
      */
-    get properties() {
-        return this.resourceTemplateReader.properties();
+    get deleted() {
+        return this.deletionState.deleted;
     }
     /**
-     * The value returned when this Resource is referenced via { "Ref": logicalId }.
-     *
-     * Mirroring CloudFormation, Resource Ref behavior is Resource-type specific.
-     * CloudFormation-specific value behavior is delegated to a Resource adapter so
-     * simulated service objects do not need to know about CloudFormation.
+     * Whether this Resource's deletion was recorded rather than carried out,
+     * because sim CloudFormation has no way to delete its Resource type.
      */
-    get refValue() {
-        return this.cfnValueAdapter().refValue();
+    get deletionSkipped() {
+        return this.deletionState.skipped;
     }
     /**
-     * The value returned when this Resource is referenced via Fn::GetAtt.
-     *
-     * Mirroring CloudFormation, Resource attributes are Resource-type specific.
-     * CloudFormation-specific value behavior is delegated to a Resource adapter so
-     * simulated service objects do not need to know about CloudFormation.
+     * The reason this Resource's deletion was skipped, if it was skipped.
      */
-    attributeValue(attributeName) {
-        return this.cfnValueAdapter().attributeValue(attributeName);
+    get deletionSkippedReason() {
+        return this.deletionState.skippedReason;
     }
     /**
      * The simulated AWS object created for this CloudFormation Resource.
@@ -125,29 +105,10 @@ export class SimCfnResource {
         return this.creationState.simResource;
     }
     /**
-     * The creation failure captured for this Resource, if creation failed.
+     * The failure captured for this Resource, if creation or deletion failed.
      */
     get error() {
-        return this.creationState.error;
-    }
-    /**
-     * Logical IDs of Resources that must complete before this Resource can
-     * create.
-     *
-     * Includes both explicit DependsOn entries and implicit dependencies from Ref
-     * expressions that target other Resources.
-     */
-    dependencies() {
-        return this.resourceTemplateReader.dependencies(this.resourceLogicalIds);
-    }
-    /**
-     * Resolve this Resource's Properties, including Refs to other Resources.
-     *
-     * Called by the creation operation once every dependency has reached
-     * CREATE_COMPLETE, so referenced Resources have valid Ref values.
-     */
-    resolvedProperties(context) {
-        return this.propertyResolver.resolve(this.properties, context);
+        return this.deletionState.error ?? this.creationState.error;
     }
     /**
      * Whether every declared dependency has reached CREATE_COMPLETE.
@@ -167,12 +128,39 @@ export class SimCfnResource {
      * remains a lifecycle record rather than an async workflow implementation.
      */
     create(context) {
-        const creationOperation = new SimCfnResourceCreateOperation({
+        return new SimCfnResourceCreateOperation({
             background: this.background,
             resource: this,
             cfnResourceFactory: this.cfnResourceFactory,
-        });
-        return creationOperation.run(context);
+        }).run(context);
+    }
+    /**
+     * Whether this Resource was left in simulated AWS by a Stack teardown,
+     * because its DeletionPolicy says to keep it.
+     */
+    get retained() {
+        return this.deletionState.retained;
+    }
+    /**
+     * Start deleting this Resource from simulated AWS.
+     *
+     * A Resource whose DeletionPolicy retains it never reaches the delete
+     * operation. CloudFormation leaves it where it is and reports it as
+     * DELETE_SKIPPED, so the Stack can finish deleting around it.
+     *
+     * The actual work is delegated to SimCfnResourceDeleteOperation, for the same
+     * reason creation is.
+     */
+    delete(context) {
+        if (this.retainedOnDelete) {
+            this.deletionState.markDeleteRetained();
+            return Promise.resolve();
+        }
+        return new SimCfnResourceDeleteOperation({
+            background: this.background,
+            resource: this,
+            cfnResourceFactory: this.cfnResourceFactory,
+        }).run(context);
     }
     /**
      * Mark this Resource as creation in progress.
@@ -181,12 +169,12 @@ export class SimCfnResource {
      * CloudFormation lifecycle.
      */
     markCreateInProgress() {
+        this.clearIgnoredProperties();
         this.creationState.markCreateInProgress();
     }
     /**
-     * Mark this Resource as successfully created and store its simulated AWS object.
-     *
-     * Intended for use by the creation operation after the appropriate
+     * Mark this Resource as successfully created and store its simulated AWS
+     * object. Intended for use by the creation operation after the appropriate
      * service-specific factory has created the simulated resource.
      */
     markCreateComplete(simResource) {
@@ -204,19 +192,37 @@ export class SimCfnResource {
     }
     /**
      * Mark this Resource as failed to create and store the failure reason.
-     *
      * Intended for use by the creation operation when service-specific creation
      * throws or rejects.
      */
     markCreateFailed(error) {
         this.creationState.markCreateFailed(error);
     }
-    cfnValueAdapter() {
-        return simCfnResourceValueAdapter({
-            logicalId: this.logicalId,
-            type: this.type,
-            simResource: this.simResource,
-        });
+    /**
+     * Mark this Resource as deletion in progress.
+     */
+    markDeleteInProgress() {
+        this.deletionState.markDeleteInProgress();
+    }
+    /**
+     * Mark this Resource as successfully deleted.
+     */
+    markDeleteComplete() {
+        this.deletionState.markDeleteComplete();
+    }
+    /**
+     * Mark this Resource's deletion as skipped because sim CloudFormation has no
+     * way to delete its service or Resource type.
+     */
+    markDeleteSkipped(reason) {
+        this.deletionState.markDeleteSkipped(reason);
+    }
+    /**
+     * Mark this Resource as failed to delete and store the failure reason.
+     */
+    markDeleteFailed(error) {
+        this.deletionState.markDeleteFailed(error);
     }
 }
+export {} from "./sim-cfn-resource.type.js";
 //# sourceMappingURL=sim-cfn-resource.js.map