@kensio/yulin 1.1.0 → 1.3.0

package/dist/service/dynamodb/stream/sim-dynamodb-stream.js

@@ -0,0 +1,100 @@
+import { simDynamoDbStreamArn, simDynamoDbStreamLabel, } from "./sim-dynamodb-stream-arn.js";
+import { SimDynamoDbStreamRecord } from "./sim-dynamodb-stream-record.js";
+import { simDynamoDbStreamTrimPoint } from "./sim-dynamodb-stream-retention.js";
+import { SimDynamoDbStreamSequenceNumbers } from "./sim-dynamodb-stream-sequence-numbers.js";
+import { SimDynamoDbStreamShard } from "./sim-dynamodb-stream-shard.js";
+/**
+ * One stream of one table: everything that changed while it was on.
+ *
+ * A stream is made when a stream is enabled and is never remade. Disabling one
+ * and enabling another gives the table a second stream with a label and an ARN
+ * of its own, which is why the table holds these rather than being one.
+ *
+ * The key schema is held here because a record's `Keys` are cut with it, and a
+ * table's key schema never changes, so the stream can be given it once.
+ */
+export class SimDynamoDbStream {
+    arn;
+    label;
+    tableName;
+    tableArn;
+    viewType;
+    enabledAt;
+    shard;
+    keySchema;
+    sequenceNumbers = new SimDynamoDbStreamSequenceNumbers();
+    enabled = true;
+    constructor(properties) {
+        this.label = simDynamoDbStreamLabel(properties.enabledAt);
+        this.arn = simDynamoDbStreamArn(properties.tableArn, this.label);
+        this.tableName = properties.tableName;
+        this.tableArn = properties.tableArn;
+        this.viewType = properties.viewType;
+        this.enabledAt = properties.enabledAt;
+        this.keySchema = properties.keySchema;
+        this.shard = new SimDynamoDbStreamShard(properties.enabledAt);
+    }
+    /**
+     * Whether this stream is still taking the table's changes.
+     */
+    get status() {
+        return this.enabled ? "ENABLED" : "DISABLED";
+    }
+    /**
+     * The records this stream has taken, oldest first.
+     */
+    get records() {
+        return this.shard.records;
+    }
+    /**
+     * The key schema of the table this stream belongs to, as DescribeStream
+     * reports it.
+     */
+    get keySchemaElements() {
+        return this.keySchema.elements;
+    }
+    /**
+     * Drop whatever the 24 hour retention window has outlived.
+     *
+     * This is applied when the stream is read rather than scheduled, which is
+     * what `simDynamoDbStreamTrimPoint` explains. Running it twice at one instant
+     * does nothing the second time.
+     */
+    applyRetention(instant) {
+        this.shard.trim(simDynamoDbStreamTrimPoint(instant));
+    }
+    /**
+     * Take one change to the table's items.
+     *
+     * Capture is eager, and that is deliberately against the house style. An
+     * index is derived when it is read because an index is a function of the
+     * table's current state. A stream is not: put A, then B, then A leaves state
+     * A while owing two `MODIFY` records, and an insert followed by a delete
+     * leaves the table empty while owing an `INSERT` and a `REMOVE`. Nothing
+     * readable afterwards reconstructs either, so the transition is written down
+     * as it happens.
+     */
+    capture(change, at) {
+        const record = new SimDynamoDbStreamRecord({
+            change,
+            keySchema: this.keySchema,
+            viewType: this.viewType,
+            sequenceNumber: this.sequenceNumbers.take(),
+            at,
+        });
+        this.shard.append(record);
+        return record;
+    }
+    /**
+     * Stop this stream taking the table's changes.
+     *
+     * The records already on it stay where they are. Real DynamoDB keeps a
+     * disabled stream readable for the rest of its retention window, and closing
+     * the shard is how a reader finds out there will be no more.
+     */
+    disable() {
+        this.enabled = false;
+        this.shard.close();
+    }
+}
+//# sourceMappingURL=sim-dynamodb-stream.js.map

