@kensio/yulin 1.19.4 → 1.20.0

package/dist/service/kinesis/command/sim-kinesis-stream-ref.js

@@ -0,0 +1,43 @@
+import { SimKinesisInvalidArgumentException } from "../error/sim-kinesis.error.js";
+import { parseSimKinesisStreamArn, simKinesisStreamArn, } from "../stream/sim-kinesis-stream-arn.js";
+/**
+ * The stream name a request carried, refusing one that named neither a name nor
+ * an ARN.
+ */
+function requiredName(name) {
+    if (name === undefined || name === "") {
+        throw new SimKinesisInvalidArgumentException("A request has to name a stream by StreamName or by StreamARN");
+    }
+    return name;
+}
+/**
+ * The ARN of the stream a request names, whichever way it named it.
+ */
+export function simKinesisRefArn(ref, scope) {
+    if (ref.StreamARN !== undefined && ref.StreamARN !== "") {
+        return ref.StreamARN;
+    }
+    return simKinesisStreamArn(scope, requiredName(ref.StreamName));
+}
+/**
+ * The name to look the stream a request names up by.
+ *
+ * An ARN naming another Account or Region reaches nothing here. Reading its
+ * name out and looking that up locally would let a test pass while the real
+ * call crossed a boundary it has no permission for, so the ARN itself becomes
+ * the lookup key. No stream name can hold a colon, so nothing is found, and the
+ * refusal names what the request asked for.
+ */
+export function simKinesisRefLookupName(ref, scope) {
+    if (ref.StreamARN === undefined || ref.StreamARN === "") {
+        return requiredName(ref.StreamName);
+    }
+    const location = parseSimKinesisStreamArn(ref.StreamARN);
+    if (location === undefined ||
+        location.accountId !== scope.accountId ||
+        location.regionName !== scope.regionName) {
+        return ref.StreamARN;
+    }
+    return location.name;
+}
+//# sourceMappingURL=sim-kinesis-stream-ref.js.map

package/dist/service/kinesis/command/sim-kinesis-stream-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-kinesis-stream-ref.js","sourceRoot":"","sources":["../../../../src/service/kinesis/command/sim-kinesis-stream-ref.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EACL,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,qCAAqC,CAAC;AAa7C;;;GAGG;AACH,SAAS,YAAY,CAAC,IAAwB;IAC5C,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,kCAAkC,CAC1C,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAwB,EACxB,KAA+B;IAE/B,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,GAAG,CAAC,SAAS,KAAK,EAAE,EAAE,CAAC;QACxD,OAAO,GAAG,CAAC,SAAS,CAAC;IACvB,CAAC;IAED,OAAO,mBAAmB,CAAC,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CACrC,GAAwB,EACxB,KAA+B;IAE/B,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,GAAG,CAAC,SAAS,KAAK,EAAE,EAAE,CAAC;QACxD,OAAO,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,QAAQ,GAAG,wBAAwB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAEzD,IACE,QAAQ,KAAK,SAAS;QACtB,QAAQ,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS;QACtC,QAAQ,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,EACxC,CAAC;QACD,OAAO,GAAG,CAAC,SAAS,CAAC;IACvB,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC"}

package/dist/service/kinesis/command/stream/sim-kinesis-create-stream.d.ts

