@kensio/yulin 1.0.0 → 1.2.0

package/dist/service/dynamodb/table/sim-dynamodb-table-storage.d.ts

@@ -0,0 +1,95 @@
+import type { BackgroundScheduler } from "../../../util/background/background.js";
+import type { SimDynamoDbItem } from "../item/sim-dynamodb-item.js";
+import type { SimDynamoDbSecondaryIndexes } from "../secondary-index/sim-dynamodb-secondary-indexes.js";
+import type { SimDynamoDbTableStream } from "../stream/sim-dynamodb-table-stream.js";
+import { SimDynamoDbTableTimeToLive } from "../time-to-live/sim-dynamodb-table-time-to-live.js";
+import type { SimDynamoDbReadView } from "./sim-dynamodb-read-view.js";
+import type { SimDynamoDbTableDefinition } from "./sim-dynamodb-table-definition.js";
+import { SimDynamoDbTableWrites } from "./sim-dynamodb-table-writes.js";
+import type { DynamoDbTableName } from "./sim-dynamodb-table-name.js";
+interface SimDynamoDbTableStorageProperties {
+    readonly tableName: DynamoDbTableName;
+    readonly definition: SimDynamoDbTableDefinition;
+    readonly indexes: SimDynamoDbSecondaryIndexes;
+    readonly stream: SimDynamoDbTableStream;
+    readonly background: BackgroundScheduler;
+}
+/**
+ * What one simulated table holds, and everything that reaches its items.
+ *
+ * The items, the key they are held under, the writes that put them there and
+ * the time to live that takes them away are all one thing, because none of them
+ * is any use without the others: a key is read to write an item, and a write is
+ * what gives an item its deletion window. Holding them together is what leaves
+ * the table itself as what a request asks about rather than where its items
+ * live.
+ *
+ * This is built from a definition rather than from a key schema, so the key an
+ * item is stored under follows an UpdateTable that changed which attributes the
+ * table declares, without the storage having to be told about the update.
+ *
+ * The stream is handed in rather than made here, because it outlives the
+ * items: a table's stream is switched on and off by UpdateTable and keeps what
+ * it captured, where the storage is only ever what the table holds now.
+ */
+export declare class SimDynamoDbTableStorage {
+    /**
+     * The table's time to live, and the item removals it drives.
+     */
+    readonly timeToLive: SimDynamoDbTableTimeToLive;
+    /**
+     * How the table takes a write, as a check and then a commit, which is what
+     * lets a transaction prepare all of its writes before committing any.
+     */
+    readonly writes: SimDynamoDbTableWrites;
+    private readonly tableName;
+    private readonly definition;
+    private readonly indexes;
+    private readonly items;
+    constructor(properties: SimDynamoDbTableStorageProperties);
+    /**
+     * Put an item into the table, and answer with whatever it replaced. The item
+     * is there by the time this returns, since real DynamoDB acknowledges a write
+     * once it is durable.
+     */
+    putItem(item: SimDynamoDbItem): SimDynamoDbItem | undefined;
+    /**
+     * The item already stored under the same primary key as this one.
+     *
+     * A conditional write is checked against what is there before it, and what is
+     * there is found by the key inside the item rather than by a Key of its own.
+     * The key is read the same way a write reads it, so an item that could not be
+     * written does not quietly find nothing here either.
+     */
+    itemUnder(item: SimDynamoDbItem): SimDynamoDbItem | undefined;
+    /**
+     * The primary key an item is stored under, as the table marshals it.
+     *
+     * A batch write tells two operations on the same item apart by comparing
+     * these, which is why the key is readable rather than only usable. Reading it
+     * checks the item against the key schema, so a key a write would refuse is
+     * refused here too.
+     */
+    keyOfItem(item: SimDynamoDbItem): string;
+    /**
+     * The primary key a request's Key names, as the table marshals it.
+     */
+    keyOfKey(key: SimDynamoDbItem): string;
+    /**
+     * Read the item a primary key names, if the table holds one.
+     *
+     * Every write has landed by the time it returns, so this reads the latest
+     * one. That is what real DynamoDB gives a strongly consistent read.
+     */
+    getItem(key: SimDynamoDbItem): SimDynamoDbItem | undefined;
+    /**
+     * Remove the item a primary key names, and answer with whatever was removed.
+     */
+    deleteItem(key: SimDynamoDbItem): SimDynamoDbItem | undefined;
+    /**
+     * What a Query or a Scan reads: the table, or one of its indexes.
+     */
+    view(indexName: string | undefined): SimDynamoDbReadView;
+}
+export {};
+//# sourceMappingURL=sim-dynamodb-table-storage.d.ts.map