package/dist/service/dynamodb/stream/sim-dynamodb-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,gCAAgC,EAAE,MAAM,2CAA2C,CAAC;AAC7F,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAmBxE;;;;;;;;;GASG;AACH,MAAM,OAAO,iBAAiB;IACZ,GAAG,CAAS;IACZ,KAAK,CAAS;IACd,SAAS,CAAS;IAClB,QAAQ,CAAS;IACjB,QAAQ,CAA4B;IACpC,SAAS,CAAO;IAChB,KAAK,CAAyB;IAE7B,SAAS,CAAuB;IAChC,eAAe,GAAG,IAAI,gCAAgC,EAAE,CAAC;IAClE,OAAO,GAAG,IAAI,CAAC;IAEvB,YAAY,UAAuC;QACjD,IAAI,CAAC,KAAK,GAAG,sBAAsB,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,GAAG,GAAG,oBAAoB,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACjE,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;QACpC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACtC,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,IAAI,sBAAsB,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACH,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;IACjC,CAAC;IAED;;;;;;OAMG;IACH,cAAc,CAAC,OAAa;QAC1B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;;;;;OAUG;IACH,OAAO,CAAC,MAA6B,EAAE,EAAQ;QAC7C,MAAM,MAAM,GAAG,IAAI,uBAAuB,CAAC;YACzC,MAAM;YACN,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,cAAc,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE;YAC3C,EAAE;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAE1B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACH,OAAO;QACL,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/service/dynamodb/stream/sim-dynamodb-stream.types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Minimal structural sim DynamoDB stream specification, as a request carries
+ * it.
+ */
+export interface SimDynamoDbStreamSpecification {
+    readonly StreamEnabled?: boolean | undefined;
+    readonly StreamViewType?: string | undefined;
+}
+/**
+ * Minimal structural sim DynamoDB stream specification, as a table reports it.
+ *
+ * A table that has a stream reports the view type it was enabled with. One that
+ * had a stream and no longer does reports only that it is off, as real DynamoDB
+ * does, since the view type belonged to the stream rather than to the table.
+ */
+export interface SimDynamoDbStreamSpecificationDescription {
+    readonly StreamEnabled: boolean;
+    readonly StreamViewType?: SimDynamoDbStreamViewType | undefined;
+}
+/**
+ * Minimal structural sim DynamoDB stream view type.
+ */
+export type SimDynamoDbStreamViewType = "KEYS_ONLY" | "NEW_IMAGE" | "OLD_IMAGE" | "NEW_AND_OLD_IMAGES";
+//# sourceMappingURL=sim-dynamodb-stream.types.d.ts.map

package/dist/service/dynamodb/stream/sim-dynamodb-stream.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream.types.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,yCAAyC;IACxD,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,MAAM,yBAAyB,GACnC,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,oBAAoB,CAAC"}

package/dist/service/dynamodb/stream/sim-dynamodb-stream.types.js

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

package/dist/service/dynamodb/stream/sim-dynamodb-stream.types.js.map

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

package/dist/service/dynamodb/stream/sim-dynamodb-streamed-orders.factory.d.ts

@@ -0,0 +1,31 @@
+import { AsyncMappedFactory } from "@kensio/part-factory";
+import type { SimAws } from "../../aws/sim-aws.js";
+import type { SimDynamoDbStreamViewType } from "./sim-dynamodb-stream.types.js";
+import type { SimDynamoDbStream } from "./sim-dynamodb-stream.js";
+/**
+ * What a test asks for when it wants a stream with records already on it.
+ */
+export interface SimDynamoDbStreamedOrdersInput {
+    readonly tableName: string;
+    readonly viewType: SimDynamoDbStreamViewType;
+    /**
+     * How many orders to write, which is how many records the stream takes.
+     */
+    readonly orders: number;
+}
+/**
+ * Creates a stream that has already captured a number of item writes.
+ *
+ * The orders are written one at a time through PutItem, so the stream takes
+ * them in the order their identifiers count up and a test can name the record
+ * it means by position.
+ *
+ * ```typescript
+ * const stream = await simDynamoDbStreamedOrdersFactory.make(
+ *   { orders: 3 },
+ *   simAws,
+ * );
+ * ```
+ */
+export declare const simDynamoDbStreamedOrdersFactory: AsyncMappedFactory<SimDynamoDbStreamedOrdersInput, SimDynamoDbStream, SimAws>;
+//# sourceMappingURL=sim-dynamodb-streamed-orders.factory.d.ts.map

