@kensio/yulin 1.11.1 → 1.12.0

package/dist/service/eventbridge/command/bus/sim-event-bridge-unsimulated-bus-input.js

@@ -0,0 +1,63 @@
+import { SimEventBridgeUnsimulatedInputException, SimEventBridgeValidationException, } from "../../error/sim-event-bridge.error.js";
+/**
+ * The maximum length real EventBridge takes for an event bus description.
+ */
+const maximumDescriptionLength = 512;
+/**
+ * What a CreateEventBus input carrying an unmodelled property is refused with.
+ */
+const refusals = [
+    [
+        (input) => input.EventSourceName,
+        "Partner event buses are not simulated, so CreateEventBus refuses an " +
+            "EventSourceName rather than creating a bus no partner can reach",
+    ],
+    [
+        (input) => input.KmsKeyIdentifier,
+        "Event bus encryption with a customer managed key is not simulated, so " +
+            "CreateEventBus refuses a KmsKeyIdentifier rather than creating a bus " +
+            "that encrypts nothing",
+    ],
+    [
+        (input) => input.DeadLetterConfig,
+        "Event bus dead letter queues are not simulated, so CreateEventBus " +
+            "refuses a DeadLetterConfig rather than creating a bus that drops " +
+            "undelivered events silently",
+    ],
+    [
+        (input) => input.LogConfig,
+        "Event bus logging is not simulated, so CreateEventBus refuses a " +
+            "LogConfig rather than creating a bus that logs nothing",
+    ],
+    [
+        (input) => input.Tags,
+        "Event bus tags are not simulated, so CreateEventBus refuses them rather " +
+            "than dropping them",
+    ],
+];
+/**
+ * Refuse the event bus request inputs this simulation does not model.
+ *
+ * Each is refused rather than ignored. A dropped tag would leave a bus looking
+ * tagged to the request that sent it and untagged to everything else, and a
+ * dead letter queue that received nothing would be one a test believed was
+ * catching undelivered events.
+ */
+export function refuseUnsimulatedBusInput(input) {
+    for (const [read, message] of refusals) {
+        if (read(input) !== undefined) {
+            throw new SimEventBridgeUnsimulatedInputException(message);
+        }
+    }
+    refuseOverlongDescription(input.Description);
+}
+/**
+ * Refuse a description real EventBridge would refuse.
+ */
+function refuseOverlongDescription(description) {
+    if (description !== undefined &&
+        description.length > maximumDescriptionLength) {
+        throw new SimEventBridgeValidationException(`Invalid parameter: Description Reason: a description is at most ${String(maximumDescriptionLength)} characters, and this one is ${String(description.length)}`);
+    }
+}
+//# sourceMappingURL=sim-event-bridge-unsimulated-bus-input.js.map

package/dist/service/eventbridge/command/bus/sim-event-bridge-unsimulated-bus-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-event-bridge-unsimulated-bus-input.js","sourceRoot":"","sources":["../../../../../src/service/eventbridge/command/bus/sim-event-bridge-unsimulated-bus-input.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uCAAuC,EACvC,iCAAiC,GAClC,MAAM,uCAAuC,CAAC;AAG/C;;GAEG;AACH,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAWrC;;GAEG;AACH,MAAM,QAAQ,GAAwC;IACpD;QACE,CAAC,KAAK,EAAW,EAAE,CAAC,KAAK,CAAC,eAAe;QACzC,sEAAsE;YACpE,iEAAiE;KACpE;IACD;QACE,CAAC,KAAK,EAAW,EAAE,CAAC,KAAK,CAAC,gBAAgB;QAC1C,wEAAwE;YACtE,uEAAuE;YACvE,uBAAuB;KAC1B;IACD;QACE,CAAC,KAAK,EAAW,EAAE,CAAC,KAAK,CAAC,gBAAgB;QAC1C,oEAAoE;YAClE,mEAAmE;YACnE,6BAA6B;KAChC;IACD;QACE,CAAC,KAAK,EAAW,EAAE,CAAC,KAAK,CAAC,SAAS;QACnC,kEAAkE;YAChE,wDAAwD;KAC3D;IACD;QACE,CAAC,KAAK,EAAW,EAAE,CAAC,KAAK,CAAC,IAAI;QAC9B,0EAA0E;YACxE,oBAAoB;KACvB;CACF,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAoC;IAEpC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,QAAQ,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,IAAI,uCAAuC,CAAC,OAAO,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,yBAAyB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CAAC,WAA+B;IAChE,IACE,WAAW,KAAK,SAAS;QACzB,WAAW,CAAC,MAAM,GAAG,wBAAwB,EAC7C,CAAC;QACD,MAAM,IAAI,iCAAiC,CACzC,mEAAmE,MAAM,CAAC,wBAAwB,CAAC,gCAAgC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAChK,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/service/eventbridge/command/put-events/put-events.command.d.ts

