@kensio/yulin 1.0.0 → 1.2.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream-record-size.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-record-size.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAGzE;;;;;;;;;;;;;;GAcG;AACH,SAAS,eAAe,CAAC,KAAuB;IAC9C,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,GAAG,EAAE,CAAC;YACT,OAAO,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;QACD,KAAK,GAAG,EAAE,CAAC;YACT,OAAO,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC;QACD,KAAK,GAAG,EAAE,CAAC;YACT,OAAO,mBAAmB,CAAC,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACjE,CAAC;QACD,KAAK,MAAM,EAAE,CAAC;YACZ,OAAO,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,KAAK,MAAM,EAAE,CAAC;YACZ,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QACD,KAAK,IAAI,EAAE,CAAC;YACV,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CACvB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,EAClD,CAAC,CACF,CAAC;QACJ,CAAC;QACD,KAAK,IAAI,EAAE,CAAC;YACV,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CACzB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,GAAG,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,EAC3D,CAAC,CACF,CAAC;QACJ,CAAC;QACD,KAAK,IAAI,EAAE,CAAC;YACV,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CACvB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CACf,KAAK,GAAG,mBAAmB,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,EAC3D,CAAC,CACF,CAAC;QACJ,CAAC;QACD,KAAK,GAAG,EAAE,CAAC;YACT,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CACxB,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,EACpD,CAAC,CACF,CAAC;QACJ,CAAC;QACD,KAAK,GAAG,EAAE,CAAC;YACT,OAAO,KAAK,CAAC,OAAO;iBACjB,OAAO,EAAE;iBACT,MAAM,CACL,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CACzB,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,EAC9D,CAAC,CACF,CAAC;QACN,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,KAAsB;IAC7C,OAAO,KAAK;SACT,OAAO,EAAE;SACT,OAAO,EAAE;SACT,MAAM,CACL,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CACvB,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,EAC5D,CAAC,CACF,CAAC;AACN,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAkC;IAElC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;AAC5E,CAAC"}

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

@@ -0,0 +1,49 @@
+import type { SimDynamoDbStreamViewType } from "./sim-dynamodb-stream.types.js";
+import type { SimDynamoDbItem } from "../item/sim-dynamodb-item.js";
+import type { SimDynamoDbKeySchema } from "../table/sim-dynamodb-key-schema.js";
+import type { SimDynamoDbItemChange } from "./sim-dynamodb-item-change.js";
+/**
+ * What kind of change one stream record reports.
+ */
+export type SimDynamoDbStreamEventName = "INSERT" | "MODIFY" | "REMOVE";
+/**
+ * Who made the change a record reports, when it was not the application.
+ *
+ * Only a time to live deletion carries one. It is how an application tells a
+ * deletion it never asked for from one of its own, which matters because the
+ * two want completely different handling downstream.
+ */
+export interface SimDynamoDbStreamUserIdentity {
+    readonly type: "Service";
+    readonly principalId: "dynamodb.amazonaws.com";
+}
+interface SimDynamoDbStreamRecordProperties {
+    readonly change: SimDynamoDbItemChange;
+    readonly keySchema: SimDynamoDbKeySchema;
+    readonly viewType: SimDynamoDbStreamViewType;
+    readonly sequenceNumber: string;
+    readonly at: Date;
+}
+/**
+ * One record on a table's stream: one change, as the stream carries it.
+ *
+ * A record is fixed once it is written. The images it holds are the items as
+ * they were at the moment of the change, rather than references to whatever the
+ * table holds now, which is what makes a stream a log of transitions rather
+ * than a view of the table.
+ */
+export declare class SimDynamoDbStreamRecord {
+    readonly eventId: string;
+    readonly eventName: SimDynamoDbStreamEventName;
+    readonly sequenceNumber: string;
+    readonly approximateCreationDateTime: Date;
+    readonly streamViewType: SimDynamoDbStreamViewType;
+    readonly keys: SimDynamoDbItem;
+    readonly newImage: SimDynamoDbItem | undefined;
+    readonly oldImage: SimDynamoDbItem | undefined;
+    readonly sizeBytes: number;
+    readonly userIdentity: SimDynamoDbStreamUserIdentity | undefined;
+    constructor(properties: SimDynamoDbStreamRecordProperties);
+}
+export {};
+//# sourceMappingURL=sim-dynamodb-stream-record.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream-record.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-record.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAK3E;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC;CAChD;AAUD,UAAU,iCAAiC;IACzC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAC7C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;CACnB;AAeD;;;;;;;GAOG;AACH,qBAAa,uBAAuB;IAClC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,SAAS,EAAE,0BAA0B,CAAC;IACtD,SAAgB,cAAc,EAAE,MAAM,CAAC;IACvC,SAAgB,2BAA2B,EAAE,IAAI,CAAC;IAClD,SAAgB,cAAc,EAAE,yBAAyB,CAAC;IAC1D,SAAgB,IAAI,EAAE,eAAe,CAAC;IACtC,SAAgB,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAC;IACtD,SAAgB,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAC;IACtD,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,YAAY,EAAE,6BAA6B,GAAG,SAAS,CAAC;IAExE,YAAY,UAAU,EAAE,iCAAiC,EAwBxD;CACF"}

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

