@kensio/yulin 0.44.0 → 0.45.0

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

@@ -0,0 +1,45 @@
+import { readSimDynamoDbKey } from "./sim-dynamodb-key-input.js";
+import { SimDynamoDbReturnValues } from "./sim-dynamodb-return-values.js";
+import { refuseUnsimulatedItemUpdateInput } from "./sim-dynamodb-unsimulated-item-update-input.js";
+import { SimDynamoDbUpdateAnswer } from "./sim-dynamodb-update-answer.js";
+import { SimDynamoDbUpdatePlan } from "./sim-dynamodb-update-plan.js";
+/**
+ * The UpdateItem command.
+ *
+ * UpdateItem changes part of an item rather than replacing it, which is what
+ * makes it different from PutItem. It upserts: a key holding nothing gets an
+ * item built from the Key and whatever the update sets.
+ *
+ * Every action of the update expression reads the item as it stood before the
+ * request, rather than the item being built, so the actions of one expression
+ * do not see each other's work.
+ */
+export class SimDynamoDbUpdateItem {
+    access;
+    constructor(properties) {
+        this.access = properties.access;
+    }
+    /**
+     * Change an item, and answer with the item before or after it when asked to.
+     */
+    handle(command, options) {
+        const input = command.input;
+        refuseUnsimulatedItemUpdateInput(input);
+        // The expressions are read before the table is reached, so one DynamoDB
+        // would refuse is refused whether or not the key holds anything.
+        const plan = SimDynamoDbUpdatePlan.read(input, "UpdateItem");
+        const table = this.access.required("dynamodb:UpdateItem", input.TableName, options?.caller);
+        const asked = SimDynamoDbReturnValues.readForUpdate(input.ReturnValues, "UpdateItem");
+        const key = readSimDynamoDbKey(input.Key);
+        const existing = table.getItem(key);
+        plan.check.assertHoldsFor(existing);
+        plan.assertLeavesKeyAlone(table.keySchema.attributeNames());
+        const updated = plan.applyTo(existing, key);
+        table.putItem(updated);
+        return new SimDynamoDbUpdateAnswer({
+            asked,
+            touched: plan.touched(),
+        }).of(existing, updated);
+    }
+}
+//# sourceMappingURL=sim-dynamodb-update-item.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-update-item.js","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/item/sim-dynamodb-update-item.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,gCAAgC,EAAE,MAAM,iDAAiD,CAAC;AACnG,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAUtE;;;;;;;;;;GAUG;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,gCAAgC,CAAC,KAAK,CAAC,CAAC;QAExC,wEAAwE;QACxE,iEAAiE;QACjE,MAAM,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QAC7D,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,aAAa,CACjD,KAAK,CAAC,YAAY,EAClB,YAAY,CACb,CAAC;QACF,MAAM,GAAG,GAAG,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAEpC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC,CAAC;QAE5D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC5C,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAEvB,OAAO,IAAI,uBAAuB,CAAC;YACjC,KAAK;YACL,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;SACxB,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC3B,CAAC;CACF"}

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

@@ -0,0 +1,43 @@
+import { SimDynamoDbProjection } from "../../expression/projection/sim-dynamodb-projection.js";
+import type { SimDynamoDbItem } from "../../item/sim-dynamodb-item.js";
+import { SimDynamoDbConditionCheck } from "./sim-dynamodb-condition-check.js";
+import { type SimDynamoDbUpdateExpressionInput } from "./sim-dynamodb-update-expressions.js";
+interface SimDynamoDbUpdatePlanInput extends SimDynamoDbUpdateExpressionInput {
+    readonly ReturnValuesOnConditionCheckFailure?: string | undefined;
+}
+/**
+ * What an UpdateItem request says to do, and what it is guarded by.
+ */
+export declare class SimDynamoDbUpdatePlan {
+    readonly check: SimDynamoDbConditionCheck;
+    private readonly update;
+    private constructor();
+    /**
+     * Read the expressions 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: SimDynamoDbUpdatePlanInput, operation: string): SimDynamoDbUpdatePlan;
+    /**
+     * Refuse an update that would move the item's primary key.
+     */
+    assertLeavesKeyAlone(keyAttributeNames: readonly string[]): void;
+    /**
+     * The parts of an item this update touched, for the reporting modes that
+     * answer with those and nothing else.
+     *
+     * A request that says nothing to change touched nothing, so the projection it
+     * answers with finds nothing in either item.
+     */
+    touched(): SimDynamoDbProjection;
+    /**
+     * The item this update makes of the one that was there.
+     *
+     * A request with no UpdateExpression still writes: UpdateItem upserts, so it
+     * leaves the stored item alone or creates one holding nothing but the Key.
+     */
+    applyTo(existing: SimDynamoDbItem | undefined, key: SimDynamoDbItem): SimDynamoDbItem;
+}
+export {};
+//# sourceMappingURL=sim-dynamodb-update-plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-update-plan.d.ts","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/item/sim-dynamodb-update-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wDAAwD,CAAC;AAG/F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,sCAAsC,CAAC;AAE9C,UAAU,0BAA2B,SAAQ,gCAAgC;IAC3E,QAAQ,CAAC,mCAAmC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnE;AAOD;;GAEG;AACH,qBAAa,qBAAqB;IAChC,SAAgB,KAAK,EAAE,yBAAyB,CAAC;IAEjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IAEvD,OAAO,eAGN;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CACT,KAAK,EAAE,0BAA0B,EACjC,SAAS,EAAE,MAAM,GAChB,qBAAqB,CAgBvB;IAED;;OAEG;IACH,oBAAoB,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAE/D;IAED;;;;;;OAMG;IACH,OAAO,IAAI,qBAAqB,CAQ/B;IAED;;;;;OAKG;IACH,OAAO,CACL,QAAQ,EAAE,eAAe,GAAG,SAAS,EACrC,GAAG,EAAE,eAAe,GACnB,eAAe,CAMjB;CACF"}

