@kensio/yulin 1.21.2 → 1.21.3

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

@@ -1,4 +1,5 @@
 import type { SimCfnResource, SimCloudFormationResourceCreateContext, SimCloudFormationResourceDeleteContext } from "../sim-cfn-resource.js";
+import type { SimCloudFormationResourceUpdateContext } from "../sim-cfn-resource.type.js";
 export interface SimCfnServiceResourceFactory {
     create(resourceTypeName: string, resource: SimCfnResource, context: SimCloudFormationResourceCreateContext): Promise<object | undefined>;
     /**
@@ -15,6 +16,14 @@ export interface SimCfnServiceResourceFactory {
      * the teardown records it and carries on.
      */
     delete(resourceTypeName: string, resource: SimCfnResource, context: SimCloudFormationResourceDeleteContext): Promise<void>;
+    /**
+     * Refuse an invalid replacement before CloudFormation deletes anything.
+     *
+     * Most simulated Resource types have no update-specific validation. A
+     * service can implement this hook when an update carries constraints that a
+     * create request cannot check.
+     */
+    assertUpdateAllowed?(resourceTypeName: string, current: SimCfnResource, updated: SimCfnResource, context: SimCloudFormationResourceUpdateContext): Promise<void> | void;
 }
 export interface SimCloudFormationParsedResourceType {
     readonly providerName: string;

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

@@ -86,3 +86,14 @@ export interface SimCloudFormationResourceDeleteContext {
     /** The principal the teardown runs as, as creation carries it. */
     readonly caller?: SimAwsCaller | undefined;
 }
+/**
+ * The two resolved Resource definitions available to update validation.
+ */
+export interface SimCloudFormationResourceUpdateContext {
+    readonly simAws: SimAws;
+    readonly currentResources: ReadonlyMap<string, SimCfnResource>;
+    readonly updatedResources: ReadonlyMap<string, SimCfnResource>;
+    readonly currentResolvedProperties: SimCfnTemplateValueRecord;
+    readonly updatedResolvedProperties: SimCfnTemplateValueRecord;
+    readonly caller?: SimAwsCaller | undefined;
+}

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

@@ -0,0 +1,26 @@
+import type { SimAws } from "../../../aws/sim-aws.js";
+import type { SimAwsCaller } from "../../../aws/caller/sim-aws-caller.js";
+import type { SimCfnResource } from "../sim-cfn-resource.js";
+interface SimCfnResourceUpdateValidatorProperties {
+    readonly current: SimCfnResource;
+    readonly updated: SimCfnResource;
+}
+interface AssertSimCfnResourceUpdateAllowedProperties {
+    readonly simAws: SimAws;
+    readonly currentResources: ReadonlyMap<string, SimCfnResource>;
+    readonly updatedResources: ReadonlyMap<string, SimCfnResource>;
+    readonly caller?: SimAwsCaller | undefined;
+}
+/**
+ * Runs service-specific validation for one Resource replacement.
+ */
+export declare class SimCfnResourceUpdateValidator {
+    private readonly current;
+    private readonly updated;
+    constructor(properties: SimCfnResourceUpdateValidatorProperties);
+    /**
+     * Refuse an invalid update before its current Resource is deleted.
+     */
+    assertAllowed(properties: AssertSimCfnResourceUpdateAllowedProperties): Promise<void>;
+}
+export {};

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

@@ -0,0 +1,55 @@
+import { parseSimCloudFormationResourceType } from "../parser/sim-cfn-resource-parser.js";
+import { resolveSimCloudFormationServiceResourceFactory } from "../resolve/service/sim-cfn-service-resolver.js";
+import { isSimCfnUnsupportedResourceError } from "../unsupported/sim-cfn-unsupported-resource.js";
+/**
+ * Runs service-specific validation for one Resource replacement.
+ */
+export class SimCfnResourceUpdateValidator {
+    current;
+    updated;
+    constructor(properties) {
+        this.current = properties.current;
+        this.updated = properties.updated;
+    }
+    /**
+     * Refuse an invalid update before its current Resource is deleted.
+     */
+    async assertAllowed(properties) {
+        const { current, updated } = this;
+        const { simAws, currentResources, updatedResources, caller } = properties;
+        const { type } = updated;
+        if (type === undefined || current.type !== type) {
+            return;
+        }
+        const resourceType = parseSimCloudFormationResourceType(type);
+        let factory;
+        try {
+            factory = resolveSimCloudFormationServiceResourceFactory(simAws, updated.accountRegionScope, resourceType);
+        }
+        catch (error) {
+            if (isSimCfnUnsupportedResourceError(error)) {
+                return;
+            }
+            throw error;
+        }
+        if (factory.assertUpdateAllowed === undefined) {
+            return;
+        }
+        await factory.assertUpdateAllowed(resourceType.resourceTypeName, current, updated, {
+            simAws,
+            currentResources,
+            updatedResources,
+            currentResolvedProperties: await current.resolvedProperties({
+                simAws,
+                resources: currentResources,
+                caller,
+            }),
+            updatedResolvedProperties: await updated.resolvedProperties({
+                simAws,
+                resources: updatedResources,
+                caller,
+            }),
+            caller,
+        });
+    }
+}

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

@@ -8,6 +8,7 @@ import type { SimCfnResource } from "../resource/sim-cfn-resource.js";
 import type { SimCfnTemplate } from "../template/sim-cfn-template.js";
 import type { SimCfnResourceOrder } from "./deploy/sim-cfn-resource-order.js";
 import { SimCfnStackUpdater } from "./update/sim-cfn-stack-updater.js";
+import type { SimCfnStackResourceReplacement } from "./update/sim-cfn-stack-update-plan.js";
 import type { SimCloudFormationStackName } from "./sim-cfn-stack.js";
 interface SimCfnStackUpdateProperties {
     readonly background: BackgroundScheduler;
@@ -87,6 +88,10 @@ export declare class SimCfnStackResourceOperations {
      * Stack.
      */
     delete(resources: ReadonlyMap<string, SimCfnResource>, deleting: readonly SimCfnResource[]): Promise<void>;
+    /**
+     * Validate every Resource replacement before the update changes the Stack.
+     */
+    assertUpdatesAllowed(currentResources: ReadonlyMap<string, SimCfnResource>, updatedResources: ReadonlyMap<string, SimCfnResource>, replacements: readonly SimCfnStackResourceReplacement[]): Promise<void>;
     /**
      * An update of this Stack from a changed template, in the same scope.
      */

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

@@ -2,6 +2,7 @@ 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";
+import { SimCfnResourceUpdateValidator } from "../resource/update/sim-cfn-resource-update-validator.js";
 /**
  * What a Stack can ask simulated AWS to do with its Resources.
  *
@@ -77,6 +78,22 @@ export class SimCfnStackResourceOperations {
     async delete(resources, deleting) {
         await this.deleter(resources).delete(deleting);
     }
+    /**
+     * Validate every Resource replacement before the update changes the Stack.
+     */
+    async assertUpdatesAllowed(currentResources, updatedResources, replacements) {
+        await Promise.all(replacements.map(async ({ current, updated }) => {
+            await new SimCfnResourceUpdateValidator({
+                current,
+                updated,
+            }).assertAllowed({
+                simAws: this.simAws,
+                currentResources,
+                updatedResources,
+                caller: this.caller,
+            });
+        }));
+    }
     /**
      * An update of this Stack from a changed template, in the same scope.
      */

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

@@ -3,6 +3,10 @@ interface SimCfnStackUpdatePlanProperties {
     readonly current: ReadonlyMap<string, SimCfnResource>;
     readonly updated: ReadonlyMap<string, SimCfnResource>;
 }
+export interface SimCfnStackResourceReplacement {
+    readonly current: SimCfnResource;
+    readonly updated: SimCfnResource;
+}
 /**
  * What an update has to do to a Stack's Resources, worked out before any of it
  * happens.
@@ -17,6 +21,8 @@ interface SimCfnStackUpdatePlanProperties {
  * simCfnStackReplacedLogicalIds decides what changed.
  */
 export declare class SimCfnStackUpdatePlan {
+    /** The current and updated halves of each Resource replacement. */
+    readonly replacements: readonly SimCfnStackResourceReplacement[];
     /**
      * The deployed Resources to delete: the ones the new template drops, and the
      * deployed halves of the ones it replaces.
@@ -27,7 +33,7 @@ export declare class SimCfnStackUpdatePlan {
      * halves of the ones it replaces.
      */
     readonly creations: readonly SimCfnResource[];
-    private readonly updated;
+    readonly updated: ReadonlyMap<string, SimCfnResource>;
     constructor(properties: SimCfnStackUpdatePlanProperties);
     /**
      * Whether the update changes any Resource at all.

package/dist/service/cloudformation/stack/update/sim-cfn-stack-update-plan.js

@@ -13,6 +13,8 @@ import { simCfnStackReplacedLogicalIds } from "./sim-cfn-stack-replaced-resource
  * simCfnStackReplacedLogicalIds decides what changed.
  */
 export class SimCfnStackUpdatePlan {
+    /** The current and updated halves of each Resource replacement. */
+    replacements;
     /**
      * The deployed Resources to delete: the ones the new template drops, and the
      * deployed halves of the ones it replaces.
@@ -28,6 +30,17 @@ export class SimCfnStackUpdatePlan {
         const { current, updated } = properties;
         const replaced = simCfnStackReplacedLogicalIds({ current, updated });
         this.updated = updated;
+        this.replacements = replaced
+            .values()
+            .map((logicalId) => {
+            const currentResource = current.get(logicalId);
+            const updatedResource = updated.get(logicalId);
+            if (currentResource === undefined || updatedResource === undefined) {
+                throw new Error(`CloudFormation replacement ${logicalId} is missing one of its Resource definitions`);
+            }
+            return { current: currentResource, updated: updatedResource };
+        })
+            .toArray();
         // Both lists are worked out now rather than on demand, because the Stack's
         // Resource map is the current one and applying the plan changes it.
         this.deletions = current

package/dist/service/cloudformation/stack/update/sim-cfn-stack-updater.js

@@ -57,6 +57,7 @@ export class SimCfnStackUpdater {
     async apply() {
         const { resources, operations } = this.properties;
         const { plan } = this;
+        await operations.assertUpdatesAllowed(resources, plan.updated, plan.replacements);
         await operations.delete(resources, plan.deletions);
         plan.applyTo(resources);
         await operations.create(resources, plan.creations);

package/dist/service/dynamodb/cfn/sim-cfn-dynamodb-resource-factory.d.ts

@@ -1,5 +1,6 @@
 import type { SimCfnServiceResourceFactory } from "../../cloudformation/resource/factory/sim-cfn-resource-factory.type.js";
 import type { SimCfnResource, SimCloudFormationResourceCreateContext, SimCloudFormationResourceDeleteContext } from "../../cloudformation/resource/sim-cfn-resource.js";
+import type { SimCloudFormationResourceUpdateContext } from "../../cloudformation/resource/sim-cfn-resource.type.js";
 import type { SimDynamoDb } from "../sim-dynamodb.js";
 interface SimDynamoDbCfnResourceFactoryProperties {
     readonly dynamoDb: SimDynamoDb;
@@ -26,5 +27,9 @@ export declare class SimDynamoDbCfnResourceFactory implements SimCfnServiceResou
      * Delete a simulated DynamoDB resource created from a CloudFormation Resource.
      */
     delete(resourceTypeName: string, resource: SimCfnResource, context: SimCloudFormationResourceDeleteContext): Promise<void>;
+    /**
+     * Validate a DynamoDB Resource replacement before its table is deleted.
+     */
+    assertUpdateAllowed(resourceTypeName: string, current: SimCfnResource, updated: SimCfnResource, context: SimCloudFormationResourceUpdateContext): void;
 }
 export {};

package/dist/service/dynamodb/cfn/sim-cfn-dynamodb-resource-factory.js

@@ -2,6 +2,7 @@ import { simCfnResourceCallerOptions } from "../../cloudformation/resource/calle
 import { SimCfnDynamoDbGlobalTableCreator } from "./global-table/sim-cfn-dynamodb-global-table-creator.js";
 import { SimCfnDynamoDbTableCreator } from "./table/sim-cfn-dynamodb-table-creator.js";
 import { SimCfnDynamoDbResourceDeleter } from "./sim-cfn-dynamodb-resource-deleter.js";
+import { SimCfnDynamoDbTableUpdateValidator } from "./table/sim-cfn-dynamodb-table-update-validator.js";
 /**
  * CloudFormation Resource factory for simulated DynamoDB resources.
  */
@@ -50,4 +51,18 @@ export class SimDynamoDbCfnResourceFactory {
     async delete(resourceTypeName, resource, context) {
         await this.deleter.delete(resourceTypeName, resource, simCfnResourceCallerOptions(context.caller));
     }
+    /**
+     * Validate a DynamoDB Resource replacement before its table is deleted.
+     */
+    assertUpdateAllowed(resourceTypeName, current, updated, context) {
+        if (resourceTypeName !== "Table") {
+            return;
+        }
+        new SimCfnDynamoDbTableUpdateValidator({
+            currentResource: current,
+            updatedResource: updated,
+            currentProperties: context.currentResolvedProperties,
+            updatedProperties: context.updatedResolvedProperties,
+        }).assertAllowed();
+    }
 }

package/dist/service/dynamodb/cfn/table/sim-cfn-dynamodb-table-update-validator.d.ts

@@ -0,0 +1,24 @@
+import type { SimCfnResource } from "../../../cloudformation/resource/sim-cfn-resource.js";
+import type { SimCfnTemplateValueRecord } from "../../../cloudformation/template/value/sim-cfn-template-value.js";
+interface SimCfnDynamoDbTableUpdateValidatorProperties {
+    readonly currentResource: SimCfnResource;
+    readonly updatedResource: SimCfnResource;
+    readonly currentProperties: SimCfnTemplateValueRecord;
+    readonly updatedProperties: SimCfnTemplateValueRecord;
+}
+/**
+ * Validates constraints that apply when CloudFormation updates a table.
+ */
+export declare class SimCfnDynamoDbTableUpdateValidator {
+    private readonly properties;
+    constructor(properties: SimCfnDynamoDbTableUpdateValidatorProperties);
+    /**
+     * Refuse a template diff that asks DynamoDB for too many index operations.
+     *
+     * https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html
+     */
+    assertAllowed(): void;
+    private tableProperties;
+    private indexUpdates;
+}
+export {};

package/dist/service/dynamodb/cfn/table/sim-cfn-dynamodb-table-update-validator.js

@@ -0,0 +1,38 @@
+import { readSimDynamoDbIndexName } from "../../secondary-index/sim-dynamodb-index-name.js";
+import { SimDynamoDbIndexUpdate } from "../../table/sim-dynamodb-index-update.js";
+import { SimCfnDynamoDbTableProperties } from "./sim-cfn-dynamodb-table-properties.js";
+/**
+ * Validates constraints that apply when CloudFormation updates a table.
+ */
+export class SimCfnDynamoDbTableUpdateValidator {
+    properties;
+    constructor(properties) {
+        this.properties = properties;
+    }
+    /**
+     * Refuse a template diff that asks DynamoDB for too many index operations.
+     *
+     * https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html
+     */
+    assertAllowed() {
+        const { currentResource, updatedResource } = this.properties;
+        const current = this.tableProperties(currentResource, this.properties.currentProperties).globalSecondaryIndexes();
+        const updated = this.tableProperties(updatedResource, this.properties.updatedProperties).globalSecondaryIndexes();
+        SimDynamoDbIndexUpdate.fromInput(this.indexUpdates(current, updated));
+    }
+    tableProperties(resource, properties) {
+        return new SimCfnDynamoDbTableProperties({ resource, properties });
+    }
+    indexUpdates(current, updated) {
+        const currentNames = new Set(current.map((index) => readSimDynamoDbIndexName(index.IndexName)));
+        const updatedNames = new Set(updated.map((index) => readSimDynamoDbIndexName(index.IndexName)));
+        return [
+            ...updated
+                .filter((index) => !currentNames.has(readSimDynamoDbIndexName(index.IndexName)))
+                .map((index) => ({ Create: index })),
+            ...current
+                .filter((index) => !updatedNames.has(readSimDynamoDbIndexName(index.IndexName)))
+                .map((index) => ({ Delete: { IndexName: index.IndexName } })),
+        ];
+    }
+}

package/dist/service/dynamodb/table/sim-dynamodb-index-update.js

@@ -73,8 +73,7 @@ export class SimDynamoDbIndexUpdate {
             .map((entry) => deletedIndexName(entry))
             .filter((name) => name !== undefined);
         if (created.length + deleted.length > 1) {
-            throw new SimDynamoDbValidationException("You can create or delete only one global secondary index per " +
-                "UpdateTable operation");
+            throw new SimDynamoDbValidationException("Cannot perform more than one GSI creation or deletion in a single update");
         }
         return new this({ created: created.at(0), deletedName: deleted.at(0) });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kensio/yulin",
-  "version": "1.21.2",
+  "version": "1.21.3",
   "description": "AWS system behaviour simulation for isolated unit testing",
   "repository": "https://github.com/KensioSoftware/yulin",
   "homepage": "https://yulinsim.dev/",
@@ -297,7 +297,7 @@
     "execa": "^10.0.0",
     "fta-cli": "^3.0.0",
     "node-sql-parser": "^5.4.0",
-    "oxfmt": "^0.64.0",
+    "oxfmt": "^0.65.0",
     "oxlint": "^1.77.0",
     "oxlint-tsgolint": "^7.0.2001",
     "semantic-release": "25.0.9",