@@ -0,0 +1,38 @@
+import type { BackgroundScheduler } from "../../../../util/background/background.js";
+import type { SimAwsAccountRegionScope } from "../../../aws/sim-aws-account-region-scope.js";
+import type { SimKinesisStreamStore } from "../../stream/sim-kinesis-stream-store.js";
+import type { SimKinesisRequestOptions } from "../sim-kinesis-request-options.js";
+import type { SimKinesisStreamAccess } from "../sim-kinesis-stream-access.js";
+import type { SimCreateStreamCommand, SimCreateStreamCommandOutput } from "./stream.command.js";
+interface SimKinesisCreateStreamProperties {
+    readonly streams: SimKinesisStreamStore;
+    readonly access: SimKinesisStreamAccess;
+    readonly accountRegionScope: SimAwsAccountRegionScope;
+    readonly background: BackgroundScheduler;
+}
+/**
+ * The command that creates a stream.
+ */
+export declare class SimKinesisCreateStream {
+    private readonly streams;
+    private readonly access;
+    private readonly accountRegionScope;
+    private readonly background;
+    constructor(properties: SimKinesisCreateStreamProperties);
+    /**
+     * Create a stream and open the shards it was asked for.
+     *
+     * A name this scope already holds is refused, as real Kinesis refuses it,
+     * rather than answering with the stream that is there. The stream is `ACTIVE`
+     * straight away: real Kinesis reports `CREATING` while it brings the shards
+     * up, and a status a test has to poll through earns nothing when there are no
+     * shards to bring up.
+     *
+     * Tags are kept on the stream. No command here reads them back, since the tag
+     * operations are unsimulated, and a test that cares reads them through the
+     * simulator's own accessor.
+     */
+    handle(command: SimCreateStreamCommand, options?: SimKinesisRequestOptions): SimCreateStreamCommandOutput;
+}
+export {};
+//# sourceMappingURL=sim-kinesis-create-stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-kinesis-create-stream.d.ts","sourceRoot":"","sources":["../../../../../src/service/kinesis/command/stream/sim-kinesis-create-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AACrF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAC;AAS7F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EACV,sBAAsB,EACtB,4BAA4B,EAC7B,MAAM,qBAAqB,CAAC;AAE7B,UAAU,gCAAgC;IACxC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,CAAC;IACtD,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;CAC1C;AAED;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA2B;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IAEjD,YAAY,UAAU,EAAE,gCAAgC,EAKvD;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CACJ,OAAO,EAAE,sBAAsB,EAC/B,OAAO,CAAC,EAAE,wBAAwB,GACjC,4BAA4B,CA2B9B;CACF"}

package/dist/service/kinesis/command/stream/sim-kinesis-create-stream.js

@@ -0,0 +1,53 @@
+import { SimKinesisResourceInUseException } from "../../error/sim-kinesis.error.js";
+import { simKinesisDefaultRetentionHours } from "../../stream/sim-kinesis-retention.js";
+import { SimKinesisStream } from "../../stream/sim-kinesis-stream.js";
+import { simKinesisCreatedShardCount, simKinesisStreamModeOf, } from "../../stream/sim-kinesis-stream-mode.js";
+import { SimKinesisStreamName } from "../../stream/sim-kinesis-stream-name.js";
+/**
+ * The command that creates a stream.
+ */
+export class SimKinesisCreateStream {
+    streams;
+    access;
+    accountRegionScope;
+    background;
+    constructor(properties) {
+        this.streams = properties.streams;
+        this.access = properties.access;
+        this.accountRegionScope = properties.accountRegionScope;
+        this.background = properties.background;
+    }
+    /**
+     * Create a stream and open the shards it was asked for.
+     *
+     * A name this scope already holds is refused, as real Kinesis refuses it,
+     * rather than answering with the stream that is there. The stream is `ACTIVE`
+     * straight away: real Kinesis reports `CREATING` while it brings the shards
+     * up, and a status a test has to poll through earns nothing when there are no
+     * shards to bring up.
+     *
+     * Tags are kept on the stream. No command here reads them back, since the tag
+     * operations are unsimulated, and a test that cares reads them through the
+     * simulator's own accessor.
+     */
+    handle(command, options) {
+        const { input } = command;
+        const name = new SimKinesisStreamName(input.StreamName);
+        this.access.authorizeName("kinesis:CreateStream", name.value, options);
+        if (this.streams.find(name.value) !== undefined) {
+            throw new SimKinesisResourceInUseException(`Stream ${name.value} under this account and region already exists`);
+        }
+        const mode = simKinesisStreamModeOf(input.StreamModeDetails?.StreamMode);
+        this.streams.add(new SimKinesisStream({
+            name,
+            accountRegionScope: this.accountRegionScope,
+            mode,
+            shardCount: simKinesisCreatedShardCount(mode, input.ShardCount),
+            retentionHours: simKinesisDefaultRetentionHours,
+            createdAt: this.background.now(),
+            tags: input.Tags ?? {},
+        }));
+        return { $metadata: {} };
+    }
+}
+//# sourceMappingURL=sim-kinesis-create-stream.js.map

