@kensio/yulin 1.19.4 → 1.20.1

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

@@ -0,0 +1,49 @@
+/**
+ * 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. Real Kinesis hands out 56 digit numbers, and starting at 10^55 gives
+ * that width with room for more records than any simulation will write.
+ */
+const firstSequenceNumber = 10n ** 55n;
+/**
+ * The sequence numbers one stream hands out.
+ *
+ * This is a counter rather than a clock. Records are commonly put inside one
+ * millisecond, and a clock cannot tell those apart, which would leave two
+ * records claiming the same position on the stream.
+ *
+ * One counter serves the whole stream rather than one per shard. Real Kinesis
+ * promises a sequence number is unique within a stream and increases within a
+ * shard, and a single counter gives both. It also means two records on
+ * different shards can be ordered against each other here, which real Kinesis
+ * does not promise. A consumer relying on that would be relying on something
+ * AWS does not offer.
+ */
+export class SimKinesisSequenceNumbers {
+    next = firstSequenceNumber;
+    /**
+     * Take the next sequence number, as the text a record carries.
+     */
+    take() {
+        const taken = this.next;
+        this.next += 1n;
+        return taken.toString();
+    }
+}
+/**
+ * Order two sequence numbers.
+ *
+ * They are compared as numbers rather than as text. The width is fixed while a
+ * simulation runs, so the two orders agree, and comparing the values keeps that
+ * true if the width ever changes.
+ */
+export function compareSimKinesisSequenceNumbers(left, right) {
+    const difference = BigInt(left) - BigInt(right);
+    if (difference === 0n) {
+        return 0;
+    }
+    return difference > 0n ? 1 : -1;
+}
+//# sourceMappingURL=sim-kinesis-sequence-numbers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-kinesis-sequence-numbers.js","sourceRoot":"","sources":["../../../../src/service/kinesis/stream/sim-kinesis-sequence-numbers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,mBAAmB,GAAG,GAAG,IAAI,GAAG,CAAC;AAEvC;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,yBAAyB;IAC5B,IAAI,GAAG,mBAAmB,CAAC;IAEnC;;OAEG;IACH,IAAI;QACF,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QAEhB,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC,CAC9C,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/kinesis/stream/sim-kinesis-shard-iterator.d.ts

@@ -0,0 +1,25 @@
+import type { SimKinesisStreamPosition } from "./sim-kinesis-stream-position.js";
+/**
+ * What a shard iterator stands for: one place on one shard of one stream.
+ */
+export interface SimKinesisShardIterator {
+    readonly streamArn: string;
+    readonly shardId: string;
+    readonly position: SimKinesisStreamPosition;
+}
+/**
+ * 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, which is what lets an iterator be used
+ * against the stream it names without the stream having to remember it. That is
+ * also why the five minute expiry is deliberately absent here rather than
+ * approximated.
+ */
+export declare function simKinesisShardIteratorToken(iterator: SimKinesisShardIterator): string;
+/**
+ * Read the place a shard iterator a request carries stands for.
+ */
+export declare function readSimKinesisShardIteratorToken(token: string | undefined): SimKinesisShardIterator;
+//# sourceMappingURL=sim-kinesis-shard-iterator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-kinesis-shard-iterator.d.ts","sourceRoot":"","sources":["../../../../src/service/kinesis/stream/sim-kinesis-shard-iterator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;CAC7C;AA2DD;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,uBAAuB,GAChC,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,uBAAuB,CA0BzB"}

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

