@kensio/yulin 1.1.0 → 1.3.0

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

@@ -0,0 +1,72 @@
+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;
+    private trimmed;
+    private first;
+    private last;
+    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[];
+    /**
+     * The sequence number of the last record trimmed off this shard, when the
+     * retention window has outlived one.
+     */
+    get trimmedThrough(): string | undefined;
+    /**
+     * The sequence number this shard starts at.
+     *
+     * This is the first record ever written to it rather than the oldest one it
+     * still holds. A shard's range is fixed as the records go on: trimming takes
+     * records away without moving where the shard began, and TRIM_HORIZON is what
+     * a reader uses to find the oldest record it can still reach.
+     */
+    get startingSequenceNumber(): string | undefined;
+    /**
+     * The sequence number this shard ends at, which only a closed one has.
+     *
+     * An open shard has no ending sequence number, since the next record written
+     * would move it. That absence is how a reader tells a shard that is still
+     * taking changes from one it can finish with.
+     */
+    get endingSequenceNumber(): string | undefined;
+    /**
+     * Write a record to this shard.
+     */
+    append(record: SimDynamoDbStreamRecord): void;
+    /**
+     * Drop the records written before an instant, remembering how far that got.
+     *
+     * The trim point is kept once the records themselves are gone, because it is
+     * the difference between a reader that asked for a position this shard never
+     * reached and one that asked for a position it has already dropped.
+     */
+    trim(before: Date): 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;IACpB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,IAAI,CAAqB;IAEjC,YAAY,EAAE,EAAE,IAAI,EAEnB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,SAAS,uBAAuB,EAAE,CAEhD;IAED;;;OAGG;IACH,IAAI,cAAc,IAAI,MAAM,GAAG,SAAS,CAEvC;IAED;;;;;;;OAOG;IACH,IAAI,sBAAsB,IAAI,MAAM,GAAG,SAAS,CAE/C;IAED;;;;;;OAMG;IACH,IAAI,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAE7C;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAI5C;IAED;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,CAavB;IAED;;;;;OAKG;IACH,KAAK,IAAI,IAAI,CAEZ;CACF"}

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

@@ -0,0 +1,113 @@
+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;
+    trimmed;
+    first;
+    last;
+    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;
+    }
+    /**
+     * The sequence number of the last record trimmed off this shard, when the
+     * retention window has outlived one.
+     */
+    get trimmedThrough() {
+        return this.trimmed;
+    }
+    /**
+     * The sequence number this shard starts at.
+     *
+     * This is the first record ever written to it rather than the oldest one it
+     * still holds. A shard's range is fixed as the records go on: trimming takes
+     * records away without moving where the shard began, and TRIM_HORIZON is what
+     * a reader uses to find the oldest record it can still reach.
+     */
+    get startingSequenceNumber() {
+        return this.first;
+    }
+    /**
+     * The sequence number this shard ends at, which only a closed one has.
+     *
+     * An open shard has no ending sequence number, since the next record written
+     * would move it. That absence is how a reader tells a shard that is still
+     * taking changes from one it can finish with.
+     */
+    get endingSequenceNumber() {
+        return this.open ? undefined : this.last;
+    }
+    /**
+     * Write a record to this shard.
+     */
+    append(record) {
+        this.written.push(record);
+        this.first ??= record.sequenceNumber;
+        this.last = record.sequenceNumber;
+    }
+    /**
+     * Drop the records written before an instant, remembering how far that got.
+     *
+     * The trim point is kept once the records themselves are gone, because it is
+     * the difference between a reader that asked for a position this shard never
+     * reached and one that asked for a position it has already dropped.
+     */
+    trim(before) {
+        const surviving = this.written.findIndex((record) => record.approximateCreationDateTime.getTime() >= before.getTime());
+        const outlived = surviving === -1 ? this.written.length : surviving;
+        if (outlived === 0) {
+            return;
+        }
+        this.trimmed = this.written[outlived - 1]?.sequenceNumber ?? this.trimmed;
+        this.written.splice(0, outlived);
+    }
+    /**
+     * 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;IACZ,OAAO,CAAqB;IAC5B,KAAK,CAAqB;IAC1B,IAAI,CAAqB;IAEjC,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;;;OAGG;IACH,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,sBAAsB;QACxB,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;;;;OAMG;IACH,IAAI,oBAAoB;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAA+B;QACpC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,cAAc,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,cAAc,CAAC;IACpC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,MAAY;QACf,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CACtC,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,2BAA2B,CAAC,OAAO,EAAE,IAAI,MAAM,CAAC,OAAO,EAAE,CACnE,CAAC;QACF,MAAM,QAAQ,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QAEpE,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,cAAc,IAAI,IAAI,CAAC,OAAO,CAAC;QAC1E,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACnC,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,42 @@
+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;
+    /**
+     * Every stream here, in ARN order.
+     *
+     * ListStreams pages by ARN, so the order a page is cut out of has to be the
+     * order the paging parameter walks. A stream's ARN is its table's ARN and
+     * then the instant it was enabled, so this also groups a table's streams
+     * together, oldest first.
+     */
+    inArnOrder(): readonly SimDynamoDbStream[];
+    /**
+     * Bring every stream here up to date at an instant.
+     *
+     * All of them rather than the one being read, so that what a test sees of one
+     * stream does not depend on which other streams it happened to read first.
+     */
+    applyRetention(instant: Date): void;
+}
+//# 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;IAED;;;;;;;OAOG;IACH,UAAU,IAAI,SAAS,iBAAiB,EAAE,CAKzC;IAED;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,CAIlC;CACF"}

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