@@ -0,0 +1,46 @@
+import type { SimResponseMetadata } from "../../../aws/metadata/response-metadata.type.js";
+/**
+ * One event as a PutEvents request carries it.
+ *
+ * Every field is optional in the API model, but `Detail`, `DetailType` and
+ * `Source` are all required for EventBridge to take the entry, which is why an
+ * entry missing one of them comes back as a failure rather than being refused
+ * up front.
+ *
+ * https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutEventsRequestEntry.html
+ */
+export interface SimPutEventsRequestEntry {
+    readonly Source?: string | undefined;
+    readonly DetailType?: string | undefined;
+    readonly Detail?: string | undefined;
+    readonly EventBusName?: string | undefined;
+    readonly Resources?: readonly string[] | undefined;
+    readonly Time?: Date | undefined;
+    readonly TraceHeader?: string | undefined;
+}
+/**
+ * One entry's result, which carries either an event id or a failure.
+ */
+export interface SimPutEventsResultEntry {
+    readonly EventId?: string | undefined;
+    readonly ErrorCode?: string | undefined;
+    readonly ErrorMessage?: string | undefined;
+}
+/**
+ * Minimal structural sim EventBridge PutEvents command.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/eventbridge/command/PutEventsCommand/
+ */
+export interface SimPutEventsCommand {
+    readonly input: SimPutEventsCommandInput;
+}
+export interface SimPutEventsCommandInput {
+    readonly Entries?: readonly SimPutEventsRequestEntry[] | undefined;
+    readonly EndpointId?: string | undefined;
+}
+export interface SimPutEventsCommandOutput {
+    readonly Entries?: readonly SimPutEventsResultEntry[] | undefined;
+    readonly FailedEntryCount?: number | undefined;
+    readonly $metadata: SimResponseMetadata;
+}
+//# sourceMappingURL=put-events.command.d.ts.map

package/dist/service/eventbridge/command/put-events/put-events.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"put-events.command.d.ts","sourceRoot":"","sources":["../../../../../src/service/eventbridge/command/put-events/put-events.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AAE3F;;;;;;;;;GASG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;CAC1C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,wBAAwB,EAAE,GAAG,SAAS,CAAC;IACnE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,uBAAuB,EAAE,GAAG,SAAS,CAAC;IAClE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;CACzC"}

package/dist/service/eventbridge/command/put-events/put-events.command.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=put-events.command.js.map

package/dist/service/eventbridge/command/put-events/put-events.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"put-events.command.js","sourceRoot":"","sources":["../../../../../src/service/eventbridge/command/put-events/put-events.command.ts"],"names":[],"mappings":""}

package/dist/service/eventbridge/command/put-events/sim-event-bridge-authorized-entries.d.ts

