@kensio/yulin 0.44.0 → 0.45.0

package/dist/service/dynamodb/command/{put-item/put-item.command.d.ts → item/item.types.d.ts}

@@ -1,26 +1,11 @@
-import type { SimResponseMetadata } from "../../../aws/metadata/response-metadata.type.js";
-/**
- * Minimal structural sim DynamoDB PutItem command.
- */
-export interface SimPutItemCommand {
-    readonly input: SimPutItemCommandInput;
-}
-/**
- * Minimal structural sim DynamoDB PutItem input.
- */
-export interface SimPutItemCommandInput {
-    readonly TableName?: string | undefined;
-    readonly Item?: Record<string, SimDynamoDbAttributeValue> | undefined;
-}
-/**
- * Minimal structural sim DynamoDB PutItem output.
- */
-export interface SimPutItemCommandOutput {
-    readonly Attributes?: Record<string, SimDynamoDbAttributeValue> | undefined;
-    readonly $metadata: SimResponseMetadata;
-}
 /**
  * Minimal structural sim DynamoDB AttributeValue.
+ *
+ * The arrays are mutable and `$unknown` is a mutable tuple, matching the shape
+ * the AWS SDK declares, so a value the simulator answers with can be passed
+ * straight back into an SDK Command. That is what a paging loop does with a
+ * `LastEvaluatedKey`, and a readonly array here would make the SDK's own types
+ * refuse it.
  */
 export type SimDynamoDbAttributeValue = {
     readonly B: Uint8Array;
@@ -45,7 +30,7 @@ export type SimDynamoDbAttributeValue = {
     readonly S?: never;
     readonly SS?: never;
 } | {
-    readonly BS: readonly Uint8Array[];
+    readonly BS: Uint8Array[];
     readonly B?: never;
     readonly BOOL?: never;
     readonly L?: never;
@@ -56,7 +41,7 @@ export type SimDynamoDbAttributeValue = {
     readonly S?: never;
     readonly SS?: never;
 } | {
-    readonly L: readonly SimDynamoDbAttributeValue[];
+    readonly L: SimDynamoDbAttributeValue[];
     readonly B?: never;
     readonly BOOL?: never;
     readonly BS?: never;
@@ -89,7 +74,7 @@ export type SimDynamoDbAttributeValue = {
     readonly S?: never;
     readonly SS?: never;
 } | {
-    readonly NS: readonly string[];
+    readonly NS: string[];
     readonly B?: never;
     readonly BOOL?: never;
     readonly BS?: never;
@@ -122,7 +107,7 @@ export type SimDynamoDbAttributeValue = {
     readonly NULL?: never;
     readonly SS?: never;
 } | {
-    readonly SS: readonly string[];
+    readonly SS: string[];
     readonly B?: never;
     readonly BOOL?: never;
     readonly BS?: never;
@@ -133,7 +118,7 @@ export type SimDynamoDbAttributeValue = {
     readonly NULL?: never;
     readonly S?: never;
 } | {
-    readonly $unknown: readonly [string, unknown];
+    readonly $unknown: [string, unknown];
     readonly B?: never;
     readonly BOOL?: never;
     readonly BS?: never;
@@ -145,4 +130,39 @@ export type SimDynamoDbAttributeValue = {
     readonly S?: never;
     readonly SS?: never;
 };
-//# sourceMappingURL=put-item.command.d.ts.map
+/**
+ * Minimal structural sim DynamoDB attribute value update.
+ *
+ * This is the older way of changing part of an item, which simulated DynamoDB
+ * refuses rather than models. It is declared so a request carrying one is
+ * refused by name.
+ */
+export interface SimDynamoDbAttributeValueUpdate {
+    readonly Value?: SimDynamoDbAttributeValue | undefined;
+    readonly Action?: string | undefined;
+}
+/**
+ * Minimal structural sim DynamoDB legacy condition.
+ *
+ * This is the older way of saying which items a read wants, which
+ * `KeyConditionExpression` and `FilterExpression` replaced. It is declared so a
+ * request carrying one is refused by name.
+ */
+export interface SimDynamoDbLegacyCondition {
+    readonly ComparisonOperator?: string | undefined;
+    readonly AttributeValueList?: readonly SimDynamoDbAttributeValue[] | undefined;
+}
+/**
+ * Minimal structural sim DynamoDB expected attribute value.
+ *
+ * This is the older conditional write input, which simulated DynamoDB refuses
+ * rather than models. It is declared so a request carrying one is refused by
+ * name.
+ */
+export interface SimDynamoDbExpectedAttributeValue {
+    readonly Value?: SimDynamoDbAttributeValue | undefined;
+    readonly Exists?: boolean | undefined;
+    readonly ComparisonOperator?: string | undefined;
+    readonly AttributeValueList?: readonly SimDynamoDbAttributeValue[] | undefined;
+}
+//# sourceMappingURL=item.types.d.ts.map

package/dist/service/dynamodb/command/item/item.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item.types.d.ts","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/item/item.types.ts"],"names":[],"mappings":"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"}

package/dist/service/dynamodb/command/item/item.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=item.types.js.map

package/dist/service/dynamodb/command/item/item.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item.types.js","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/item/item.types.ts"],"names":[],"mappings":""}

package/dist/service/dynamodb/command/item/sim-dynamodb-condition-check.d.ts

@@ -0,0 +1,53 @@
+import type { SimDynamoDbCondition } from "../../expression/condition/sim-dynamodb-condition.js";
+import type { SimDynamoDbItem } from "../../item/sim-dynamodb-item.js";
+import type { SimDynamoDbAttributeValue } from "./item.types.js";
+interface SimDynamoDbConditionCheckInput {
+    readonly ConditionExpression?: string | undefined;
+    readonly ExpressionAttributeNames?: Readonly<Record<string, string>> | undefined;
+    readonly ExpressionAttributeValues?: Readonly<Record<string, SimDynamoDbAttributeValue>> | undefined;
+    readonly ReturnValuesOnConditionCheckFailure?: string | undefined;
+}
+/**
+ * The condition a write is guarded by, and what happens when it does not hold.
+ *
+ * PutItem and DeleteItem guard a write the same way, so they check it the same
+ * way. The check is against whatever is stored under the key already, which may
+ * be nothing: that is what makes `attribute_not_exists` an insert if absent.
+ */
+export declare class SimDynamoDbConditionCheck {
+    private readonly condition;
+    private readonly reportsItem;
+    private constructor();
+    /**
+     * Read the condition a request carries, before anything is looked up.
+     *
+     * An expression DynamoDB would refuse is refused whether or not the key holds
+     * anything, so a bad expression fails the same way every time.
+     */
+    static read(input: SimDynamoDbConditionCheckInput, operation: string): SimDynamoDbConditionCheck;
+    /**
+     * Guard a write with a condition that has already been read.
+     *
+     * UpdateItem reads its condition alongside its update expression, since the
+     * two share the request's placeholders, and then hands the condition here.
+     */
+    static of(condition: SimDynamoDbCondition | undefined, input: SimDynamoDbConditionCheckInput, operation: string): SimDynamoDbConditionCheck;
+    /**
+     * Whether the request asked for the item that turned it away.
+     */
+    private static reportsItemFor;
+    /**
+     * Refuse the write when the condition does not hold for what is stored.
+     *
+     * Nothing has changed by the time this throws, so the item is left exactly as
+     * it was.
+     */
+    assertHoldsFor(existing: SimDynamoDbItem | undefined): void;
+    /**
+     * The item the failure carries, when the request asked for it and there was
+     * one.
+     */
+    private reportedItem;
+}
+export {};
+//# sourceMappingURL=sim-dynamodb-condition-check.d.ts.map

package/dist/service/dynamodb/command/item/sim-dynamodb-condition-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-condition-check.d.ts","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/item/sim-dynamodb-condition-check.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sDAAsD,CAAC;AAEjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAOjE,UAAU,8BAA8B;IACtC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,wBAAwB,CAAC,EAChC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,yBAAyB,CAAC,EACjC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC,GAAG,SAAS,CAAC;IAClE,QAAQ,CAAC,mCAAmC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnE;AAOD;;;;;;GAMG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IAEtC,OAAO,eAGN;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CACT,KAAK,EAAE,8BAA8B,EACrC,SAAS,EAAE,MAAM,GAChB,yBAAyB,CAE3B;IAED;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CACP,SAAS,EAAE,oBAAoB,GAAG,SAAS,EAC3C,KAAK,EAAE,8BAA8B,EACrC,SAAS,EAAE,MAAM,GAChB,yBAAyB,CAK3B;IAED;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAoB7B;;;;;OAKG;IACH,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,GAAG,IAAI,CAY1D;IAED;;;OAGG;IACH,OAAO,CAAC,YAAY;CASrB"}

package/dist/service/dynamodb/command/item/sim-dynamodb-condition-check.js

@@ -0,0 +1,83 @@
+import { SimDynamoDbConditionalCheckFailedException, SimDynamoDbValidationException, } from "../../error/dynamodb.error.js";
+import { readSimDynamoDbCondition } from "../../expression/condition/sim-dynamodb-condition-expression.js";
+import { SimDynamoDbItemSnapshot } from "../../expression/sim-dynamodb-item-snapshot.js";
+/**
+ * What a request can ask to be given back when its condition turns it away.
+ */
+const failureModes = new Set(["NONE", "ALL_OLD"]);
+/**
+ * The condition a write is guarded by, and what happens when it does not hold.
+ *
+ * PutItem and DeleteItem guard a write the same way, so they check it the same
+ * way. The check is against whatever is stored under the key already, which may
+ * be nothing: that is what makes `attribute_not_exists` an insert if absent.
+ */
+export class SimDynamoDbConditionCheck {
+    condition;
+    reportsItem;
+    constructor(properties) {
+        this.condition = properties.condition;
+        this.reportsItem = properties.reportsItem;
+    }
+    /**
+     * Read the condition a request carries, before anything is looked up.
+     *
+     * An expression DynamoDB would refuse is refused whether or not the key holds
+     * anything, so a bad expression fails the same way every time.
+     */
+    static read(input, operation) {
+        return this.of(readSimDynamoDbCondition(input), input, operation);
+    }
+    /**
+     * Guard a write with a condition that has already been read.
+     *
+     * UpdateItem reads its condition alongside its update expression, since the
+     * two share the request's placeholders, and then hands the condition here.
+     */
+    static of(condition, input, operation) {
+        return new this({
+            condition,
+            reportsItem: this.reportsItemFor(input, operation),
+        });
+    }
+    /**
+     * Whether the request asked for the item that turned it away.
+     */
+    static reportsItemFor(input, operation) {
+        const asked = input.ReturnValuesOnConditionCheckFailure;
+        if (asked === undefined) {
+            return false;
+        }
+        if (!failureModes.has(asked)) {
+            throw new SimDynamoDbValidationException(`ReturnValuesOnConditionCheckFailure set to invalid value: ${asked}. ` +
+                `${operation} takes NONE or ALL_OLD.`);
+        }
+        return asked === "ALL_OLD";
+    }
+    /**
+     * Refuse the write when the condition does not hold for what is stored.
+     *
+     * Nothing has changed by the time this throws, so the item is left exactly as
+     * it was.
+     */
+    assertHoldsFor(existing) {
+        if (this.condition === undefined) {
+            return;
+        }
+        if (this.condition.holdsFor(new SimDynamoDbItemSnapshot(existing))) {
+            return;
+        }
+        throw new SimDynamoDbConditionalCheckFailedException(this.reportedItem(existing));
+    }
+    /**
+     * The item the failure carries, when the request asked for it and there was
+     * one.
+     */
+    reportedItem(existing) {
+        if (!this.reportsItem) {
+            return undefined;
+        }
+        return existing?.toAttributeValues();
+    }
+}
+//# sourceMappingURL=sim-dynamodb-condition-check.js.map

package/dist/service/dynamodb/command/item/sim-dynamodb-condition-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-condition-check.js","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/item/sim-dynamodb-condition-check.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0CAA0C,EAC1C,8BAA8B,GAC/B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,iEAAiE,CAAC;AAE3G,OAAO,EAAE,uBAAuB,EAAE,MAAM,gDAAgD,CAAC;AAIzF;;GAEG;AACH,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAgBvE;;;;;;GAMG;AACH,MAAM,OAAO,yBAAyB;IACnB,SAAS,CAAmC;IAC5C,WAAW,CAAU;IAEtC,YAAoB,UAA+C;QACjE,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACtC,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CACT,KAAqC,EACrC,SAAiB;QAEjB,OAAO,IAAI,CAAC,EAAE,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IACpE,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CACP,SAA2C,EAC3C,KAAqC,EACrC,SAAiB;QAEjB,OAAO,IAAI,IAAI,CAAC;YACd,SAAS;YACT,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC;SACnD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,cAAc,CAC3B,KAAqC,EACrC,SAAiB;QAEjB,MAAM,KAAK,GAAG,KAAK,CAAC,mCAAmC,CAAC;QAExD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,8BAA8B,CACtC,6DAA6D,KAAK,IAAI;gBACpE,GAAG,SAAS,yBAAyB,CACxC,CAAC;QACJ,CAAC;QAED,OAAO,KAAK,KAAK,SAAS,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,QAAqC;QAClD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,uBAAuB,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YACnE,OAAO;QACT,CAAC;QAED,MAAM,IAAI,0CAA0C,CAClD,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAC5B,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,YAAY,CAClB,QAAqC;QAErC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IACvC,CAAC;CACF"}

package/dist/service/dynamodb/command/item/sim-dynamodb-delete-item.d.ts

@@ -0,0 +1,29 @@
+import type { SimAwsCaller } from "../../../aws/caller/sim-aws-caller.js";
+import type { SimDynamoDbTableAccess } from "../table/sim-dynamodb-table-access.js";
+import type { SimDeleteItemCommand, SimDeleteItemCommandOutput } from "./item.command.js";
+interface SimDynamoDbDeleteItemProperties {
+    readonly access: SimDynamoDbTableAccess;
+}
+interface SimDynamoDbDeleteItemOptions {
+    readonly caller?: SimAwsCaller;
+}
+/**
+ * The DeleteItem command.
+ *
+ * DeleteItem names a key rather than an item, so deleting a key that holds
+ * nothing succeeds and reports nothing removed. The item is gone by the time
+ * the call returns, so a read that follows it misses.
+ *
+ * A ConditionExpression is checked against whatever is stored under the key. A
+ * condition that does not hold leaves the item exactly as it was.
+ */
+export declare class SimDynamoDbDeleteItem {
+    private readonly access;
+    constructor(properties: SimDynamoDbDeleteItemProperties);
+    /**
+     * Remove an item, and answer with the item that was removed when asked to.
+     */
+    handle(command: SimDeleteItemCommand, options?: SimDynamoDbDeleteItemOptions): SimDeleteItemCommandOutput;
+}
+export {};
+//# sourceMappingURL=sim-dynamodb-delete-item.d.ts.map

package/dist/service/dynamodb/command/item/sim-dynamodb-delete-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-delete-item.d.ts","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/item/sim-dynamodb-delete-item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AACpF,OAAO,KAAK,EACV,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,mBAAmB,CAAC;AAM3B,UAAU,+BAA+B;IACvC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;CACzC;AAED,UAAU,4BAA4B;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAEhD,YAAY,UAAU,EAAE,+BAA+B,EAEtD;IAED;;OAEG;IACH,MAAM,CACJ,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE,4BAA4B,GACrC,0BAA0B,CA4B5B;CACF"}

package/dist/service/dynamodb/command/item/sim-dynamodb-delete-item.js

@@ -0,0 +1,40 @@
+import { readSimDynamoDbKey } from "./sim-dynamodb-key-input.js";
+import { SimDynamoDbConditionCheck } from "./sim-dynamodb-condition-check.js";
+import { SimDynamoDbReturnValues } from "./sim-dynamodb-return-values.js";
+import { refuseUnsimulatedItemWriteInput } from "./sim-dynamodb-unsimulated-item-write-input.js";
+/**
+ * The DeleteItem command.
+ *
+ * DeleteItem names a key rather than an item, so deleting a key that holds
+ * nothing succeeds and reports nothing removed. The item is gone by the time
+ * the call returns, so a read that follows it misses.
+ *
+ * A ConditionExpression is checked against whatever is stored under the key. A
+ * condition that does not hold leaves the item exactly as it was.
+ */
+export class SimDynamoDbDeleteItem {
+    access;
+    constructor(properties) {
+        this.access = properties.access;
+    }
+    /**
+     * Remove an item, and answer with the item that was removed when asked to.
+     */
+    handle(command, options) {
+        const input = command.input;
+        refuseUnsimulatedItemWriteInput(input, "DeleteItem");
+        // The condition is read before the table is reached, so an expression
+        // DynamoDB would refuse is refused whether or not the key holds anything.
+        const check = SimDynamoDbConditionCheck.read(input, "DeleteItem");
+        const table = this.access.required("dynamodb:DeleteItem", input.TableName, options?.caller);
+        const asked = SimDynamoDbReturnValues.read(input.ReturnValues, "DeleteItem");
+        const key = readSimDynamoDbKey(input.Key);
+        check.assertHoldsFor(table.getItem(key));
+        const removed = table.deleteItem(key);
+        if (!asked.reportsBefore() || removed === undefined) {
+            return { $metadata: {} };
+        }
+        return { Attributes: removed.toAttributeValues(), $metadata: {} };
+    }
+}
+//# sourceMappingURL=sim-dynamodb-delete-item.js.map

package/dist/service/dynamodb/command/item/sim-dynamodb-delete-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-delete-item.js","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/item/sim-dynamodb-delete-item.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,+BAA+B,EAAE,MAAM,gDAAgD,CAAC;AAUjG;;;;;;;;;GASG;AACH,MAAM,OAAO,qBAAqB;IACf,MAAM,CAAyB;IAEhD,YAAY,UAA2C;QACrD,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,OAA6B,EAC7B,OAAsC;QAEtC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAE5B,+BAA+B,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QAErD,sEAAsE;QACtE,0EAA0E;QAC1E,MAAM,KAAK,GAAG,yBAAyB,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAChC,qBAAqB,EACrB,KAAK,CAAC,SAAS,EACf,OAAO,EAAE,MAAM,CAChB,CAAC;QACF,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,CACxC,KAAK,CAAC,YAAY,EAClB,YAAY,CACb,CAAC;QACF,MAAM,GAAG,GAAG,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE1C,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAEzC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAEtC,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACpD,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QAC3B,CAAC;QAED,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,iBAAiB,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IACpE,CAAC;CACF"}

package/dist/service/dynamodb/command/item/sim-dynamodb-get-item.d.ts

@@ -0,0 +1,30 @@
+import type { SimAwsCaller } from "../../../aws/caller/sim-aws-caller.js";
+import type { SimDynamoDbTableAccess } from "../table/sim-dynamodb-table-access.js";
+import type { SimGetItemCommand, SimGetItemCommandOutput } from "./item.command.js";
+interface SimDynamoDbGetItemProperties {
+    readonly access: SimDynamoDbTableAccess;
+}
+interface SimDynamoDbGetItemOptions {
+    readonly caller?: SimAwsCaller;
+}
+/**
+ * The GetItem command.
+ *
+ * A read here is always the latest write, whether or not `ConsistentRead` asks
+ * for one. Nothing about a write is scheduled, so there is no window in which
+ * an eventually consistent read could answer with something older.
+ */
+export declare class SimDynamoDbGetItem {
+    private readonly access;
+    constructor(properties: SimDynamoDbGetItemProperties);
+    /**
+     * Read the item a primary key names.
+     *
+     * A key holding nothing answers with no `Item` at all rather than an empty
+     * one, which is how a caller tells a miss from an item carrying nothing but
+     * its key.
+     */
+    handle(command: SimGetItemCommand, options?: SimDynamoDbGetItemOptions): SimGetItemCommandOutput;
+}
+export {};
+//# sourceMappingURL=sim-dynamodb-get-item.d.ts.map

package/dist/service/dynamodb/command/item/sim-dynamodb-get-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-get-item.d.ts","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/item/sim-dynamodb-get-item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AACpF,OAAO,KAAK,EACV,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,mBAAmB,CAAC;AAK3B,UAAU,4BAA4B;IACpC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;CACzC;AAED,UAAU,yBAAyB;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;CAChC;AAED;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAEhD,YAAY,UAAU,EAAE,4BAA4B,EAEnD;IAED;;;;;;OAMG;IACH,MAAM,CACJ,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,yBAAyB,GAClC,uBAAuB,CAyBzB;CACF"}

package/dist/service/dynamodb/command/item/sim-dynamodb-get-item.js

@@ -0,0 +1,41 @@
+import { readSimDynamoDbKey } from "./sim-dynamodb-key-input.js";
+import { refuseUnsimulatedItemReadInput } from "./sim-dynamodb-unsimulated-item-read-input.js";
+import { readSimDynamoDbProjection } from "../../expression/projection/sim-dynamodb-projection-expression.js";
+/**
+ * The GetItem command.
+ *
+ * A read here is always the latest write, whether or not `ConsistentRead` asks
+ * for one. Nothing about a write is scheduled, so there is no window in which
+ * an eventually consistent read could answer with something older.
+ */
+export class SimDynamoDbGetItem {
+    access;
+    constructor(properties) {
+        this.access = properties.access;
+    }
+    /**
+     * Read the item a primary key names.
+     *
+     * A key holding nothing answers with no `Item` at all rather than an empty
+     * one, which is how a caller tells a miss from an item carrying nothing but
+     * its key.
+     */
+    handle(command, options) {
+        const input = command.input;
+        refuseUnsimulatedItemReadInput(input);
+        // The projection is read before the table is reached, so an expression
+        // DynamoDB would refuse is refused whether or not the key holds anything.
+        const projection = readSimDynamoDbProjection(input);
+        const table = this.access.required("dynamodb:GetItem", input.TableName, options?.caller);
+        const found = table.getItem(readSimDynamoDbKey(input.Key));
+        if (found === undefined) {
+            return { $metadata: {} };
+        }
+        // A projection that found none of what it asked for leaves an item with no
+        // attributes, which is answered with as an empty Item rather than as a
+        // miss: the key was there, and nothing the request asked for was.
+        const projected = projection?.apply(found) ?? found;
+        return { Item: projected.toAttributeValues(), $metadata: {} };
+    }
+}
+//# sourceMappingURL=sim-dynamodb-get-item.js.map

package/dist/service/dynamodb/command/item/sim-dynamodb-get-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-get-item.js","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/item/sim-dynamodb-get-item.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,8BAA8B,EAAE,MAAM,+CAA+C,CAAC;AAC/F,OAAO,EAAE,yBAAyB,EAAE,MAAM,mEAAmE,CAAC;AAU9G;;;;;;GAMG;AACH,MAAM,OAAO,kBAAkB;IACZ,MAAM,CAAyB;IAEhD,YAAY,UAAwC;QAClD,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;IAClC,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CACJ,OAA0B,EAC1B,OAAmC;QAEnC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAE5B,8BAA8B,CAAC,KAAK,CAAC,CAAC;QAEtC,uEAAuE;QACvE,0EAA0E;QAC1E,MAAM,UAAU,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAChC,kBAAkB,EAClB,KAAK,CAAC,SAAS,EACf,OAAO,EAAE,MAAM,CAChB,CAAC;QACF,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAE3D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QAC3B,CAAC;QAED,2EAA2E;QAC3E,uEAAuE;QACvE,kEAAkE;QAClE,MAAM,SAAS,GAAG,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;QAEpD,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,iBAAiB,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAChE,CAAC;CACF"}

package/dist/service/dynamodb/command/item/sim-dynamodb-item-page.d.ts

@@ -0,0 +1,37 @@
+import type { SimDynamoDbItem } from "../../item/sim-dynamodb-item.js";
+import type { SimDynamoDbKeySchema } from "../../table/sim-dynamodb-key-schema.js";
+import type { SimDynamoDbAttributeValue } from "./item.types.js";
+interface SimDynamoDbItemPageProperties {
+    /** The items the walk reached, already in the order they are read in. */
+    readonly items: readonly SimDynamoDbItem[];
+    readonly limit: number | undefined;
+    readonly keySchema: SimDynamoDbKeySchema;
+}
+/**
+ * One page of items, as a Query hands them out.
+ *
+ * `Limit` counts the items a walk evaluated rather than the items it answers
+ * with. A page is cut here and filtered afterwards, which is what makes
+ * `ScannedCount` the items the read evaluated and lets a filtered page come
+ * back shorter than the limit, or empty.
+ *
+ * `LastEvaluatedKey` is there whenever the walk stopped at the limit, including
+ * when it stopped on the last matching item. A caller looping until the token
+ * is absent therefore reads one empty page at the end. That is what real
+ * DynamoDB does: it cannot know the range is exhausted without looking past it.
+ *
+ * Scan pages the same way, so this takes items and a key schema rather than a
+ * query.
+ */
+export declare class SimDynamoDbItemPage {
+    readonly items: readonly SimDynamoDbItem[];
+    readonly lastEvaluatedKey: Record<string, SimDynamoDbAttributeValue> | undefined;
+    constructor(properties: SimDynamoDbItemPageProperties);
+    /**
+     * The key to resume from, when the walk stopped at the limit rather than at
+     * the end of the range.
+     */
+    private tokenFor;
+}
+export {};
+//# sourceMappingURL=sim-dynamodb-item-page.d.ts.map

package/dist/service/dynamodb/command/item/sim-dynamodb-item-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-item-page.d.ts","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/item/sim-dynamodb-item-page.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAEnF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAwBjE,UAAU,6BAA6B;IACrC,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,mBAAmB;IAC9B,SAAgB,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAClD,SAAgB,gBAAgB,EAC9B,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,GAAG,SAAS,CAAC;IAExD,YAAY,UAAU,EAAE,6BAA6B,EAKpD;IAED;;;OAGG;IACH,OAAO,CAAC,QAAQ;CAYjB"}

package/dist/service/dynamodb/command/item/sim-dynamodb-item-page.js

@@ -0,0 +1,56 @@
+import { SimDynamoDbValidationException } from "../../error/dynamodb.error.js";
+import { simDynamoDbPrimaryKeyAttributes } from "../../table/sim-dynamodb-primary-key.js";
+/**
+ * Read the page size a request asks for.
+ *
+ * A request with no `Limit` reads everything the key range holds. Real DynamoDB
+ * stops a page at 1 MB instead, which is not modelled here, so a page breaks
+ * only on a `Limit`.
+ */
+function readLimit(limit) {
+    if (limit === undefined) {
+        return Infinity;
+    }
+    if (!Number.isSafeInteger(limit) || limit < 1) {
+        throw new SimDynamoDbValidationException(`Limit ${limit.toString()} is invalid. It is a whole number of at ` +
+            `least 1.`);
+    }
+    return limit;
+}
+/**
+ * One page of items, as a Query hands them out.
+ *
+ * `Limit` counts the items a walk evaluated rather than the items it answers
+ * with. A page is cut here and filtered afterwards, which is what makes
+ * `ScannedCount` the items the read evaluated and lets a filtered page come
+ * back shorter than the limit, or empty.
+ *
+ * `LastEvaluatedKey` is there whenever the walk stopped at the limit, including
+ * when it stopped on the last matching item. A caller looping until the token
+ * is absent therefore reads one empty page at the end. That is what real
+ * DynamoDB does: it cannot know the range is exhausted without looking past it.
+ *
+ * Scan pages the same way, so this takes items and a key schema rather than a
+ * query.
+ */
+export class SimDynamoDbItemPage {
+    items;
+    lastEvaluatedKey;
+    constructor(properties) {
+        const limit = readLimit(properties.limit);
+        this.items = properties.items.slice(0, limit);
+        this.lastEvaluatedKey = this.tokenFor(properties.keySchema, limit);
+    }
+    /**
+     * The key to resume from, when the walk stopped at the limit rather than at
+     * the end of the range.
+     */
+    tokenFor(keySchema, limit) {
+        const last = this.items.at(-1);
+        if (last === undefined || this.items.length < limit) {
+            return undefined;
+        }
+        return simDynamoDbPrimaryKeyAttributes(last, keySchema);
+    }
+}
+//# sourceMappingURL=sim-dynamodb-item-page.js.map

package/dist/service/dynamodb/command/item/sim-dynamodb-item-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-item-page.js","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/item/sim-dynamodb-item-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAG/E,OAAO,EAAE,+BAA+B,EAAE,MAAM,yCAAyC,CAAC;AAG1F;;;;;;GAMG;AACH,SAAS,SAAS,CAAC,KAAyB;IAC1C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,8BAA8B,CACtC,SAAS,KAAK,CAAC,QAAQ,EAAE,0CAA0C;YACjE,UAAU,CACb,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AASD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,mBAAmB;IACd,KAAK,CAA6B;IAClC,gBAAgB,CACwB;IAExD,YAAY,UAAyC;QACnD,MAAM,KAAK,GAAG,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAE1C,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC9C,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACrE,CAAC;IAED;;;OAGG;IACK,QAAQ,CACd,SAA+B,EAC/B,KAAa;QAEb,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAE/B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;YACpD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,+BAA+B,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/service/dynamodb/command/item/sim-dynamodb-key-input.d.ts

@@ -0,0 +1,12 @@
+import { SimDynamoDbItem } from "../../item/sim-dynamodb-item.js";
+import type { SimDynamoDbAttributeValue } from "./item.types.js";
+/**
+ * Read the Key a request names one item by.
+ *
+ * The Key is read as an item, which is what checks the attribute values it
+ * carries. What makes it a key rather than an item is checked against the
+ * table's key schema, in `SimDynamoDbItemKey`, so GetItem and DeleteItem are
+ * both held to the same rules.
+ */
+export declare function readSimDynamoDbKey(key: Readonly<Record<string, SimDynamoDbAttributeValue>> | undefined): SimDynamoDbItem;
+//# sourceMappingURL=sim-dynamodb-key-input.d.ts.map

package/dist/service/dynamodb/command/item/sim-dynamodb-key-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-key-input.d.ts","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/item/sim-dynamodb-key-input.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAEjE;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC,GAAG,SAAS,GACnE,eAAe,CAMjB"}

package/dist/service/dynamodb/command/item/sim-dynamodb-key-input.js

@@ -0,0 +1,17 @@
+import { SimDynamoDbValidationException } from "../../error/dynamodb.error.js";
+import { SimDynamoDbItem } from "../../item/sim-dynamodb-item.js";
+/**
+ * Read the Key a request names one item by.
+ *
+ * The Key is read as an item, which is what checks the attribute values it
+ * carries. What makes it a key rather than an item is checked against the
+ * table's key schema, in `SimDynamoDbItemKey`, so GetItem and DeleteItem are
+ * both held to the same rules.
+ */
+export function readSimDynamoDbKey(key) {
+    if (key === undefined || Object.keys(key).length === 0) {
+        throw new SimDynamoDbValidationException("A Key is required");
+    }
+    return SimDynamoDbItem.fromAttributeValues(key);
+}
+//# sourceMappingURL=sim-dynamodb-key-input.js.map

package/dist/service/dynamodb/command/item/sim-dynamodb-key-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-key-input.js","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/item/sim-dynamodb-key-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGlE;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAoE;IAEpE,IAAI,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,8BAA8B,CAAC,mBAAmB,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,eAAe,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;AAClD,CAAC"}

package/dist/service/dynamodb/command/item/sim-dynamodb-put-item.d.ts

@@ -0,0 +1,29 @@
+import type { SimAwsCaller } from "../../../aws/caller/sim-aws-caller.js";
+import type { SimDynamoDbTableAccess } from "../table/sim-dynamodb-table-access.js";
+import type { SimPutItemCommand, SimPutItemCommandOutput } from "./item.command.js";
+interface SimDynamoDbPutItemProperties {
+    readonly access: SimDynamoDbTableAccess;
+}
+interface SimDynamoDbPutItemOptions {
+    readonly caller?: SimAwsCaller;
+}
+/**
+ * The PutItem command.
+ *
+ * A put replaces the whole item under its primary key rather than merging into
+ * it, which is what makes PutItem different from UpdateItem. The item is
+ * written before the call returns, so a read that follows finds it.
+ *
+ * A ConditionExpression is checked against whatever is stored under the key
+ * already. A condition that does not hold leaves the table exactly as it was.
+ */
+export declare class SimDynamoDbPutItem {
+    private readonly access;
+    constructor(properties: SimDynamoDbPutItemProperties);
+    /**
+     * Write an item, and answer with the item it replaced when asked to.
+     */
+    handle(command: SimPutItemCommand, options?: SimDynamoDbPutItemOptions): SimPutItemCommandOutput;
+}
+export {};
+//# sourceMappingURL=sim-dynamodb-put-item.d.ts.map

package/dist/service/dynamodb/command/item/sim-dynamodb-put-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-put-item.d.ts","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/item/sim-dynamodb-put-item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAG1E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AACpF,OAAO,KAAK,EACV,iBAAiB,EAEjB,uBAAuB,EACxB,MAAM,mBAAmB,CAAC;AAK3B,UAAU,4BAA4B;IACpC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;CACzC;AAED,UAAU,yBAAyB;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;CAChC;AAaD;;;;;;;;;GASG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAEhD,YAAY,UAAU,EAAE,4BAA4B,EAEnD;IAED;;OAEG;IACH,MAAM,CACJ,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,yBAAyB,GAClC,uBAAuB,CAyBzB;CACF"}