@@ -0,0 +1,54 @@
+/**
+ * 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);
+    }
+    /**
+     * Every stream here, in ARN order.
+     *
+     * ListStreams pages by ARN, so the order a page is cut out of has to be the
+     * order the paging parameter walks. A stream's ARN is its table's ARN and
+     * then the instant it was enabled, so this also groups a table's streams
+     * together, oldest first.
+     */
+    inArnOrder() {
+        return this.streams
+            .values()
+            .toArray()
+            .toSorted((left, right) => left.arn.localeCompare(right.arn));
+    }
+    /**
+     * Bring every stream here up to date at an instant.
+     *
+     * All of them rather than the one being read, so that what a test sees of one
+     * stream does not depend on which other streams it happened to read first.
+     */
+    applyRetention(instant) {
+        for (const stream of this.streams.values()) {
+            stream.applyRetention(instant);
+        }
+    }
+}
+//# 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;IAED;;;;;;;OAOG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO;aAChB,MAAM,EAAE;aACR,OAAO,EAAE;aACT,QAAQ,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAClE,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,OAAa;QAC1B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;IACH,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,88 @@
+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 { SimDynamoDbKeySchemaElement } from "../command/table/table.types.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[];
+    /**
+     * The key schema of the table this stream belongs to, as DescribeStream
+     * reports it.
+     */
+    get keySchemaElements(): readonly SimDynamoDbKeySchemaElement[];
+    /**
+     * 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: Date): void;
+    /**
+     * 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

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AACnF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAK3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAG1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,UAAU,CAAC;AAE7D,UAAU,2BAA2B;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,qBAAa,iBAAiB;IAC5B,SAAgB,GAAG,EAAE,MAAM,CAAC;IAC5B,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,QAAQ,EAAE,yBAAyB,CAAC;IACpD,SAAgB,SAAS,EAAE,IAAI,CAAC;IAChC,SAAgB,KAAK,EAAE,sBAAsB,CAAC;IAE9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA0C;IAC1E,OAAO,CAAC,OAAO,CAAQ;IAEvB,YAAY,UAAU,EAAE,2BAA2B,EASlD;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,uBAAuB,CAEpC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,SAAS,uBAAuB,EAAE,CAEhD;IAED;;;OAGG;IACH,IAAI,iBAAiB,IAAI,SAAS,2BAA2B,EAAE,CAE9D;IAED;;;;;;OAMG;IACH,cAAc,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,CAElC;IAED;;;;;;;;;;OAUG;IACH,OAAO,CAAC,MAAM,EAAE,qBAAqB,EAAE,EAAE,EAAE,IAAI,GAAG,uBAAuB,CAYxE;IAED;;;;;;OAMG;IACH,OAAO,IAAI,IAAI,CAGd;CACF"}