@@ -0,0 +1,21 @@
+import type { SimEventBridgeBusAccess } from "../bus/sim-event-bridge-bus-access.js";
+import type { SimEventBridgeRequestOptions } from "../sim-event-bridge-request-options.js";
+import type { SimPutEventsRequestEntry } from "./put-events.command.js";
+/**
+ * One entry, and the name of the bus the caller is allowed to put it on.
+ */
+export interface SimEventBridgeAuthorizedEntry {
+    readonly entry: SimPutEventsRequestEntry;
+    readonly busName: string;
+}
+/**
+ * Resolve and authorize the bus every entry names, before any of them is
+ * delivered.
+ *
+ * Authorizing entry by entry as each is delivered would leave a refused
+ * request half done: an earlier entry's event would already be on its bus when
+ * a later entry's refusal threw. Every entry is decided here first, so a
+ * request that throws has changed nothing.
+ */
+export declare function authorizedEntries(entries: readonly SimPutEventsRequestEntry[], access: SimEventBridgeBusAccess, options: SimEventBridgeRequestOptions | undefined): readonly SimEventBridgeAuthorizedEntry[];
+//# sourceMappingURL=sim-event-bridge-authorized-entries.d.ts.map

package/dist/service/eventbridge/command/put-events/sim-event-bridge-authorized-entries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-event-bridge-authorized-entries.d.ts","sourceRoot":"","sources":["../../../../../src/service/eventbridge/command/put-events/sim-event-bridge-authorized-entries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AAC3F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,wBAAwB,EAAE,EAC5C,MAAM,EAAE,uBAAuB,EAC/B,OAAO,EAAE,4BAA4B,GAAG,SAAS,GAChD,SAAS,6BAA6B,EAAE,CAQ1C"}

package/dist/service/eventbridge/command/put-events/sim-event-bridge-authorized-entries.js

@@ -0,0 +1,17 @@
+/**
+ * Resolve and authorize the bus every entry names, before any of them is
+ * delivered.
+ *
+ * Authorizing entry by entry as each is delivered would leave a refused
+ * request half done: an earlier entry's event would already be on its bus when
+ * a later entry's refusal threw. Every entry is decided here first, so a
+ * request that throws has changed nothing.
+ */
+export function authorizedEntries(entries, access, options) {
+    return entries.map((entry) => {
+        const busName = access.requestedName(entry.EventBusName);
+        access.authorizeName("events:PutEvents", busName, options);
+        return { entry, busName: busName.value };
+    });
+}
+//# sourceMappingURL=sim-event-bridge-authorized-entries.js.map

package/dist/service/eventbridge/command/put-events/sim-event-bridge-authorized-entries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-event-bridge-authorized-entries.js","sourceRoot":"","sources":["../../../../../src/service/eventbridge/command/put-events/sim-event-bridge-authorized-entries.ts"],"names":[],"mappings":"AAYA;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAA4C,EAC5C,MAA+B,EAC/B,OAAiD;IAEjD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3B,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAEzD,MAAM,CAAC,aAAa,CAAC,kBAAkB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAE3D,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/service/eventbridge/command/put-events/sim-event-bridge-entry-failure.d.ts

@@ -0,0 +1,44 @@
+import type { SimPutEventsResultEntry } from "./put-events.command.js";
+/**
+ * The error code a malformed `Detail` comes back with.
+ *
+ * This one AWS documents.
+ */
+export declare const simEventBridgeMalformedDetailCode = "MalformedDetail";
+/**
+ * The error code an entry missing a required field comes back with.
+ *
+ * The API reference documents that EventBridge fails such an entry but not
+ * what it calls the failure, so this is taken from the code observed in
+ * practice rather than from the documentation.
+ */
+export declare const simEventBridgeInvalidArgumentCode = "InvalidArgument";
+/**
+ * One entry EventBridge would not take, and why.
+ *
+ * A failure is a value rather than a thrown error because PutEvents keeps
+ * going: the rest of the request is processed, and the failure is reported in
+ * this entry's place in the result.
+ */
+export declare class SimEventBridgeEntryFailure {
+    readonly code: string;
+    readonly message: string;
+    private constructor();
+    /**
+     * An entry whose `Detail` is not a JSON object.
+     */
+    static malformedDetail(): SimEventBridgeEntryFailure;
+    /**
+     * An entry with none of the field a routable event has to carry.
+     */
+    static missing(field: string): SimEventBridgeEntryFailure;
+    /**
+     * An entry whose `DetailType` is longer than EventBridge takes.
+     */
+    static detailTypeTooLong(length: number): SimEventBridgeEntryFailure;
+    /**
+     * This failure as it appears in the PutEvents result.
+     */
+    toResultEntry(): SimPutEventsResultEntry;
+}
+//# sourceMappingURL=sim-event-bridge-entry-failure.d.ts.map

