@kensio/yulin 1.2.0 → 1.3.0

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

@@ -0,0 +1,33 @@
+import type { SimDynamoDbStreamRecord } from "./sim-dynamodb-stream-record.js";
+import { type SimDynamoDbStreamPosition } from "./sim-dynamodb-stream-position.js";
+import type { SimDynamoDbStreamShard } from "./sim-dynamodb-stream-shard.js";
+/**
+ * What one read of a shard came back with.
+ *
+ * `drained` is only true of a closed shard a reader has reached the end of. An
+ * open shard is never drained, however empty it is: more may yet be written to
+ * it, and that is the difference between a reader that should look again and
+ * one that is finished.
+ */
+export interface SimDynamoDbStreamRead {
+    readonly records: readonly SimDynamoDbStreamRecord[];
+    readonly next: SimDynamoDbStreamPosition;
+    readonly drained: boolean;
+}
+/**
+ * Ensure a shard still holds the position a reader is asking for.
+ *
+ * Checked when an iterator is handed out as well as when one is used, because a
+ * caller can name a sequence number the retention window has already outlived
+ * and should find that out at the request rather than one call later.
+ */
+export declare function assertSimDynamoDbStreamPositionReadable(shard: SimDynamoDbStreamShard, position: SimDynamoDbStreamPosition): void;
+/**
+ * Read up to a limit of records from a shard, starting at a position.
+ *
+ * An empty result is an ordinary answer rather than a problem: a reader that
+ * has caught up with an open shard gets nothing back and the position it
+ * already had, which is what makes polling each successive iterator work.
+ */
+export declare function simDynamoDbStreamRead(shard: SimDynamoDbStreamShard, position: SimDynamoDbStreamPosition, limit: number): SimDynamoDbStreamRead;
+//# sourceMappingURL=sim-dynamodb-stream-read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream-read.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-read.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,mCAAmC,CAAC;AAE3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAE7E;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACrD,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AA4BD;;;;;;GAMG;AACH,wBAAgB,uCAAuC,CACrD,KAAK,EAAE,sBAAsB,EAC7B,QAAQ,EAAE,yBAAyB,GAClC,IAAI,CAYN;AAyBD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,sBAAsB,EAC7B,QAAQ,EAAE,yBAAyB,EACnC,KAAK,EAAE,MAAM,GACZ,qBAAqB,CAgBvB"}

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