package/dist/service/dynamodb/stream/sim-dynamodb-streamed-orders.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-streamed-orders.factory.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-streamed-orders.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlE;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAE7C;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gCAAgC,+EA2B5C,CAAC"}

package/dist/service/dynamodb/stream/sim-dynamodb-streamed-orders.factory.js

@@ -0,0 +1,33 @@
+import { AsyncMappedFactory } from "@kensio/part-factory";
+import { assertDefined } from "../../../util/type-guard/defined.js";
+import { simDynamoDbStreamedTableFactory } from "./sim-dynamodb-streamed-table.factory.js";
+/**
+ * Creates a stream that has already captured a number of item writes.
+ *
+ * The orders are written one at a time through PutItem, so the stream takes
+ * them in the order their identifiers count up and a test can name the record
+ * it means by position.
+ *
+ * ```typescript
+ * const stream = await simDynamoDbStreamedOrdersFactory.make(
+ *   { orders: 3 },
+ *   simAws,
+ * );
+ * ```
+ */
+export const simDynamoDbStreamedOrdersFactory = new AsyncMappedFactory(() => ({ tableName: "orders", viewType: "NEW_AND_OLD_IMAGES", orders: 1 }), async (input, simAws) => {
+    const table = await simDynamoDbStreamedTableFactory.make({ tableName: input.tableName, viewType: input.viewType }, simAws);
+    for (let order = 1; order <= input.orders; order += 1) {
+        // eslint-disable-next-line no-await-in-loop
+        await simAws.dynamoDb().putItem({
+            input: {
+                TableName: input.tableName,
+                Item: { orderId: { S: `order-${order.toString()}` } },
+            },
+        });
+    }
+    const stream = table.stream.latest;
+    assertDefined(stream, "DynamoDB table stream");
+    return stream;
+});
+//# sourceMappingURL=sim-dynamodb-streamed-orders.factory.js.map

package/dist/service/dynamodb/stream/sim-dynamodb-streamed-orders.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-streamed-orders.factory.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-streamed-orders.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAIpE,OAAO,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AAe3F;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,IAAI,kBAAkB,CAKpE,GAAG,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,EAC1E,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IACtB,MAAM,KAAK,GAAG,MAAM,+BAA+B,CAAC,IAAI,CACtD,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,EACxD,MAAM,CACP,CAAC;IAEF,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACtD,4CAA4C;QAC5C,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC;YAC9B,KAAK,EAAE;gBACL,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,SAAS,KAAK,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE;aACtD;SACF,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;IACnC,aAAa,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IAE/C,OAAO,MAAM,CAAC;AAChB,CAAC,CACF,CAAC"}

package/dist/service/dynamodb/stream/sim-dynamodb-streamed-table.factory.d.ts

@@ -0,0 +1,31 @@
+import { AsyncMappedFactory } from "@kensio/part-factory";
+import type { SimAws } from "../../aws/sim-aws.js";
+import type { SimDynamoDbStreamViewType } from "./sim-dynamodb-stream.types.js";
+import type { SimDynamoDbTable } from "../table/sim-dynamodb-table.js";
+/**
+ * What a test asks for when it wants a table that captures its changes.
+ */
+export interface SimDynamoDbStreamedTableInput {
+    readonly tableName: string;
+    readonly partitionKeyName: string;
+    /**
+     * Which images the stream's records carry.
+     */
+    readonly viewType: SimDynamoDbStreamViewType;
+}
+/**
+ * Creates a table with a stream already switched on, through CreateTable.
+ *
+ * The table went through the ordinary command, so it is the table an
+ * application would have rather than one built around the commands, and it is
+ * ACTIVE by the time this answers.
+ *
+ * ```typescript
+ * const table = await simDynamoDbStreamedTableFactory.make(
+ *   { tableName: "orders", viewType: "NEW_AND_OLD_IMAGES" },
+ *   simAws,
+ * );
+ * ```
+ */
+export declare const simDynamoDbStreamedTableFactory: AsyncMappedFactory<SimDynamoDbStreamedTableInput, SimDynamoDbTable, SimAws>;
+//# sourceMappingURL=sim-dynamodb-streamed-table.factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-streamed-table.factory.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-streamed-table.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;CAC9C;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,+BAA+B,6EAwC3C,CAAC"}