package/dist/service/dynamodb/command/item/sim-dynamodb-update-plan.js

@@ -0,0 +1,68 @@
+import { SimDynamoDbProjection } from "../../expression/projection/sim-dynamodb-projection.js";
+import { updateExpressionName } from "../../expression/update/sim-dynamodb-update-refusal.js";
+import { SimDynamoDbConditionCheck } from "./sim-dynamodb-condition-check.js";
+import { readSimDynamoDbUpdateExpressions, } from "./sim-dynamodb-update-expressions.js";
+/**
+ * What an UpdateItem request says to do, and what it is guarded by.
+ */
+export class SimDynamoDbUpdatePlan {
+    check;
+    update;
+    constructor(properties) {
+        this.update = properties.update;
+        this.check = properties.check;
+    }
+    /**
+     * Read the expressions 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) {
+        const expression = input.UpdateExpression;
+        if (expression === undefined) {
+            return new this({
+                update: undefined,
+                check: SimDynamoDbConditionCheck.read(input, operation),
+            });
+        }
+        const read = readSimDynamoDbUpdateExpressions(input, expression);
+        return new this({
+            update: read.update,
+            check: SimDynamoDbConditionCheck.of(read.condition, input, operation),
+        });
+    }
+    /**
+     * Refuse an update that would move the item's primary key.
+     */
+    assertLeavesKeyAlone(keyAttributeNames) {
+        this.update?.assertLeavesKeyAlone(keyAttributeNames);
+    }
+    /**
+     * The parts of an item this update touched, for the reporting modes that
+     * answer with those and nothing else.
+     *
+     * A request that says nothing to change touched nothing, so the projection it
+     * answers with finds nothing in either item.
+     */
+    touched() {
+        return (this.update?.touched() ??
+            new SimDynamoDbProjection({
+                expressionName: updateExpressionName,
+                paths: [],
+            }));
+    }
+    /**
+     * The item this update makes of the one that was there.
+     *
+     * A request with no UpdateExpression still writes: UpdateItem upserts, so it
+     * leaves the stored item alone or creates one holding nothing but the Key.
+     */
+    applyTo(existing, key) {
+        if (this.update === undefined) {
+            return existing ?? key;
+        }
+        return this.update.applyTo(existing, key);
+    }
+}
+//# sourceMappingURL=sim-dynamodb-update-plan.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-update-plan.js","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/item/sim-dynamodb-update-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wDAAwD,CAAC;AAC/F,OAAO,EAAE,oBAAoB,EAAE,MAAM,wDAAwD,CAAC;AAG9F,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EACL,gCAAgC,GAEjC,MAAM,sCAAsC,CAAC;AAW9C;;GAEG;AACH,MAAM,OAAO,qBAAqB;IAChB,KAAK,CAA4B;IAEhC,MAAM,CAAgC;IAEvD,YAAoB,UAA2C;QAC7D,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;IAChC,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CACT,KAAiC,EACjC,SAAiB;QAEjB,MAAM,UAAU,GAAG,KAAK,CAAC,gBAAgB,CAAC;QAE1C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,IAAI,IAAI,CAAC;gBACd,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE,yBAAyB,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC;aACxD,CAAC,CAAC;QACL,CAAC;QAED,MAAM,IAAI,GAAG,gCAAgC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAEjE,OAAO,IAAI,IAAI,CAAC;YACd,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,yBAAyB,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC;SACtE,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,iBAAoC;QACvD,IAAI,CAAC,MAAM,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;OAMG;IACH,OAAO;QACL,OAAO,CACL,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE;YACtB,IAAI,qBAAqB,CAAC;gBACxB,cAAc,EAAE,oBAAoB;gBACpC,KAAK,EAAE,EAAE;aACV,CAAC,CACH,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,OAAO,CACL,QAAqC,EACrC,GAAoB;QAEpB,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,QAAQ,IAAI,GAAG,CAAC;QACzB,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/dist/service/dynamodb/command/query/query.command.d.ts