package/dist/service/dynamodb/table/sim-dynamodb-table-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-table-storage.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/table/sim-dynamodb-table-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sDAAsD,CAAC;AACxG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,MAAM,oDAAoD,CAAC;AAChG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAGrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,UAAU,iCAAiC;IACzC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,0BAA0B,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,2BAA2B,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,uBAAuB;IAClC;;OAEG;IACH,SAAgB,UAAU,EAAE,0BAA0B,CAAC;IAEvD;;;OAGG;IACH,SAAgB,MAAM,EAAE,sBAAsB,CAAC;IAE/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAE9C,YAAY,UAAU,EAAE,iCAAiC,EAgBxD;IAED;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,eAAe,GAAG,eAAe,GAAG,SAAS,CAE1D;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,IAAI,EAAE,eAAe,GAAG,eAAe,GAAG,SAAS,CAE5D;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAEvC;IAED;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAErC;IAED;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,eAAe,GAAG,eAAe,GAAG,SAAS,CAEzD;IAED;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,eAAe,GAAG,SAAS,CAE5D;IAED;;OAEG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,mBAAmB,CAUvD;CACF"}

package/dist/service/dynamodb/table/sim-dynamodb-table-storage.js

@@ -0,0 +1,120 @@
+import { SimDynamoDbTableTimeToLive } from "../time-to-live/sim-dynamodb-table-time-to-live.js";
+import { SimDynamoDbTableItems } from "./sim-dynamodb-table-items.js";
+import { simDynamoDbTableReadView } from "./sim-dynamodb-table-read-view.js";
+import { SimDynamoDbTableWrites } from "./sim-dynamodb-table-writes.js";
+/**
+ * What one simulated table holds, and everything that reaches its items.
+ *
+ * The items, the key they are held under, the writes that put them there and
+ * the time to live that takes them away are all one thing, because none of them
+ * is any use without the others: a key is read to write an item, and a write is
+ * what gives an item its deletion window. Holding them together is what leaves
+ * the table itself as what a request asks about rather than where its items
+ * live.
+ *
+ * This is built from a definition rather than from a key schema, so the key an
+ * item is stored under follows an UpdateTable that changed which attributes the
+ * table declares, without the storage having to be told about the update.
+ *
+ * The stream is handed in rather than made here, because it outlives the
+ * items: a table's stream is switched on and off by UpdateTable and keeps what
+ * it captured, where the storage is only ever what the table holds now.
+ */
+export class SimDynamoDbTableStorage {
+    /**
+     * The table's time to live, and the item removals it drives.
+     */
+    timeToLive;
+    /**
+     * How the table takes a write, as a check and then a commit, which is what
+     * lets a transaction prepare all of its writes before committing any.
+     */
+    writes;
+    tableName;
+    definition;
+    indexes;
+    items;
+    constructor(properties) {
+        this.items = new SimDynamoDbTableItems({ changes: properties.stream });
+        this.tableName = properties.tableName;
+        this.definition = properties.definition;
+        this.indexes = properties.indexes;
+        this.timeToLive = new SimDynamoDbTableTimeToLive({
+            tableName: properties.tableName,
+            items: this.items,
+            background: properties.background,
+        });
+        this.writes = new SimDynamoDbTableWrites({
+            items: this.items,
+            timeToLive: this.timeToLive,
+            definition: properties.definition,
+            indexes: properties.indexes,
+        });
+    }
+    /**
+     * Put an item into the table, and answer with whatever it replaced. The item
+     * is there by the time this returns, since real DynamoDB acknowledges a write
+     * once it is durable.
+     */
+    putItem(item) {
+        return this.writes.prepareItem(item).commit();
+    }
+    /**
+     * The item already stored under the same primary key as this one.
+     *
+     * A conditional write is checked against what is there before it, and what is
+     * there is found by the key inside the item rather than by a Key of its own.
+     * The key is read the same way a write reads it, so an item that could not be
+     * written does not quietly find nothing here either.
+     */
+    itemUnder(item) {
+        return this.items.get(this.definition.itemKey.of(item));
+    }
+    /**
+     * The primary key an item is stored under, as the table marshals it.
+     *
+     * A batch write tells two operations on the same item apart by comparing
+     * these, which is why the key is readable rather than only usable. Reading it
+     * checks the item against the key schema, so a key a write would refuse is
+     * refused here too.
+     */
+    keyOfItem(item) {
+        return this.definition.itemKey.of(item);
+    }
+    /**
+     * The primary key a request's Key names, as the table marshals it.
+     */
+    keyOfKey(key) {
+        return this.definition.itemKey.ofKey(key);
+    }
+    /**
+     * Read the item a primary key names, if the table holds one.
+     *
+     * Every write has landed by the time it returns, so this reads the latest
+     * one. That is what real DynamoDB gives a strongly consistent read.
+     */
+    getItem(key) {
+        return this.items.get(this.definition.itemKey.ofKey(key));
+    }
+    /**
+     * Remove the item a primary key names, and answer with whatever was removed.
+     */
+    deleteItem(key) {
+        return this.writes.prepareRemoval(key).commit();
+    }
+    /**
+     * What a Query or a Scan reads: the table, or one of its indexes.
+     */
+    view(indexName) {
+        return simDynamoDbTableReadView({
+            tableName: this.tableName,
+            indexName,
+            items: this.items.entries().values().toArray(),
+            keySchema: this.definition.keySchema,
+            attributeDefinitions: this.definition.attributeDefinitions,
+            indexes: this.indexes,
+            itemKey: this.definition.itemKey,
+        });
+    }
+}
+//# sourceMappingURL=sim-dynamodb-table-storage.js.map