package/dist/service/dynamodb/stream/sim-dynamodb-streamed-table.factory.js

@@ -0,0 +1,45 @@
+import { AsyncMappedFactory } from "@kensio/part-factory";
+import { assertDefined } from "../../../util/type-guard/defined.js";
+/**
+ * Creates a table with a stream already switched on, through CreateTable.
+ *
+ * The table went through the ordinary command, so it is the table an
+ * application would have rather than one built around the commands, and it is
+ * ACTIVE by the time this answers.
+ *
+ * ```typescript
+ * const table = await simDynamoDbStreamedTableFactory.make(
+ *   { tableName: "orders", viewType: "NEW_AND_OLD_IMAGES" },
+ *   simAws,
+ * );
+ * ```
+ */
+export const simDynamoDbStreamedTableFactory = new AsyncMappedFactory(() => ({
+    tableName: "orders",
+    partitionKeyName: "orderId",
+    viewType: "NEW_AND_OLD_IMAGES",
+}), async (input, simAws) => {
+    const simDynamoDb = simAws.dynamoDb();
+    await simDynamoDb.createTable({
+        input: {
+            TableName: input.tableName,
+            KeySchema: [{ AttributeName: input.partitionKeyName, KeyType: "HASH" }],
+            AttributeDefinitions: [
+                { AttributeName: input.partitionKeyName, AttributeType: "S" },
+            ],
+            BillingMode: "PAY_PER_REQUEST",
+            StreamSpecification: {
+                StreamEnabled: true,
+                StreamViewType: input.viewType,
+            },
+        },
+    });
+    await simAws.backgroundTasksComplete();
+    // A name CreateTable accepted is a table the store holds, so this is only
+    // missing if something is wrong with the simulator itself.
+    const table = simDynamoDb.findTable(input.tableName);
+    assertDefined(table, `Simulated DynamoDB created the table ${input.tableName} and then did ` +
+        `not hold it`);
+    return table;
+});
+//# sourceMappingURL=sim-dynamodb-streamed-table.factory.js.map

package/dist/service/dynamodb/stream/sim-dynamodb-streamed-table.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-streamed-table.factory.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-streamed-table.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAkBpE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAI,kBAAkB,CAKnE,GAAG,EAAE,CAAC,CAAC;IACL,SAAS,EAAE,QAAQ;IACnB,gBAAgB,EAAE,SAAS;IAC3B,QAAQ,EAAE,oBAAoB;CAC/B,CAAC,EACF,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IACtB,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAEtC,MAAM,WAAW,CAAC,WAAW,CAAC;QAC5B,KAAK,EAAE;YACL,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;YACvE,oBAAoB,EAAE;gBACpB,EAAE,aAAa,EAAE,KAAK,CAAC,gBAAgB,EAAE,aAAa,EAAE,GAAG,EAAE;aAC9D;YACD,WAAW,EAAE,iBAAiB;YAC9B,mBAAmB,EAAE;gBACnB,aAAa,EAAE,IAAI;gBACnB,cAAc,EAAE,KAAK,CAAC,QAAQ;aAC/B;SACF;KACF,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,uBAAuB,EAAE,CAAC;IAEvC,0EAA0E;IAC1E,2DAA2D;IAC3D,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACrD,aAAa,CACX,KAAK,EACL,wCAAwC,KAAK,CAAC,SAAS,gBAAgB;QACrE,aAAa,CAChB,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC,CACF,CAAC"}

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

