@kensio/yulin 0.17.0 → 0.19.0

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

@@ -0,0 +1,183 @@
+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";
+interface SimCloudFormationResourceProps {
+    readonly accountRegionScope?: SimAwsAccountRegionScope;
+    readonly background?: BackgroundScheduler;
+    readonly logicalId?: string;
+    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;
+}
+/**
+ * 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
+ * produced by Resource creation.
+ *
+ * This class stays small:
+ * - 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.
+ *
+ * As a result, SimCfnResource acts as the stable Resource record passed between
+ * stack creation, dependency resolution, and service-specific factories.
+ */
+export declare class SimCfnResource<T extends object = object> {
+    readonly accountRegionScope: SimAwsAccountRegionScope;
+    readonly logicalId: string;
+    readonly template: SimCfnTemplateValueRecord;
+    private readonly creationState;
+    private readonly resourceTemplateReader;
+    private readonly propertyResolver;
+    private readonly background;
+    private readonly cfnResourceFactory;
+    private readonly resourceLogicalIds;
+    constructor(props?: SimCloudFormationResourceProps);
+    /**
+     * Get the current CloudFormation creation status for this Resource.
+     */
+    get status(): SimCloudFormationResourceStatus;
+    /**
+     * Whether this Resource has been deployed into simulated AWS.
+     */
+    get deployed(): boolean;
+    /**
+     * Whether this Resource was skipped because sim CloudFormation does not yet
+     * support creating its service or Resource type.
+     */
+    get skipped(): boolean;
+    /**
+     * The reason this Resource was skipped, if it was skipped.
+     */
+    get skippedReason(): string | undefined;
+    /**
+     * Whether this Resource has reached a terminal successful creation status.
+     */
+    get createComplete(): boolean;
+    /**
+     * The CloudFormation Resource type from the Resource template.
+     *
+     * E.g. AWS::S3::Bucket
+     */
+    get type(): string | undefined;
+    /**
+     * 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(): SimCfnTemplateValueRecord;
+    /**
+     * 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(): SimCfnTemplateValue;
+    /**
+     * 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: string): SimCfnTemplateValue;
+    /**
+     * The simulated AWS object created for this CloudFormation Resource.
+     *
+     * For example, an AWS::S3::Bucket Resource may point at a simulated S3 Bucket
+     * after creation completes. Resources that do not produce a concrete service
+     * object may leave this undefined.
+     */
+    get simResource(): T | undefined;
+    /**
+     * The creation failure captured for this Resource, if creation 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.
+     *
+     * Missing dependencies are treated as not ready because they cannot report a
+     * successful creation status.
+     */
+    canCreate(resources: ReadonlyMap<string, SimCfnResource>): boolean;
+    /**
+     * Start creating this Resource into simulated AWS.
+     *
+     * The actual work is delegated to SimCfnResourceCreateOperation so this class
+     * remains a lifecycle record rather than an async workflow implementation.
+     */
+    create(context: SimCloudFormationResourceCreateContext): Promise<void>;
+    /**
+     * Mark this Resource as creation in progress.
+     *
+     * Intended for use by the creation operation while it runs the simulated
+     * CloudFormation lifecycle.
+     */
+    markCreateInProgress(): void;
+    /**
+     * 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;
+    /**
+     * Mark this Resource as skipped because sim CloudFormation does not yet
+     * support creating its service or Resource type.
+     *
+     * Skipped Resources are treated as CREATE_COMPLETE so unsupported Resources do
+     * not block local simulation of the rest of the Stack.
+     */
+    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;
+}
+export {};
+//# sourceMappingURL=sim-cfn-resource.d.ts.map

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

@@ -0,0 +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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"}

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