@@ -0,0 +1,66 @@
+import { SimDynamoDbTrimmedDataAccessException } from "../error/dynamodb.error.js";
+import { simDynamoDbStreamAfter, } from "./sim-dynamodb-stream-position.js";
+import { compareSimDynamoDbSequenceNumbers } from "./sim-dynamodb-stream-sequence-numbers.js";
+/**
+ * Whether a shard has dropped the record a position names.
+ *
+ * `at` a trimmed sequence number is gone: that record is what was asked for.
+ * `after` one is not, as long as the record following it survived, which is why
+ * the two comparisons differ by the equal case.
+ */
+function isTrimmed(shard, sequenceNumber, inclusive) {
+    const trimmedThrough = shard.trimmedThrough;
+    if (trimmedThrough === undefined) {
+        return false;
+    }
+    const order = compareSimDynamoDbSequenceNumbers(sequenceNumber, trimmedThrough);
+    return inclusive ? order <= 0 : order < 0;
+}
+/**
+ * Ensure a shard still holds the position a reader is asking for.
+ *
+ * Checked when an iterator is handed out as well as when one is used, because a
+ * caller can name a sequence number the retention window has already outlived
+ * and should find that out at the request rather than one call later.
+ */
+export function assertSimDynamoDbStreamPositionReadable(shard, position) {
+    if (position.kind === "start" ||
+        !isTrimmed(shard, position.sequenceNumber, position.kind === "at")) {
+        return;
+    }
+    throw new SimDynamoDbTrimmedDataAccessException(`Stream record with sequence number ${position.sequenceNumber} on shard ` +
+        `${shard.shardId} is past the 24 hour trim point`);
+}
+/**
+ * Where in the records a position starts reading from.
+ */
+function startIndexOf(records, position) {
+    if (position.kind === "start") {
+        return 0;
+    }
+    const wanted = position.kind === "at" ? 0 : 1;
+    const found = records.findIndex((record) => compareSimDynamoDbSequenceNumbers(record.sequenceNumber, position.sequenceNumber) >= wanted);
+    return found === -1 ? records.length : found;
+}
+/**
+ * Read up to a limit of records from a shard, starting at a position.
+ *
+ * An empty result is an ordinary answer rather than a problem: a reader that
+ * has caught up with an open shard gets nothing back and the position it
+ * already had, which is what makes polling each successive iterator work.
+ */
+export function simDynamoDbStreamRead(shard, position, limit) {
+    assertSimDynamoDbStreamPositionReadable(shard, position);
+    const available = shard.records;
+    const start = startIndexOf(available, position);
+    const records = available.slice(start, start + limit);
+    const last = records.at(-1);
+    return {
+        records,
+        next: last === undefined
+            ? position
+            : simDynamoDbStreamAfter(last.sequenceNumber),
+        drained: !shard.isOpen && start + records.length >= available.length,
+    };
+}
+//# sourceMappingURL=sim-dynamodb-stream-read.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream-read.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qCAAqC,EAAE,MAAM,4BAA4B,CAAC;AAEnF,OAAO,EACL,sBAAsB,GAEvB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,iCAAiC,EAAE,MAAM,2CAA2C,CAAC;AAiB9F;;;;;;GAMG;AACH,SAAS,SAAS,CAChB,KAA6B,EAC7B,cAAsB,EACtB,SAAkB;IAElB,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC;IAE5C,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,iCAAiC,CAC7C,cAAc,EACd,cAAc,CACf,CAAC;IAEF,OAAO,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uCAAuC,CACrD,KAA6B,EAC7B,QAAmC;IAEnC,IACE,QAAQ,CAAC,IAAI,KAAK,OAAO;QACzB,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,EAClE,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,IAAI,qCAAqC,CAC7C,sCAAsC,QAAQ,CAAC,cAAc,YAAY;QACvE,GAAG,KAAK,CAAC,OAAO,iCAAiC,CACpD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CACnB,OAA2C,EAC3C,QAAmC;IAEnC,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAC7B,CAAC,MAAM,EAAE,EAAE,CACT,iCAAiC,CAC/B,MAAM,CAAC,cAAc,EACrB,QAAQ,CAAC,cAAc,CACxB,IAAI,MAAM,CACd,CAAC;IAEF,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;AAC/C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAA6B,EAC7B,QAAmC,EACnC,KAAa;IAEb,uCAAuC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAEzD,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC;IAChC,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5B,OAAO;QACL,OAAO;QACP,IAAI,EACF,IAAI,KAAK,SAAS;YAChB,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,sBAAsB,CAAC,IAAI,CAAC,cAAc,CAAC;QACjD,OAAO,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,GAAG,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM;KACrE,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * The instant a stream's records have to be newer than to still be readable.
+ *
+ * Trimming is applied when a stream is read rather than scheduled, because it
+ * is a pure function of the current time: whatever a read finds is what the
+ * retention window holds at the instant of that read, and nothing has to have
+ * run in between for that to be true. Compare `SimSqsQueue.applyLifecycle`,
+ * which is the same shape for the same reason.
+ *
+ * A stream itself is not dropped once everything on it has been trimmed. Real
+ * DynamoDB eventually stops listing a disabled stream whose records have all
+ * aged out, which is a divergence in a test's favour: the ARN a test is holding
+ * goes on resolving, and reading it gives an empty result rather than a
+ * resource that has silently disappeared.
+ */
+export declare function simDynamoDbStreamTrimPoint(now: Date): Date;
+//# sourceMappingURL=sim-dynamodb-stream-retention.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream-retention.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-retention.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI,CAE1D"}

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