@@ -0,0 +1,97 @@
+import type { SimArn } from "../../aws/arn.js";
+import type { SimClock } from "../../../util/clock/sim-clock.js";
+import type { SimDynamoDbStreamSpecificationDescription } from "./sim-dynamodb-stream.types.js";
+import type { SimDynamoDbKeySchema } from "../table/sim-dynamodb-key-schema.js";
+import type { SimDynamoDbItemChange, SimDynamoDbItemChanges } from "./sim-dynamodb-item-change.js";
+import { SimDynamoDbStream } from "./sim-dynamodb-stream.js";
+import { SimDynamoDbStreamActivity } from "./sim-dynamodb-stream-activity.js";
+import type { SimDynamoDbStreamRequest } from "./sim-dynamodb-stream-specification.js";
+import { SimDynamoDbStreamStore } from "./sim-dynamodb-stream-store.js";
+interface SimDynamoDbTableStreamProperties {
+    readonly tableName: string;
+    readonly tableArn: SimArn;
+    readonly keySchema: SimDynamoDbKeySchema;
+    readonly clock: SimClock;
+    readonly activity?: SimDynamoDbStreamActivity | undefined;
+}
+/**
+ * One table's stream: the setting, and what the changes are captured on.
+ *
+ * The setting and the log are held together for the same reason time to live
+ * holds the setting and the removals it drives: switching the setting on is
+ * what gives the table somewhere to write its changes, and switching it off is
+ * what stops it.
+ *
+ * A table can have had several streams over its life, since disabling one and
+ * enabling another makes a second with a label and an ARN of its own. Only one
+ * of them is ever taking changes. `latest` is the one `LatestStreamArn` names,
+ * which real DynamoDB goes on reporting after the stream has been switched off.
+ */
+export declare class SimDynamoDbTableStream implements SimDynamoDbItemChanges {
+    private readonly tableName;
+    private readonly tableArn;
+    private readonly keySchema;
+    private readonly clock;
+    private readonly activity;
+    private streams;
+    private enabled;
+    private newest;
+    constructor(properties: SimDynamoDbTableStreamProperties);
+    /**
+     * The stream taking this table's changes, when one is switched on.
+     */
+    get current(): SimDynamoDbStream | undefined;
+    /**
+     * The last stream this table had, switched on or not.
+     */
+    get latest(): SimDynamoDbStream | undefined;
+    /**
+     * How this table reports its stream setting, when it has ever had one.
+     *
+     * A table that has never had a stream reports no `StreamSpecification` at
+     * all, rather than one saying it is off, which is how a caller tells a table
+     * that never had a stream from one whose stream was switched off.
+     */
+    specification(): SimDynamoDbStreamSpecificationDescription | undefined;
+    /**
+     * Hand this table's streams to the store that resolves one by ARN.
+     *
+     * A table is built before the name it is taking has been checked, so a table
+     * that is refused for a name already in use has still made its stream by
+     * then. Registering when the table becomes real rather than when it is built
+     * is what keeps that stream from being resolvable by an ARN nobody was ever
+     * given. Until this is called a table keeps its streams to itself, which is
+     * what a table built with no simulated DynamoDB holding it does for good.
+     */
+    publishTo(streams: SimDynamoDbStreamStore): void;
+    /**
+     * Apply a stream request that has already been checked against this table.
+     *
+     * Nothing here refuses anything. A request asking for the stream the table
+     * already has, or for the removal of one it does not have, was refused while
+     * the request was being read.
+     */
+    apply(request: SimDynamoDbStreamRequest | undefined): void;
+    /**
+     * Take one change to the table's items.
+     *
+     * This is the choke point every item mutation passes through exactly once. A
+     * table with no stream on captures nothing, which is the ordinary case and
+     * costs one comparison.
+     */
+    capture(change: SimDynamoDbItemChange): void;
+    /**
+     * Switch a stream on, which makes a new one.
+     *
+     * The label and the ARN come from the instant it was enabled, so re-enabling
+     * a stream gives a different ARN to the one the table had before. Anything
+     * holding the old ARN is holding the old stream, as it would be on AWS.
+     */
+    private enable;
+    /**
+     * Switch the stream off, leaving what it captured where it is.
+     */
+    private disable;
+}
+export {};
+//# sourceMappingURL=sim-dynamodb-table-stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-table-stream.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-table-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EACV,yCAAyC,EAE1C,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AACvF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE,UAAU,gCAAgC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;CAC3D;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,sBAAuB,YAAW,sBAAsB;IACnE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,MAAM,CAAgC;IAE9C,YAAY,UAAU,EAAE,gCAAgC,EAMvD;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,iBAAiB,GAAG,SAAS,CAE3C;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,iBAAiB,GAAG,SAAS,CAE1C;IAED;;;;;;OAMG;IACH,aAAa,IAAI,yCAAyC,GAAG,SAAS,CAMrE;IAED;;;;;;;;;OASG;IACH,SAAS,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAM/C;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,wBAAwB,GAAG,SAAS,GAAG,IAAI,CAYzD;IAED;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAS3C;IAED;;;;;;OAMG;IACH,OAAO,CAAC,MAAM;IAkBd;;OAEG;IACH,OAAO,CAAC,OAAO;CAIhB"}

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