@@ -0,0 +1,57 @@
+import type { SimResponseMetadata } from "../../../aws/metadata/response-metadata.type.js";
+import type { SimDynamoDbAttributeValue, SimDynamoDbLegacyCondition } from "../item/item.types.js";
+/**
+ * Minimal structural sim DynamoDB Query command.
+ */
+export interface SimQueryCommand {
+    readonly input: SimQueryCommandInput;
+}
+/**
+ * Minimal structural sim DynamoDB Query input.
+ *
+ * The inputs this simulation does not model are declared as well as the ones it
+ * does, so a request that asks for one of them is refused by name rather than
+ * given a page that means something else.
+ */
+export interface SimQueryCommandInput {
+    readonly TableName?: string | undefined;
+    readonly KeyConditionExpression?: string | undefined;
+    readonly ExpressionAttributeNames?: Readonly<Record<string, string>> | undefined;
+    readonly ExpressionAttributeValues?: Readonly<Record<string, SimDynamoDbAttributeValue>> | undefined;
+    readonly ScanIndexForward?: boolean | undefined;
+    readonly Limit?: number | undefined;
+    readonly ExclusiveStartKey?: Readonly<Record<string, SimDynamoDbAttributeValue>> | undefined;
+    readonly ConsistentRead?: boolean | undefined;
+    readonly IndexName?: string | undefined;
+    readonly FilterExpression?: string | undefined;
+    readonly ProjectionExpression?: string | undefined;
+    readonly Select?: string | undefined;
+    readonly ReturnConsumedCapacity?: string | undefined;
+    readonly AttributesToGet?: readonly string[] | undefined;
+    readonly KeyConditions?: Readonly<Record<string, SimDynamoDbLegacyCondition>> | undefined;
+    readonly QueryFilter?: Readonly<Record<string, SimDynamoDbLegacyCondition>> | undefined;
+    readonly ConditionalOperator?: string | undefined;
+    readonly Segment?: number | undefined;
+    readonly TotalSegments?: number | undefined;
+}
+/**
+ * Minimal structural sim DynamoDB Query output.
+ *
+ * `ScannedCount` is how many items the walk evaluated and `Count` how many of
+ * them the filter kept, so the two are the same number for a query carrying no
+ * `FilterExpression`.
+ *
+ * `Items` is absent altogether for a `Select` of `COUNT`, rather than empty.
+ *
+ * `LastEvaluatedKey` is absent only when the key range ran out inside the
+ * `Limit`, so a caller loops until it is gone rather than until the page is
+ * short.
+ */
+export interface SimQueryCommandOutput {
+    readonly Items?: readonly Readonly<Record<string, SimDynamoDbAttributeValue>>[] | undefined;
+    readonly Count?: number | undefined;
+    readonly ScannedCount?: number | undefined;
+    readonly LastEvaluatedKey?: Readonly<Record<string, SimDynamoDbAttributeValue>> | undefined;
+    readonly $metadata: SimResponseMetadata;
+}
+//# sourceMappingURL=query.command.d.ts.map

package/dist/service/dynamodb/command/query/query.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.command.d.ts","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/query/query.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AAC3F,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;CACtC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrD,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,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,iBAAiB,CAAC,EACzB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC,GAAG,SAAS,CAAC;IAClE,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACzD,QAAQ,CAAC,aAAa,CAAC,EACrB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC,GAAG,SAAS,CAAC;IACnE,QAAQ,CAAC,WAAW,CAAC,EACnB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC,GAAG,SAAS,CAAC;IACnE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAKlD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,CAAC,EACb,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC;IAC7E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,CAAC,EACxB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC,GAAG,SAAS,CAAC;IAClE,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;CACzC"}

package/dist/service/dynamodb/command/query/query.command.js

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

package/dist/service/dynamodb/command/query/query.command.js.map

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

package/dist/service/dynamodb/command/query/sim-dynamodb-query-expressions.d.ts

@@ -0,0 +1,24 @@
+import type { SimDynamoDbFilter } from "../../expression/filter/sim-dynamodb-filter.js";
+import type { SimDynamoDbKeyConditionTerms } from "../../expression/key-condition/sim-dynamodb-key-condition-terms.js";
+import type { SimQueryCommandInput } from "./query.command.js";
+/**
+ * What a query's expressions say, once both have been read.
+ */
+export interface SimDynamoDbQueryExpressions {
+    readonly terms: SimDynamoDbKeyConditionTerms;
+    readonly filter: SimDynamoDbFilter | undefined;
+}
+/**
+ * Read both expressions of a query against one set of placeholders.
+ *
+ * `ExpressionAttributeNames` and `ExpressionAttributeValues` are shared between
+ * them, so they are checked once both have been read. A placeholder used by
+ * either counts as used, and one used by neither is refused.
+ *
+ * Both are read before the table is reached, so an expression DynamoDB would
+ * refuse is refused whether or not the table is there. What is left is the part
+ * that needs the key schema, which each of them is held to once the table has
+ * been found.
+ */
+export declare function readSimDynamoDbQueryExpressions(input: SimQueryCommandInput): SimDynamoDbQueryExpressions;
+//# sourceMappingURL=sim-dynamodb-query-expressions.d.ts.map