@@ -0,0 +1,84 @@
+import { isRecord } from "../../../util/type-guard/record.js";
+import { SimKinesisExpiredIteratorException } from "../error/sim-kinesis.error.js";
+/**
+ * The four 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", "timestamp"]);
+/**
+ * Refuse a shard iterator a request carries that this simulation never made.
+ *
+ * Real Kinesis reports an iterator it will not accept as expired, which is what
+ * an unreadable one is here: something that was never valid, or is no longer.
+ */
+function refuse() {
+    throw new SimKinesisExpiredIteratorException("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" };
+    }
+    if (kind === "timestamp") {
+        const epochMillis = value["epochMillis"];
+        if (typeof epochMillis !== "number") {
+            refuse();
+        }
+        return { kind: "timestamp", epochMillis };
+    }
+    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, which is what lets an iterator be used
+ * against the stream it names without the stream having to remember it. That is
+ * also why the five minute expiry is deliberately absent here rather than
+ * approximated.
+ */
+export function simKinesisShardIteratorToken(iterator) {
+    return Buffer.from(JSON.stringify(iterator), "utf8").toString("base64url");
+}
+/**
+ * Read the place a shard iterator a request carries stands for.
+ */
+export function readSimKinesisShardIteratorToken(token) {
+    if (token === undefined || token === "") {
+        refuse();
+    }
+    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-kinesis-shard-iterator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-kinesis-shard-iterator.js","sourceRoot":"","sources":["../../../../src/service/kinesis/stream/sim-kinesis-shard-iterator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAC9D,OAAO,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AAYnF;;;GAGG;AACH,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;AAErE;;;;;GAKG;AACH,SAAS,MAAM;IACb,MAAM,IAAI,kCAAkC,CAC1C,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;IAE3B,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,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,MAAM,WAAW,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC;QAEzC,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,EAAE,CAAC;QACX,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,cAAc,GAAG,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAE/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,4BAA4B,CAC1C,QAAiC;IAEjC,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,gCAAgC,CAC9C,KAAyB;IAEzB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACxC,MAAM,EAAE,CAAC;IACX,CAAC;IAED,IAAI,OAAgB,CAAC;IAErB,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/kinesis/stream/sim-kinesis-shard-map.d.ts

@@ -0,0 +1,34 @@
+import type { SimKinesisSequenceNumbers } from "./sim-kinesis-sequence-numbers.js";
+import { SimKinesisShard } from "./sim-kinesis-shard.js";
+interface SimKinesisShardMapProperties {
+    readonly shardCount: number;
+    readonly sequenceNumbers: SimKinesisSequenceNumbers;
+}
+/**
+ * The shards of one stream, and which slice of the hash key space each holds.
+ *
+ * The shards are opened together and stay as they are. Nothing here splits or
+ * merges one, so a record's shard is decided by its hash key alone and stays
+ * decidable for the life of the stream.
+ */
+export declare class SimKinesisShardMap {
+    readonly shards: readonly SimKinesisShard[];
+    constructor(properties: SimKinesisShardMapProperties);
+    /**
+     * Find a shard by its identifier.
+     */
+    find(shardId: string): SimKinesisShard | undefined;
+    /**
+     * The shard whose slice of the hash key space a key falls in.
+     *
+     * The ranges cover the whole space between them, so one of them always
+     * matches whatever a 128 bit hash lands on.
+     */
+    covering(hashKey: bigint): SimKinesisShard;
+    /**
+     * Drop the records put before an instant, on every shard.
+     */
+    trim(before: Date): void;
+}
+export {};
+//# sourceMappingURL=sim-kinesis-shard-map.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-kinesis-shard-map.d.ts","sourceRoot":"","sources":["../../../../src/service/kinesis/stream/sim-kinesis-shard-map.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,UAAU,4BAA4B;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC;CACrD;AAED;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC7B,SAAgB,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAEnD,YAAY,UAAU,EAAE,4BAA4B,EASnD;IAED;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEjD;IAED;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAKzC;IAED;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,CAIvB;CACF"}

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

@@ -0,0 +1,46 @@
+import { assertDefined } from "../../../util/type-guard/defined.js";
+import { simKinesisHashKeyRanges } from "./sim-kinesis-hash-key.js";
+import { SimKinesisShard } from "./sim-kinesis-shard.js";
+/**
+ * The shards of one stream, and which slice of the hash key space each holds.
+ *
+ * The shards are opened together and stay as they are. Nothing here splits or
+ * merges one, so a record's shard is decided by its hash key alone and stays
+ * decidable for the life of the stream.
+ */
+export class SimKinesisShardMap {
+    shards;
+    constructor(properties) {
+        this.shards = simKinesisHashKeyRanges(properties.shardCount).map((hashKeyRange, ordinal) => new SimKinesisShard({
+            ordinal,
+            hashKeyRange,
+            startingSequenceNumber: properties.sequenceNumbers.take(),
+        }));
+    }
+    /**
+     * Find a shard by its identifier.
+     */
+    find(shardId) {
+        return this.shards.find((shard) => shard.shardId === shardId);
+    }
+    /**
+     * The shard whose slice of the hash key space a key falls in.
+     *
+     * The ranges cover the whole space between them, so one of them always
+     * matches whatever a 128 bit hash lands on.
+     */
+    covering(hashKey) {
+        const shard = this.shards.find((candidate) => candidate.covers(hashKey));
+        assertDefined(shard, `Kinesis shard covering hash key ${hashKey}`);
+        return shard;
+    }
+    /**
+     * Drop the records put before an instant, on every shard.
+     */
+    trim(before) {
+        for (const shard of this.shards) {
+            shard.trim(before);
+        }
+    }
+}
+//# sourceMappingURL=sim-kinesis-shard-map.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-kinesis-shard-map.js","sourceRoot":"","sources":["../../../../src/service/kinesis/stream/sim-kinesis-shard-map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAOzD;;;;;;GAMG;AACH,MAAM,OAAO,kBAAkB;IACb,MAAM,CAA6B;IAEnD,YAAY,UAAwC;QAClD,IAAI,CAAC,MAAM,GAAG,uBAAuB,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,GAAG,CAC9D,CAAC,YAAY,EAAE,OAAO,EAAE,EAAE,CACxB,IAAI,eAAe,CAAC;YAClB,OAAO;YACP,YAAY;YACZ,sBAAsB,EAAE,UAAU,CAAC,eAAe,CAAC,IAAI,EAAE;SAC1D,CAAC,CACL,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IAChE,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,OAAe;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACzE,aAAa,CAAC,KAAK,EAAE,mCAAmC,OAAO,EAAE,CAAC,CAAC;QAEnE,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,MAAY;QACf,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,62 @@
+import type { SimKinesisHashKeyRange } from "./sim-kinesis-hash-key.js";
+import type { SimKinesisRecord } from "./sim-kinesis-record.js";
+/**
+ * The identifier the shard at an ordinal carries.
+ *
+ * Kinesis shapes these as `shardId-000000000000`, counting from zero, and a
+ * consumer that stores a shard identifier stores that string.
+ */
+export declare function simKinesisShardId(ordinal: number): string;
+interface SimKinesisShardProperties {
+    readonly ordinal: number;
+    readonly hashKeyRange: SimKinesisHashKeyRange;
+    readonly startingSequenceNumber: string;
+}
+/**
+ * One shard of one stream, and the records put onto it.
+ *
+ * A shard owns a slice of the hash key space, and it takes the records whose
+ * partition keys hash into that slice. Nothing here splits or merges: a shard
+ * is opened when the stream is created and stays open for the life of it.
+ */
+export declare class SimKinesisShard {
+    readonly shardId: string;
+    readonly hashKeyRange: SimKinesisHashKeyRange;
+    /**
+     * The sequence number this shard opened at.
+     *
+     * Real Kinesis gives a shard one when it is created, before any record is on
+     * it, and reports it in the shard's sequence number range. It stays where it
+     * is as records are put and trimmed, so it is a fact about the shard rather
+     * than about what the shard currently holds.
+     */
+    readonly startingSequenceNumber: string;
+    private readonly written;
+    constructor(properties: SimKinesisShardProperties);
+    /**
+     * The records on this shard, oldest first.
+     */
+    get records(): readonly SimKinesisRecord[];
+    /**
+     * The sequence number of the newest record on this shard.
+     */
+    get latestSequenceNumber(): string | undefined;
+    /**
+     * Whether a hash key falls in this shard's slice of the space.
+     */
+    covers(hashKey: bigint): boolean;
+    /**
+     * Put a record onto this shard.
+     */
+    append(record: SimKinesisRecord): void;
+    /**
+     * Drop the records put before an instant.
+     *
+     * Real Kinesis moves a reader asking for a trimmed position on to the trim
+     * horizon rather than refusing it, so nothing here has to remember how far
+     * trimming got.
+     */
+    trim(before: Date): void;
+}
+export {};
+//# sourceMappingURL=sim-kinesis-shard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-kinesis-shard.d.ts","sourceRoot":"","sources":["../../../../src/service/kinesis/stream/sim-kinesis-shard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAOhE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,UAAU,yBAAyB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,sBAAsB,CAAC;IAC9C,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;CACzC;AAED;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,YAAY,EAAE,sBAAsB,CAAC;IAErD;;;;;;;OAOG;IACH,SAAgB,sBAAsB,EAAE,MAAM,CAAC;IAE/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAElD,YAAY,UAAU,EAAE,yBAAyB,EAIhD;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,SAAS,gBAAgB,EAAE,CAEzC;IAED;;OAEG;IACH,IAAI,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAE7C;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAI/B;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAErC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,CAMvB;CACF"}

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

@@ -0,0 +1,76 @@
+/**
+ * How many digits Kinesis pads a shard identifier's ordinal to.
+ */
+const shardOrdinalDigits = 12;
+/**
+ * The identifier the shard at an ordinal carries.
+ *
+ * Kinesis shapes these as `shardId-000000000000`, counting from zero, and a
+ * consumer that stores a shard identifier stores that string.
+ */
+export function simKinesisShardId(ordinal) {
+    return `shardId-${ordinal.toString().padStart(shardOrdinalDigits, "0")}`;
+}
+/**
+ * One shard of one stream, and the records put onto it.
+ *
+ * A shard owns a slice of the hash key space, and it takes the records whose
+ * partition keys hash into that slice. Nothing here splits or merges: a shard
+ * is opened when the stream is created and stays open for the life of it.
+ */
+export class SimKinesisShard {
+    shardId;
+    hashKeyRange;
+    /**
+     * The sequence number this shard opened at.
+     *
+     * Real Kinesis gives a shard one when it is created, before any record is on
+     * it, and reports it in the shard's sequence number range. It stays where it
+     * is as records are put and trimmed, so it is a fact about the shard rather
+     * than about what the shard currently holds.
+     */
+    startingSequenceNumber;
+    written = [];
+    constructor(properties) {
+        this.shardId = simKinesisShardId(properties.ordinal);
+        this.hashKeyRange = properties.hashKeyRange;
+        this.startingSequenceNumber = properties.startingSequenceNumber;
+    }
+    /**
+     * The records on this shard, oldest first.
+     */
+    get records() {
+        return this.written;
+    }
+    /**
+     * The sequence number of the newest record on this shard.
+     */
+    get latestSequenceNumber() {
+        return this.written.at(-1)?.sequenceNumber;
+    }
+    /**
+     * Whether a hash key falls in this shard's slice of the space.
+     */
+    covers(hashKey) {
+        const { startingHashKey, endingHashKey } = this.hashKeyRange;
+        return hashKey >= startingHashKey && hashKey <= endingHashKey;
+    }
+    /**
+     * Put a record onto this shard.
+     */
+    append(record) {
+        this.written.push(record);
+    }
+    /**
+     * Drop the records put before an instant.
+     *
+     * Real Kinesis moves a reader asking for a trimmed position on to the trim
+     * horizon rather than refusing it, so nothing here has to remember how far
+     * trimming got.
+     */
+    trim(before) {
+        const surviving = this.written.findIndex((record) => record.arrivedAt.getTime() >= before.getTime());
+        this.written.splice(0, surviving === -1 ? this.written.length : surviving);
+    }
+}
+//# sourceMappingURL=sim-kinesis-shard.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-kinesis-shard.js","sourceRoot":"","sources":["../../../../src/service/kinesis/stream/sim-kinesis-shard.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,WAAW,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,EAAE,GAAG,CAAC,EAAE,CAAC;AAC3E,CAAC;AAQD;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;IACV,OAAO,CAAS;IAChB,YAAY,CAAyB;IAErD;;;;;;;OAOG;IACa,sBAAsB,CAAS;IAE9B,OAAO,GAAuB,EAAE,CAAC;IAElD,YAAY,UAAqC;QAC/C,IAAI,CAAC,OAAO,GAAG,iBAAiB,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACrD,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC;QAC5C,IAAI,CAAC,sBAAsB,GAAG,UAAU,CAAC,sBAAsB,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,IAAI,oBAAoB;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAe;QACpB,MAAM,EAAE,eAAe,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC;QAE7D,OAAO,OAAO,IAAI,eAAe,IAAI,OAAO,IAAI,aAAa,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAwB;QAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,MAAY;QACf,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CACtC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,MAAM,CAAC,OAAO,EAAE,CAC3D,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7E,CAAC;CACF"}

package/dist/service/kinesis/stream/sim-kinesis-stream-activity.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Something outside Kinesis waiting for records on a stream.
+ *
+ * A Lambda event source mapping is the one this exists for. Real Lambda polls a
+ * stream continuously, and nothing in this simulation runs continuously, so the
+ * stream says when there is something to poll for instead.
+ */
+export interface SimKinesisStreamWatcher {
+    /**
+     * A record has been put, and can be read now.
+     *
+     * There is no instant here, unlike the queue watcher this mirrors. A stream
+     * record is readable the moment it is put: nothing delays one, and nothing
+     * hides one that has been handed out.
+     */
+    recordsAvailable(): void;
+}
+/**
+ * What a consumer that cannot poll continuously needs from the streams of one
+ * simulated Kinesis: to be told when a record has been put.
+ *
+ * Watchers are held by stream ARN rather than on the stream itself, so a
+ * watcher survives whatever the stream does, and so the stream model stays a
+ * log rather than a subscription list.
+ */
+export declare class SimKinesisStreamActivity {
+    private readonly watchers;
+    /**
+     * Watch a stream for the records put onto it.
+     */
+    watch(streamArn: string, watcher: SimKinesisStreamWatcher): void;
+    /**
+     * Stop watching a stream.
+     */
+    unwatch(streamArn: string, watcher: SimKinesisStreamWatcher): void;
+    /**
+     * Tell a stream's watchers that there is something to read.
+     */
+    recordsAvailable(streamArn: string): void;
+    private watchersOf;
+}
+//# sourceMappingURL=sim-kinesis-stream-activity.d.ts.map

package/dist/service/kinesis/stream/sim-kinesis-stream-activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-kinesis-stream-activity.d.ts","sourceRoot":"","sources":["../../../../src/service/kinesis/stream/sim-kinesis-stream-activity.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;OAMG;IACH,gBAAgB,IAAI,IAAI,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgD;IAEzE;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAE/D;IAED;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAejE;IAED;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAIxC;IAED,OAAO,CAAC,UAAU;CAGnB"}

package/dist/service/kinesis/stream/sim-kinesis-stream-activity.js

@@ -0,0 +1,43 @@
+/**
+ * What a consumer that cannot poll continuously needs from the streams of one
+ * simulated Kinesis: to be told when a record has been put.
+ *
+ * Watchers are held by stream ARN rather than on the stream itself, so a
+ * watcher survives whatever the stream does, and so the stream model stays a
+ * log rather than a subscription list.
+ */
+export class SimKinesisStreamActivity {
+    watchers = new Map();
+    /**
+     * Watch a stream for the records put onto it.
+     */
+    watch(streamArn, watcher) {
+        this.watchers.set(streamArn, [...this.watchersOf(streamArn), watcher]);
+    }
+    /**
+     * Stop watching a stream.
+     */
+    unwatch(streamArn, watcher) {
+        const remaining = this.watchersOf(streamArn).filter((held) => held !== watcher);
+        if (remaining.length === 0) {
+            // A stream nothing watches any more is forgotten. Keeping the empty list
+            // would grow one entry per stream ever watched, for the life of the
+            // simulation.
+            this.watchers.delete(streamArn);
+            return;
+        }
+        this.watchers.set(streamArn, [...remaining]);
+    }
+    /**
+     * Tell a stream's watchers that there is something to read.
+     */
+    recordsAvailable(streamArn) {
+        for (const watcher of this.watchersOf(streamArn)) {
+            watcher.recordsAvailable();
+        }
+    }
+    watchersOf(streamArn) {
+        return this.watchers.get(streamArn) ?? [];
+    }
+}
+//# sourceMappingURL=sim-kinesis-stream-activity.js.map

package/dist/service/kinesis/stream/sim-kinesis-stream-activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-kinesis-stream-activity.js","sourceRoot":"","sources":["../../../../src/service/kinesis/stream/sim-kinesis-stream-activity.ts"],"names":[],"mappings":"AAkBA;;;;;;;GAOG;AACH,MAAM,OAAO,wBAAwB;IAClB,QAAQ,GAAG,IAAI,GAAG,EAAqC,CAAC;IAEzE;;OAEG;IACH,KAAK,CAAC,SAAiB,EAAE,OAAgC;QACvD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,SAAiB,EAAE,OAAgC;QACzD,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,MAAM,CACjD,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,OAAO,CAC3B,CAAC;QAEF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,yEAAyE;YACzE,oEAAoE;YACpE,cAAc;YACd,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAEhC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,SAAiB;QAChC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACjD,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,SAAiB;QAClC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;CACF"}

package/dist/service/kinesis/stream/sim-kinesis-stream-arn.d.ts

@@ -0,0 +1,30 @@
+import type { SimAwsAccountRegionScope } from "../../aws/sim-aws-account-region-scope.js";
+/**
+ * Where one stream is, in the three facts its ARN carries.
+ *
+ * The strings are unbranded because the callers that have only read an ARN,
+ * rather than been handed a scope, have nothing but strings to offer.
+ */
+export interface SimKinesisStreamLocation {
+    readonly regionName: string;
+    readonly accountId: string;
+    readonly name: string;
+}
+/**
+ * The ARN of a stream of a given name in an Account and Region.
+ */
+export declare function simKinesisStreamArn(accountRegionScope: SimAwsAccountRegionScope, name: string): string;
+/**
+ * Read a stream ARN into the Region, Account and name it carries.
+ *
+ * All three matter. An ARN naming another Account or Region reaches nothing in
+ * a simulated Kinesis scope rather than having its name read out and looked up
+ * locally, since treating a foreign one as local would let a test pass while
+ * the real call crossed a boundary it has no permission for.
+ *
+ * Nothing is returned for a string that is not a stream ARN, including a
+ * consumer ARN, which carries the consumer name and creation time after the
+ * stream name.
+ */
+export declare function parseSimKinesisStreamArn(value: string): SimKinesisStreamLocation | undefined;
+//# sourceMappingURL=sim-kinesis-stream-arn.d.ts.map

package/dist/service/kinesis/stream/sim-kinesis-stream-arn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-kinesis-stream-arn.d.ts","sourceRoot":"","sources":["../../../../src/service/kinesis/stream/sim-kinesis-stream-arn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAQ1F;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,kBAAkB,EAAE,wBAAwB,EAC5C,IAAI,EAAE,MAAM,GACX,MAAM,CAIR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,GACZ,wBAAwB,GAAG,SAAS,CA+BtC"}

package/dist/service/kinesis/stream/sim-kinesis-stream-arn.js

@@ -0,0 +1,47 @@
+const streamArnPartition = "aws";
+const streamArnService = "kinesis";
+const streamArnResourceType = "stream";
+/**
+ * The ARN of a stream of a given name in an Account and Region.
+ */
+export function simKinesisStreamArn(accountRegionScope, name) {
+    const { regionName, accountId } = accountRegionScope;
+    return `arn:${streamArnPartition}:${streamArnService}:${regionName}:${accountId}:${streamArnResourceType}/${name}`;
+}
+/**
+ * Read a stream ARN into the Region, Account and name it carries.
+ *
+ * All three matter. An ARN naming another Account or Region reaches nothing in
+ * a simulated Kinesis scope rather than having its name read out and looked up
+ * locally, since treating a foreign one as local would let a test pass while
+ * the real call crossed a boundary it has no permission for.
+ *
+ * Nothing is returned for a string that is not a stream ARN, including a
+ * consumer ARN, which carries the consumer name and creation time after the
+ * stream name.
+ */
+export function parseSimKinesisStreamArn(value) {
+    const parts = value.split(":");
+    if (parts.length !== 6) {
+        return undefined;
+    }
+    const [prefix, partition, service, regionName, accountId, resource] = parts;
+    if (prefix !== "arn" ||
+        partition !== streamArnPartition ||
+        service !== streamArnService ||
+        regionName === undefined ||
+        regionName === "" ||
+        accountId === undefined ||
+        accountId === "" ||
+        resource === undefined) {
+        return undefined;
+    }
+    if (!resource.startsWith(`${streamArnResourceType}/`)) {
+        return undefined;
+    }
+    const name = resource.slice(`${streamArnResourceType}/`.length);
+    return name === "" || name.includes("/")
+        ? undefined
+        : { regionName, accountId, name };
+}
+//# sourceMappingURL=sim-kinesis-stream-arn.js.map

package/dist/service/kinesis/stream/sim-kinesis-stream-arn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-kinesis-stream-arn.js","sourceRoot":"","sources":["../../../../src/service/kinesis/stream/sim-kinesis-stream-arn.ts"],"names":[],"mappings":"AAEA,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAEjC,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAEnC,MAAM,qBAAqB,GAAG,QAAQ,CAAC;AAcvC;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,kBAA4C,EAC5C,IAAY;IAEZ,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,kBAAkB,CAAC;IAErD,OAAO,OAAO,kBAAkB,IAAI,gBAAgB,IAAI,UAAU,IAAI,SAAS,IAAI,qBAAqB,IAAI,IAAI,EAAE,CAAC;AACrH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAa;IAEb,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC;IAE5E,IACE,MAAM,KAAK,KAAK;QAChB,SAAS,KAAK,kBAAkB;QAChC,OAAO,KAAK,gBAAgB;QAC5B,UAAU,KAAK,SAAS;QACxB,UAAU,KAAK,EAAE;QACjB,SAAS,KAAK,SAAS;QACvB,SAAS,KAAK,EAAE;QAChB,QAAQ,KAAK,SAAS,EACtB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,qBAAqB,GAAG,CAAC,EAAE,CAAC;QACtD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,qBAAqB,GAAG,CAAC,MAAM,CAAC,CAAC;IAEhE,OAAO,IAAI,KAAK,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QACtC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACtC,CAAC"}

package/dist/service/kinesis/stream/sim-kinesis-stream-mode.d.ts

@@ -0,0 +1,24 @@
+/**
+ * How a stream's capacity is decided.
+ */
+export type SimKinesisStreamMode = "PROVISIONED" | "ON_DEMAND";
+/**
+ * How many shards an on-demand stream starts with.
+ *
+ * Real Kinesis gives an on-demand stream four shards and grows it with the
+ * traffic. Nothing here measures traffic, so the count stays where it starts.
+ */
+export declare const simKinesisOnDemandShardCount = 4;
+/**
+ * Read the stream mode a request asked for.
+ */
+export declare function simKinesisStreamModeOf(mode: string | undefined): SimKinesisStreamMode;
+/**
+ * How many shards a stream is created with.
+ *
+ * An on-demand stream takes no shard count, and real Kinesis refuses a request
+ * carrying both. A provisioned stream created without one gets a single shard,
+ * which is what real Kinesis does.
+ */
+export declare function simKinesisCreatedShardCount(mode: SimKinesisStreamMode, shardCount: number | undefined): number;
+//# sourceMappingURL=sim-kinesis-stream-mode.d.ts.map

package/dist/service/kinesis/stream/sim-kinesis-stream-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-kinesis-stream-mode.d.ts","sourceRoot":"","sources":["../../../../src/service/kinesis/stream/sim-kinesis-stream-mode.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,WAAW,CAAC;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAO9C;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,oBAAoB,CAatB;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,oBAAoB,EAC1B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,MAAM,CA6BR"}