@@ -0,0 +1,135 @@
+import { SimDynamoDbStream } from "./sim-dynamodb-stream.js";
+import { SimDynamoDbStreamActivity } from "./sim-dynamodb-stream-activity.js";
+import { simDynamoDbStreamLabelInstant } from "./sim-dynamodb-stream-arn.js";
+import { SimDynamoDbStreamStore } from "./sim-dynamodb-stream-store.js";
+/**
+ * One table's stream: the setting, and what the changes are captured on.
+ *
+ * The setting and the log are held together for the same reason time to live
+ * holds the setting and the removals it drives: switching the setting on is
+ * what gives the table somewhere to write its changes, and switching it off is
+ * what stops it.
+ *
+ * A table can have had several streams over its life, since disabling one and
+ * enabling another makes a second with a label and an ARN of its own. Only one
+ * of them is ever taking changes. `latest` is the one `LatestStreamArn` names,
+ * which real DynamoDB goes on reporting after the stream has been switched off.
+ */
+export class SimDynamoDbTableStream {
+    tableName;
+    tableArn;
+    keySchema;
+    clock;
+    activity;
+    streams = new SimDynamoDbStreamStore();
+    enabled;
+    newest;
+    constructor(properties) {
+        this.tableName = properties.tableName;
+        this.tableArn = properties.tableArn;
+        this.keySchema = properties.keySchema;
+        this.clock = properties.clock;
+        this.activity = properties.activity ?? new SimDynamoDbStreamActivity();
+    }
+    /**
+     * The stream taking this table's changes, when one is switched on.
+     */
+    get current() {
+        return this.enabled;
+    }
+    /**
+     * The last stream this table had, switched on or not.
+     */
+    get latest() {
+        return this.newest;
+    }
+    /**
+     * How this table reports its stream setting, when it has ever had one.
+     *
+     * A table that has never had a stream reports no `StreamSpecification` at
+     * all, rather than one saying it is off, which is how a caller tells a table
+     * that never had a stream from one whose stream was switched off.
+     */
+    specification() {
+        if (this.enabled !== undefined) {
+            return { StreamEnabled: true, StreamViewType: this.enabled.viewType };
+        }
+        return this.newest === undefined ? undefined : { StreamEnabled: false };
+    }
+    /**
+     * Hand this table's streams to the store that resolves one by ARN.
+     *
+     * A table is built before the name it is taking has been checked, so a table
+     * that is refused for a name already in use has still made its stream by
+     * then. Registering when the table becomes real rather than when it is built
+     * is what keeps that stream from being resolvable by an ARN nobody was ever
+     * given. Until this is called a table keeps its streams to itself, which is
+     * what a table built with no simulated DynamoDB holding it does for good.
+     */
+    publishTo(streams) {
+        this.streams = streams;
+        if (this.enabled !== undefined) {
+            streams.add(this.enabled);
+        }
+    }
+    /**
+     * Apply a stream request that has already been checked against this table.
+     *
+     * Nothing here refuses anything. A request asking for the stream the table
+     * already has, or for the removal of one it does not have, was refused while
+     * the request was being read.
+     */
+    apply(request) {
+        if (request === undefined) {
+            return;
+        }
+        if (request.enabled) {
+            this.enable(request.viewType);
+            return;
+        }
+        this.disable();
+    }
+    /**
+     * Take one change to the table's items.
+     *
+     * This is the choke point every item mutation passes through exactly once. A
+     * table with no stream on captures nothing, which is the ordinary case and
+     * costs one comparison.
+     */
+    capture(change) {
+        const stream = this.enabled;
+        if (stream === undefined) {
+            return;
+        }
+        stream.capture(change, this.clock.now());
+        this.activity.recordsAvailable(stream.arn);
+    }
+    /**
+     * Switch a stream on, which makes a new one.
+     *
+     * The label and the ARN come from the instant it was enabled, so re-enabling
+     * a stream gives a different ARN to the one the table had before. Anything
+     * holding the old ARN is holding the old stream, as it would be on AWS.
+     */
+    enable(viewType) {
+        const enabledAt = simDynamoDbStreamLabelInstant(this.clock.now(), this.newest?.enabledAt);
+        const stream = new SimDynamoDbStream({
+            tableName: this.tableName,
+            tableArn: this.tableArn,
+            keySchema: this.keySchema,
+            viewType,
+            enabledAt,
+        });
+        this.enabled = stream;
+        this.newest = stream;
+        this.streams.add(stream);
+    }
+    /**
+     * Switch the stream off, leaving what it captured where it is.
+     */
+    disable() {
+        this.enabled?.disable();
+        this.enabled = undefined;
+    }
+}
+//# sourceMappingURL=sim-dynamodb-table-stream.js.map

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"sim-dynamodb-table-description.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/table/sim-dynamodb-table-description.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,2BAA2B,EAC5B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAehE;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,gBAAgB,GACtB,2BAA2B,CAoB7B"}
+{"version":3,"file":"sim-dynamodb-table-description.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/table/sim-dynamodb-table-description.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,2BAA2B,EAC5B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAehE;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,gBAAgB,GACtB,2BAA2B,CA0B7B"}

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