package/dist/service/eventbridge/command/put-events/sim-event-bridge-entry-failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-event-bridge-entry-failure.d.ts","sourceRoot":"","sources":["../../../../../src/service/eventbridge/command/put-events/sim-event-bridge-entry-failure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,oBAAoB,CAAC;AAEnE;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,oBAAoB,CAAC;AAEnE;;;;;;GAMG;AACH,qBAAa,0BAA0B;aAEnB,IAAI,EAAE,MAAM;aACZ,OAAO,EAAE,MAAM;IAFjC,OAAO,eAGH;IAEJ;;OAEG;IACH,MAAM,CAAC,eAAe,IAAI,0BAA0B,CAEnD;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,0BAA0B,CAKxD;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,0BAA0B,CAMnE;IAED;;OAEG;IACH,aAAa,IAAI,uBAAuB,CAEvC;CACF"}

package/dist/service/eventbridge/command/put-events/sim-event-bridge-entry-failure.js

@@ -0,0 +1,55 @@
+/**
+ * The error code a malformed `Detail` comes back with.
+ *
+ * This one AWS documents.
+ */
+export const simEventBridgeMalformedDetailCode = "MalformedDetail";
+/**
+ * The error code an entry missing a required field comes back with.
+ *
+ * The API reference documents that EventBridge fails such an entry but not
+ * what it calls the failure, so this is taken from the code observed in
+ * practice rather than from the documentation.
+ */
+export const simEventBridgeInvalidArgumentCode = "InvalidArgument";
+/**
+ * One entry EventBridge would not take, and why.
+ *
+ * A failure is a value rather than a thrown error because PutEvents keeps
+ * going: the rest of the request is processed, and the failure is reported in
+ * this entry's place in the result.
+ */
+export class SimEventBridgeEntryFailure {
+    code;
+    message;
+    constructor(code, message) {
+        this.code = code;
+        this.message = message;
+    }
+    /**
+     * An entry whose `Detail` is not a JSON object.
+     */
+    static malformedDetail() {
+        return new this(simEventBridgeMalformedDetailCode, "Detail is malformed.");
+    }
+    /**
+     * An entry with none of the field a routable event has to carry.
+     */
+    static missing(field) {
+        return new this(simEventBridgeInvalidArgumentCode, `Parameter ${field} is not valid. Reason: ${field} is a required argument.`);
+    }
+    /**
+     * An entry whose `DetailType` is longer than EventBridge takes.
+     */
+    static detailTypeTooLong(length) {
+        return new this(simEventBridgeInvalidArgumentCode, `Parameter DetailType is not valid. Reason: DetailType is at most 128 ` +
+            `characters, and this one is ${String(length)}.`);
+    }
+    /**
+     * This failure as it appears in the PutEvents result.
+     */
+    toResultEntry() {
+        return { ErrorCode: this.code, ErrorMessage: this.message };
+    }
+}
+//# sourceMappingURL=sim-event-bridge-entry-failure.js.map