@@ -0,0 +1,60 @@
+import { randomUUID } from "node:crypto";
+import { assertDefined } from "../../../util/type-guard/defined.js";
+import { simDynamoDbStreamImages } from "./sim-dynamodb-stream-images.js";
+import { simDynamoDbStreamRecordKeys } from "./sim-dynamodb-stream-record-keys.js";
+import { simDynamoDbStreamRecordSize } from "./sim-dynamodb-stream-record-size.js";
+/**
+ * The identity a time to live deletion is written under.
+ */
+const timeToLiveIdentity = {
+    type: "Service",
+    principalId: "dynamodb.amazonaws.com",
+};
+/**
+ * Which of the three kinds of change these images are.
+ */
+function eventNameOf(change) {
+    if (change.newImage === undefined) {
+        return "REMOVE";
+    }
+    return change.oldImage === undefined ? "INSERT" : "MODIFY";
+}
+/**
+ * One record on a table's stream: one change, as the stream carries it.
+ *
+ * A record is fixed once it is written. The images it holds are the items as
+ * they were at the moment of the change, rather than references to whatever the
+ * table holds now, which is what makes a stream a log of transitions rather
+ * than a view of the table.
+ */
+export class SimDynamoDbStreamRecord {
+    eventId;
+    eventName;
+    sequenceNumber;
+    approximateCreationDateTime;
+    streamViewType;
+    keys;
+    newImage;
+    oldImage;
+    sizeBytes;
+    userIdentity;
+    constructor(properties) {
+        const { change, viewType } = properties;
+        // A change with neither image never happened, and the stream is never told
+        // about one, so the item the keys are cut from is always there.
+        const changed = change.newImage ?? change.oldImage;
+        assertDefined(changed, "DynamoDB stream record item image");
+        const images = simDynamoDbStreamImages(change, viewType);
+        this.eventId = randomUUID().replaceAll("-", "");
+        this.eventName = eventNameOf(change);
+        this.sequenceNumber = properties.sequenceNumber;
+        this.approximateCreationDateTime = properties.at;
+        this.streamViewType = viewType;
+        this.keys = simDynamoDbStreamRecordKeys(changed, properties.keySchema);
+        this.newImage = images.newImage;
+        this.oldImage = images.oldImage;
+        this.sizeBytes = simDynamoDbStreamRecordSize([this.keys, images.newImage, images.oldImage].filter((image) => image !== undefined));
+        this.userIdentity = change.expired ? timeToLiveIdentity : undefined;
+    }
+}
+//# sourceMappingURL=sim-dynamodb-stream-record.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream-record.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAKpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AAmBnF;;GAEG;AACH,MAAM,kBAAkB,GAAkC;IACxD,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,wBAAwB;CACtC,CAAC;AAUF;;GAEG;AACH,SAAS,WAAW,CAClB,MAA6B;IAE7B,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC7D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,uBAAuB;IAClB,OAAO,CAAS;IAChB,SAAS,CAA6B;IACtC,cAAc,CAAS;IACvB,2BAA2B,CAAO;IAClC,cAAc,CAA4B;IAC1C,IAAI,CAAkB;IACtB,QAAQ,CAA8B;IACtC,QAAQ,CAA8B;IACtC,SAAS,CAAS;IAClB,YAAY,CAA4C;IAExE,YAAY,UAA6C;QACvD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC;QAExC,2EAA2E;QAC3E,gEAAgE;QAChE,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC;QACnD,aAAa,CAAC,OAAO,EAAE,mCAAmC,CAAC,CAAC;QAE5D,MAAM,MAAM,GAAG,uBAAuB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAEzD,IAAI,CAAC,OAAO,GAAG,UAAU,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC,cAAc,CAAC;QAChD,IAAI,CAAC,2BAA2B,GAAG,UAAU,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;QACvE,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,2BAA2B,CAC1C,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAClD,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAC/B,CACF,CAAC;QACF,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,CAAC;CACF"}