package/dist/service/kinesis/command/stream/sim-kinesis-create-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-kinesis-create-stream.js","sourceRoot":"","sources":["../../../../../src/service/kinesis/command/stream/sim-kinesis-create-stream.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gCAAgC,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,EAAE,+BAA+B,EAAE,MAAM,uCAAuC,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAgB/E;;GAEG;AACH,MAAM,OAAO,sBAAsB;IAChB,OAAO,CAAwB;IAC/B,MAAM,CAAyB;IAC/B,kBAAkB,CAA2B;IAC7C,UAAU,CAAsB;IAEjD,YAAY,UAA4C;QACtD,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QAChC,IAAI,CAAC,kBAAkB,GAAG,UAAU,CAAC,kBAAkB,CAAC;QACxD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CACJ,OAA+B,EAC/B,OAAkC;QAElC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,oBAAoB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAExD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,sBAAsB,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAEvE,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;YAChD,MAAM,IAAI,gCAAgC,CACxC,UAAU,IAAI,CAAC,KAAK,+CAA+C,CACpE,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,sBAAsB,CAAC,KAAK,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC;QAEzE,IAAI,CAAC,OAAO,CAAC,GAAG,CACd,IAAI,gBAAgB,CAAC;YACnB,IAAI;YACJ,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;YAC3C,IAAI;YACJ,UAAU,EAAE,2BAA2B,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC;YAC/D,cAAc,EAAE,+BAA+B;YAC/C,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE;YAChC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;SACvB,CAAC,CACH,CAAC;QAEF,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/service/kinesis/command/stream/sim-kinesis-retention-commands.d.ts

@@ -0,0 +1,30 @@
+import type { SimKinesisRequestOptions } from "../sim-kinesis-request-options.js";
+import type { SimKinesisStreamAccess } from "../sim-kinesis-stream-access.js";
+import type { SimDecreaseStreamRetentionPeriodCommand, SimIncreaseStreamRetentionPeriodCommand, SimStreamRetentionPeriodCommandOutput } from "./stream.command.js";
+interface SimKinesisRetentionCommandsProperties {
+    readonly access: SimKinesisStreamAccess;
+}
+/**
+ * The commands that move how long a stream keeps a record.
+ *
+ * They are two commands rather than one because real Kinesis refuses the wrong
+ * direction: increasing to less than the stream already keeps, or decreasing to
+ * more, is a mistake about what the caller believed the stream was set to.
+ */
+export declare class SimKinesisRetentionCommands {
+    private readonly access;
+    constructor(properties: SimKinesisRetentionCommandsProperties);
+    /**
+     * Keep records for longer than the stream keeps them now.
+     */
+    increase(command: SimIncreaseStreamRetentionPeriodCommand, options?: SimKinesisRequestOptions): SimStreamRetentionPeriodCommandOutput;
+    /**
+     * Keep records for less time than the stream keeps them now.
+     *
+     * A record already older than the new window is gone from the next read,
+     * since retention is applied when a stream is read.
+     */
+    decrease(command: SimDecreaseStreamRetentionPeriodCommand, options?: SimKinesisRequestOptions): SimStreamRetentionPeriodCommandOutput;
+}
+export {};
+//# sourceMappingURL=sim-kinesis-retention-commands.d.ts.map

package/dist/service/kinesis/command/stream/sim-kinesis-retention-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-kinesis-retention-commands.d.ts","sourceRoot":"","sources":["../../../../../src/service/kinesis/command/stream/sim-kinesis-retention-commands.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EACV,uCAAuC,EACvC,uCAAuC,EACvC,qCAAqC,EACtC,MAAM,qBAAqB,CAAC;AAE7B,UAAU,qCAAqC;IAC7C,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;CACzC;AAED;;;;;;GAMG;AACH,qBAAa,2BAA2B;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAEhD,YAAY,UAAU,EAAE,qCAAqC,EAE5D;IAED;;OAEG;IACH,QAAQ,CACN,OAAO,EAAE,uCAAuC,EAChD,OAAO,CAAC,EAAE,wBAAwB,GACjC,qCAAqC,CAavC;IAED;;;;;OAKG;IACH,QAAQ,CACN,OAAO,EAAE,uCAAuC,EAChD,OAAO,CAAC,EAAE,wBAAwB,GACjC,qCAAqC,CAavC;CACF"}