package/dist/service/dynamodb/command/query/sim-dynamodb-query-expressions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-query-expressions.d.ts","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/query/sim-dynamodb-query-expressions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AAExF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oEAAoE,CAAC;AAEvH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,4BAA4B,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAAC;CAChD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,oBAAoB,GAC1B,2BAA2B,CAQ7B"}

package/dist/service/dynamodb/command/query/sim-dynamodb-query-expressions.js

@@ -0,0 +1,32 @@
+import { parseSimDynamoDbFilter } from "../../expression/filter/sim-dynamodb-filter-expression.js";
+import { readSimDynamoDbKeyCondition } from "../../expression/key-condition/sim-dynamodb-key-condition-expression.js";
+import { SimDynamoDbExpressionParameters } from "../../expression/sim-dynamodb-expression-parameters.js";
+/**
+ * Read both expressions of a query against one set of placeholders.
+ *
+ * `ExpressionAttributeNames` and `ExpressionAttributeValues` are shared between
+ * them, so they are checked once both have been read. A placeholder used by
+ * either counts as used, and one used by neither is refused.
+ *
+ * Both are read before the table is reached, so an expression DynamoDB would
+ * refuse is refused whether or not the table is there. What is left is the part
+ * that needs the key schema, which each of them is held to once the table has
+ * been found.
+ */
+export function readSimDynamoDbQueryExpressions(input) {
+    const parameters = new SimDynamoDbExpressionParameters(input);
+    const terms = readSimDynamoDbKeyCondition(input, parameters);
+    const filter = filterIn(input.FilterExpression, parameters);
+    parameters.assertAllUsed();
+    return { terms, filter };
+}
+/**
+ * Read the filter a query drops read items by, if it names one.
+ */
+function filterIn(expression, parameters) {
+    if (expression === undefined) {
+        return undefined;
+    }
+    return parseSimDynamoDbFilter(expression, parameters);
+}
+//# sourceMappingURL=sim-dynamodb-query-expressions.js.map

package/dist/service/dynamodb/command/query/sim-dynamodb-query-expressions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-query-expressions.js","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/query/sim-dynamodb-query-expressions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,2DAA2D,CAAC;AAEnG,OAAO,EAAE,2BAA2B,EAAE,MAAM,yEAAyE,CAAC;AAEtH,OAAO,EAAE,+BAA+B,EAAE,MAAM,wDAAwD,CAAC;AAWzG;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,+BAA+B,CAC7C,KAA2B;IAE3B,MAAM,UAAU,GAAG,IAAI,+BAA+B,CAAC,KAAK,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,2BAA2B,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;IAE5D,UAAU,CAAC,aAAa,EAAE,CAAC;IAE3B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,SAAS,QAAQ,CACf,UAA8B,EAC9B,UAA2C;IAE3C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,sBAAsB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AACxD,CAAC"}

package/dist/service/dynamodb/command/query/sim-dynamodb-query-segment.d.ts

@@ -0,0 +1,11 @@
+import type { SimQueryCommandInput } from "./query.command.js";
+/**
+ * Refuse the parallel scan inputs on a Query.
+ *
+ * `Segment` and `TotalSegments` divide a Scan. They are not Query parameters at
+ * all, and a query has nothing to divide: it reads one item collection, which
+ * sits under one partition key and so inside one segment. A request carrying
+ * one is code that meant to scan, so it is refused rather than ignored.
+ */
+export declare function refuseSimDynamoDbQuerySegment(input: SimQueryCommandInput): void;
+//# sourceMappingURL=sim-dynamodb-query-segment.d.ts.map

package/dist/service/dynamodb/command/query/sim-dynamodb-query-segment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-query-segment.d.ts","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/query/sim-dynamodb-query-segment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,oBAAoB,GAC1B,IAAI,CAUN"}

package/dist/service/dynamodb/command/query/sim-dynamodb-query-segment.js

@@ -0,0 +1,18 @@
+import { SimDynamoDbValidationException } from "../../error/dynamodb.error.js";
+/**
+ * Refuse the parallel scan inputs on a Query.
+ *
+ * `Segment` and `TotalSegments` divide a Scan. They are not Query parameters at
+ * all, and a query has nothing to divide: it reads one item collection, which
+ * sits under one partition key and so inside one segment. A request carrying
+ * one is code that meant to scan, so it is refused rather than ignored.
+ */
+export function refuseSimDynamoDbQuerySegment(input) {
+    if (input.Segment === undefined && input.TotalSegments === undefined) {
+        return;
+    }
+    throw new SimDynamoDbValidationException("Segment and TotalSegments divide a parallel Scan, and Query does not " +
+        "take them: a query reads one item collection, which sits under one " +
+        "partition key");
+}
+//# sourceMappingURL=sim-dynamodb-query-segment.js.map