package/dist/service/dynamodb/stream/sim-dynamodb-stream-sequence-numbers.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The sequence numbers one stream hands out.
+ *
+ * This is a counter rather than a clock. Records are commonly written inside
+ * one millisecond, and a clock cannot tell those apart, so a clock-derived
+ * sequence number would leave two records claiming the same position on the
+ * stream. Real DynamoDB varies the width between 21 and 40 digits, where these
+ * stay at 21, which is a divergence in a reader's favour: lexicographic order
+ * is numeric order here whatever two numbers are compared.
+ */
+export declare class SimDynamoDbStreamSequenceNumbers {
+    private next;
+    /**
+     * Take the next sequence number, as the text a record carries.
+     */
+    take(): string;
+}
+//# sourceMappingURL=sim-dynamodb-stream-sequence-numbers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream-sequence-numbers.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-sequence-numbers.ts"],"names":[],"mappings":"AAUA;;;;;;;;;GASG;AACH,qBAAa,gCAAgC;IAC3C,OAAO,CAAC,IAAI,CAAuB;IAEnC;;OAEG;IACH,IAAI,IAAI,MAAM,CAMb;CACF"}

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

@@ -0,0 +1,31 @@
+/**
+ * The number the first record on a stream is given.
+ *
+ * A sequence number is compared as text by anything reading a stream, so the
+ * width has to be fixed and the first digit has to be something other than a
+ * zero. Starting at 10^20 gives 21 digits of room, which is a hundred billion
+ * billion records before the width changes.
+ */
+const firstSequenceNumber = 100000000000000000000n;
+/**
+ * The sequence numbers one stream hands out.
+ *
+ * This is a counter rather than a clock. Records are commonly written inside
+ * one millisecond, and a clock cannot tell those apart, so a clock-derived
+ * sequence number would leave two records claiming the same position on the
+ * stream. Real DynamoDB varies the width between 21 and 40 digits, where these
+ * stay at 21, which is a divergence in a reader's favour: lexicographic order
+ * is numeric order here whatever two numbers are compared.
+ */
+export class SimDynamoDbStreamSequenceNumbers {
+    next = firstSequenceNumber;
+    /**
+     * Take the next sequence number, as the text a record carries.
+     */
+    take() {
+        const taken = this.next;
+        this.next += 1n;
+        return taken.toString();
+    }
+}
+//# sourceMappingURL=sim-dynamodb-stream-sequence-numbers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream-sequence-numbers.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-sequence-numbers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,mBAAmB,GAAG,sBAA4B,CAAC;AAEzD;;;;;;;;;GASG;AACH,MAAM,OAAO,gCAAgC;IACnC,IAAI,GAAG,mBAAmB,CAAC;IAEnC;;OAEG;IACH,IAAI;QACF,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC;QAExB,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QAEhB,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;CACF"}

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