@@ -0,0 +1,24 @@
+/**
+ * How long DynamoDB Streams keeps a record before trimming it.
+ */
+const retentionHours = 24;
+const millisecondsPerHour = 60 * 60 * 1000;
+/**
+ * The instant a stream's records have to be newer than to still be readable.
+ *
+ * Trimming is applied when a stream is read rather than scheduled, because it
+ * is a pure function of the current time: whatever a read finds is what the
+ * retention window holds at the instant of that read, and nothing has to have
+ * run in between for that to be true. Compare `SimSqsQueue.applyLifecycle`,
+ * which is the same shape for the same reason.
+ *
+ * A stream itself is not dropped once everything on it has been trimmed. Real
+ * DynamoDB eventually stops listing a disabled stream whose records have all
+ * aged out, which is a divergence in a test's favour: the ARN a test is holding
+ * goes on resolving, and reading it gives an empty result rather than a
+ * resource that has silently disappeared.
+ */
+export function simDynamoDbStreamTrimPoint(now) {
+    return new Date(now.getTime() - retentionHours * millisecondsPerHour);
+}
+//# sourceMappingURL=sim-dynamodb-stream-retention.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream-retention.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-retention.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,cAAc,GAAG,EAAE,CAAC;AAE1B,MAAM,mBAAmB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE3C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,0BAA0B,CAAC,GAAS;IAClD,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,cAAc,GAAG,mBAAmB,CAAC,CAAC;AACxE,CAAC"}

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

@@ -15,4 +15,20 @@ export declare class SimDynamoDbStreamSequenceNumbers {
      */
     take(): string;
 }
+/**
+ * Read a sequence number a request carries.
+ *
+ * Real DynamoDB refuses anything that is not a run of digits, so a caller that
+ * passes a shard identifier or a truncated value here finds out at the request
+ * rather than reading from a position nothing could ever be at.
+ */
+export declare function readSimDynamoDbSequenceNumber(value: string | undefined, operationName: string): string;
+/**
+ * Order two sequence numbers, as a comparator does.
+ *
+ * These are compared as numbers rather than as text. The ones a simulated
+ * stream hands out are a fixed width, where the two orders agree, but one a
+ * request carries came from outside and need not be.
+ */
+export declare function compareSimDynamoDbSequenceNumbers(left: string, right: string): number;
 //# sourceMappingURL=sim-dynamodb-stream-sequence-numbers.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"sim-dynamodb-stream-sequence-numbers.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-sequence-numbers.ts"],"names":[],"mappings":"AAYA;;;;;;;;;GASG;AACH,qBAAa,gCAAgC;IAC3C,OAAO,CAAC,IAAI,CAAuB;IAEnC;;OAEG;IACH,IAAI,IAAI,MAAM,CAMb;CACF;AAOD;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,aAAa,EAAE,MAAM,GACpB,MAAM,CAQR;AAED;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,MAAM,CAQR"}

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

@@ -1,3 +1,4 @@
+import { SimDynamoDbValidationException } from "../error/dynamodb.error.js";
 /**
  * The number the first record on a stream is given.
  *
@@ -28,4 +29,35 @@ export class SimDynamoDbStreamSequenceNumbers {
         return taken.toString();
     }
 }
+/**
+ * A sequence number is digits and nothing else.
+ */
+const digitsOnly = /^\d+$/u;
+/**
+ * Read a sequence number a request carries.
+ *
+ * Real DynamoDB refuses anything that is not a run of digits, so a caller that
+ * passes a shard identifier or a truncated value here finds out at the request
+ * rather than reading from a position nothing could ever be at.
+ */
+export function readSimDynamoDbSequenceNumber(value, operationName) {
+    if (value === undefined || !digitsOnly.test(value)) {
+        throw new SimDynamoDbValidationException(`${operationName} needs a numeric SequenceNumber`);
+    }
+    return value;
+}
+/**
+ * Order two sequence numbers, as a comparator does.
+ *
+ * These are compared as numbers rather than as text. The ones a simulated
+ * stream hands out are a fixed width, where the two orders agree, but one a
+ * request carries came from outside and need not be.
+ */
+export function compareSimDynamoDbSequenceNumbers(left, right) {
+    const difference = BigInt(left) - BigInt(right);
+    if (difference === 0n) {
+        return 0;
+    }
+    return difference > 0n ? 1 : -1;
+}
 //# sourceMappingURL=sim-dynamodb-stream-sequence-numbers.js.map

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