package/dist/service/kinesis/command/stream/sim-kinesis-retention-commands.js

@@ -0,0 +1,67 @@
+import { SimKinesisInvalidArgumentException } from "../../error/sim-kinesis.error.js";
+import { simKinesisRetentionHours } from "../../stream/sim-kinesis-retention.js";
+/**
+ * The commands that move how long a stream keeps a record.
+ *
+ * They are two commands rather than one because real Kinesis refuses the wrong
+ * direction: increasing to less than the stream already keeps, or decreasing to
+ * more, is a mistake about what the caller believed the stream was set to.
+ */
+export class SimKinesisRetentionCommands {
+    access;
+    constructor(properties) {
+        this.access = properties.access;
+    }
+    /**
+     * Keep records for longer than the stream keeps them now.
+     */
+    increase(command, options) {
+        const { input } = command;
+        const stream = this.access.require("kinesis:IncreaseStreamRetentionPeriod", input, options);
+        const hours = requiredHours(input.RetentionPeriodHours);
+        assertDirection(stream, hours, "increase");
+        stream.setRetentionHours(hours);
+        return { $metadata: {} };
+    }
+    /**
+     * Keep records for less time than the stream keeps them now.
+     *
+     * A record already older than the new window is gone from the next read,
+     * since retention is applied when a stream is read.
+     */
+    decrease(command, options) {
+        const { input } = command;
+        const stream = this.access.require("kinesis:DecreaseStreamRetentionPeriod", input, options);
+        const hours = requiredHours(input.RetentionPeriodHours);
+        assertDirection(stream, hours, "decrease");
+        stream.setRetentionHours(hours);
+        return { $metadata: {} };
+    }
+}
+/**
+ * The retention a request has to carry, in the range Kinesis accepts.
+ */
+function requiredHours(hours) {
+    if (hours === undefined) {
+        throw new SimKinesisInvalidArgumentException("RetentionPeriodHours is required to change how long a stream keeps a " +
+            "record");
+    }
+    return simKinesisRetentionHours(hours);
+}
+/**
+ * Refuse a change that does not go the way the command asking for it goes.
+ *
+ * Real Kinesis wants the new period to be strictly more for an increase and
+ * strictly less for a decrease, so asking for what the stream already keeps is
+ * refused as well. A caller doing that has the wrong idea of what the stream is
+ * set to, which is the mistake both commands exist to catch.
+ */
+function assertDirection(stream, hours, direction) {
+    const held = stream.retentionHours;
+    const wrongWay = direction === "increase" ? hours <= held : hours >= held;
+    if (wrongWay) {
+        throw new SimKinesisInvalidArgumentException(`Cannot ${direction} the retention of stream ${stream.name} from ` +
+            `${held} hours to ${hours}`);
+    }
+}
+//# sourceMappingURL=sim-kinesis-retention-commands.js.map

package/dist/service/kinesis/command/stream/sim-kinesis-retention-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-kinesis-retention-commands.js","sourceRoot":"","sources":["../../../../../src/service/kinesis/command/stream/sim-kinesis-retention-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kCAAkC,EAAE,MAAM,kCAAkC,CAAC;AACtF,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAcjF;;;;;;GAMG;AACH,MAAM,OAAO,2BAA2B;IACrB,MAAM,CAAyB;IAEhD,YAAY,UAAiD;QAC3D,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,QAAQ,CACN,OAAgD,EAChD,OAAkC;QAElC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAChC,uCAAuC,EACvC,KAAK,EACL,OAAO,CACR,CAAC;QACF,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAExD,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;QAC3C,MAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAEhC,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC3B,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CACN,OAAgD,EAChD,OAAkC;QAElC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAChC,uCAAuC,EACvC,KAAK,EACL,OAAO,CACR,CAAC;QACF,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAExD,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;QAC3C,MAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAEhC,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC3B,CAAC;CACF;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,KAAyB;IAC9C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,kCAAkC,CAC1C,uEAAuE;YACrE,QAAQ,CACX,CAAC;IACJ,CAAC;IAED,OAAO,wBAAwB,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,eAAe,CACtB,MAAwB,EACxB,KAAa,EACb,SAAkC;IAElC,MAAM,IAAI,GAAG,MAAM,CAAC,cAAc,CAAC;IACnC,MAAM,QAAQ,GAAG,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC;IAE1E,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,IAAI,kCAAkC,CAC1C,UAAU,SAAS,4BAA4B,MAAM,CAAC,IAAI,QAAQ;YAChE,GAAG,IAAI,aAAa,KAAK,EAAE,CAC9B,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/service/kinesis/command/stream/sim-kinesis-stream-commands.d.ts