@@ -0,0 +1,39 @@
+import type { SimDynamoDbStreamRecord } from "./sim-dynamodb-stream-record.js";
+/**
+ * The one shard of one stream, and the records written to it.
+ *
+ * AWS documents an open shard as corresponding to one table partition, and a
+ * simulated table is always one partition, so one shard per stream is accurate
+ * rather than a shortcut. Nothing here splits: a shard is opened when the
+ * stream is enabled and closed when it is disabled.
+ *
+ * The total order that gives across every key is stronger than the per-key
+ * order AWS guarantees. A consumer relying on it here would be relying on
+ * something real DynamoDB does not promise.
+ */
+export declare class SimDynamoDbStreamShard {
+    readonly shardId: string;
+    private readonly written;
+    private open;
+    constructor(at: Date);
+    /**
+     * Whether this shard is still taking records.
+     */
+    get isOpen(): boolean;
+    /**
+     * The records written to this shard, oldest first.
+     */
+    get records(): readonly SimDynamoDbStreamRecord[];
+    /**
+     * Write a record to this shard.
+     */
+    append(record: SimDynamoDbStreamRecord): void;
+    /**
+     * Close this shard to further records.
+     *
+     * What is already on it stays readable: disabling a stream stops it taking
+     * changes rather than throwing away the ones it took.
+     */
+    close(): void;
+}
+//# sourceMappingURL=sim-dynamodb-stream-shard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream-shard.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-shard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAoB/E;;;;;;;;;;;GAWG;AACH,qBAAa,sBAAsB;IACjC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAEhC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,IAAI,CAAQ;IAEpB,YAAY,EAAE,EAAE,IAAI,EAEnB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,SAAS,uBAAuB,EAAE,CAEhD;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAE5C;IAED;;;;;OAKG;IACH,KAAK,IAAI,IAAI,CAEZ;CACF"}

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

@@ -0,0 +1,64 @@
+import { randomUUID } from "node:crypto";
+/**
+ * How many digits DynamoDB pads a shard identifier's instant to.
+ */
+const shardInstantDigits = 20;
+/**
+ * The identifier a shard opened at an instant carries.
+ *
+ * DynamoDB shapes these as `shardId-00000001414562045508-2bac9cd2`: the instant
+ * the shard opened, padded, and then something to tell two shards opened at one
+ * instant apart.
+ */
+function shardId(at) {
+    const opened = at.getTime().toString().padStart(shardInstantDigits, "0");
+    return `shardId-${opened}-${randomUUID().slice(0, 8)}`;
+}
+/**
+ * The one shard of one stream, and the records written to it.
+ *
+ * AWS documents an open shard as corresponding to one table partition, and a
+ * simulated table is always one partition, so one shard per stream is accurate
+ * rather than a shortcut. Nothing here splits: a shard is opened when the
+ * stream is enabled and closed when it is disabled.
+ *
+ * The total order that gives across every key is stronger than the per-key
+ * order AWS guarantees. A consumer relying on it here would be relying on
+ * something real DynamoDB does not promise.
+ */
+export class SimDynamoDbStreamShard {
+    shardId;
+    written = [];
+    open = true;
+    constructor(at) {
+        this.shardId = shardId(at);
+    }
+    /**
+     * Whether this shard is still taking records.
+     */
+    get isOpen() {
+        return this.open;
+    }
+    /**
+     * The records written to this shard, oldest first.
+     */
+    get records() {
+        return this.written;
+    }
+    /**
+     * Write a record to this shard.
+     */
+    append(record) {
+        this.written.push(record);
+    }
+    /**
+     * Close this shard to further records.
+     *
+     * What is already on it stays readable: disabling a stream stops it taking
+     * changes rather than throwing away the ones it took.
+     */
+    close() {
+        this.open = false;
+    }
+}
+//# sourceMappingURL=sim-dynamodb-stream-shard.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream-shard.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-shard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;GAEG;AACH,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B;;;;;;GAMG;AACH,SAAS,OAAO,CAAC,EAAQ;IACvB,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;IAEzE,OAAO,WAAW,MAAM,IAAI,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,sBAAsB;IACjB,OAAO,CAAS;IAEf,OAAO,GAA8B,EAAE,CAAC;IACjD,IAAI,GAAG,IAAI,CAAC;IAEpB,YAAY,EAAQ;QAClB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAA+B;QACpC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;OAKG;IACH,KAAK;QACH,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;IACpB,CAAC;CACF"}

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