package/dist/service/dynamodb/command/query/sim-dynamodb-query-segment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-query-segment.js","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/query/sim-dynamodb-query-segment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAG/E;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAA2B;IAE3B,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACrE,OAAO;IACT,CAAC;IAED,MAAM,IAAI,8BAA8B,CACtC,uEAAuE;QACrE,qEAAqE;QACrE,eAAe,CAClB,CAAC;AACJ,CAAC"}

package/dist/service/dynamodb/command/query/sim-dynamodb-query-start-key.d.ts

@@ -0,0 +1,24 @@
+import type { SimDynamoDbKeyCondition } from "../../expression/key-condition/sim-dynamodb-key-condition.js";
+import { SimDynamoDbItem } from "../../item/sim-dynamodb-item.js";
+import type { SimDynamoDbTable } from "../../table/sim-dynamodb-table.js";
+import type { SimDynamoDbAttributeValue } from "../item/item.types.js";
+interface SimDynamoDbQueryStartKeyProperties {
+    readonly table: SimDynamoDbTable;
+    readonly keyCondition: SimDynamoDbKeyCondition;
+    readonly exclusiveStartKey: Readonly<Record<string, SimDynamoDbAttributeValue>> | undefined;
+}
+/**
+ * Read the key a query resumes after, if the request carries one.
+ *
+ * The token a page hands out is the primary key of the item the walk stopped
+ * on, so it is read back as a Key: the same rules apply as to the Key of a
+ * GetItem, and an attribute that is not part of the primary key, a missing key
+ * element or a type mismatch are refused the same way.
+ *
+ * It also has to name the item collection the query is reading. A token from
+ * another partition names a place this walk never reaches, so it is refused
+ * rather than quietly reading from the start.
+ */
+export declare function readSimDynamoDbQueryStartKey(properties: SimDynamoDbQueryStartKeyProperties): SimDynamoDbItem | undefined;
+export {};
+//# sourceMappingURL=sim-dynamodb-query-start-key.d.ts.map

package/dist/service/dynamodb/command/query/sim-dynamodb-query-start-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-query-start-key.d.ts","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/query/sim-dynamodb-query-start-key.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8DAA8D,CAAC;AAC5G,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAEvE,UAAU,kCAAkC;IAC1C,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,uBAAuB,CAAC;IAC/C,QAAQ,CAAC,iBAAiB,EACxB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC,GAAG,SAAS,CAAC;CACnE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,kCAAkC,GAC7C,eAAe,GAAG,SAAS,CAwB7B"}

package/dist/service/dynamodb/command/query/sim-dynamodb-query-start-key.js

@@ -0,0 +1,46 @@
+import { assertDefined } from "../../../../util/type-guard/defined.js";
+import { SimDynamoDbValidationException } from "../../error/dynamodb.error.js";
+import { SimDynamoDbItem } from "../../item/sim-dynamodb-item.js";
+import { simDynamoDbValuesEqual } from "../../item/sim-dynamodb-value-comparison.js";
+/**
+ * Read the key a query resumes after, if the request carries one.
+ *
+ * The token a page hands out is the primary key of the item the walk stopped
+ * on, so it is read back as a Key: the same rules apply as to the Key of a
+ * GetItem, and an attribute that is not part of the primary key, a missing key
+ * element or a type mismatch are refused the same way.
+ *
+ * It also has to name the item collection the query is reading. A token from
+ * another partition names a place this walk never reaches, so it is refused
+ * rather than quietly reading from the start.
+ */
+export function readSimDynamoDbQueryStartKey(properties) {
+    const { table, keyCondition } = properties;
+    const attributeValues = properties.exclusiveStartKey;
+    if (attributeValues === undefined) {
+        return undefined;
+    }
+    if (Object.keys(attributeValues).length === 0) {
+        throw new SimDynamoDbValidationException("An ExclusiveStartKey names the item to resume after, and this one " +
+            "names no attribute at all");
+    }
+    const startKey = SimDynamoDbItem.fromAttributeValues(attributeValues);
+    // Reading the key through the table checks it against the key schema, which
+    // is what makes a token DynamoDB would refuse refused here too.
+    table.keyOfKey(startKey);
+    assertSamePartition(startKey, table, keyCondition);
+    return startKey;
+}
+/**
+ * Refuse a token from an item collection other than the one being read.
+ */
+function assertSamePartition(startKey, table, keyCondition) {
+    const attributeName = table.keySchema.hashKeyAttributeName;
+    const value = startKey.attribute(attributeName);
+    assertDefined(value, `partition key ${attributeName} of an ExclusiveStartKey`);
+    if (!simDynamoDbValuesEqual(value, keyCondition.partitionKeyValue)) {
+        throw new SimDynamoDbValidationException(`The ExclusiveStartKey names the partition key ${attributeName} of a ` +
+            `different item collection to the one the KeyConditionExpression reads`);
+    }
+}
+//# sourceMappingURL=sim-dynamodb-query-start-key.js.map