@@ -0,0 +1,46 @@
+import type { SimKinesisStreamStore } from "../../stream/sim-kinesis-stream-store.js";
+import type { SimKinesisRequestOptions } from "../sim-kinesis-request-options.js";
+import type { SimKinesisStreamAccess } from "../sim-kinesis-stream-access.js";
+import type { SimDeleteStreamCommand, SimDeleteStreamCommandOutput, SimDescribeStreamCommand, SimDescribeStreamCommandOutput, SimDescribeStreamSummaryCommand, SimDescribeStreamSummaryCommandOutput, SimListStreamsCommand, SimListStreamsCommandOutput } from "./stream.command.js";
+interface SimKinesisStreamCommandsProperties {
+    readonly streams: SimKinesisStreamStore;
+    readonly access: SimKinesisStreamAccess;
+}
+/**
+ * The commands that list, describe and delete streams.
+ */
+export declare class SimKinesisStreamCommands {
+    private readonly streams;
+    private readonly access;
+    constructor(properties: SimKinesisStreamCommandsProperties);
+    /**
+     * List the streams in this scope, by name.
+     *
+     * Real Kinesis gives this action no stream-level permission, so it authorizes
+     * against every stream in the Account and Region and does not filter the list
+     * by what the caller can reach.
+     */
+    listStreams(command: SimListStreamsCommand, options?: SimKinesisRequestOptions): SimListStreamsCommandOutput;
+    /**
+     * Describe a stream and a page of its shards.
+     */
+    describeStream(command: SimDescribeStreamCommand, options?: SimKinesisRequestOptions): SimDescribeStreamCommandOutput;
+    /**
+     * Describe a stream without listing its shards.
+     */
+    describeStreamSummary(command: SimDescribeStreamSummaryCommand, options?: SimKinesisRequestOptions): SimDescribeStreamSummaryCommandOutput;
+    /**
+     * Delete a stream, and the records on every one of its shards.
+     *
+     * The name is freed at once, so a stream can be recreated under the same name
+     * straight away. A stream that is not there is refused, as real Kinesis
+     * refuses it, unlike SNS where deleting a missing topic succeeds.
+     *
+     * `EnforceConsumerDeletion` is accepted and needs nothing done with it. It
+     * decides what happens to a stream's enhanced fan-out consumers, and no
+     * stream here has any.
+     */
+    deleteStream(command: SimDeleteStreamCommand, options?: SimKinesisRequestOptions): SimDeleteStreamCommandOutput;
+}
+export {};
+//# sourceMappingURL=sim-kinesis-stream-commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-kinesis-stream-commands.d.ts","sourceRoot":"","sources":["../../../../../src/service/kinesis/command/stream/sim-kinesis-stream-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAEtF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAM9E,OAAO,KAAK,EACV,sBAAsB,EACtB,4BAA4B,EAC5B,wBAAwB,EACxB,8BAA8B,EAC9B,+BAA+B,EAC/B,qCAAqC,EACrC,qBAAqB,EACrB,2BAA2B,EAC5B,MAAM,qBAAqB,CAAC;AAO7B,UAAU,kCAAkC;IAC1C,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;CACzC;AAED;;GAEG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAEhD,YAAY,UAAU,EAAE,kCAAkC,EAGzD;IAED;;;;;;OAMG;IACH,WAAW,CACT,OAAO,EAAE,qBAAqB,EAC9B,OAAO,CAAC,EAAE,wBAAwB,GACjC,2BAA2B,CAkB7B;IAED;;OAEG;IACH,cAAc,CACZ,OAAO,EAAE,wBAAwB,EACjC,OAAO,CAAC,EAAE,wBAAwB,GACjC,8BAA8B,CAYhC;IAED;;OAEG;IACH,qBAAqB,CACnB,OAAO,EAAE,+BAA+B,EACxC,OAAO,CAAC,EAAE,wBAAwB,GACjC,qCAAqC,CAWvC;IAED;;;;;;;;;;OAUG;IACH,YAAY,CACV,OAAO,EAAE,sBAAsB,EAC/B,OAAO,CAAC,EAAE,wBAAwB,GACjC,4BAA4B,CAU9B;CACF"}