@@ -0,0 +1,28 @@
+import type { SimDynamoDbStreamSpecification, SimDynamoDbStreamViewType } from "./sim-dynamodb-stream.types.js";
+/**
+ * What a request asks a table's stream to be, once it has been checked.
+ *
+ * A view type is there when the stream is being switched on, and never when it
+ * is being switched off, since the view type belongs to the stream rather than
+ * to the table. The two shapes are one type rather than two so that a request
+ * carrying a StreamSpecification is one thing to read and one thing to apply.
+ */
+export type SimDynamoDbStreamRequest = {
+    readonly enabled: true;
+    readonly viewType: SimDynamoDbStreamViewType;
+} | {
+    readonly enabled: false;
+};
+/**
+ * Read the StreamSpecification a CreateTable or UpdateTable request carries.
+ *
+ * Nothing here knows about the table, so nothing here refuses a request for the
+ * stream the table already has. This is only the request read on its own: what
+ * it asks for, and whether it asks for it coherently.
+ *
+ * `StreamEnabled` is required whenever the specification is there at all, as it
+ * is on real DynamoDB. A specification carrying only a view type would read as
+ * a request for a stream while making a table with none.
+ */
+export declare function readSimDynamoDbStreamSpecification(input: SimDynamoDbStreamSpecification | undefined): SimDynamoDbStreamRequest | undefined;
+//# sourceMappingURL=sim-dynamodb-stream-specification.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream-specification.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-specification.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,8BAA8B,EAC9B,yBAAyB,EAC1B,MAAM,gCAAgC,CAAC;AAGxC;;;;;;;GAOG;AACH,MAAM,MAAM,wBAAwB,GAChC;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAA;CAAE,GACxE;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,8BAA8B,GAAG,SAAS,GAChD,wBAAwB,GAAG,SAAS,CAoBtC"}

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

@@ -0,0 +1,30 @@
+import { SimDynamoDbValidationException } from "../error/dynamodb.error.js";
+import { readSimDynamoDbStreamViewType } from "./sim-dynamodb-stream-view-type.js";
+/**
+ * Read the StreamSpecification a CreateTable or UpdateTable request carries.
+ *
+ * Nothing here knows about the table, so nothing here refuses a request for the
+ * stream the table already has. This is only the request read on its own: what
+ * it asks for, and whether it asks for it coherently.
+ *
+ * `StreamEnabled` is required whenever the specification is there at all, as it
+ * is on real DynamoDB. A specification carrying only a view type would read as
+ * a request for a stream while making a table with none.
+ */
+export function readSimDynamoDbStreamSpecification(input) {
+    if (input === undefined) {
+        return undefined;
+    }
+    if (input.StreamEnabled === undefined) {
+        throw new SimDynamoDbValidationException("One or more parameter values were invalid: StreamEnabled is required " +
+            "in a StreamSpecification");
+    }
+    if (!input.StreamEnabled) {
+        return { enabled: false };
+    }
+    return {
+        enabled: true,
+        viewType: readSimDynamoDbStreamViewType(input.StreamViewType),
+    };
+}
+//# sourceMappingURL=sim-dynamodb-stream-specification.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream-specification.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-specification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAK5E,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAcnF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kCAAkC,CAChD,KAAiD;IAEjD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACtC,MAAM,IAAI,8BAA8B,CACtC,uEAAuE;YACrE,0BAA0B,CAC7B,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;QACzB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,6BAA6B,CAAC,KAAK,CAAC,cAAc,CAAC;KAC9D,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,26 @@
+import type { SimDynamoDbStream } from "./sim-dynamodb-stream.js";
+/**
+ * The streams one simulated DynamoDB holds, keyed by ARN.
+ *
+ * A stream outlives being enabled: disabling one leaves it readable for the
+ * rest of its retention window, and the table that made it has already moved on
+ * to reporting nothing or reporting a newer one. So the streams are held here
+ * rather than only on the tables, which is what lets an ARN be resolved to the
+ * stream it names however long ago the table stopped writing to it.
+ */
+export declare class SimDynamoDbStreamStore {
+    private readonly streams;
+    /**
+     * Hold a stream a table has just enabled.
+     */
+    add(stream: SimDynamoDbStream): void;
+    /**
+     * Find the stream an ARN names, if there is one.
+     *
+     * An ARN naming no stream is simply not found. It reaches this from request
+     * input, where a value that names nothing is an ordinary case the caller
+     * reports in its own terms.
+     */
+    findByArn(streamArn: string): SimDynamoDbStream | undefined;
+}
+//# sourceMappingURL=sim-dynamodb-stream-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream-store.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;;;;;;GAQG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAEhE;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAEnC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAE1D;CACF"}

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