package/dist/service/dynamodb/table/sim-dynamodb-table-storage.js.map

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

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

@@ -1,6 +1,7 @@
 import type { SimUpdateTableCommandInput } from "../command/table/table.command.js";
 import type { SimDynamoDbTableClass } from "../command/table/table.types.js";
 import type { SimDynamoDbGlobalSecondaryIndex } from "../secondary-index/sim-dynamodb-global-secondary-index.js";
+import type { SimDynamoDbStreamRequest } from "../stream/sim-dynamodb-stream-specification.js";
 import type { SimDynamoDbAttributeDefinitions } from "./sim-dynamodb-attribute-definitions.js";
 import type { SimDynamoDbTableBilling } from "./sim-dynamodb-table-billing.js";
 import type { SimDynamoDbUpdatableTable } from "./sim-dynamodb-updatable-table.js";
@@ -18,6 +19,7 @@ export declare class SimDynamoDbTableUpdate {
     readonly indexDeleted: string | undefined;
     readonly tableClass: SimDynamoDbTableClass | undefined;
     readonly deletionProtectionEnabled: boolean | undefined;
+    readonly stream: SimDynamoDbStreamRequest | undefined;
     private constructor();
     /**
      * Read the change an UpdateTable request asks a table for.

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

@@ -1 +1 @@
-{"version":3,"file":"sim-dynamodb-table-update.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/table/sim-dynamodb-table-update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAE7E,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,2DAA2D,CAAC;AACjH,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,yCAAyC,CAAC;AAE/F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE/E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AA2DnF;;;;;;GAMG;AACH,qBAAa,sBAAsB;IACjC,SAAgB,oBAAoB,EAAE,+BAA+B,CAAC;IACtE,SAAgB,OAAO,EAAE,uBAAuB,GAAG,SAAS,CAAC;IAC7D,SAAgB,YAAY,EAAE,+BAA+B,GAAG,SAAS,CAAC;IAC1E,SAAgB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjD,SAAgB,UAAU,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAC9D,SAAgB,yBAAyB,EAAE,OAAO,GAAG,SAAS,CAAC;IAE/D,OAAO,eASN;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,CACd,KAAK,EAAE,0BAA0B,EACjC,KAAK,EAAE,yBAAyB,GAC/B,sBAAsB,CAyBxB;CACF"}
+{"version":3,"file":"sim-dynamodb-table-update.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/table/sim-dynamodb-table-update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAE7E,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,2DAA2D,CAAC;AACjH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gDAAgD,CAAC;AAE/F,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,yCAAyC,CAAC;AAE/F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE/E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AA6DnF;;;;;;GAMG;AACH,qBAAa,sBAAsB;IACjC,SAAgB,oBAAoB,EAAE,+BAA+B,CAAC;IACtE,SAAgB,OAAO,EAAE,uBAAuB,GAAG,SAAS,CAAC;IAC7D,SAAgB,YAAY,EAAE,+BAA+B,GAAG,SAAS,CAAC;IAC1E,SAAgB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjD,SAAgB,UAAU,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAC9D,SAAgB,yBAAyB,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/D,SAAgB,MAAM,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAE7D,OAAO,eAUN;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,CACd,KAAK,EAAE,0BAA0B,EACjC,KAAK,EAAE,yBAAyB,GAC/B,sBAAsB,CA0BxB;CACF"}

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

@@ -1,4 +1,5 @@
 import { SimDynamoDbValidationException } from "../error/dynamodb.error.js";
+import { readSimDynamoDbStreamUpdate } from "../stream/sim-dynamodb-stream-update.js";
 import { SimDynamoDbIndexUpdate } from "./sim-dynamodb-index-update.js";
 import { readSimDynamoDbTableClass } from "./sim-dynamodb-table-class.js";
 import { readSimDynamoDbUpdatedBilling } from "./sim-dynamodb-updated-billing.js";
@@ -7,9 +8,9 @@ import { simDynamoDbCreatedIndex, simDynamoDbDeletedIndexName, } from "./sim-dyn
  * Refuse a request asking for more than one thing at a time.
  *
  * AWS takes one of these per call: change what the table is billed and
- * provisioned as, add one global secondary index, or remove one. A table class
- * or deletion protection change is not one of them and rides along with any of
- * them.
+ * provisioned as, add one global secondary index, or remove one. A table class,
+ * a deletion protection or a stream change is not one of them and rides along
+ * with any of them.
  */
 function assertOneOperation(billing, indexUpdate) {
     if (billing !== undefined && !indexUpdate.isEmpty) {
@@ -26,11 +27,12 @@ function assertAsksForSomething(properties) {
         properties.indexCreated !== undefined ||
         properties.indexDeleted !== undefined ||
         properties.tableClass !== undefined ||
-        properties.deletionProtectionEnabled !== undefined;
+        properties.deletionProtectionEnabled !== undefined ||
+        properties.stream !== undefined;
     if (!asks) {
         throw new SimDynamoDbValidationException("An UpdateTable request changes the table's billing and throughput, " +
-            "its global secondary indexes, its table class or its deletion " +
-            "protection, and this one changes none of them");
+            "its global secondary indexes, its stream, its table class or its " +
+            "deletion protection, and this one changes none of them");
     }
 }
 /**
@@ -47,6 +49,7 @@ export class SimDynamoDbTableUpdate {
     indexDeleted;
     tableClass;
     deletionProtectionEnabled;
+    stream;
     constructor(properties) {
         assertAsksForSomething(properties);
         this.attributeDefinitions = properties.attributeDefinitions;
@@ -55,6 +58,7 @@ export class SimDynamoDbTableUpdate {
         this.indexDeleted = properties.indexDeleted;
         this.tableClass = properties.tableClass;
         this.deletionProtectionEnabled = properties.deletionProtectionEnabled;
+        this.stream = properties.stream;
     }
     /**
      * Read the change an UpdateTable request asks a table for.
@@ -73,6 +77,7 @@ export class SimDynamoDbTableUpdate {
             indexDeleted: simDynamoDbDeletedIndexName(indexUpdate, table),
             tableClass: readSimDynamoDbTableClass(input.TableClass),
             deletionProtectionEnabled: input.DeletionProtectionEnabled,
+            stream: readSimDynamoDbStreamUpdate(input, table.stream),
         });
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"sim-dynamodb-table-update.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/table/sim-dynamodb-table-update.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAG5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,OAAO,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,EACL,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,mCAAmC,CAAC;AAW3C;;;;;;;GAOG;AACH,SAAS,kBAAkB,CACzB,OAA4C,EAC5C,WAAmC;IAEnC,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QAClD,MAAM,IAAI,8BAA8B,CACtC,wEAAwE;YACtE,mEAAmE;YACnE,iCAAiC,CACpC,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAC7B,UAA4C;IAE5C,MAAM,IAAI,GACR,UAAU,CAAC,OAAO,KAAK,SAAS;QAChC,UAAU,CAAC,YAAY,KAAK,SAAS;QACrC,UAAU,CAAC,YAAY,KAAK,SAAS;QACrC,UAAU,CAAC,UAAU,KAAK,SAAS;QACnC,UAAU,CAAC,yBAAyB,KAAK,SAAS,CAAC;IAErD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,8BAA8B,CACtC,qEAAqE;YACnE,gEAAgE;YAChE,+CAA+C,CAClD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,sBAAsB;IACjB,oBAAoB,CAAkC;IACtD,OAAO,CAAsC;IAC7C,YAAY,CAA8C;IAC1D,YAAY,CAAqB;IACjC,UAAU,CAAoC;IAC9C,yBAAyB,CAAsB;IAE/D,YAAoB,UAA4C;QAC9D,sBAAsB,CAAC,UAAU,CAAC,CAAC;QAEnC,IAAI,CAAC,oBAAoB,GAAG,UAAU,CAAC,oBAAoB,CAAC;QAC5D,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;QAClC,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC;QAC5C,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC;QAC5C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;QACxC,IAAI,CAAC,yBAAyB,GAAG,UAAU,CAAC,yBAAyB,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,CACd,KAAiC,EACjC,KAAgC;QAEhC,MAAM,WAAW,GAAG,sBAAsB,CAAC,SAAS,CAClD,KAAK,CAAC,2BAA2B,CAClC,CAAC;QACF,MAAM,OAAO,GAAG,6BAA6B,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC5D,kBAAkB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAEzC,4EAA4E;QAC5E,wEAAwE;QACxE,MAAM,oBAAoB,GAAG,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAC1D,KAAK,CAAC,oBAAoB,CAC3B,CAAC;QAEF,OAAO,IAAI,IAAI,CAAC;YACd,oBAAoB;YACpB,OAAO;YACP,YAAY,EAAE,uBAAuB,CACnC,WAAW,EACX,KAAK,EACL,oBAAoB,CACrB;YACD,YAAY,EAAE,2BAA2B,CAAC,WAAW,EAAE,KAAK,CAAC;YAC7D,UAAU,EAAE,yBAAyB,CAAC,KAAK,CAAC,UAAU,CAAC;YACvD,yBAAyB,EAAE,KAAK,CAAC,yBAAyB;SAC3D,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"sim-dynamodb-table-update.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/table/sim-dynamodb-table-update.ts"],"names":[],"mappings":"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"}

package/dist/service/dynamodb/table/sim-dynamodb-table-writes.d.ts

@@ -0,0 +1,57 @@
+import type { SimDynamoDbItem } from "../item/sim-dynamodb-item.js";
+import type { SimDynamoDbSecondaryIndexes } from "../secondary-index/sim-dynamodb-secondary-indexes.js";
+import type { SimDynamoDbTableTimeToLive } from "../time-to-live/sim-dynamodb-table-time-to-live.js";
+import type { SimDynamoDbTableDefinition } from "./sim-dynamodb-table-definition.js";
+import type { SimDynamoDbTableItems } from "./sim-dynamodb-table-items.js";
+/**
+ * Where a prepared write lands once it is committed.
+ */
+interface SimDynamoDbTableStore {
+    readonly items: SimDynamoDbTableItems;
+    readonly timeToLive: SimDynamoDbTableTimeToLive;
+}
+interface SimDynamoDbTableWritesProperties extends SimDynamoDbTableStore {
+    readonly definition: SimDynamoDbTableDefinition;
+    readonly indexes: SimDynamoDbSecondaryIndexes;
+}
+/**
+ * A write to a table that has passed everything it could be refused for.
+ *
+ * Committing it stores what was prepared and nothing else, so it cannot throw.
+ * That is what lets a transaction prepare all of its writes and then apply them
+ * knowing none of them will fail part way through.
+ */
+export interface SimDynamoDbTableWrite {
+    /**
+     * Make this write, and answer with whatever item it displaced.
+     */
+    commit(): SimDynamoDbItem | undefined;
+}
+/**
+ * How one table takes a write, in the two steps a transaction needs.
+ *
+ * Preparing a write does everything that can be refused, and committing it does
+ * everything that cannot. Every write in the service goes through both, so a
+ * check added to the write path is on the preparing side by construction rather
+ * than by anyone remembering to put it there.
+ */
+export declare class SimDynamoDbTableWrites {
+    private readonly store;
+    private readonly definition;
+    private readonly indexes;
+    constructor(properties: SimDynamoDbTableWritesProperties);
+    /**
+     * Check an item can be written to this table, without writing it.
+     */
+    prepareItem(item: SimDynamoDbItem): SimDynamoDbTableWrite;
+    /**
+     * Check a key can be removed from this table, without removing it.
+     *
+     * A key holding nothing is prepared as readily as one holding an item.
+     * DynamoDB deletes by key rather than by item, so removing a key that is
+     * already free asks for the state it is already in.
+     */
+    prepareRemoval(key: SimDynamoDbItem): SimDynamoDbTableWrite;
+}
+export {};
+//# sourceMappingURL=sim-dynamodb-table-writes.d.ts.map

package/dist/service/dynamodb/table/sim-dynamodb-table-writes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-table-writes.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/table/sim-dynamodb-table-writes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sDAAsD,CAAC;AACxG,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oDAAoD,CAAC;AACrG,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E;;GAEG;AACH,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,0BAA0B,CAAC;CACjD;AAED,UAAU,gCAAiC,SAAQ,qBAAqB;IACtE,QAAQ,CAAC,UAAU,EAAE,0BAA0B,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,2BAA2B,CAAC;CAC/C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,IAAI,eAAe,GAAG,SAAS,CAAC;CACvC;AA8CD;;;;;;;GAOG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IAEtD,YAAY,UAAU,EAAE,gCAAgC,EAIvD;IAED;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,qBAAqB,CASxD;IAED;;;;;;OAMG;IACH,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,qBAAqB,CAK1D;CACF"}

package/dist/service/dynamodb/table/sim-dynamodb-table-writes.js

@@ -0,0 +1,72 @@
+/**
+ * A prepared put, which is an item and the key it goes under.
+ */
+class SimDynamoDbTableItemWrite {
+    store;
+    key;
+    item;
+    constructor(store, key, item) {
+        this.store = store;
+        this.key = key;
+        this.item = item;
+    }
+    commit() {
+        const replaced = this.store.items.put(this.key, this.item);
+        this.store.timeToLive.scheduleFor(this.key, this.item);
+        return replaced;
+    }
+}
+/**
+ * A prepared delete, which is the key the item to remove is held under.
+ */
+class SimDynamoDbTableItemRemoval {
+    store;
+    key;
+    constructor(store, key) {
+        this.store = store;
+        this.key = key;
+    }
+    commit() {
+        return this.store.items.remove(this.key);
+    }
+}
+/**
+ * How one table takes a write, in the two steps a transaction needs.
+ *
+ * Preparing a write does everything that can be refused, and committing it does
+ * everything that cannot. Every write in the service goes through both, so a
+ * check added to the write path is on the preparing side by construction rather
+ * than by anyone remembering to put it there.
+ */
+export class SimDynamoDbTableWrites {
+    store;
+    definition;
+    indexes;
+    constructor(properties) {
+        this.store = { items: properties.items, timeToLive: properties.timeToLive };
+        this.definition = properties.definition;
+        this.indexes = properties.indexes;
+    }
+    /**
+     * Check an item can be written to this table, without writing it.
+     */
+    prepareItem(item) {
+        const key = this.definition.itemKey.of(item);
+        // An item need not carry an index's key attributes, since a secondary
+        // index of either kind is sparse. Carrying one as a type the index did not
+        // declare is refused, since the index could never hold it.
+        this.indexes.assertItemKeyTypes(item, this.definition.attributeDefinitions);
+        return new SimDynamoDbTableItemWrite(this.store, key, item);
+    }
+    /**
+     * Check a key can be removed from this table, without removing it.
+     *
+     * A key holding nothing is prepared as readily as one holding an item.
+     * DynamoDB deletes by key rather than by item, so removing a key that is
+     * already free asks for the state it is already in.
+     */
+    prepareRemoval(key) {
+        return new SimDynamoDbTableItemRemoval(this.store, this.definition.itemKey.ofKey(key));
+    }
+}
+//# sourceMappingURL=sim-dynamodb-table-writes.js.map

package/dist/service/dynamodb/table/sim-dynamodb-table-writes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-table-writes.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/table/sim-dynamodb-table-writes.ts"],"names":[],"mappings":"AAiCA;;GAEG;AACH,MAAM,yBAAyB;IACZ,KAAK,CAAwB;IAC7B,GAAG,CAAS;IACZ,IAAI,CAAkB;IAEvC,YACE,KAA4B,EAC5B,GAAW,EACX,IAAqB;QAErB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,MAAM;QACJ,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAE3D,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAEvD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,2BAA2B;IACd,KAAK,CAAwB;IAC7B,GAAG,CAAS;IAE7B,YAAY,KAA4B,EAAE,GAAW;QACnD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3C,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,sBAAsB;IAChB,KAAK,CAAwB;IAC7B,UAAU,CAA6B;IACvC,OAAO,CAA8B;IAEtD,YAAY,UAA4C;QACtD,IAAI,CAAC,KAAK,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,UAAU,EAAE,CAAC;QAC5E,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,IAAqB;QAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAE7C,sEAAsE;QACtE,2EAA2E;QAC3E,2DAA2D;QAC3D,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;QAE5E,OAAO,IAAI,yBAAyB,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;OAMG;IACH,cAAc,CAAC,GAAoB;QACjC,OAAO,IAAI,2BAA2B,CACpC,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CACnC,CAAC;IACJ,CAAC;CACF"}

package/dist/service/dynamodb/table/sim-dynamodb-table.d.ts

@@ -2,10 +2,14 @@ import type { SimArn } from "../../aws/arn.js";
 import { type BackgroundScheduler } from "../../../util/background/background.js";
 import type { SimDynamoDbTableClass, SimDynamoDbTableDescription, SimDynamoDbTableStatus } from "../command/table/table.types.js";
 import type { SimDynamoDbItem } from "../item/sim-dynamodb-item.js";
-import { SimDynamoDbTableTimeToLive } from "../time-to-live/sim-dynamodb-table-time-to-live.js";
+import type { SimDynamoDbStreamActivity } from "../stream/sim-dynamodb-stream-activity.js";
+import type { SimDynamoDbStreamRequest } from "../stream/sim-dynamodb-stream-specification.js";
+import { SimDynamoDbTableStream } from "../stream/sim-dynamodb-table-stream.js";
+import type { SimDynamoDbTableTimeToLive } from "../time-to-live/sim-dynamodb-table-time-to-live.js";
 import { SimDynamoDbSecondaryIndexes } from "../secondary-index/sim-dynamodb-secondary-indexes.js";
 import type { SimDynamoDbReadView } from "./sim-dynamodb-read-view.js";
 import { SimDynamoDbTableTags } from "./sim-dynamodb-table-tags.js";
+import type { SimDynamoDbTableWrites } from "./sim-dynamodb-table-writes.js";
 import type { SimDynamoDbAttributeDefinitions } from "./sim-dynamodb-attribute-definitions.js";
 import type { SimDynamoDbKeySchema } from "./sim-dynamodb-key-schema.js";
 import type { SimDynamoDbTableBilling } from "./sim-dynamodb-table-billing.js";
@@ -21,6 +25,8 @@ interface SimDynamoDbTableProperties {
     readonly tableClass?: SimDynamoDbTableClass | undefined;
     readonly deletionProtectionEnabled?: boolean | undefined;
     readonly tags?: SimDynamoDbTableTags;
+    readonly stream?: SimDynamoDbStreamRequest | undefined;
+    readonly streamActivity?: SimDynamoDbStreamActivity;
     readonly background?: BackgroundScheduler;
 }
 /**
@@ -53,33 +59,31 @@ export declare class SimDynamoDbTable {
      */
     readonly tags: SimDynamoDbTableTags;
     /**
-     * This table's time to live, and the item removals it drives.
+     * This table's stream, and the item changes captured on it.
+     *
+     * A table always has one of these, and it holds no stream until one is
+     * enabled. That is what lets the item store report every change to the same
+     * place whether or not anything is listening.
      */
-    readonly timeToLive: SimDynamoDbTableTimeToLive;
-    private readonly items;
+    readonly stream: SimDynamoDbTableStream;
     private readonly definition;
     private readonly lifecycle;
+    private readonly storage;
     constructor(properties: SimDynamoDbTableProperties);
-    /**
-     * Get the current table status.
-     */
+    /** Get the current table status. */
     get status(): SimDynamoDbTableStatus;
-    /**
-     * The attributes this table's keys are made of.
-     */
+    /** The attributes this table's keys are made of. */
     get attributeDefinitions(): SimDynamoDbAttributeDefinitions;
-    /**
-     * How this table is billed, and what it is provisioned for.
-     */
+    /** How this table is billed, and what it is provisioned for. */
     get billing(): SimDynamoDbTableBilling;
-    /**
-     * The class this table is stored under, when it was given one.
-     */
+    /** The class this table is stored under, when it was given one. */
     get tableClass(): SimDynamoDbTableClass | undefined;
-    /**
-     * Whether this table is protected from deletion.
-     */
+    /** Whether this table is protected from deletion. */
     get deletionProtectionEnabled(): boolean;
+    /** This table's time to live, and the item removals it drives. */
+    get timeToLive(): SimDynamoDbTableTimeToLive;
+    /** How this table takes a write, as a check and then a commit. */
+    get writes(): SimDynamoDbTableWrites;
     /**
      * Simulate the table entering ACTIVE status, with its indexes.
      *
@@ -90,9 +94,7 @@ export declare class SimDynamoDbTable {
      * which is what AWS gets to by copying them into it.
      */
     activate(): Promise<void>;
-    /**
-     * Refuse an update this table is not in a state to take.
-     */
+    /** Refuse an update this table is not in a state to take. */
     assertUpdatable(): void;
     /**
      * Apply a change UpdateTable has already checked against this table.
@@ -102,9 +104,7 @@ export declare class SimDynamoDbTable {
      * either applies whole or was never built.
      */
     applyUpdate(update: SimDynamoDbTableUpdate): void;
-    /**
-     * Refuse a delete this table is not in a state to take.
-     */
+    /** Refuse a delete this table is not in a state to take. */
     assertDeletable(): void;
     /**
      * Simulate the table entering DELETING status.
@@ -113,53 +113,21 @@ export declare class SimDynamoDbTable {
      * AWS. What removes it is the background task the delete schedules.
      */
     beginDeletion(): void;
-    /**
-     * Describe this table the way DynamoDB reports it.
-     */
+    /** Describe this table the way DynamoDB reports it. */
     toDescription(): SimDynamoDbTableDescription;
-    /**
-     * Put an item into the table, and answer with whatever it replaced.
-     *
-     * The item is there by the time this returns. Real DynamoDB acknowledges a
-     * write once it is durable, so a read that follows it finds it.
-     */
+    /** Put an item into the table, and answer with whatever it replaced. */
     putItem(item: SimDynamoDbItem): SimDynamoDbItem | undefined;
-    /**
-     * The item already stored under the same primary key as this one.
-     *
-     * A conditional write is checked against what is there before it, and what is
-     * there is found by the key inside the item rather than by a Key of its own.
-     * The key is read the same way a write reads it, so an item that could not be
-     * written does not quietly find nothing here either.
-     */
+    /** The item already stored under the same primary key as this one. */
     itemUnder(item: SimDynamoDbItem): SimDynamoDbItem | undefined;
-    /**
-     * The primary key an item is stored under, as this table marshals it.
-     *
-     * A batch write tells two operations on the same item apart by comparing
-     * these, which is why the key is readable rather than only usable. Reading it
-     * checks the item against the key schema, so a key a write would refuse is
-     * refused here too.
-     */
+    /** The primary key an item is stored under, as this table marshals it. */
     keyOfItem(item: SimDynamoDbItem): string;
-    /**
-     * The primary key a request's Key names, as this table marshals it.
-     */
+    /** The primary key a request's Key names, as this table marshals it. */
     keyOfKey(key: SimDynamoDbItem): string;
-    /**
-     * Read the item a primary key names, if the table holds one.
-     *
-     * Every write has landed by the time it returns, so this reads the latest
-     * one. That is what real DynamoDB gives a strongly consistent read.
-     */
+    /** Read the item a primary key names, if the table holds one. */
     getItem(key: SimDynamoDbItem): SimDynamoDbItem | undefined;
-    /**
-     * Remove the item a primary key names, and answer with whatever was removed.
-     */
+    /** Remove the item a primary key names, and what was removed with it. */
     deleteItem(key: SimDynamoDbItem): SimDynamoDbItem | undefined;
-    /**
-     * What a Query or a Scan reads: this table, or one of its indexes.
-     */
+    /** What a Query or a Scan reads: this table, or one of its indexes. */
     view(indexName: string | undefined): SimDynamoDbReadView;
 }
 export {};

package/dist/service/dynamodb/table/sim-dynamodb-table.d.ts.map

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