package/dist/service/kinesis/command/stream/sim-kinesis-stream-commands.js

@@ -0,0 +1,74 @@
+import { SimKinesisPage } from "../sim-kinesis-page.js";
+import { streamDescription, streamDescriptionSummary, streamSummary, } from "./sim-kinesis-stream-descriptions.js";
+/**
+ * How many streams ListStreams reports when a request asks for no limit.
+ */
+const defaultStreamLimit = 100;
+/**
+ * The commands that list, describe and delete streams.
+ */
+export class SimKinesisStreamCommands {
+    streams;
+    access;
+    constructor(properties) {
+        this.streams = properties.streams;
+        this.access = properties.access;
+    }
+    /**
+     * List the streams in this scope, by name.
+     *
+     * Real Kinesis gives this action no stream-level permission, so it authorizes
+     * against every stream in the Account and Region and does not filter the list
+     * by what the caller can reach.
+     */
+    listStreams(command, options) {
+        this.access.authorizeAnyStream("kinesis:ListStreams", options);
+        const { input } = command;
+        const page = new SimKinesisPage(this.streams.all, (stream) => stream.name, input.NextToken ?? input.ExclusiveStartStreamName, input.Limit ?? defaultStreamLimit);
+        return {
+            $metadata: {},
+            StreamNames: page.items.map((stream) => stream.name),
+            StreamSummaries: page.items.map((stream) => streamSummary(stream)),
+            HasMoreStreams: page.hasMore,
+            NextToken: page.hasMore ? page.items.at(-1)?.name : undefined,
+        };
+    }
+    /**
+     * Describe a stream and a page of its shards.
+     */
+    describeStream(command, options) {
+        const { input } = command;
+        const stream = this.access.require("kinesis:DescribeStream", input, options);
+        return {
+            $metadata: {},
+            StreamDescription: streamDescription(stream, input),
+        };
+    }
+    /**
+     * Describe a stream without listing its shards.
+     */
+    describeStreamSummary(command, options) {
+        const stream = this.access.require("kinesis:DescribeStreamSummary", command.input, options);
+        return {
+            $metadata: {},
+            StreamDescriptionSummary: streamDescriptionSummary(stream),
+        };
+    }
+    /**
+     * Delete a stream, and the records on every one of its shards.
+     *
+     * The name is freed at once, so a stream can be recreated under the same name
+     * straight away. A stream that is not there is refused, as real Kinesis
+     * refuses it, unlike SNS where deleting a missing topic succeeds.
+     *
+     * `EnforceConsumerDeletion` is accepted and needs nothing done with it. It
+     * decides what happens to a stream's enhanced fan-out consumers, and no
+     * stream here has any.
+     */
+    deleteStream(command, options) {
+        const stream = this.access.require("kinesis:DeleteStream", command.input, options);
+        this.streams.remove(stream);
+        return { $metadata: {} };
+    }
+}
+//# sourceMappingURL=sim-kinesis-stream-commands.js.map