@@ -0,0 +1,29 @@
+/**
+ * The streams one simulated DynamoDB holds, keyed by ARN.
+ *
+ * A stream outlives being enabled: disabling one leaves it readable for the
+ * rest of its retention window, and the table that made it has already moved on
+ * to reporting nothing or reporting a newer one. So the streams are held here
+ * rather than only on the tables, which is what lets an ARN be resolved to the
+ * stream it names however long ago the table stopped writing to it.
+ */
+export class SimDynamoDbStreamStore {
+    streams = new Map();
+    /**
+     * Hold a stream a table has just enabled.
+     */
+    add(stream) {
+        this.streams.set(stream.arn, stream);
+    }
+    /**
+     * Find the stream an ARN names, if there is one.
+     *
+     * An ARN naming no stream is simply not found. It reaches this from request
+     * input, where a value that names nothing is an ordinary case the caller
+     * reports in its own terms.
+     */
+    findByArn(streamArn) {
+        return this.streams.get(streamArn);
+    }
+}
+//# sourceMappingURL=sim-dynamodb-stream-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream-store.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-store.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,OAAO,sBAAsB;IAChB,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;IAEhE;;OAEG;IACH,GAAG,CAAC,MAAyB;QAC3B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,SAAiB;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;CACF"}

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

@@ -0,0 +1,13 @@
+import type { SimUpdateTableCommandInput } from "../command/table/table.command.js";
+import { type SimDynamoDbStreamRequest } from "./sim-dynamodb-stream-specification.js";
+import type { SimDynamoDbTableStream } from "./sim-dynamodb-table-stream.js";
+/**
+ * Read the change an UpdateTable request asks a table's stream for.
+ *
+ * Unlike CreateTable, where a stream specification describes a table that does
+ * not exist yet, this is read against the stream the table already has. A
+ * request that asks for the state the table is already in is refused rather
+ * than accepted as a no-op, which is what real DynamoDB does with both of them.
+ */
+export declare function readSimDynamoDbStreamUpdate(input: SimUpdateTableCommandInput, stream: SimDynamoDbTableStream): SimDynamoDbStreamRequest | undefined;
+//# sourceMappingURL=sim-dynamodb-stream-update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream-update.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAEpF,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AA+C7E;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,sBAAsB,GAC7B,wBAAwB,GAAG,SAAS,CAWtC"}

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