package/dist/service/dynamodb/command/query/sim-dynamodb-query-start-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-query-start-key.js","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/query/sim-dynamodb-query-start-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AACvE,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAE/E,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AAWrF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,4BAA4B,CAC1C,UAA8C;IAE9C,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,UAAU,CAAC;IAC3C,MAAM,eAAe,GAAG,UAAU,CAAC,iBAAiB,CAAC;IAErD,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,8BAA8B,CACtC,oEAAoE;YAClE,2BAA2B,CAC9B,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC;IAEtE,4EAA4E;IAC5E,gEAAgE;IAChE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEzB,mBAAmB,CAAC,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;IAEnD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAC1B,QAAyB,EACzB,KAAuB,EACvB,YAAqC;IAErC,MAAM,aAAa,GAAG,KAAK,CAAC,SAAS,CAAC,oBAAoB,CAAC;IAC3D,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAEhD,aAAa,CACX,KAAK,EACL,iBAAiB,aAAa,0BAA0B,CACzD,CAAC;IAEF,IAAI,CAAC,sBAAsB,CAAC,KAAK,EAAE,YAAY,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,8BAA8B,CACtC,iDAAiD,aAAa,QAAQ;YACpE,uEAAuE,CAC1E,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/service/dynamodb/command/query/sim-dynamodb-query.d.ts

@@ -0,0 +1,26 @@
+import type { SimAwsCaller } from "../../../aws/caller/sim-aws-caller.js";
+import type { SimDynamoDbTableAccess } from "../table/sim-dynamodb-table-access.js";
+import type { SimQueryCommand, SimQueryCommandOutput } from "./query.command.js";
+interface SimDynamoDbQueryProperties {
+    readonly access: SimDynamoDbTableAccess;
+}
+interface SimDynamoDbQueryOptions {
+    readonly caller?: SimAwsCaller;
+}
+/**
+ * The Query command.
+ *
+ * A query reads one item collection: the items under one partition key, in sort
+ * key order. That is the whole of it, and it is why the key condition is a
+ * closed grammar rather than the general condition grammar.
+ */
+export declare class SimDynamoDbQuery {
+    private readonly access;
+    constructor(properties: SimDynamoDbQueryProperties);
+    /**
+     * Read a page of the item collection a key condition names.
+     */
+    handle(command: SimQueryCommand, options?: SimDynamoDbQueryOptions): SimQueryCommandOutput;
+}
+export {};
+//# sourceMappingURL=sim-dynamodb-query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-query.d.ts","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/query/sim-dynamodb-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAI1E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AACpF,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACtB,MAAM,oBAAoB,CAAC;AAM5B,UAAU,0BAA0B;IAClC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;CACzC;AAED,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;CAChC;AAED;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAEhD,YAAY,UAAU,EAAE,0BAA0B,EAEjD;IAED;;OAEG;IACH,MAAM,CACJ,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,uBAAuB,GAChC,qBAAqB,CAiDvB;CACF"}

package/dist/service/dynamodb/command/query/sim-dynamodb-query.js

@@ -0,0 +1,63 @@
+import { SimDynamoDbItemPage } from "../item/sim-dynamodb-item-page.js";
+import { SimDynamoDbReadAnswer } from "../read/sim-dynamodb-read-answer.js";
+import { SimDynamoDbSelect } from "../read/sim-dynamodb-select.js";
+import { readSimDynamoDbQueryExpressions } from "./sim-dynamodb-query-expressions.js";
+import { refuseSimDynamoDbQuerySegment } from "./sim-dynamodb-query-segment.js";
+import { readSimDynamoDbQueryStartKey } from "./sim-dynamodb-query-start-key.js";
+import { refuseUnsimulatedQueryInput } from "./sim-dynamodb-unsimulated-query-input.js";
+/**
+ * The Query command.
+ *
+ * A query reads one item collection: the items under one partition key, in sort
+ * key order. That is the whole of it, and it is why the key condition is a
+ * closed grammar rather than the general condition grammar.
+ */
+export class SimDynamoDbQuery {
+    access;
+    constructor(properties) {
+        this.access = properties.access;
+    }
+    /**
+     * Read a page of the item collection a key condition names.
+     */
+    handle(command, options) {
+        const input = command.input;
+        // Which attributes the request asks for is read first, since it decides
+        // whether the projection the request carries is one it could have asked
+        // for at all.
+        const select = SimDynamoDbSelect.from(input);
+        refuseUnsimulatedQueryInput(input);
+        refuseSimDynamoDbQuerySegment(input);
+        const expressions = readSimDynamoDbQueryExpressions(input);
+        const table = this.access.required("dynamodb:Query", input.TableName, options?.caller);
+        const keyCondition = expressions.terms.forTable(table);
+        // A query has narrowed the read by its key condition already, so a filter
+        // naming a key attribute is refused. That needs the key schema, so it
+        // waits for the table the same way the key condition does.
+        expressions.filter?.assertNamesNoKeyAttribute(table.keySchema);
+        // The token names an item of the collection being read, so it can only be
+        // checked once that collection is known.
+        const after = readSimDynamoDbQueryStartKey({
+            table,
+            keyCondition,
+            exclusiveStartKey: input.ExclusiveStartKey,
+        });
+        const page = new SimDynamoDbItemPage({
+            items: table.itemCollection(keyCondition).walk({
+                forward: input.ScanIndexForward ?? true,
+                after,
+            }),
+            limit: input.Limit,
+            keySchema: table.keySchema,
+        });
+        return {
+            ...new SimDynamoDbReadAnswer({
+                page,
+                filter: expressions.filter,
+                select,
+            }).fields(),
+            $metadata: {},
+        };
+    }
+}
+//# sourceMappingURL=sim-dynamodb-query.js.map