package/dist/service/kinesis/command/stream/sim-kinesis-stream-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-kinesis-stream-commands.js","sourceRoot":"","sources":["../../../../../src/service/kinesis/command/stream/sim-kinesis-stream-commands.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,aAAa,GACd,MAAM,sCAAsC,CAAC;AAY9C;;GAEG;AACH,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAO/B;;GAEG;AACH,MAAM,OAAO,wBAAwB;IAClB,OAAO,CAAwB;IAC/B,MAAM,CAAyB;IAEhD,YAAY,UAA8C;QACxD,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;IAClC,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CACT,OAA8B,EAC9B,OAAkC;QAElC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;QAE/D,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,cAAc,CAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,EAChB,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EACvB,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,wBAAwB,EACjD,KAAK,CAAC,KAAK,IAAI,kBAAkB,CAClC,CAAC;QAEF,OAAO;YACL,SAAS,EAAE,EAAE;YACb,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;YACpD,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAClE,cAAc,EAAE,IAAI,CAAC,OAAO;YAC5B,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS;SAC9D,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,cAAc,CACZ,OAAiC,EACjC,OAAkC;QAElC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAChC,wBAAwB,EACxB,KAAK,EACL,OAAO,CACR,CAAC;QAEF,OAAO;YACL,SAAS,EAAE,EAAE;YACb,iBAAiB,EAAE,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC;SACpD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,qBAAqB,CACnB,OAAwC,EACxC,OAAkC;QAElC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAChC,+BAA+B,EAC/B,OAAO,CAAC,KAAK,EACb,OAAO,CACR,CAAC;QAEF,OAAO;YACL,SAAS,EAAE,EAAE;YACb,wBAAwB,EAAE,wBAAwB,CAAC,MAAM,CAAC;SAC3D,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACH,YAAY,CACV,OAA+B,EAC/B,OAAkC;QAElC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAChC,sBAAsB,EACtB,OAAO,CAAC,KAAK,EACb,OAAO,CACR,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAE5B,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/service/kinesis/command/stream/sim-kinesis-stream-descriptions.d.ts

@@ -0,0 +1,18 @@
+import type { SimKinesisStream } from "../../stream/sim-kinesis-stream.js";
+import type { SimDescribeStreamCommandInput, SimKinesisStreamDescription, SimKinesisStreamDescriptionSummary, SimKinesisStreamSummary } from "./stream.command.js";
+/**
+ * One stream, as ListStreams reports it.
+ */
+export declare function streamSummary(stream: SimKinesisStream): SimKinesisStreamSummary;
+/**
+ * One stream and a page of its shards, as DescribeStream reports them.
+ */
+export declare function streamDescription(stream: SimKinesisStream, input: SimDescribeStreamCommandInput): SimKinesisStreamDescription;
+/**
+ * One stream without its shards, as DescribeStreamSummary reports it.
+ *
+ * The consumer count is zero because enhanced fan-out is unsimulated, so
+ * nothing here registers a consumer against a stream.
+ */
+export declare function streamDescriptionSummary(stream: SimKinesisStream): SimKinesisStreamDescriptionSummary;
+//# sourceMappingURL=sim-kinesis-stream-descriptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-kinesis-stream-descriptions.d.ts","sourceRoot":"","sources":["../../../../../src/service/kinesis/command/stream/sim-kinesis-stream-descriptions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAE3E,OAAO,KAAK,EACV,6BAA6B,EAE7B,2BAA2B,EAC3B,kCAAkC,EAClC,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AA4B7B;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,gBAAgB,GACvB,uBAAuB,CAQzB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,6BAA6B,GACnC,2BAA2B,CAmB7B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,gBAAgB,GACvB,kCAAkC,CAYpC"}

package/dist/service/kinesis/command/stream/sim-kinesis-stream-descriptions.js