@@ -29,6 +29,12 @@ export function describeSimDynamoDbTable(table) {
         GlobalSecondaryIndexes: table.indexes.global.descriptions(table.status),
         LocalSecondaryIndexes: table.indexes.local.descriptions(),
         DeletionProtectionEnabled: table.deletionProtectionEnabled,
+        StreamSpecification: table.stream.specification(),
+        // These stay set once the table has had a stream, whether or not it still
+        // has one, since they name the last stream rather than the current
+        // setting. A table that has never had one reports neither.
+        LatestStreamArn: table.stream.latest?.arn,
+        LatestStreamLabel: table.stream.latest?.label,
         // Neither figure is tracked yet. Real DynamoDB updates both about every
         // six hours, so they lag behind the items anyway.
         ItemCount: 0,

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

@@ -1 +1 @@
-{"version":3,"file":"sim-dynamodb-table-description.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/table/sim-dynamodb-table-description.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,SAAS,iBAAiB,CACxB,UAA6C;IAE7C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;AACpC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAuB;IAEvB,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,GAAG;QACnB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ;QACnC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB,CAAC,QAAQ;QACzD,WAAW,EAAE,KAAK,CAAC,MAAM;QACzB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,kBAAkB,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE;QAC3C,qBAAqB,EAAE,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE;QAC5D,iBAAiB,EAAE,iBAAiB,CAAC,KAAK,CAAC,UAAU,CAAC;QACtD,sBAAsB,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC;QACvE,qBAAqB,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE;QACzD,yBAAyB,EAAE,KAAK,CAAC,yBAAyB;QAC1D,wEAAwE;QACxE,kDAAkD;QAClD,SAAS,EAAE,CAAC;QACZ,cAAc,EAAE,CAAC;KAClB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"sim-dynamodb-table-description.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/table/sim-dynamodb-table-description.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,SAAS,iBAAiB,CACxB,UAA6C;IAE7C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;AACpC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAuB;IAEvB,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,GAAG;QACnB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ;QACnC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB,CAAC,QAAQ;QACzD,WAAW,EAAE,KAAK,CAAC,MAAM;QACzB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,kBAAkB,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE;QAC3C,qBAAqB,EAAE,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE;QAC5D,iBAAiB,EAAE,iBAAiB,CAAC,KAAK,CAAC,UAAU,CAAC;QACtD,sBAAsB,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC;QACvE,qBAAqB,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE;QACzD,yBAAyB,EAAE,KAAK,CAAC,yBAAyB;QAC1D,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC,aAAa,EAAE;QACjD,0EAA0E;QAC1E,mEAAmE;QACnE,2DAA2D;QAC3D,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG;QACzC,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK;QAC7C,wEAAwE;QACxE,kDAAkD;QAClD,SAAS,EAAE,CAAC;QACZ,cAAc,EAAE,CAAC;KAClB,CAAC;AACJ,CAAC"}

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

@@ -1,4 +1,8 @@
 import type { SimDynamoDbItem } from "../item/sim-dynamodb-item.js";
+import type { SimDynamoDbItemChanges } from "../stream/sim-dynamodb-item-change.js";
+interface SimDynamoDbTableItemsProperties {
+    readonly changes: SimDynamoDbItemChanges;
+}
 /**
  * The items one simulated table holds, keyed by marshalled primary key.
  *
@@ -6,11 +10,25 @@ import type { SimDynamoDbItem } from "../item/sim-dynamodb-item.js";
  * read-your-writes as real DynamoDB is for a strongly consistent read. Nothing
  * here is scheduled: an item that a request has been told was written is an
  * item that is there.
+ *
+ * This is also where every change to an item is reported from, because it is
+ * the one place all of them pass through exactly once: PutItem, UpdateItem,
+ * DeleteItem, the batch and transactional writes, and the time to live removal
+ * all end up here and nowhere else. The old value is already read to answer
+ * with, so reporting the transition costs nothing extra.
  */
 export declare class SimDynamoDbTableItems {
     private readonly items;
+    private readonly changes;
+    constructor(properties: SimDynamoDbTableItemsProperties);
     /**
      * Write an item, and answer with whatever it replaced.
+     *
+     * A write is reported whether or not it changed anything. UpdateItem with no
+     * UpdateExpression stores the item that was already there, so the two images
+     * arrive here as the same object, and real DynamoDB writes a `MODIFY` record
+     * for that request too. Comparing the images to decide would report less than
+     * AWS does, so nothing here compares them.
      */
     put(key: string, item: SimDynamoDbItem): SimDynamoDbItem | undefined;
     /**
@@ -29,8 +47,22 @@ export declare class SimDynamoDbTableItems {
      *
      * A key holding nothing is not a failure. DynamoDB deletes by key rather than
      * by item, so removing a key that is already free asks for the state it is
-     * already in.
+     * already in, and nothing happened for a change to be reported about.
      */
     remove(key: string): SimDynamoDbItem | undefined;
+    /**
+     * Take the item held under a key because its time to live ran out.
+     *
+     * This is a removal by DynamoDB itself rather than by the application, which
+     * is the one thing about a change that cannot be worked out from the images.
+     * It is a separate call rather than a flag on `remove` so that a caller has
+     * to decide which it is making.
+     */
+    expire(key: string): SimDynamoDbItem | undefined;
+    /**
+     * Take the item held under a key, however it came to be taken.
+     */
+    private removed;
 }
+export {};
 //# sourceMappingURL=sim-dynamodb-table-items.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sim-dynamodb-table-items.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/table/sim-dynamodb-table-items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;;;;;GAOG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;IAE5D;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,eAAe,GAAG,SAAS,CAMnE;IAED;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE5C;IAED;;;;;OAKG;IACH,OAAO,IAAI,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAE9C;IAED;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAM/C;CACF"}
+{"version":3,"file":"sim-dynamodb-table-items.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/table/sim-dynamodb-table-items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAEpF,UAAU,+BAA+B;IACvC,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;CAC1C;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IAEjD,YAAY,UAAU,EAAE,+BAA+B,EAEtD;IAED;;;;;;;;OAQG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,eAAe,GAAG,SAAS,CAWnE;IAED;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE5C;IAED;;;;;OAKG;IACH,OAAO,IAAI,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAE9C;IAED;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE/C;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE/C;IAED;;OAEG;IACH,OAAO,CAAC,OAAO;CAehB"}