@@ -0,0 +1,48 @@
+import { SimDynamoDbValidationException } from "../error/dynamodb.error.js";
+import { readSimDynamoDbStreamSpecification, } from "./sim-dynamodb-stream-specification.js";
+/**
+ * Refuse a request to switch on a stream the table already has.
+ *
+ * A stream's view type is fixed for the life of the stream, so there is no such
+ * thing as changing it in place: what an application wants is a new stream, and
+ * AWS makes it ask for one by switching this one off first. The refusal says so
+ * rather than leaving a reader to work out why the obvious request failed.
+ */
+function refuseSecondStream(request, stream) {
+    const current = stream.current;
+    if (current === undefined || !request.enabled) {
+        return;
+    }
+    if (request.viewType === current.viewType) {
+        throw new SimDynamoDbValidationException("Table already has an enabled stream");
+    }
+    throw new SimDynamoDbValidationException(`Table already has an enabled stream, and a stream's StreamViewType ` +
+        `cannot be changed in place: switch the ${current.viewType} stream off ` +
+        `and on again to get a ${request.viewType} one`);
+}
+/**
+ * Refuse a request to switch off a stream the table does not have.
+ */
+function refuseAbsentStream(request, stream) {
+    if (!request.enabled && stream.current === undefined) {
+        throw new SimDynamoDbValidationException("Table does not have an enabled stream to disable");
+    }
+}
+/**
+ * Read the change an UpdateTable request asks a table's stream for.
+ *
+ * Unlike CreateTable, where a stream specification describes a table that does
+ * not exist yet, this is read against the stream the table already has. A
+ * request that asks for the state the table is already in is refused rather
+ * than accepted as a no-op, which is what real DynamoDB does with both of them.
+ */
+export function readSimDynamoDbStreamUpdate(input, stream) {
+    const request = readSimDynamoDbStreamSpecification(input.StreamSpecification);
+    if (request === undefined) {
+        return undefined;
+    }
+    refuseSecondStream(request, stream);
+    refuseAbsentStream(request, stream);
+    return request;
+}
+//# sourceMappingURL=sim-dynamodb-stream-update.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream-update.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-update.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EACL,kCAAkC,GAEnC,MAAM,wCAAwC,CAAC;AAGhD;;;;;;;GAOG;AACH,SAAS,kBAAkB,CACzB,OAAiC,EACjC,MAA8B;IAE9B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAE/B,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC9C,OAAO;IACT,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,8BAA8B,CACtC,qCAAqC,CACtC,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,8BAA8B,CACtC,qEAAqE;QACnE,0CAA0C,OAAO,CAAC,QAAQ,cAAc;QACxE,yBAAyB,OAAO,CAAC,QAAQ,MAAM,CAClD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CACzB,OAAiC,EACjC,MAA8B;IAE9B,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACrD,MAAM,IAAI,8BAA8B,CACtC,kDAAkD,CACnD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAiC,EACjC,MAA8B;IAE9B,MAAM,OAAO,GAAG,kCAAkC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAE9E,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACpC,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAEpC,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/service/dynamodb/stream/sim-dynamodb-stream-view-type.d.ts

@@ -0,0 +1,10 @@
+import type { SimDynamoDbStreamViewType } from "./sim-dynamodb-stream.types.js";
+/**
+ * Read the view type a stream is being enabled with.
+ *
+ * A stream that is on has one: a record with no view type would be a record
+ * with no rule about which images it carries. Real DynamoDB requires it the
+ * same way, so a request leaving it out is refused rather than defaulted.
+ */
+export declare function readSimDynamoDbStreamViewType(value: string | undefined): SimDynamoDbStreamViewType;
+//# sourceMappingURL=sim-dynamodb-stream-view-type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream-view-type.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-view-type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAuBhF;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,yBAAyB,CAgB3B"}

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