package/dist/service/dynamodb/command/query/sim-dynamodb-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-query.js","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/query/sim-dynamodb-query.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAMnE,OAAO,EAAE,+BAA+B,EAAE,MAAM,qCAAqC,CAAC;AACtF,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAUxF;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IACV,MAAM,CAAyB;IAEhD,YAAY,UAAsC;QAChD,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,OAAwB,EACxB,OAAiC;QAEjC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAE5B,wEAAwE;QACxE,wEAAwE;QACxE,cAAc;QACd,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE7C,2BAA2B,CAAC,KAAK,CAAC,CAAC;QACnC,6BAA6B,CAAC,KAAK,CAAC,CAAC;QAErC,MAAM,WAAW,GAAG,+BAA+B,CAAC,KAAK,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAChC,gBAAgB,EAChB,KAAK,CAAC,SAAS,EACf,OAAO,EAAE,MAAM,CAChB,CAAC;QACF,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAEvD,0EAA0E;QAC1E,sEAAsE;QACtE,2DAA2D;QAC3D,WAAW,CAAC,MAAM,EAAE,yBAAyB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAE/D,0EAA0E;QAC1E,yCAAyC;QACzC,MAAM,KAAK,GAAG,4BAA4B,CAAC;YACzC,KAAK;YACL,YAAY;YACZ,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;SAC3C,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,IAAI,mBAAmB,CAAC;YACnC,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC;gBAC7C,OAAO,EAAE,KAAK,CAAC,gBAAgB,IAAI,IAAI;gBACvC,KAAK;aACN,CAAC;YACF,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC,CAAC;QAEH,OAAO;YACL,GAAG,IAAI,qBAAqB,CAAC;gBAC3B,IAAI;gBACJ,MAAM,EAAE,WAAW,CAAC,MAAM;gBAC1B,MAAM;aACP,CAAC,CAAC,MAAM,EAAE;YACX,SAAS,EAAE,EAAE;SACd,CAAC;IACJ,CAAC;CACF"}

package/dist/service/dynamodb/command/query/sim-dynamodb-unsimulated-query-input.d.ts

@@ -0,0 +1,11 @@
+import type { SimQueryCommandInput } from "./query.command.js";
+/**
+ * Refuse the Query inputs this simulation does not model.
+ *
+ * Each of these changes which items a query answers with, or which parts of
+ * them, so a query that quietly ignored one would answer with more than the
+ * request asked for. That is the failure that passes here and surprises an
+ * application reading the page.
+ */
+export declare function refuseUnsimulatedQueryInput(input: SimQueryCommandInput): void;
+//# sourceMappingURL=sim-dynamodb-unsimulated-query-input.d.ts.map

package/dist/service/dynamodb/command/query/sim-dynamodb-unsimulated-query-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-unsimulated-query-input.d.ts","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/query/sim-dynamodb-unsimulated-query-input.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAsC7E"}

package/dist/service/dynamodb/command/query/sim-dynamodb-unsimulated-query-input.js

