@kensio/yulin 1.20.0 → 1.20.1

package/dist/service/stepfunctions/wait/sim-states-wait-due.js

@@ -0,0 +1,67 @@
+import { selectSimStatesPath } from "../data/sim-states-path-segment.js";
+import { parseSimStatesReferencePath } from "../data/sim-states-reference-path.js";
+import { readSimStatesTimestamp } from "../data/sim-states-timestamp.js";
+import { SimStatesRuntimeFailure } from "../error/sim-step-functions.error.js";
+import { simStatesMaximumWaitSeconds, simStatesWaitFields, } from "./sim-states-wait-fields.js";
+const millisecondsInASecond = 1000;
+/**
+ * The instant a `Wait` state waits for.
+ *
+ * The two literal fields are known from the definition. The two path fields
+ * are read out of the state's effective input, and a path holding the wrong
+ * kind of value fails the execution the way real Step Functions does.
+ */
+export function simStatesWaitDue(state, input, now) {
+    if (state.Seconds !== undefined) {
+        return afterSeconds(now, state.Seconds, "Seconds");
+    }
+    if (state.Timestamp !== undefined) {
+        return atTimestamp(state.Timestamp, "Timestamp");
+    }
+    if (state.SecondsPath !== undefined) {
+        return afterSeconds(now, valueAt(state.SecondsPath, input), `SecondsPath ${state.SecondsPath}`);
+    }
+    if (state.TimestampPath !== undefined) {
+        return atTimestamp(valueAt(state.TimestampPath, input), `TimestampPath ${state.TimestampPath}`);
+    }
+    throw new SimStatesRuntimeFailure(`A Wait state carries none of ${simStatesWaitFields.join(", ")}, so ` +
+        "nothing says how long it waits.");
+}
+/**
+ * The instant a number of seconds from now.
+ */
+function afterSeconds(now, seconds, source) {
+    if (!isAWaitInSeconds(seconds)) {
+        throw new SimStatesRuntimeFailure(`A Wait state reads ${source}, which holds ${JSON.stringify(seconds)} ` +
+            "rather than a whole number of seconds between 0 and " +
+            `${String(simStatesMaximumWaitSeconds)}.`);
+    }
+    return new Date(now.getTime() + seconds * millisecondsInASecond);
+}
+/**
+ * Whether a value is a length of time a `Wait` state can wait for.
+ */
+function isAWaitInSeconds(seconds) {
+    return (typeof seconds === "number" &&
+        Number.isSafeInteger(seconds) &&
+        seconds >= 0 &&
+        seconds <= simStatesMaximumWaitSeconds);
+}
+/**
+ * The instant a timestamp names.
+ */
+function atTimestamp(timestamp, source) {
+    const milliseconds = readSimStatesTimestamp(timestamp);
+    if (milliseconds === undefined) {
+        throw new SimStatesRuntimeFailure(`A Wait state reads ${source}, which holds ` +
+            `${JSON.stringify(timestamp)} rather than an RFC3339 instant.`);
+    }
+    return new Date(milliseconds);
+}
+/**
+ * What one of the two paths selects in the state's input.
+ */
+function valueAt(path, input) {
+    return selectSimStatesPath(input, parseSimStatesReferencePath(path));
+}
+//# sourceMappingURL=sim-states-wait-due.js.map

package/dist/service/stepfunctions/wait/sim-states-wait-due.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-states-wait-due.js","sourceRoot":"","sources":["../../../../src/service/stepfunctions/wait/sim-states-wait-due.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AAErC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAEnC;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAyB,EACzB,KAAgB,EAChB,GAAS;IAET,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,YAAY,CACjB,GAAG,EACH,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,EACjC,eAAe,KAAK,CAAC,WAAW,EAAE,CACnC,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,WAAW,CAChB,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,EACnC,iBAAiB,KAAK,CAAC,aAAa,EAAE,CACvC,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,uBAAuB,CAC/B,gCAAgC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO;QACnE,iCAAiC,CACpC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CACnB,GAAS,EACT,OAA8B,EAC9B,MAAc;IAEd,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,uBAAuB,CAC/B,sBAAsB,MAAM,iBAAiB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG;YACrE,sDAAsD;YACtD,GAAG,MAAM,CAAC,2BAA2B,CAAC,GAAG,CAC5C,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,OAAO,GAAG,qBAAqB,CAAC,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,OAA8B;IACtD,OAAO,CACL,OAAO,OAAO,KAAK,QAAQ;QAC3B,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC;QAC7B,OAAO,IAAI,CAAC;QACZ,OAAO,IAAI,2BAA2B,CACvC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,SAAgC,EAAE,MAAc;IACnE,MAAM,YAAY,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAEvD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,uBAAuB,CAC/B,sBAAsB,MAAM,gBAAgB;YAC1C,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,kCAAkC,CACjE,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,SAAS,OAAO,CAAC,IAAY,EAAE,KAAgB;IAC7C,OAAO,mBAAmB,CAAC,KAAK,EAAE,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC;AACvE,CAAC"}