@@ -1 +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"}
+{"version":3,"file":"sim-dynamodb-stream-sequence-numbers.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-sequence-numbers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAE5E;;;;;;;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;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,QAAQ,CAAC;AAE5B;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAyB,EACzB,aAAqB;IAErB,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,8BAA8B,CACtC,GAAG,aAAa,iCAAiC,CAClD,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iCAAiC,CAC/C,IAAY,EACZ,KAAa;IAEb,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEhD,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;QACtB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC"}

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

@@ -0,0 +1,25 @@
+import type { SimDynamoDbStreamPosition } from "./sim-dynamodb-stream-position.js";
+/**
+ * What a shard iterator stands for: one place on one shard of one stream.
+ */
+export interface SimDynamoDbShardIterator {
+    readonly streamArn: string;
+    readonly shardId: string;
+    readonly position: SimDynamoDbStreamPosition;
+}
+/**
+ * The opaque token a caller is handed to read on from a place.
+ *
+ * Real shard iterators are opaque strings a caller passes back unread, and this
+ * one is the same shape: the place it stands for travels inside it rather than
+ * in a table of handed-out iterators. That is what lets an iterator be used
+ * against the stream it names without the stream having to remember it, which
+ * is also why the 15 minute expiry is deliberately absent here rather than
+ * approximated.
+ */
+export declare function simDynamoDbShardIteratorToken(iterator: SimDynamoDbShardIterator): string;
+/**
+ * Read the place a shard iterator a request carries stands for.
+ */
+export declare function readSimDynamoDbShardIteratorToken(token: string | undefined): SimDynamoDbShardIterator;
+//# sourceMappingURL=sim-dynamodb-stream-shard-iterator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream-shard-iterator.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-shard-iterator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;CAC9C;AA4CD;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,wBAAwB,GACjC,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,wBAAwB,CA2B1B"}

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