@@ -0,0 +1,20 @@
+import { SimDynamoDbUnsimulatedInput } from "../item/sim-dynamodb-unsimulated-input.js";
+/**
+ * Refuse the Query inputs this simulation does not model.
+ *
+ * Each of these changes which items a query answers with, or which parts of
+ * them, so a query that quietly ignored one would answer with more than the
+ * request asked for. That is the failure that passes here and surprises an
+ * application reading the page.
+ */
+export function refuseUnsimulatedQueryInput(input) {
+    const unsimulated = new SimDynamoDbUnsimulatedInput("Query");
+    unsimulated.refuse(input.IndexName !== undefined, "IndexName", "reading the table where a secondary index was asked for");
+    unsimulated.refuse(input.ProjectionExpression !== undefined, "ProjectionExpression", "answering with whole items where part of them was asked for");
+    unsimulated.refuse((input.AttributesToGet ?? []).length > 0, "AttributesToGet", "answering with whole items where part of them was asked for");
+    unsimulated.refuseNamed(input.KeyConditions, "KeyConditions", "reading a key condition written the way KeyConditionExpression replaced");
+    unsimulated.refuseNamed(input.QueryFilter, "QueryFilter", "answering with the items a legacy filter would have dropped");
+    unsimulated.refuse(input.ConditionalOperator !== undefined, "ConditionalOperator", "joining the legacy conditions it applies to");
+    unsimulated.refuseReporting(input.ReturnConsumedCapacity, "ReturnConsumedCapacity", "reporting a capacity cost nothing here measures");
+}
+//# sourceMappingURL=sim-dynamodb-unsimulated-query-input.js.map

package/dist/service/dynamodb/command/query/sim-dynamodb-unsimulated-query-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-unsimulated-query-input.js","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/query/sim-dynamodb-unsimulated-query-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAGxF;;;;;;;GAOG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAA2B;IACrE,MAAM,WAAW,GAAG,IAAI,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAE7D,WAAW,CAAC,MAAM,CAChB,KAAK,CAAC,SAAS,KAAK,SAAS,EAC7B,WAAW,EACX,yDAAyD,CAC1D,CAAC;IACF,WAAW,CAAC,MAAM,CAChB,KAAK,CAAC,oBAAoB,KAAK,SAAS,EACxC,sBAAsB,EACtB,6DAA6D,CAC9D,CAAC;IACF,WAAW,CAAC,MAAM,CAChB,CAAC,KAAK,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EACxC,iBAAiB,EACjB,6DAA6D,CAC9D,CAAC;IACF,WAAW,CAAC,WAAW,CACrB,KAAK,CAAC,aAAa,EACnB,eAAe,EACf,yEAAyE,CAC1E,CAAC;IACF,WAAW,CAAC,WAAW,CACrB,KAAK,CAAC,WAAW,EACjB,aAAa,EACb,6DAA6D,CAC9D,CAAC;IACF,WAAW,CAAC,MAAM,CAChB,KAAK,CAAC,mBAAmB,KAAK,SAAS,EACvC,qBAAqB,EACrB,6CAA6C,CAC9C,CAAC;IACF,WAAW,CAAC,eAAe,CACzB,KAAK,CAAC,sBAAsB,EAC5B,wBAAwB,EACxB,iDAAiD,CAClD,CAAC;AACJ,CAAC"}

package/dist/service/dynamodb/command/read/sim-dynamodb-read-answer.d.ts

@@ -0,0 +1,48 @@
+import type { SimDynamoDbFilter } from "../../expression/filter/sim-dynamodb-filter.js";
+import type { SimDynamoDbAttributeValue } from "../item/item.types.js";
+import type { SimDynamoDbItemPage } from "../item/sim-dynamodb-item-page.js";
+import type { SimDynamoDbSelect } from "./sim-dynamodb-select.js";
+/**
+ * What a query or a scan answers with, beyond its metadata.
+ */
+export interface SimDynamoDbReadFields {
+    readonly Items?: readonly Readonly<Record<string, SimDynamoDbAttributeValue>>[] | undefined;
+    readonly Count: number;
+    readonly ScannedCount: number;
+    readonly LastEvaluatedKey?: Readonly<Record<string, SimDynamoDbAttributeValue>> | undefined;
+}
+interface SimDynamoDbReadAnswerProperties {
+    readonly page: SimDynamoDbItemPage;
+    readonly filter: SimDynamoDbFilter | undefined;
+    readonly select: SimDynamoDbSelect;
+}
+/**
+ * The page a query or a scan answers with, once its filter has been applied.
+ *
+ * The order the parts run in is the whole of the behaviour. The walk is cut to
+ * the `Limit` first, so `ScannedCount` is how many items the read evaluated.
+ * The filter then drops items from that page, so `Count` is how many of them
+ * survived. A `Count` below the `Limit` therefore says nothing about whether
+ * there is more to read, and a page whose items were all dropped answers with
+ * none and still hands out a `LastEvaluatedKey`.
+ *
+ * Query and Scan answer the same way, so this takes a page rather than either
+ * of them.
+ */
+export declare class SimDynamoDbReadAnswer {
+    private readonly kept;
+    private readonly scannedCount;
+    private readonly lastEvaluatedKey;
+    private readonly select;
+    constructor(properties: SimDynamoDbReadAnswerProperties);
+    /**
+     * The fields the command output carries.
+     */
+    fields(): SimDynamoDbReadFields;
+    /**
+     * The items answered with, which a counted read leaves out altogether.
+     */
+    private items;
+}
+export {};
+//# sourceMappingURL=sim-dynamodb-read-answer.d.ts.map