@@ -0,0 +1,74 @@
+import { SimKinesisPage } from "../sim-kinesis-page.js";
+/**
+ * How many shards DescribeStream reports when a request asks for no limit.
+ */
+const defaultShardLimit = 100;
+/**
+ * One shard, as DescribeStream reports it.
+ *
+ * The hash key bounds are decimal strings because the space runs to 2^128. The
+ * ending sequence number is absent, which is how a reader tells a shard that is
+ * still taking records from one it can finish with. Nothing here closes a
+ * shard.
+ */
+function shardOutput(shard) {
+    return {
+        ShardId: shard.shardId,
+        HashKeyRange: {
+            StartingHashKey: shard.hashKeyRange.startingHashKey.toString(),
+            EndingHashKey: shard.hashKeyRange.endingHashKey.toString(),
+        },
+        SequenceNumberRange: {
+            StartingSequenceNumber: shard.startingSequenceNumber,
+        },
+    };
+}
+/**
+ * One stream, as ListStreams reports it.
+ */
+export function streamSummary(stream) {
+    return {
+        StreamName: stream.name,
+        StreamARN: stream.arn,
+        StreamStatus: stream.status,
+        StreamModeDetails: { StreamMode: stream.mode },
+        StreamCreationTimestamp: stream.createdAt,
+    };
+}
+/**
+ * One stream and a page of its shards, as DescribeStream reports them.
+ */
+export function streamDescription(stream, input) {
+    const page = new SimKinesisPage(stream.shards, (shard) => shard.shardId, input.ExclusiveStartShardId, input.Limit ?? defaultShardLimit);
+    return {
+        StreamName: stream.name,
+        StreamARN: stream.arn,
+        StreamStatus: stream.status,
+        StreamModeDetails: { StreamMode: stream.mode },
+        Shards: page.items.map((shard) => shardOutput(shard)),
+        HasMoreShards: page.hasMore,
+        RetentionPeriodHours: stream.retentionHours,
+        StreamCreationTimestamp: stream.createdAt,
+        EnhancedMonitoring: [],
+    };
+}
+/**
+ * One stream without its shards, as DescribeStreamSummary reports it.
+ *
+ * The consumer count is zero because enhanced fan-out is unsimulated, so
+ * nothing here registers a consumer against a stream.
+ */
+export function streamDescriptionSummary(stream) {
+    return {
+        StreamName: stream.name,
+        StreamARN: stream.arn,
+        StreamStatus: stream.status,
+        StreamModeDetails: { StreamMode: stream.mode },
+        RetentionPeriodHours: stream.retentionHours,
+        StreamCreationTimestamp: stream.createdAt,
+        EnhancedMonitoring: [],
+        OpenShardCount: stream.shards.length,
+        ConsumerCount: 0,
+    };
+}
+//# sourceMappingURL=sim-kinesis-stream-descriptions.js.map

package/dist/service/kinesis/command/stream/sim-kinesis-stream-descriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-kinesis-stream-descriptions.js","sourceRoot":"","sources":["../../../../../src/service/kinesis/command/stream/sim-kinesis-stream-descriptions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AASxD;;GAEG;AACH,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B;;;;;;;GAOG;AACH,SAAS,WAAW,CAAC,KAAsB;IACzC,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,YAAY,EAAE;YACZ,eAAe,EAAE,KAAK,CAAC,YAAY,CAAC,eAAe,CAAC,QAAQ,EAAE;YAC9D,aAAa,EAAE,KAAK,CAAC,YAAY,CAAC,aAAa,CAAC,QAAQ,EAAE;SAC3D;QACD,mBAAmB,EAAE;YACnB,sBAAsB,EAAE,KAAK,CAAC,sBAAsB;SACrD;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAwB;IAExB,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,IAAI;QACvB,SAAS,EAAE,MAAM,CAAC,GAAG;QACrB,YAAY,EAAE,MAAM,CAAC,MAAM;QAC3B,iBAAiB,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE;QAC9C,uBAAuB,EAAE,MAAM,CAAC,SAAS;KAC1C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAwB,EACxB,KAAoC;IAEpC,MAAM,IAAI,GAAG,IAAI,cAAc,CAC7B,MAAM,CAAC,MAAM,EACb,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EACxB,KAAK,CAAC,qBAAqB,EAC3B,KAAK,CAAC,KAAK,IAAI,iBAAiB,CACjC,CAAC;IAEF,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,IAAI;QACvB,SAAS,EAAE,MAAM,CAAC,GAAG;QACrB,YAAY,EAAE,MAAM,CAAC,MAAM;QAC3B,iBAAiB,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE;QAC9C,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACrD,aAAa,EAAE,IAAI,CAAC,OAAO;QAC3B,oBAAoB,EAAE,MAAM,CAAC,cAAc;QAC3C,uBAAuB,EAAE,MAAM,CAAC,SAAS;QACzC,kBAAkB,EAAE,EAAE;KACvB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAwB;IAExB,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,IAAI;QACvB,SAAS,EAAE,MAAM,CAAC,GAAG;QACrB,YAAY,EAAE,MAAM,CAAC,MAAM;QAC3B,iBAAiB,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE;QAC9C,oBAAoB,EAAE,MAAM,CAAC,cAAc;QAC3C,uBAAuB,EAAE,MAAM,CAAC,SAAS;QACzC,kBAAkB,EAAE,EAAE;QACtB,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;QACpC,aAAa,EAAE,CAAC;KACjB,CAAC;AACJ,CAAC"}