package/dist/service/eventbridge/command/put-events/sim-event-bridge-entry-failure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-event-bridge-entry-failure.js","sourceRoot":"","sources":["../../../../../src/service/eventbridge/command/put-events/sim-event-bridge-entry-failure.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,iBAAiB,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,iBAAiB,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,OAAO,0BAA0B;IAEnB,IAAI;IACJ,OAAO;IAFzB,YACkB,IAAY,EACZ,OAAe;oBADf,IAAI;uBACJ,OAAO;IACtB,CAAC;IAEJ;;OAEG;IACH,MAAM,CAAC,eAAe;QACpB,OAAO,IAAI,IAAI,CAAC,iCAAiC,EAAE,sBAAsB,CAAC,CAAC;IAC7E,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,IAAI,CACb,iCAAiC,EACjC,aAAa,KAAK,0BAA0B,KAAK,0BAA0B,CAC5E,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAc;QACrC,OAAO,IAAI,IAAI,CACb,iCAAiC,EACjC,uEAAuE;YACrE,+BAA+B,MAAM,CAAC,MAAM,CAAC,GAAG,CACnD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IAC9D,CAAC;CACF"}

package/dist/service/eventbridge/command/put-events/sim-event-bridge-entry-reader.d.ts

@@ -0,0 +1,40 @@
+import type { SimAwsAccountRegionScope } from "../../../aws/sim-aws-account-region-scope.js";
+import { SimEventBridgeEvent } from "../../event/sim-event-bridge-event.js";
+import { SimEventBridgeEntryFailure } from "./sim-event-bridge-entry-failure.js";
+import type { SimPutEventsRequestEntry } from "./put-events.command.js";
+/**
+ * Whether an entry carries everything a routable event needs.
+ *
+ * A request in which no entry does at all is refused outright, which is why
+ * this is asked of every entry before any of them is read.
+ */
+export declare function isRoutableEntry(entry: SimPutEventsRequestEntry): boolean;
+interface SimEventBridgeEntryReaderProperties {
+    readonly accountRegionScope: SimAwsAccountRegionScope;
+}
+/**
+ * Reads one PutEvents entry into the event EventBridge would build from it.
+ *
+ * `Detail`, `DetailType` and `Source` are all optional in the API model and
+ * all required for an entry to be taken, so this is where that gap is closed.
+ * An entry missing one comes back as a failure rather than a thrown error,
+ * because the rest of the request still goes through.
+ */
+export declare class SimEventBridgeEntryReader {
+    private readonly accountRegionScope;
+    constructor(properties: SimEventBridgeEntryReaderProperties);
+    /**
+     * Read an entry into an event, or into the failure it comes back as.
+     *
+     * The timestamp is the one the entry carries, or the instant of the call
+     * when it carries none, which is what puts a simulation's own clock on every
+     * event that did not name a time.
+     */
+    read(entry: SimPutEventsRequestEntry, at: Date): SimEventBridgeEvent | SimEventBridgeEntryFailure;
+    /**
+     * Build the event, once the entry is known to carry what one needs.
+     */
+    private eventFrom;
+}
+export {};
+//# sourceMappingURL=sim-event-bridge-entry-reader.d.ts.map

package/dist/service/eventbridge/command/put-events/sim-event-bridge-entry-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-event-bridge-entry-reader.d.ts","sourceRoot":"","sources":["../../../../../src/service/eventbridge/command/put-events/sim-event-bridge-entry-reader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAC;AAE7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAOxE;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAMxE;AAkCD,UAAU,mCAAmC;IAC3C,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,CAAC;CACvD;AAED;;;;;;;GAOG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA2B;IAE9D,YAAY,UAAU,EAAE,mCAAmC,EAE1D;IAED;;;;;;OAMG;IACH,IAAI,CACF,KAAK,EAAE,wBAAwB,EAC/B,EAAE,EAAE,IAAI,GACP,mBAAmB,GAAG,0BAA0B,CA0BlD;IAED;;OAEG;IACH,OAAO,CAAC,SAAS;CAwBlB"}

package/dist/service/eventbridge/command/put-events/sim-event-bridge-entry-reader.js