@@ -0,0 +1,74 @@
+import { isRecord } from "../../../util/type-guard/record.js";
+import { SimDynamoDbValidationException } from "../error/dynamodb.error.js";
+/**
+ * The three position kinds, as a value read back out of a token has to be one
+ * of them before it is trusted.
+ */
+const positionKinds = new Set(["start", "at", "after"]);
+/**
+ * Refuse a shard iterator a request carries that this simulation never made.
+ */
+function refuse() {
+    throw new SimDynamoDbValidationException("The provided ShardIterator is not valid");
+}
+/**
+ * Read a position back out of a decoded token.
+ */
+function readPosition(value) {
+    if (!isRecord(value) || typeof value["kind"] !== "string") {
+        refuse();
+    }
+    const kind = value["kind"];
+    if (!positionKinds.has(kind)) {
+        refuse();
+    }
+    if (kind === "start") {
+        return { kind: "start" };
+    }
+    const sequenceNumber = value["sequenceNumber"];
+    if (typeof sequenceNumber !== "string") {
+        refuse();
+    }
+    return kind === "at"
+        ? { kind: "at", sequenceNumber }
+        : { kind: "after", sequenceNumber };
+}
+/**
+ * The opaque token a caller is handed to read on from a place.
+ *
+ * Real shard iterators are opaque strings a caller passes back unread, and this
+ * one is the same shape: the place it stands for travels inside it rather than
+ * in a table of handed-out iterators. That is what lets an iterator be used
+ * against the stream it names without the stream having to remember it, which
+ * is also why the 15 minute expiry is deliberately absent here rather than
+ * approximated.
+ */
+export function simDynamoDbShardIteratorToken(iterator) {
+    return Buffer.from(JSON.stringify(iterator), "utf8").toString("base64url");
+}
+/**
+ * Read the place a shard iterator a request carries stands for.
+ */
+export function readSimDynamoDbShardIteratorToken(token) {
+    if (token === undefined || token === "") {
+        throw new SimDynamoDbValidationException("GetRecords requires a ShardIterator");
+    }
+    let decoded;
+    try {
+        decoded = JSON.parse(Buffer.from(token, "base64url").toString("utf8"));
+    }
+    catch {
+        refuse();
+    }
+    if (!isRecord(decoded) ||
+        typeof decoded["streamArn"] !== "string" ||
+        typeof decoded["shardId"] !== "string") {
+        refuse();
+    }
+    return {
+        streamArn: decoded["streamArn"],
+        shardId: decoded["shardId"],
+        position: readPosition(decoded["position"]),
+    };
+}
+//# sourceMappingURL=sim-dynamodb-stream-shard-iterator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-stream-shard-iterator.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream-shard-iterator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAC9D,OAAO,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAY5E;;;GAGG;AACH,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AAExD;;GAEG;AACH,SAAS,MAAM;IACb,MAAM,IAAI,8BAA8B,CACtC,yCAAyC,CAC1C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1D,MAAM,EAAE,CAAC;IACX,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,EAAE,CAAC;IACX,CAAC;IAED,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,cAAc,GAAG,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC/C,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,EAAE,CAAC;IACX,CAAC;IAED,OAAO,IAAI,KAAK,IAAI;QAClB,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE;QAChC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;AACxC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,6BAA6B,CAC3C,QAAkC;IAElC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC7E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iCAAiC,CAC/C,KAAyB;IAEzB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,8BAA8B,CACtC,qCAAqC,CACtC,CAAC;IACJ,CAAC;IAED,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,EAAE,CAAC;IACX,CAAC;IAED,IACE,CAAC,QAAQ,CAAC,OAAO,CAAC;QAClB,OAAO,OAAO,CAAC,WAAW,CAAC,KAAK,QAAQ;QACxC,OAAO,OAAO,CAAC,SAAS,CAAC,KAAK,QAAQ,EACtC,CAAC;QACD,MAAM,EAAE,CAAC;IACX,CAAC;IAED,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC;QAC/B,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC;QAC3B,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;KAC5C,CAAC;AACJ,CAAC"}

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

@@ -15,6 +15,9 @@ 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.
@@ -24,10 +27,40 @@ export declare class SimDynamoDbStreamShard {
      * 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.
      *

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

@@ -1 +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"}
+{"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

@@ -30,6 +30,9 @@ export class SimDynamoDbStreamShard {
     shardId;
     written = [];
     open = true;
+    trimmed;
+    first;
+    last;
     constructor(at) {
         this.shardId = shardId(at);
     }
@@ -45,11 +48,57 @@ export class SimDynamoDbStreamShard {
     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.

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

@@ -1 +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"}
+{"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-store.d.ts

@@ -22,5 +22,21 @@ export declare class SimDynamoDbStreamStore {
      * 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

@@ -1 +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"}
+{"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

@@ -25,5 +25,30 @@ export class SimDynamoDbStreamStore {
     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

@@ -1 +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"}
+{"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.d.ts

@@ -1,6 +1,7 @@
 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";
@@ -49,6 +50,19 @@ export declare class SimDynamoDbStream {
      * 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.
      *

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

@@ -1 +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,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAK3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,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;;;;;;;;;;OAUG;IACH,OAAO,CAAC,MAAM,EAAE,qBAAqB,EAAE,EAAE,EAAE,IAAI,GAAG,uBAAuB,CAYxE;IAED;;;;;;OAMG;IACH,OAAO,IAAI,IAAI,CAGd;CACF"}
+{"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"}

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

@@ -1,5 +1,6 @@
 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";
 /**
@@ -45,6 +46,23 @@ export class SimDynamoDbStream {
     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.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"sim-dynamodb-stream.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/stream/sim-dynamodb-stream.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,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;;;;;;;;;;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"}
+{"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"}