@@ -0,0 +1,38 @@
+import { SimDynamoDbValidationException } from "../error/dynamodb.error.js";
+/**
+ * Every view type a stream can be enabled with.
+ *
+ * The keys of the changed item are on every record whichever of these a stream
+ * was enabled with, so `KEYS_ONLY` is the floor rather than an exception.
+ */
+const streamViewTypes = [
+    "KEYS_ONLY",
+    "NEW_IMAGE",
+    "OLD_IMAGE",
+    "NEW_AND_OLD_IMAGES",
+];
+/**
+ * Whether some text names a view type.
+ */
+function isStreamViewType(value) {
+    return streamViewTypes.includes(value);
+}
+/**
+ * Read the view type a stream is being enabled with.
+ *
+ * A stream that is on has one: a record with no view type would be a record
+ * with no rule about which images it carries. Real DynamoDB requires it the
+ * same way, so a request leaving it out is refused rather than defaulted.
+ */
+export function readSimDynamoDbStreamViewType(value) {
+    if (value === undefined) {
+        throw new SimDynamoDbValidationException("One or more parameter values were invalid: StreamViewType is " +
+            "required when StreamEnabled is true");
+    }
+    if (!isStreamViewType(value)) {
+        throw new SimDynamoDbValidationException(`One or more parameter values were invalid: Unknown StreamViewType ` +
+            `${value}, expected one of ${streamViewTypes.join(", ")}`);
+    }
+    return value;
+}
+//# sourceMappingURL=sim-dynamodb-stream-view-type.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream-view-type.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-view-type.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAE5E;;;;;GAKG;AACH,MAAM,eAAe,GAAyC;IAC5D,WAAW;IACX,WAAW;IACX,WAAW;IACX,oBAAoB;CACrB,CAAC;AAEF;;GAEG;AACH,SAAS,gBAAgB,CAAC,KAAa;IACrC,OAAO,eAAe,CAAC,QAAQ,CAAC,KAAkC,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAyB;IAEzB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,8BAA8B,CACtC,+DAA+D;YAC7D,qCAAqC,CACxC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,8BAA8B,CACtC,oEAAoE;YAClE,GAAG,KAAK,qBAAqB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5D,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,74 @@
+import type { SimArn } from "../../aws/arn.js";
+import type { SimDynamoDbStreamViewType } from "./sim-dynamodb-stream.types.js";
+import type { SimDynamoDbKeySchema } from "../table/sim-dynamodb-key-schema.js";
+import type { SimDynamoDbItemChange } from "./sim-dynamodb-item-change.js";
+import { SimDynamoDbStreamRecord } from "./sim-dynamodb-stream-record.js";
+import { SimDynamoDbStreamShard } from "./sim-dynamodb-stream-shard.js";
+/**
+ * Where a stream is between being enabled and being disabled.
+ *
+ * Real DynamoDB also has `ENABLING` and `DISABLING`, which it passes through
+ * while it brings the stream up or takes it down. Nothing here takes any time
+ * over either, so a stream switches straight between the two settled states.
+ */
+export type SimDynamoDbStreamStatus = "ENABLED" | "DISABLED";
+interface SimDynamoDbStreamProperties {
+    readonly tableName: string;
+    readonly tableArn: SimArn;
+    readonly keySchema: SimDynamoDbKeySchema;
+    readonly viewType: SimDynamoDbStreamViewType;
+    readonly enabledAt: Date;
+}
+/**
+ * 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 declare class SimDynamoDbStream {
+    readonly arn: SimArn;
+    readonly label: string;
+    readonly tableName: string;
+    readonly tableArn: SimArn;
+    readonly viewType: SimDynamoDbStreamViewType;
+    readonly enabledAt: Date;
+    readonly shard: SimDynamoDbStreamShard;
+    private readonly keySchema;
+    private readonly sequenceNumbers;
+    private enabled;
+    constructor(properties: SimDynamoDbStreamProperties);
+    /**
+     * Whether this stream is still taking the table's changes.
+     */
+    get status(): SimDynamoDbStreamStatus;
+    /**
+     * The records this stream has taken, oldest first.
+     */
+    get records(): readonly SimDynamoDbStreamRecord[];
+    /**
+     * 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: SimDynamoDbItemChange, at: Date): SimDynamoDbStreamRecord;
+    /**
+     * 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(): void;
+}
+export {};
+//# sourceMappingURL=sim-dynamodb-stream.d.ts.map