@@ -0,0 +1,104 @@
+import { randomUUID } from "node:crypto";
+import { isRecord } from "../../../../util/type-guard/record.js";
+import { SimEventBridgeEvent } from "../../event/sim-event-bridge-event.js";
+import { SimEventBridgeEntryFailure } from "./sim-event-bridge-entry-failure.js";
+/**
+ * The longest `DetailType` real EventBridge takes.
+ */
+const maximumDetailTypeLength = 128;
+/**
+ * Whether an entry carries everything a routable event needs.
+ *
+ * A request in which no entry does at all is refused outright, which is why
+ * this is asked of every entry before any of them is read.
+ */
+export function isRoutableEntry(entry) {
+    return (entry.Source !== undefined &&
+        entry.DetailType !== undefined &&
+        entry.Detail !== undefined);
+}
+/**
+ * Read an entry's `Detail` as the JSON object it has to be.
+ *
+ * Anything that is not an object is malformed, including a JSON array, number
+ * or string, since a rule's event pattern matches fields of an object and has
+ * nothing to match against otherwise.
+ */
+function readDetail(detail) {
+    try {
+        const parsed = JSON.parse(detail);
+        if (!isRecord(parsed)) {
+            return undefined;
+        }
+        return parsed;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Reads one PutEvents entry into the event EventBridge would build from it.
+ *
+ * `Detail`, `DetailType` and `Source` are all optional in the API model and
+ * all required for an entry to be taken, so this is where that gap is closed.
+ * An entry missing one comes back as a failure rather than a thrown error,
+ * because the rest of the request still goes through.
+ */
+export class SimEventBridgeEntryReader {
+    accountRegionScope;
+    constructor(properties) {
+        this.accountRegionScope = properties.accountRegionScope;
+    }
+    /**
+     * Read an entry into an event, or into the failure it comes back as.
+     *
+     * The timestamp is the one the entry carries, or the instant of the call
+     * when it carries none, which is what puts a simulation's own clock on every
+     * event that did not name a time.
+     */
+    read(entry, at) {
+        if (entry.Source === undefined) {
+            return SimEventBridgeEntryFailure.missing("Source");
+        }
+        if (entry.DetailType === undefined) {
+            return SimEventBridgeEntryFailure.missing("DetailType");
+        }
+        if (entry.Detail === undefined) {
+            return SimEventBridgeEntryFailure.missing("Detail");
+        }
+        if (entry.DetailType.length > maximumDetailTypeLength) {
+            return SimEventBridgeEntryFailure.detailTypeTooLong(entry.DetailType.length);
+        }
+        return this.eventFrom({
+            entry,
+            source: entry.Source,
+            detailType: entry.DetailType,
+            detail: entry.Detail,
+            at,
+        });
+    }
+    /**
+     * Build the event, once the entry is known to carry what one needs.
+     */
+    eventFrom(read) {
+        const detail = readDetail(read.detail);
+        if (detail === undefined) {
+            return SimEventBridgeEntryFailure.malformedDetail();
+        }
+        // The timestamp and the resource list are copied rather than held onto,
+        // because they belong to the request the caller still has a reference to.
+        // A caller reusing an entry object between calls would otherwise change an
+        // event that has already been put.
+        return new SimEventBridgeEvent({
+            id: randomUUID(),
+            detailType: read.detailType,
+            source: read.source,
+            account: this.accountRegionScope.accountId,
+            time: new Date(read.entry.Time?.getTime() ?? read.at.getTime()),
+            region: this.accountRegionScope.regionName,
+            resources: [...(read.entry.Resources ?? [])],
+            detail,
+        });
+    }
+}
+//# sourceMappingURL=sim-event-bridge-entry-reader.js.map

package/dist/service/eventbridge/command/put-events/sim-event-bridge-entry-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-event-bridge-entry-reader.js","sourceRoot":"","sources":["../../../../../src/service/eventbridge/command/put-events/sim-event-bridge-entry-reader.ts"],"names":[],"mappings":"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"}

package/dist/service/eventbridge/command/put-events/sim-event-bridge-entry-size.d.ts

@@ -0,0 +1,26 @@
+import type { SimPutEventsRequestEntry } from "./put-events.command.js";
+/**
+ * The most one PutEvents request may total.
+ *
+ * The limit is on the request rather than on any one entry, so a single entry
+ * may use the whole of it.
+ */
+export declare const simEventBridgeMaximumRequestBytes = 1048576;
+/**
+ * Measure one PutEvents entry the way real EventBridge measures it.
+ *
+ * This is AWS's own documented calculation rather than the size of the JSON on
+ * the wire: a `Time` counts as a flat 14 bytes, and `Source`, `DetailType`,
+ * `Detail` and each entry of `Resources` count as the length of their UTF-8
+ * encoded forms. Nothing else in the entry counts at all, which is why a
+ * `TraceHeader` or an `EventBusName` is free.
+ *
+ * https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-putevents.html#eb-putevent-size
+ */
+export declare function simEventBridgeEntrySize(entry: SimPutEventsRequestEntry): number;
+/**
+ * Measure every entry of a request together, which is what the limit applies
+ * to.
+ */
+export declare function simEventBridgeRequestSize(entries: readonly SimPutEventsRequestEntry[]): number;
+//# sourceMappingURL=sim-event-bridge-entry-size.d.ts.map

package/dist/service/eventbridge/command/put-events/sim-event-bridge-entry-size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-event-bridge-entry-size.d.ts","sourceRoot":"","sources":["../../../../../src/service/eventbridge/command/put-events/sim-event-bridge-entry-size.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAOxE;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,UAAY,CAAC;AAE3D;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,wBAAwB,GAC9B,MAAM,CAUR;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,SAAS,wBAAwB,EAAE,GAC3C,MAAM,CAKR"}

package/dist/service/eventbridge/command/put-events/sim-event-bridge-entry-size.js

@@ -0,0 +1,56 @@
+/**
+ * The size real EventBridge counts a `Time` as, whatever the instant is.
+ */
+const timeSizeBytes = 14;
+/**
+ * The most one PutEvents request may total.
+ *
+ * The limit is on the request rather than on any one entry, so a single entry
+ * may use the whole of it.
+ */
+export const simEventBridgeMaximumRequestBytes = 1_048_576;
+/**
+ * Measure one PutEvents entry the way real EventBridge measures it.
+ *
+ * This is AWS's own documented calculation rather than the size of the JSON on
+ * the wire: a `Time` counts as a flat 14 bytes, and `Source`, `DetailType`,
+ * `Detail` and each entry of `Resources` count as the length of their UTF-8
+ * encoded forms. Nothing else in the entry counts at all, which is why a
+ * `TraceHeader` or an `EventBusName` is free.
+ *
+ * https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-putevents.html#eb-putevent-size
+ */
+export function simEventBridgeEntrySize(entry) {
+    const resources = entry.Resources ?? [];
+    return (timeSize(entry.Time) +
+        utf8Length(entry.Source) +
+        utf8Length(entry.DetailType) +
+        utf8Length(entry.Detail) +
+        resources.reduce((total, resource) => total + utf8Length(resource), 0));
+}
+/**
+ * Measure every entry of a request together, which is what the limit applies
+ * to.
+ */
+export function simEventBridgeRequestSize(entries) {
+    return entries.reduce((total, entry) => total + simEventBridgeEntrySize(entry), 0);
+}
+/**
+ * What a `Time` counts towards the total, which is a flat rate or nothing.
+ */
+function timeSize(time) {
+    if (time === undefined) {
+        return 0;
+    }
+    return timeSizeBytes;
+}
+/**
+ * The number of bytes a string takes in UTF-8, or none for an absent one.
+ */
+function utf8Length(value) {
+    if (value === undefined) {
+        return 0;
+    }
+    return Buffer.byteLength(value, "utf8");
+}
+//# sourceMappingURL=sim-event-bridge-entry-size.js.map

package/dist/service/eventbridge/command/put-events/sim-event-bridge-entry-size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-event-bridge-entry-size.js","sourceRoot":"","sources":["../../../../../src/service/eventbridge/command/put-events/sim-event-bridge-entry-size.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,SAAS,CAAC;AAE3D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAA+B;IAE/B,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC;IAExC,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;QACpB,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;QACxB,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC;QAC5B,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;QACxB,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CACvE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAA4C;IAE5C,OAAO,OAAO,CAAC,MAAM,CACnB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,uBAAuB,CAAC,KAAK,CAAC,EACxD,CAAC,CACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,QAAQ,CAAC,IAAsB;IACtC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,KAAyB;IAC3C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC"}

package/dist/service/eventbridge/command/put-events/sim-event-bridge-put-events.d.ts

@@ -0,0 +1,49 @@
+import type { BackgroundScheduler } from "../../../../util/background/background.js";
+import type { SimAwsAccountRegionScope } from "../../../aws/sim-aws-account-region-scope.js";
+import type { SimEventBridgeRouter } from "../../routing/sim-event-bridge-router.js";
+import type { SimEventBridgeRequestOptions } from "../sim-event-bridge-request-options.js";
+import type { SimEventBridgeBusAccess } from "../bus/sim-event-bridge-bus-access.js";
+import type { SimPutEventsCommand, SimPutEventsCommandOutput } from "./put-events.command.js";
+interface SimEventBridgePutEventsProperties {
+    readonly access: SimEventBridgeBusAccess;
+    readonly accountRegionScope: SimAwsAccountRegionScope;
+    readonly clock: BackgroundScheduler;
+    readonly router: SimEventBridgeRouter;
+}
+/**
+ * The PutEvents command.
+ *
+ * Entries are independent: one that EventBridge will not take comes back as a
+ * failure in its own place in the result while the rest go through, and each
+ * entry may name a different bus.
+ *
+ * An entry naming a bus that does not exist succeeds. Real EventBridge answers
+ * 200, finds no rule to match the event against, and drops it, without
+ * counting the entry as failed. That is a trap worth knowing about, since a
+ * mistyped bus name looks exactly like a working call, so this simulation
+ * reproduces it rather than being helpfully stricter.
+ */
+export declare class SimEventBridgePutEvents {
+    private readonly access;
+    private readonly clock;
+    private readonly router;
+    private readonly reader;
+    constructor(properties: SimEventBridgePutEventsProperties);
+    /**
+     * Put events onto the buses their entries name.
+     *
+     * Every entry is stamped with the one instant the call was made at, rather
+     * than each reading the clock again, so a request's events share a timestamp
+     * as they do on real AWS.
+     */
+    handle(command: SimPutEventsCommand, options?: SimEventBridgeRequestOptions): SimPutEventsCommandOutput;
+    /**
+     * Put one authorized entry onto the bus it names.
+     *
+     * A bus that is not there takes the event nowhere, and the entry still
+     * succeeds.
+     */
+    private put;
+}
+export {};
+//# sourceMappingURL=sim-event-bridge-put-events.d.ts.map

package/dist/service/eventbridge/command/put-events/sim-event-bridge-put-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-event-bridge-put-events.d.ts","sourceRoot":"","sources":["../../../../../src/service/eventbridge/command/put-events/sim-event-bridge-put-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AACrF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAC;AAC7F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AAC3F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAQrF,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EAE1B,MAAM,yBAAyB,CAAC;AAEjC,UAAU,iCAAiC;IACzC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,CAAC;IACtD,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;CACvC;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IAEnD,YAAY,UAAU,EAAE,iCAAiC,EAOxD;IAED;;;;;;OAMG;IACH,MAAM,CACJ,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,4BAA4B,GACrC,yBAAyB,CAe3B;IAED;;;;;OAKG;IACH,OAAO,CAAC,GAAG;CAcZ"}