package/dist/service/stepfunctions/wait/sim-states-wait-fields.d.ts

@@ -0,0 +1,18 @@
+import type { JSONValue } from "../../../util/type-guard/json.js";
+/**
+ * The four ways a `Wait` state says how long to wait.
+ */
+/**
+ * The longest wait Step Functions takes, which is a little over three years.
+ */
+export declare const simStatesMaximumWaitSeconds = 99999999;
+export declare const simStatesWaitFields: readonly ["Seconds", "SecondsPath", "Timestamp", "TimestampPath"];
+/**
+ * Check what a `Wait` state waits for.
+ *
+ * A `Wait` state carries exactly one of the four fields. Real Step Functions
+ * refuses a definition carrying none or more than one when the state machine
+ * is created, and so does this.
+ */
+export declare function checkSimStatesWaitFields(stateName: string, state: Record<string, JSONValue>): void;
+//# sourceMappingURL=sim-states-wait-fields.d.ts.map

package/dist/service/stepfunctions/wait/sim-states-wait-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-states-wait-fields.d.ts","sourceRoot":"","sources":["../../../../src/service/stepfunctions/wait/sim-states-wait-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAKlE;;GAEG;AACH;;GAEG;AACH,eAAO,MAAM,2BAA2B,WAAa,CAAC;AAEtD,eAAO,MAAM,mBAAmB,YAC9B,SAAS,EACT,aAAa,EACb,WAAW,EACX,eAAe,CACP,CAAC;AAEX;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAC/B,IAAI,CAuBN"}

package/dist/service/stepfunctions/wait/sim-states-wait-fields.js