@@ -0,0 +1,218 @@
+import { simAwsAccountRegionScopeFactory, } from "../../aws/sim-aws-account-region-scope.js";
+import { BackgroundTasks, } from "../../../util/background/background.js";
+import { SimCfnResourceCreateOperation } from "./create/sim-cfn-resource-create-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";
+/**
+ * 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
+ * produced by Resource creation.
+ *
+ * This class stays small:
+ * - 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.
+ *
+ * As a result, SimCfnResource acts as the stable Resource record passed between
+ * stack creation, dependency resolution, and service-specific factories.
+ */
+export class SimCfnResource {
+    accountRegionScope;
+    logicalId;
+    template;
+    creationState = new SimCfnResourceCreationState();
+    resourceTemplateReader;
+    propertyResolver;
+    background;
+    cfnResourceFactory;
+    resourceLogicalIds;
+    constructor(props = {}) {
+        const { accountRegionScope = simAwsAccountRegionScopeFactory.make(), background = new BackgroundTasks(), logicalId = "Resource", template = {}, cfnResourceFactory, parameters, resourceLogicalIds = new Set(), } = props;
+        this.accountRegionScope = accountRegionScope;
+        this.background = background;
+        this.logicalId = logicalId;
+        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 status() {
+        return this.creationState.status;
+    }
+    /**
+     * Whether this Resource has been deployed into simulated AWS.
+     */
+    get deployed() {
+        return this.creationState.deployed;
+    }
+    /**
+     * Whether this Resource was skipped because sim CloudFormation does not yet
+     * support creating its service or Resource type.
+     */
+    get skipped() {
+        return this.creationState.skipped;
+    }
+    /**
+     * The reason this Resource was skipped, if it was skipped.
+     */
+    get skippedReason() {
+        return this.creationState.skippedReason;
+    }
+    /**
+     * Whether this Resource has reached a terminal successful creation status.
+     */
+    get createComplete() {
+        return this.creationState.createComplete;
+    }
+    /**
+     * 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 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();
+    }
+    /**
+     * 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);
+    }
+    /**
+     * The simulated AWS object created for this CloudFormation Resource.
+     *
+     * For example, an AWS::S3::Bucket Resource may point at a simulated S3 Bucket
+     * after creation completes. Resources that do not produce a concrete service
+     * object may leave this undefined.
+     */
+    get simResource() {
+        return this.creationState.simResource;
+    }
+    /**
+     * The creation failure captured for this Resource, if creation 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);
+    }
+    /**
+     * Whether every declared dependency has reached CREATE_COMPLETE.
+     *
+     * Missing dependencies are treated as not ready because they cannot report a
+     * successful creation status.
+     */
+    canCreate(resources) {
+        return this.dependencies().every((dependency) => {
+            return resources.get(dependency)?.status === "CREATE_COMPLETE";
+        });
+    }
+    /**
+     * Start creating this Resource into simulated AWS.
+     *
+     * The actual work is delegated to SimCfnResourceCreateOperation so this class
+     * remains a lifecycle record rather than an async workflow implementation.
+     */
+    create(context) {
+        return new SimCfnResourceCreateOperation({
+            background: this.background,
+            resource: this,
+            cfnResourceFactory: this.cfnResourceFactory,
+        }).run(context);
+    }
+    /**
+     * Mark this Resource as creation in progress.
+     *
+     * Intended for use by the creation operation while it runs the simulated
+     * CloudFormation lifecycle.
+     */
+    markCreateInProgress() {
+        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
+     * service-specific factory has created the simulated resource.
+     */
+    markCreateComplete(simResource) {
+        this.creationState.markCreateComplete(simResource);
+    }
+    /**
+     * Mark this Resource as skipped because sim CloudFormation does not yet
+     * support creating its service or Resource type.
+     *
+     * Skipped Resources are treated as CREATE_COMPLETE so unsupported Resources do
+     * not block local simulation of the rest of the Stack.
+     */
+    markCreateSkipped(reason) {
+        this.creationState.markCreateSkipped(reason);
+    }
+    /**
+     * 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,
+        });
+    }
+}
+//# sourceMappingURL=sim-cfn-resource.js.map

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

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

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

@@ -0,0 +1,57 @@
+import type { SimCloudFormationResourceStatus } from "../sim-cfn-resource.js";
+/**
+ * Tracks CloudFormation Resource creation status, backing sim Resource and error.
+ */
+export declare class SimCfnResourceCreationState<T extends object = object> {
+    private _status;
+    private _simResource;
+    private deployError;
+    private _skippedReason;
+    /**
+     * Get the current Resource status.
+     */
+    get status(): SimCloudFormationResourceStatus;
+    /**
+     * Whether this Resource has been deployed into simulated AWS.
+     */
+    get deployed(): boolean;
+    /**
+     * Whether this Resource was skipped because sim CloudFormation does not yet
+     * support creating its service or Resource type.
+     */
+    get skipped(): boolean;
+    /**
+     * The reason this Resource was skipped, if it was skipped.
+     */
+    get skippedReason(): string | undefined;
+    /**
+     * Whether this Resource has reached a terminal creation status.
+     */
+    get createComplete(): boolean;
+    /**
+     * The simulated AWS resource represented by this CloudFormation Resource.
+     */
+    get simResource(): T | undefined;
+    /**
+     * Get the deployment error, if Resource creation failed.
+     */
+    get error(): Error | undefined;
+    /**
+     * Mark this Resource as creation in progress.
+     */
+    markCreateInProgress(): void;
+    /**
+     * Mark this Resource as successfully created.
+     */
+    markCreateComplete(simResource?: T): void;
+    /**
+     * Mark this Resource as skipped because its sim implementation is not yet
+     * available.
+     */
+    markCreateSkipped(reason: string): void;
+    /**
+     * Mark this Resource as failed to create.
+     */
+    markCreateFailed(error?: Error): void;
+}
+//# sourceMappingURL=sim-cfn-resource-creation-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cfn-resource-creation-state.d.ts","sourceRoot":"","sources":["../../../../../src/service/cloudformation/resource/state/sim-cfn-resource-creation-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAE9E;;GAEG;AACH,qBAAa,2BAA2B,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAChE,OAAO,CAAC,OAAO,CAAqD;IACpE,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,cAAc,CAAqB;IAE3C;;OAEG;IACH,IAAW,MAAM,IAAI,+BAA+B,CAEnD;IAED;;OAEG;IACH,IAAW,QAAQ,IAAI,OAAO,CAI7B;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,CAInC;IAED;;OAEG;IACH,IAAW,WAAW,IAAI,CAAC,GAAG,SAAS,CAEtC;IAED;;OAEG;IACH,IAAW,KAAK,IAAI,KAAK,GAAG,SAAS,CAEpC;IAED;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAO5B;;OAEG;IACH,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI;IAOzC;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAOvC;;OAEG;IACH,gBAAgB,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;CAMtC"}

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

@@ -0,0 +1,90 @@
+/**
+ * Tracks CloudFormation Resource creation status, backing sim Resource and error.
+ */
+export class SimCfnResourceCreationState {
+    _status = "CREATE_PENDING";
+    _simResource;
+    deployError;
+    _skippedReason;
+    /**
+     * Get the current Resource status.
+     */
+    get status() {
+        return this._status;
+    }
+    /**
+     * Whether this Resource has been deployed into simulated AWS.
+     */
+    get deployed() {
+        return (this._status === "CREATE_COMPLETE" && this._skippedReason === undefined);
+    }
+    /**
+     * Whether this Resource was skipped because sim CloudFormation does not yet
+     * support creating its service or Resource type.
+     */
+    get skipped() {
+        return this._skippedReason !== undefined;
+    }
+    /**
+     * The reason this Resource was skipped, if it was skipped.
+     */
+    get skippedReason() {
+        return this._skippedReason;
+    }
+    /**
+     * Whether this Resource has reached a terminal creation status.
+     */
+    get createComplete() {
+        return (this._status === "CREATE_COMPLETE" || this._status === "CREATE_FAILED");
+    }
+    /**
+     * The simulated AWS resource represented by this CloudFormation Resource.
+     */
+    get simResource() {
+        return this._simResource;
+    }
+    /**
+     * Get the deployment error, if Resource creation failed.
+     */
+    get error() {
+        return this.deployError;
+    }
+    /**
+     * Mark this Resource as creation in progress.
+     */
+    markCreateInProgress() {
+        this.deployError = undefined;
+        this._simResource = undefined;
+        this._skippedReason = undefined;
+        this._status = "CREATE_IN_PROGRESS";
+    }
+    /**
+     * Mark this Resource as successfully created.
+     */
+    markCreateComplete(simResource) {
+        this._simResource = simResource;
+        this.deployError = undefined;
+        this._skippedReason = undefined;
+        this._status = "CREATE_COMPLETE";
+    }
+    /**
+     * Mark this Resource as skipped because its sim implementation is not yet
+     * available.
+     */
+    markCreateSkipped(reason) {
+        this._simResource = undefined;
+        this.deployError = undefined;
+        this._skippedReason = reason;
+        this._status = "CREATE_COMPLETE";
+    }
+    /**
+     * Mark this Resource as failed to create.
+     */
+    markCreateFailed(error) {
+        this.deployError = error;
+        this._simResource = undefined;
+        this._skippedReason = undefined;
+        this._status = "CREATE_FAILED";
+    }
+}
+//# sourceMappingURL=sim-cfn-resource-creation-state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cfn-resource-creation-state.js","sourceRoot":"","sources":["../../../../../src/service/cloudformation/resource/state/sim-cfn-resource-creation-state.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,2BAA2B;IAC9B,OAAO,GAAoC,gBAAgB,CAAC;IAC5D,YAAY,CAAgB;IAC5B,WAAW,CAAoB;IAC/B,cAAc,CAAqB;IAE3C;;OAEG;IACH,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,IAAW,QAAQ;QACjB,OAAO,CACL,IAAI,CAAC,OAAO,KAAK,iBAAiB,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,CACxE,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,cAAc,KAAK,SAAS,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,IAAW,aAAa;QACtB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,IAAW,cAAc;QACvB,OAAO,CACL,IAAI,CAAC,OAAO,KAAK,iBAAiB,IAAI,IAAI,CAAC,OAAO,KAAK,eAAe,CACvE,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAW,WAAW;QACpB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAC9B,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,oBAAoB,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,WAAe;QAChC,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,iBAAiB,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,iBAAiB,CAAC,MAAc;QAC9B,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAC9B,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,iBAAiB,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,KAAa;QAC5B,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAC9B,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,eAAe,CAAC;IACjC,CAAC;CACF"}

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

@@ -0,0 +1,39 @@
+import type { SimCfnTemplateValueRecord } from "../../template/value/sim-cfn-template-value.js";
+/**
+ * Reads CloudFormation Resource-level fields from one Resource template object.
+ *
+ * This is narrower than SimCfnTemplate. SimCfnTemplate represents the whole
+ * stack template body: it validates top-level template shape, resolves
+ * Parameters, and extracts Resource entries.
+ *
+ * SimCfnResourceTemplateReader only works after that extraction step. It reads
+ * fields from one individual Resource object, such as Type, Properties, and
+ * DependsOn, so SimCfnResource can stay focused on Resource lifecycle state.
+ */
+export declare class SimCfnResourceTemplateReader {
+    private readonly template;
+    constructor(template: SimCfnTemplateValueRecord);
+    /**
+     * The CloudFormation Resource type, for example AWS::S3::Bucket.
+     */
+    type(): string | undefined;
+    /**
+     * The CloudFormation Resource properties object.
+     *
+     * CloudFormation Resources may omit Properties. In that case, and when the
+     * field is not an object, the simulator treats it as an empty object.
+     */
+    properties(): SimCfnTemplateValueRecord;
+    /**
+     * Logical IDs on which this Resource depends.
+     *
+     * Combines explicit DependsOn entries with implicit dependencies introduced
+     * by Ref expressions that point at other Resources. The set of Resource
+     * logical IDs distinguishes Resource Refs from Parameter Refs.
+     *
+     * DependsOn may be absent, a string, or a list of strings. Dependency parsing
+     * is delegated so this reader only exposes the normalized string list.
+     */
+    dependencies(resourceLogicalIds?: ReadonlySet<string>): string[];
+}
+//# sourceMappingURL=sim-cfn-resource-template-reader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cfn-resource-template-reader.d.ts","sourceRoot":"","sources":["../../../../../src/service/cloudformation/resource/template/sim-cfn-resource-template-reader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAGhG;;;;;;;;;;GAUG;AACH,qBAAa,4BAA4B;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,yBAAyB;IAEhE;;OAEG;IACH,IAAI,IAAI,MAAM,GAAG,SAAS;IAM1B;;;;;OAKG;IACH,UAAU,IAAI,yBAAyB;IAUvC;;;;;;;;;OASG;IACH,YAAY,CAAC,kBAAkB,GAAE,WAAW,CAAC,MAAM,CAAa,GAAG,MAAM,EAAE;CAW5E"}

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

@@ -0,0 +1,55 @@
+import { parseSimCfnResourceDependencies, parseSimCfnResourceRefDependencies, } from "../dependency/sim-cfn-resource-dependencies.js";
+import { isCfnTemplateValueRecord } from "./sim-cfn-templ-val-record.js";
+/**
+ * Reads CloudFormation Resource-level fields from one Resource template object.
+ *
+ * This is narrower than SimCfnTemplate. SimCfnTemplate represents the whole
+ * stack template body: it validates top-level template shape, resolves
+ * Parameters, and extracts Resource entries.
+ *
+ * SimCfnResourceTemplateReader only works after that extraction step. It reads
+ * fields from one individual Resource object, such as Type, Properties, and
+ * DependsOn, so SimCfnResource can stay focused on Resource lifecycle state.
+ */
+export class SimCfnResourceTemplateReader {
+    template;
+    constructor(template) {
+        this.template = template;
+    }
+    /**
+     * The CloudFormation Resource type, for example AWS::S3::Bucket.
+     */
+    type() {
+        const type = this.template["Type"];
+        return typeof type === "string" ? type : undefined;
+    }
+    /**
+     * The CloudFormation Resource properties object.
+     *
+     * CloudFormation Resources may omit Properties. In that case, and when the
+     * field is not an object, the simulator treats it as an empty object.
+     */
+    properties() {
+        const properties = this.template["Properties"];
+        if (!isCfnTemplateValueRecord(properties)) {
+            return {};
+        }
+        return properties;
+    }
+    /**
+     * Logical IDs on which this Resource depends.
+     *
+     * Combines explicit DependsOn entries with implicit dependencies introduced
+     * by Ref expressions that point at other Resources. The set of Resource
+     * logical IDs distinguishes Resource Refs from Parameter Refs.
+     *
+     * DependsOn may be absent, a string, or a list of strings. Dependency parsing
+     * is delegated so this reader only exposes the normalized string list.
+     */
+    dependencies(resourceLogicalIds = new Set()) {
+        const dependsOn = parseSimCfnResourceDependencies(this.template["DependsOn"]);
+        const refDependencies = parseSimCfnResourceRefDependencies(this.template, resourceLogicalIds);
+        return [...new Set([...dependsOn, ...refDependencies])];
+    }
+}
+//# sourceMappingURL=sim-cfn-resource-template-reader.js.map