@@ -0,0 +1,85 @@
+import { parseSimStatesReferencePath } from "../data/sim-states-reference-path.js";
+import { readSimStatesTimestamp } from "../data/sim-states-timestamp.js";
+import { SimStatesInvalidDefinition } from "../error/sim-step-functions.error.js";
+/**
+ * The four ways a `Wait` state says how long to wait.
+ */
+/**
+ * The longest wait Step Functions takes, which is a little over three years.
+ */
+export const simStatesMaximumWaitSeconds = 99_999_999;
+export const simStatesWaitFields = [
+    "Seconds",
+    "SecondsPath",
+    "Timestamp",
+    "TimestampPath",
+];
+/**
+ * Check what a `Wait` state waits for.
+ *
+ * A `Wait` state carries exactly one of the four fields. Real Step Functions
+ * refuses a definition carrying none or more than one when the state machine
+ * is created, and so does this.
+ */
+export function checkSimStatesWaitFields(stateName, state) {
+    const present = simStatesWaitFields.filter((field) => Object.hasOwn(state, field));
+    const [field] = present;
+    if (field === undefined) {
+        throw new SimStatesInvalidDefinition(`The Wait state ${stateName} carries none of ` +
+            `${simStatesWaitFields.join(", ")}. A Wait state carries exactly one.`);
+    }
+    if (present.length > 1) {
+        throw new SimStatesInvalidDefinition(`The Wait state ${stateName} carries ${present.join(", ")}. A Wait ` +
+            "state carries exactly one of them.");
+    }
+    // The field was found among this state's own keys.
+    // oxlint-disable-next-line security/detect-object-injection
+    checkField(stateName, field, state[field]);
+}
+/**
+ * Check the one field the state carries.
+ *
+ * The two paths are checked as far as their syntax here. What they select is
+ * only known once the state runs.
+ */
+function checkField(stateName, field, written) {
+    if (field === "Seconds") {
+        checkSeconds(stateName, written);
+        return;
+    }
+    if (field === "Timestamp") {
+        checkTimestamp(stateName, written);
+        return;
+    }
+    if (typeof written !== "string") {
+        throw new SimStatesInvalidDefinition(`The Wait state ${stateName} has a ${field} that is not a Reference ` +
+            "Path.");
+    }
+    parseSimStatesReferencePath(written);
+}
+/**
+ * `Seconds` is a whole number of seconds within the range a wait takes.
+ */
+function checkSeconds(stateName, written) {
+    if (typeof written !== "number" || !Number.isSafeInteger(written)) {
+        throw new SimStatesInvalidDefinition(`The Wait state ${stateName} has a Seconds that is not a whole number.`);
+    }
+    if (written < 0) {
+        throw new SimStatesInvalidDefinition(`The Wait state ${stateName} waits for ${String(written)} seconds. A ` +
+            "wait does not run backwards.");
+    }
+    if (written > simStatesMaximumWaitSeconds) {
+        throw new SimStatesInvalidDefinition(`The Wait state ${stateName} waits for ${String(written)} seconds. ` +
+            `Step Functions waits ${String(simStatesMaximumWaitSeconds)} at most.`);
+    }
+}
+/**
+ * `Timestamp` is an instant, written the way Amazon States Language writes one.
+ */
+function checkTimestamp(stateName, written) {
+    if (readSimStatesTimestamp(written) === undefined) {
+        throw new SimStatesInvalidDefinition(`The Wait state ${stateName} has a Timestamp that is not an RFC3339 ` +
+            "instant, such as 2026-07-26T09:00:00Z.");
+    }
+}
+//# sourceMappingURL=sim-states-wait-fields.js.map

package/dist/service/stepfunctions/wait/sim-states-wait-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-states-wait-fields.js","sourceRoot":"","sources":["../../../../src/service/stepfunctions/wait/sim-states-wait-fields.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kensio/yulin",
-  "version": "1.20.0",
+  "version": "1.20.1",
   "description": "AWS system behaviour simulation for isolated unit testing",
   "repository": "https://github.com/KensioSoftware/yulin",
   "homepage": "https://yulinsim.dev/",
@@ -99,6 +99,10 @@
       "import": "./dist/config/eslint/index.js",
       "types": "./dist/config/eslint/index.d.ts"
     },
+    "./firehose": {
+      "import": "./dist/service/firehose/index.js",
+      "types": "./dist/service/firehose/index.d.ts"
+    },
     "./eventbridge": {
       "import": "./dist/service/eventbridge/index.js",
       "types": "./dist/service/eventbridge/index.d.ts"
@@ -169,6 +173,10 @@
       "import": "./dist/service/sqs/index.js",
       "types": "./dist/service/sqs/index.d.ts"
     },
+    "./stepfunctions": {
+      "import": "./dist/service/stepfunctions/index.js",
+      "types": "./dist/service/stepfunctions/index.d.ts"
+    },
     "./ssm": {
       "import": "./dist/service/ssm/index.js",
       "types": "./dist/service/ssm/index.d.ts"
@@ -217,6 +225,7 @@
     "@aws-sdk/client-ecs": "^3.1101.0",
     "@aws-sdk/client-elastic-load-balancing-v2": "^3.1109.0",
     "@aws-sdk/client-eventbridge": "^3.1109.0",
+    "@aws-sdk/client-firehose": "^3.1115.0",
     "@aws-sdk/client-iam": "^3.1101.0",
     "@aws-sdk/client-kinesis": "^3.1115.0",
     "@aws-sdk/client-kms": "^3.1101.0",
@@ -230,6 +239,7 @@
     "@aws-sdk/client-scheduler": "^3.1109.0",
     "@aws-sdk/client-secrets-manager": "^3.1101.0",
     "@aws-sdk/client-sesv2": "^3.1111.0",
+    "@aws-sdk/client-sfn": "^3.1115.0",
     "@aws-sdk/client-sns": "^3.1104.0",
     "@aws-sdk/client-sqs": "^3.1101.0",
     "@aws-sdk/client-ssm": "^3.1101.0",