@kensio/yulin 1.15.1 → 1.16.0

package/dist/service/cloudwatch/alarm/action/sim-cloudwatch-alarm-notification.d.ts

@@ -0,0 +1,26 @@
+import type { SimAwsAccountRegionScope } from "../../../aws/sim-aws-account-region-scope.js";
+import type { SimCloudWatchAlarm } from "../sim-cloudwatch-alarm.js";
+import type { SimCloudWatchAlarmTransition } from "../sim-cloudwatch-alarm.js";
+interface SimCloudWatchAlarmMessageProperties {
+    readonly alarm: SimCloudWatchAlarm;
+    readonly transition: SimCloudWatchAlarmTransition;
+    readonly accountRegionScope: SimAwsAccountRegionScope;
+}
+/**
+ * The subject line real CloudWatch puts on an alarm notification.
+ */
+export declare function simCloudWatchAlarmSubject(properties: SimCloudWatchAlarmMessageProperties): string;
+/**
+ * The JSON body real CloudWatch publishes when an alarm changes state.
+ *
+ * The shape is what a subscriber parses, so it is worth matching: a Lambda
+ * function reading `NewStateValue` out of an SNS message is the code a test
+ * here is most likely to be exercising.
+ *
+ * `Region` carries the region code rather than the human name real CloudWatch
+ * uses ("eu-west-2" rather than "EU (London)"), because the simulation knows
+ * the code and nothing here maps one to the other.
+ */
+export declare function simCloudWatchAlarmMessage(properties: SimCloudWatchAlarmMessageProperties): string;
+export {};
+//# sourceMappingURL=sim-cloudwatch-alarm-notification.d.ts.map

package/dist/service/cloudwatch/alarm/action/sim-cloudwatch-alarm-notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cloudwatch-alarm-notification.d.ts","sourceRoot":"","sources":["../../../../../src/service/cloudwatch/alarm/action/sim-cloudwatch-alarm-notification.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAC;AAC7F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAE/E,UAAU,mCAAmC;IAC3C,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,4BAA4B,CAAC;IAClD,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,CAAC;CACvD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,mCAAmC,GAC9C,MAAM,CAKR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,mCAAmC,GAC9C,MAAM,CAqCR"}

package/dist/service/cloudwatch/alarm/action/sim-cloudwatch-alarm-notification.js

@@ -0,0 +1,56 @@
+/**
+ * The subject line real CloudWatch puts on an alarm notification.
+ */
+export function simCloudWatchAlarmSubject(properties) {
+    const { transition, accountRegionScope } = properties;
+    const name = properties.alarm.name;
+    return `${transition.state}: "${name}" in ${accountRegionScope.regionName}`;
+}
+/**
+ * The JSON body real CloudWatch publishes when an alarm changes state.
+ *
+ * The shape is what a subscriber parses, so it is worth matching: a Lambda
+ * function reading `NewStateValue` out of an SNS message is the code a test
+ * here is most likely to be exercising.
+ *
+ * `Region` carries the region code rather than the human name real CloudWatch
+ * uses ("eu-west-2" rather than "EU (London)"), because the simulation knows
+ * the code and nothing here maps one to the other.
+ */
+export function simCloudWatchAlarmMessage(properties) {
+    const { alarm, transition, accountRegionScope } = properties;
+    const definition = alarm.definition;
+    return JSON.stringify({
+        AlarmName: alarm.name,
+        AlarmDescription: definition.alarmDescription ?? null,
+        AWSAccountId: accountRegionScope.accountId,
+        AlarmConfigurationUpdatedTimestamp: alarm.configurationUpdatedAt.toISOString(),
+        NewStateValue: transition.state,
+        NewStateReason: transition.reason,
+        StateChangeTime: transition.at.toISOString(),
+        Region: accountRegionScope.regionName,
+        AlarmArn: alarm.arn,
+        OldStateValue: transition.previousState,
+        OKActions: definition.okActions,
+        AlarmActions: definition.alarmActions,
+        InsufficientDataActions: definition.insufficientDataActions,
+        Trigger: {
+            MetricName: definition.metric.metricName,
+            Namespace: definition.metric.namespace,
+            StatisticType: "Statistic",
+            Statistic: definition.statistic.toUpperCase(),
+            Unit: definition.unit ?? null,
+            Dimensions: definition.metric.dimensions.map((dimension) => ({
+                value: dimension.value,
+                name: dimension.name,
+            })),
+            Period: definition.period,
+            EvaluationPeriods: definition.evaluationPeriods,
+            DatapointsToAlarm: definition.datapointsToAlarm,
+            ComparisonOperator: definition.comparisonOperator,
+            Threshold: definition.threshold,
+            TreatMissingData: definition.treatMissingData,
+        },
+    });
+}
+//# sourceMappingURL=sim-cloudwatch-alarm-notification.js.map

package/dist/service/cloudwatch/alarm/action/sim-cloudwatch-alarm-notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cloudwatch-alarm-notification.js","sourceRoot":"","sources":["../../../../../src/service/cloudwatch/alarm/action/sim-cloudwatch-alarm-notification.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,UAA+C;IAE/C,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,GAAG,UAAU,CAAC;IACtD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;IAEnC,OAAO,GAAG,UAAU,CAAC,KAAK,MAAM,IAAI,QAAQ,kBAAkB,CAAC,UAAU,EAAE,CAAC;AAC9E,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,yBAAyB,CACvC,UAA+C;IAE/C,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,GAAG,UAAU,CAAC;IAC7D,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IAEpC,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,gBAAgB,EAAE,UAAU,CAAC,gBAAgB,IAAI,IAAI;QACrD,YAAY,EAAE,kBAAkB,CAAC,SAAS;QAC1C,kCAAkC,EAChC,KAAK,CAAC,sBAAsB,CAAC,WAAW,EAAE;QAC5C,aAAa,EAAE,UAAU,CAAC,KAAK;QAC/B,cAAc,EAAE,UAAU,CAAC,MAAM;QACjC,eAAe,EAAE,UAAU,CAAC,EAAE,CAAC,WAAW,EAAE;QAC5C,MAAM,EAAE,kBAAkB,CAAC,UAAU;QACrC,QAAQ,EAAE,KAAK,CAAC,GAAG;QACnB,aAAa,EAAE,UAAU,CAAC,aAAa;QACvC,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,YAAY,EAAE,UAAU,CAAC,YAAY;QACrC,uBAAuB,EAAE,UAAU,CAAC,uBAAuB;QAC3D,OAAO,EAAE;YACP,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,UAAU;YACxC,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC,SAAS;YACtC,aAAa,EAAE,WAAW;YAC1B,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,WAAW,EAAE;YAC7C,IAAI,EAAE,UAAU,CAAC,IAAI,IAAI,IAAI;YAC7B,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;gBAC3D,KAAK,EAAE,SAAS,CAAC,KAAK;gBACtB,IAAI,EAAE,SAAS,CAAC,IAAI;aACrB,CAAC,CAAC;YACH,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,iBAAiB,EAAE,UAAU,CAAC,iBAAiB;YAC/C,iBAAiB,EAAE,UAAU,CAAC,iBAAiB;YAC/C,kBAAkB,EAAE,UAAU,CAAC,kBAAkB;YACjD,SAAS,EAAE,UAAU,CAAC,SAAS;YAC/B,gBAAgB,EAAE,UAAU,CAAC,gBAAgB;SAC9C;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/service/cloudwatch/alarm/action/sim-cloudwatch-alarm-targets.d.ts

@@ -0,0 +1,37 @@
+/**
+ * One notification an alarm action sends.
+ */
+export interface SimCloudWatchAlarmNotification {
+    readonly topicArn: string;
+    readonly subject: string;
+    readonly message: string;
+}
+/**
+ * Where an alarm's actions reach.
+ *
+ * An alarm holds a topic ARN and nothing else, so what that ARN names is
+ * resolved when the alarm fires rather than when it is created: a topic made
+ * after the alarm is a topic the alarm can still reach, as it would be in an
+ * account.
+ */
+export interface SimCloudWatchAlarmTargets {
+    /**
+     * Send one notification, or throw saying why it could not be sent.
+     */
+    notify(notification: SimCloudWatchAlarmNotification): Promise<void>;
+}
+/**
+ * The targets a simulated CloudWatch built on its own has, which are none.
+ *
+ * Alarms still evaluate and change state without anything to notify. Firing at
+ * nothing is reported as a failure rather than passing quietly, because an
+ * alarm whose action reaches nowhere is exactly what a test setting one up is
+ * checking against.
+ */
+export declare class SimCloudWatchNoAlarmTargets implements SimCloudWatchAlarmTargets {
+    /**
+     * Refuse every notification, since there is nothing here to notify.
+     */
+    notify(notification: SimCloudWatchAlarmNotification): Promise<void>;
+}
+//# sourceMappingURL=sim-cloudwatch-alarm-targets.d.ts.map

package/dist/service/cloudwatch/alarm/action/sim-cloudwatch-alarm-targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cloudwatch-alarm-targets.d.ts","sourceRoot":"","sources":["../../../../../src/service/cloudwatch/alarm/action/sim-cloudwatch-alarm-targets.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,MAAM,CAAC,YAAY,EAAE,8BAA8B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrE;AAED;;;;;;;GAOG;AACH,qBAAa,2BAA4B,YAAW,yBAAyB;IAC3E;;OAEG;IACH,MAAM,CAAC,YAAY,EAAE,8BAA8B,GAAG,OAAO,CAAC,IAAI,CAAC,CAQlE;CACF"}

package/dist/service/cloudwatch/alarm/action/sim-cloudwatch-alarm-targets.js

@@ -0,0 +1,19 @@
+/**
+ * The targets a simulated CloudWatch built on its own has, which are none.
+ *
+ * Alarms still evaluate and change state without anything to notify. Firing at
+ * nothing is reported as a failure rather than passing quietly, because an
+ * alarm whose action reaches nowhere is exactly what a test setting one up is
+ * checking against.
+ */
+export class SimCloudWatchNoAlarmTargets {
+    /**
+     * Refuse every notification, since there is nothing here to notify.
+     */
+    notify(notification) {
+        return Promise.reject(new Error(`${notification.topicArn} is not reachable: this simulated CloudWatch ` +
+            `was built without the rest of the simulation, so it has no SNS to ` +
+            `publish to.`));
+    }
+}
+//# sourceMappingURL=sim-cloudwatch-alarm-targets.js.map

package/dist/service/cloudwatch/alarm/action/sim-cloudwatch-alarm-targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cloudwatch-alarm-targets.js","sourceRoot":"","sources":["../../../../../src/service/cloudwatch/alarm/action/sim-cloudwatch-alarm-targets.ts"],"names":[],"mappings":"AAwBA;;;;;;;GAOG;AACH,MAAM,OAAO,2BAA2B;IACtC;;OAEG;IACH,MAAM,CAAC,YAA4C;QACjD,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CACP,GAAG,YAAY,CAAC,QAAQ,+CAA+C;YACrE,oEAAoE;YACpE,aAAa,CAChB,CACF,CAAC;IACJ,CAAC;CACF"}

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-arn.d.ts

@@ -0,0 +1,10 @@
+import type { SimAwsAccountRegionScope } from "../../aws/sim-aws-account-region-scope.js";
+/**
+ * The ARN of an alarm.
+ *
+ * Alarms are the one thing in CloudWatch that has an ARN: a metric has none,
+ * which is why every metric action authorizes against `*`, while an alarm can
+ * be named by a policy and is what `DescribeAlarms` reports.
+ */
+export declare function simCloudWatchAlarmArn(scope: SimAwsAccountRegionScope, alarmName: string): string;
+//# sourceMappingURL=sim-cloudwatch-alarm-arn.d.ts.map

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-arn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cloudwatch-alarm-arn.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudwatch/alarm/sim-cloudwatch-alarm-arn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAE1F;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,wBAAwB,EAC/B,SAAS,EAAE,MAAM,GAChB,MAAM,CAER"}

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-arn.js

@@ -0,0 +1,11 @@
+/**
+ * The ARN of an alarm.
+ *
+ * Alarms are the one thing in CloudWatch that has an ARN: a metric has none,
+ * which is why every metric action authorizes against `*`, while an alarm can
+ * be named by a policy and is what `DescribeAlarms` reports.
+ */
+export function simCloudWatchAlarmArn(scope, alarmName) {
+    return `arn:aws:cloudwatch:${scope.regionName}:${scope.accountId}:alarm:${alarmName}`;
+}
+//# sourceMappingURL=sim-cloudwatch-alarm-arn.js.map

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-arn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cloudwatch-alarm-arn.js","sourceRoot":"","sources":["../../../../src/service/cloudwatch/alarm/sim-cloudwatch-alarm-arn.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAA+B,EAC/B,SAAiB;IAEjB,OAAO,sBAAsB,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,SAAS,UAAU,SAAS,EAAE,CAAC;AACxF,CAAC"}

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-definition.d.ts

@@ -0,0 +1,33 @@
+import type { SimCloudWatchMetricIdentity } from "../metric/sim-cloudwatch-metric.js";
+import type { SimCloudWatchStatistic } from "../metric/sim-cloudwatch-statistic.js";
+import type { SimCloudWatchUnit } from "../metric/sim-cloudwatch-unit.js";
+import type { SimCloudWatchComparisonOperator } from "./sim-cloudwatch-comparison.js";
+import type { SimCloudWatchMissingDataTreatment } from "./sim-cloudwatch-missing-data.js";
+/**
+ * What one alarm watches for, as PutMetricAlarm stated it.
+ *
+ * Held apart from the alarm itself because it is replaced wholesale: real
+ * PutMetricAlarm on a name that exists updates every one of these rather than
+ * merging, and the alarm keeps its state and history across the change.
+ */
+export interface SimCloudWatchAlarmDefinition {
+    readonly alarmName: string;
+    readonly alarmDescription: string | undefined;
+    readonly metric: SimCloudWatchMetricIdentity;
+    readonly statistic: SimCloudWatchStatistic;
+    readonly unit: SimCloudWatchUnit | undefined;
+    /** How long each evaluated period is, in seconds. */
+    readonly period: number;
+    /** How many periods back the alarm looks each time it evaluates. */
+    readonly evaluationPeriods: number;
+    /** How many of those must breach for the alarm to fire. */
+    readonly datapointsToAlarm: number;
+    readonly threshold: number;
+    readonly comparisonOperator: SimCloudWatchComparisonOperator;
+    readonly treatMissingData: SimCloudWatchMissingDataTreatment;
+    readonly actionsEnabled: boolean;
+    readonly alarmActions: readonly string[];
+    readonly okActions: readonly string[];
+    readonly insufficientDataActions: readonly string[];
+}
+//# sourceMappingURL=sim-cloudwatch-alarm-definition.d.ts.map

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cloudwatch-alarm-definition.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudwatch/alarm/sim-cloudwatch-alarm-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACtF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC;AACtF,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,kCAAkC,CAAC;AAE1F;;;;;;GAMG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IAE9C,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAE7C,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,oEAAoE;IACpE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAEnC,2DAA2D;IAC3D,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAEnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,+BAA+B,CAAC;IAC7D,QAAQ,CAAC,gBAAgB,EAAE,iCAAiC,CAAC;IAE7D,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,uBAAuB,EAAE,SAAS,MAAM,EAAE,CAAC;CACrD"}

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-definition.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sim-cloudwatch-alarm-definition.js.map

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cloudwatch-alarm-definition.js","sourceRoot":"","sources":["../../../../src/service/cloudwatch/alarm/sim-cloudwatch-alarm-definition.ts"],"names":[],"mappings":""}

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-evaluation.d.ts

@@ -0,0 +1,32 @@
+import type { SimCloudWatchAlarmDefinition } from "./sim-cloudwatch-alarm-definition.js";
+import type { SimCloudWatchAlarmState } from "./sim-cloudwatch-alarm-state.js";
+/**
+ * What one evaluated period was worth to the alarm.
+ *
+ * A period is missing when nothing was published into it, which is a different
+ * thing from a period whose values happened to sum to zero.
+ */
+export type SimCloudWatchPeriodVerdict = "breaching" | "notBreaching" | "absent";
+/**
+ * What an evaluation decided, and why.
+ *
+ * `state` being undefined means the alarm keeps the state it has, which is
+ * what `TreatMissingData: ignore` asks for.
+ */
+export interface SimCloudWatchEvaluation {
+    readonly state: SimCloudWatchAlarmState | undefined;
+    readonly reason: string;
+}
+/**
+ * Decide what the periods an alarm just looked at make its state.
+ *
+ * The periods arrive oldest first and are as many as `evaluationPeriods`, with
+ * `undefined` for a period nothing was published into.
+ *
+ * This is CloudWatch's M-of-N rule: the alarm fires when at least
+ * `datapointsToAlarm` of the periods breach, whether or not they are
+ * consecutive. Everything else is OK, except that an alarm with nothing to go
+ * on reports INSUFFICIENT_DATA rather than guessing.
+ */
+export declare function evaluateSimCloudWatchAlarm(values: readonly (number | undefined)[], definition: SimCloudWatchAlarmDefinition): SimCloudWatchEvaluation;
+//# sourceMappingURL=sim-cloudwatch-alarm-evaluation.d.ts.map

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-evaluation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cloudwatch-alarm-evaluation.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudwatch/alarm/sim-cloudwatch-alarm-evaluation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AACzF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAG/E;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,GAClC,WAAW,GACX,cAAc,GACd,QAAQ,CAAC;AAEb;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,uBAAuB,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,EACvC,UAAU,EAAE,4BAA4B,GACvC,uBAAuB,CA4BzB"}

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-evaluation.js

@@ -0,0 +1,75 @@
+import { simCloudWatchBreaches } from "./sim-cloudwatch-comparison.js";
+/**
+ * Decide what the periods an alarm just looked at make its state.
+ *
+ * The periods arrive oldest first and are as many as `evaluationPeriods`, with
+ * `undefined` for a period nothing was published into.
+ *
+ * This is CloudWatch's M-of-N rule: the alarm fires when at least
+ * `datapointsToAlarm` of the periods breach, whether or not they are
+ * consecutive. Everything else is OK, except that an alarm with nothing to go
+ * on reports INSUFFICIENT_DATA rather than guessing.
+ */
+export function evaluateSimCloudWatchAlarm(values, definition) {
+    const verdicts = values.map((value) => verdictFor(value, definition));
+    if (keepsItsState(verdicts, definition)) {
+        return {
+            state: undefined,
+            reason: "Insufficient Data: the alarm is configured to ignore missing data, " +
+                "so its state is unchanged",
+        };
+    }
+    const breaching = verdicts.filter((verdict) => verdict === "breaching").length;
+    if (breaching >= definition.datapointsToAlarm) {
+        return { state: "ALARM", reason: reason(breaching, definition, "") };
+    }
+    if (verdicts.every((verdict) => verdict === "absent")) {
+        return {
+            state: "INSUFFICIENT_DATA",
+            reason: `Insufficient Data: ${String(values.length)} datapoints were unknown`,
+        };
+    }
+    return { state: "OK", reason: reason(breaching, definition, "only ") };
+}
+/**
+ * Whether the alarm was told to leave its state alone when data is missing.
+ */
+function keepsItsState(verdicts, definition) {
+    return (definition.treatMissingData === "ignore" && verdicts.includes("absent"));
+}
+/**
+ * What one period is worth, once missing data has been treated.
+ *
+ * `missing` leaves an absent period absent, so it counts towards neither side
+ * and only matters if every period is absent. The other two treatments turn it
+ * into a period with an opinion.
+ */
+function verdictFor(value, definition) {
+    if (value !== undefined) {
+        return simCloudWatchBreaches(value, definition.threshold, definition.comparisonOperator)
+            ? "breaching"
+            : "notBreaching";
+    }
+    switch (definition.treatMissingData) {
+        case "breaching": {
+            return "breaching";
+        }
+        case "notBreaching": {
+            return "notBreaching";
+        }
+        // `missing` leaves the period absent so it counts towards neither side,
+        // and `ignore` never reaches here: an absent period under it stops the
+        // evaluation before any verdict is read.
+        case "missing":
+        case "ignore": {
+            return "absent";
+        }
+    }
+}
+/**
+ * Why the alarm decided what it did, in the shape real CloudWatch words it.
+ */
+function reason(breaching, definition, qualifier) {
+    return `Threshold Crossed: ${qualifier}${String(breaching)} out of the last ${String(definition.evaluationPeriods)} datapoints were ${definition.comparisonOperator} the threshold (${String(definition.threshold)})`;
+}
+//# sourceMappingURL=sim-cloudwatch-alarm-evaluation.js.map

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-evaluation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cloudwatch-alarm-evaluation.js","sourceRoot":"","sources":["../../../../src/service/cloudwatch/alarm/sim-cloudwatch-alarm-evaluation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAwBvE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAuC,EACvC,UAAwC;IAExC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;IAEtE,IAAI,aAAa,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC;QACxC,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,MAAM,EACJ,qEAAqE;gBACrE,2BAA2B;SAC9B,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAC/B,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,WAAW,CACrC,CAAC,MAAM,CAAC;IAET,IAAI,SAAS,IAAI,UAAU,CAAC,iBAAiB,EAAE,CAAC;QAC9C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC;IACvE,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,QAAQ,CAAC,EAAE,CAAC;QACtD,OAAO;YACL,KAAK,EAAE,mBAAmB;YAC1B,MAAM,EAAE,sBAAsB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,0BAA0B;SAC9E,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CACpB,QAA+C,EAC/C,UAAwC;IAExC,OAAO,CACL,UAAU,CAAC,gBAAgB,KAAK,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CACxE,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,UAAU,CACjB,KAAyB,EACzB,UAAwC;IAExC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,qBAAqB,CAC1B,KAAK,EACL,UAAU,CAAC,SAAS,EACpB,UAAU,CAAC,kBAAkB,CAC9B;YACC,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,cAAc,CAAC;IACrB,CAAC;IAED,QAAQ,UAAU,CAAC,gBAAgB,EAAE,CAAC;QACpC,KAAK,WAAW,EAAE,CAAC;YACjB,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,KAAK,cAAc,EAAE,CAAC;YACpB,OAAO,cAAc,CAAC;QACxB,CAAC;QACD,wEAAwE;QACxE,uEAAuE;QACvE,yCAAyC;QACzC,KAAK,SAAS,CAAC;QACf,KAAK,QAAQ,EAAE,CAAC;YACd,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,MAAM,CACb,SAAiB,EACjB,UAAwC,EACxC,SAAiB;IAEjB,OAAO,sBAAsB,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,oBAAoB,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,oBAAoB,UAAU,CAAC,kBAAkB,mBAAmB,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC;AACxN,CAAC"}

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-history.d.ts

@@ -0,0 +1,26 @@
+import type { SimCloudWatchAlarmState } from "./sim-cloudwatch-alarm-state.js";
+/**
+ * One thing that happened to an alarm.
+ *
+ * Only state changes are recorded. Real CloudWatch also records configuration
+ * updates and action invocations, and those say nothing a test could not read
+ * off the alarm itself, so the history here is the transitions.
+ */
+export interface SimCloudWatchAlarmHistoryItem {
+    readonly timestamp: Date;
+    readonly previousState: SimCloudWatchAlarmState;
+    readonly state: SimCloudWatchAlarmState;
+    readonly reason: string;
+}
+/**
+ * The state changes of one alarm, newest first.
+ *
+ * Newest first is how real DescribeAlarmHistory answers, and it is what a test
+ * asserting on the last transition wants to read.
+ */
+export declare class SimCloudWatchAlarmHistory {
+    #private;
+    get all(): readonly SimCloudWatchAlarmHistoryItem[];
+    record(item: SimCloudWatchAlarmHistoryItem): void;
+}
+//# sourceMappingURL=sim-cloudwatch-alarm-history.d.ts.map

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cloudwatch-alarm-history.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudwatch/alarm/sim-cloudwatch-alarm-history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE/E;;;;;;GAMG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,uBAAuB,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,qBAAa,yBAAyB;;IAGpC,IAAI,GAAG,IAAI,SAAS,6BAA6B,EAAE,CAElD;IAED,MAAM,CAAC,IAAI,EAAE,6BAA6B,GAAG,IAAI,CAEhD;CACF"}

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-history.js

@@ -0,0 +1,16 @@
+/**
+ * The state changes of one alarm, newest first.
+ *
+ * Newest first is how real DescribeAlarmHistory answers, and it is what a test
+ * asserting on the last transition wants to read.
+ */
+export class SimCloudWatchAlarmHistory {
+    #items = [];
+    get all() {
+        return this.#items;
+    }
+    record(item) {
+        this.#items.unshift(item);
+    }
+}
+//# sourceMappingURL=sim-cloudwatch-alarm-history.js.map

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cloudwatch-alarm-history.js","sourceRoot":"","sources":["../../../../src/service/cloudwatch/alarm/sim-cloudwatch-alarm-history.ts"],"names":[],"mappings":"AAgBA;;;;;GAKG;AACH,MAAM,OAAO,yBAAyB;IAC3B,MAAM,GAAoC,EAAE,CAAC;IAEtD,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,IAAmC;QACxC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;CACF"}

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-periods.d.ts

@@ -0,0 +1,23 @@
+import type { SimCloudWatchMetricStore } from "../metric/sim-cloudwatch-metric-store.js";
+import type { SimCloudWatchAlarmDefinition } from "./sim-cloudwatch-alarm-definition.js";
+/**
+ * The instant the period after the one holding an instant begins.
+ *
+ * An alarm evaluates on period boundaries, so this is when it next has a
+ * complete period to look at.
+ */
+export declare function simCloudWatchNextPeriodBoundary(now: Date, periodSeconds: number): Date;
+/**
+ * Read the periods an alarm looks at when it evaluates at an instant, oldest
+ * first.
+ *
+ * The window is the `evaluationPeriods` complete periods before the boundary,
+ * so an alarm evaluating at 09:03 with three one-minute periods reads 09:00,
+ * 09:01 and 09:02 and not the minute it is standing on, which has not finished.
+ *
+ * A period nothing was published into comes back as `undefined` rather than
+ * being left out, because which period is missing is what `TreatMissingData`
+ * decides on.
+ */
+export declare function simCloudWatchAlarmPeriods(metrics: SimCloudWatchMetricStore, definition: SimCloudWatchAlarmDefinition, boundary: Date): readonly (number | undefined)[];
+//# sourceMappingURL=sim-cloudwatch-alarm-periods.d.ts.map

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-periods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cloudwatch-alarm-periods.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudwatch/alarm/sim-cloudwatch-alarm-periods.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAGzF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AAIzF;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,IAAI,EACT,aAAa,EAAE,MAAM,GACpB,IAAI,CAKN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,wBAAwB,EACjC,UAAU,EAAE,4BAA4B,EACxC,QAAQ,EAAE,IAAI,GACb,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAiBjC"}

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-periods.js

@@ -0,0 +1,37 @@
+import { simCloudWatchPeriodAggregates } from "../metric/sim-cloudwatch-period.js";
+import { simCloudWatchStatisticValue } from "../metric/sim-cloudwatch-statistic.js";
+const millisecondsPerSecond = 1000;
+/**
+ * The instant the period after the one holding an instant begins.
+ *
+ * An alarm evaluates on period boundaries, so this is when it next has a
+ * complete period to look at.
+ */
+export function simCloudWatchNextPeriodBoundary(now, periodSeconds) {
+    const periodMilliseconds = periodSeconds * millisecondsPerSecond;
+    const elapsed = Math.floor(now.getTime() / periodMilliseconds);
+    return new Date((elapsed + 1) * periodMilliseconds);
+}
+/**
+ * Read the periods an alarm looks at when it evaluates at an instant, oldest
+ * first.
+ *
+ * The window is the `evaluationPeriods` complete periods before the boundary,
+ * so an alarm evaluating at 09:03 with three one-minute periods reads 09:00,
+ * 09:01 and 09:02 and not the minute it is standing on, which has not finished.
+ *
+ * A period nothing was published into comes back as `undefined` rather than
+ * being left out, because which period is missing is what `TreatMissingData`
+ * decides on.
+ */
+export function simCloudWatchAlarmPeriods(metrics, definition, boundary) {
+    const periodMilliseconds = definition.period * millisecondsPerSecond;
+    const endTime = boundary.getTime();
+    const startTime = endTime - definition.evaluationPeriods * periodMilliseconds;
+    const found = metrics.find(definition.metric);
+    const aggregates = simCloudWatchPeriodAggregates(found?.within({ startTime, endTime, unit: definition.unit }) ?? [], definition.period);
+    return Array.from({ length: definition.evaluationPeriods }, (_, index) => aggregates.get(startTime + index * periodMilliseconds)).map((aggregate) => aggregate === undefined
+        ? undefined
+        : simCloudWatchStatisticValue(aggregate, definition.statistic));
+}
+//# sourceMappingURL=sim-cloudwatch-alarm-periods.js.map

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-periods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cloudwatch-alarm-periods.js","sourceRoot":"","sources":["../../../../src/service/cloudwatch/alarm/sim-cloudwatch-alarm-periods.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AAGpF,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAC7C,GAAS,EACT,aAAqB;IAErB,MAAM,kBAAkB,GAAG,aAAa,GAAG,qBAAqB,CAAC;IACjE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,kBAAkB,CAAC,CAAC;IAE/D,OAAO,IAAI,IAAI,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAiC,EACjC,UAAwC,EACxC,QAAc;IAEd,MAAM,kBAAkB,GAAG,UAAU,CAAC,MAAM,GAAG,qBAAqB,CAAC;IACrE,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;IACnC,MAAM,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC,iBAAiB,GAAG,kBAAkB,CAAC;IAC9E,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,6BAA6B,CAC9C,KAAK,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAClE,UAAU,CAAC,MAAM,CAClB,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CACvE,UAAU,CAAC,GAAG,CAAC,SAAS,GAAG,KAAK,GAAG,kBAAkB,CAAC,CACvD,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAClB,SAAS,KAAK,SAAS;QACrB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,2BAA2B,CAAC,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,CACjE,CAAC;AACJ,CAAC"}

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-schedule.d.ts

@@ -0,0 +1,55 @@
+import type { BackgroundScheduler } from "../../../util/background/background.js";
+import type { SimCloudWatchMetricStore } from "../metric/sim-cloudwatch-metric-store.js";
+import type { SimCloudWatchAlarmActions } from "./action/sim-cloudwatch-alarm-actions.js";
+import type { SimCloudWatchAlarm } from "./sim-cloudwatch-alarm.js";
+interface SimCloudWatchAlarmScheduleProperties {
+    readonly metrics: SimCloudWatchMetricStore;
+    readonly actions: SimCloudWatchAlarmActions;
+    readonly background: BackgroundScheduler;
+}
+/**
+ * Runs each alarm's evaluation on the simulation's clock.
+ *
+ * Nothing here uses a real timer. An alarm's next evaluation is scheduled on
+ * the background scheduler at the next period boundary, and every evaluation
+ * schedules the one after it, so a frozen clock evaluates nothing and
+ * `advanceBy({ minutes: 20 })` walks twenty one-minute evaluations and settles
+ * before the call returns.
+ *
+ * Each alarm keeps one task for its whole life, because taking a scheduled
+ * turn back off the clock is done by task identity: a fresh closure per
+ * evaluation could be scheduled but never cancelled.
+ */
+export declare class SimCloudWatchAlarmSchedule {
+    #private;
+    constructor(properties: SimCloudWatchAlarmScheduleProperties);
+    /**
+     * Start evaluating an alarm, from the next period boundary.
+     *
+     * An alarm already being evaluated has its existing turn taken back off the
+     * clock first, so it never gains a second one and never keeps a turn due at
+     * the boundary of a period it no longer has: an alarm moved from an hourly
+     * to a one-minute period would otherwise sit unevaluated until the hour it
+     * was first scheduled for came round.
+     */
+    start(alarm: SimCloudWatchAlarm): void;
+    /**
+     * Stop evaluating an alarm and take its scheduled turn back off the clock.
+     *
+     * Without this a deleted alarm would keep waking up, keep reading a metric
+     * nothing watches, and keep the simulation from settling.
+     */
+    stop(alarmName: string): void;
+    /**
+     * Evaluate an alarm against the periods behind it, then schedule the next
+     * turn.
+     *
+     * The clock reads the boundary this turn was due at while this runs, so a
+     * transition is stamped with when it happened rather than with wherever time
+     * was eventually advanced to.
+     */
+    private evaluate;
+    private scheduleNext;
+}
+export {};
+//# sourceMappingURL=sim-cloudwatch-alarm-schedule.d.ts.map

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cloudwatch-alarm-schedule.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudwatch/alarm/sim-cloudwatch-alarm-schedule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EAEpB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACzF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAC1F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAOpE,UAAU,oCAAoC;IAC5C,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;CAC1C;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,0BAA0B;;IAMrC,YAAY,UAAU,EAAE,oCAAoC,EAI3D;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CASrC;IAED;;;;;OAKG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAS5B;IAED;;;;;;;OAOG;YACW,QAAQ;IAwBtB,OAAO,CAAC,YAAY;CASrB"}

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-schedule.js

@@ -0,0 +1,84 @@
+import { evaluateSimCloudWatchAlarm } from "./sim-cloudwatch-alarm-evaluation.js";
+import { simCloudWatchAlarmPeriods, simCloudWatchNextPeriodBoundary, } from "./sim-cloudwatch-alarm-periods.js";
+/**
+ * Runs each alarm's evaluation on the simulation's clock.
+ *
+ * Nothing here uses a real timer. An alarm's next evaluation is scheduled on
+ * the background scheduler at the next period boundary, and every evaluation
+ * schedules the one after it, so a frozen clock evaluates nothing and
+ * `advanceBy({ minutes: 20 })` walks twenty one-minute evaluations and settles
+ * before the call returns.
+ *
+ * Each alarm keeps one task for its whole life, because taking a scheduled
+ * turn back off the clock is done by task identity: a fresh closure per
+ * evaluation could be scheduled but never cancelled.
+ */
+export class SimCloudWatchAlarmSchedule {
+    #metrics;
+    #actions;
+    #background;
+    #tasks = new Map();
+    constructor(properties) {
+        this.#metrics = properties.metrics;
+        this.#actions = properties.actions;
+        this.#background = properties.background;
+    }
+    /**
+     * Start evaluating an alarm, from the next period boundary.
+     *
+     * An alarm already being evaluated has its existing turn taken back off the
+     * clock first, so it never gains a second one and never keeps a turn due at
+     * the boundary of a period it no longer has: an alarm moved from an hourly
+     * to a one-minute period would otherwise sit unevaluated until the hour it
+     * was first scheduled for came round.
+     */
+    start(alarm) {
+        this.stop(alarm.name);
+        const task = async () => {
+            await this.evaluate(alarm);
+        };
+        this.#tasks.set(alarm.name, task);
+        this.scheduleNext(alarm, task);
+    }
+    /**
+     * Stop evaluating an alarm and take its scheduled turn back off the clock.
+     *
+     * Without this a deleted alarm would keep waking up, keep reading a metric
+     * nothing watches, and keep the simulation from settling.
+     */
+    stop(alarmName) {
+        const task = this.#tasks.get(alarmName);
+        if (task === undefined) {
+            return;
+        }
+        this.#tasks.delete(alarmName);
+        this.#background.cancelScheduled(task);
+    }
+    /**
+     * Evaluate an alarm against the periods behind it, then schedule the next
+     * turn.
+     *
+     * The clock reads the boundary this turn was due at while this runs, so a
+     * transition is stamped with when it happened rather than with wherever time
+     * was eventually advanced to.
+     */
+    async evaluate(alarm) {
+        const task = this.#tasks.get(alarm.name);
+        if (task === undefined) {
+            return;
+        }
+        const now = this.#background.now();
+        const evaluation = evaluateSimCloudWatchAlarm(simCloudWatchAlarmPeriods(this.#metrics, alarm.definition, now), alarm.definition);
+        const transition = evaluation.state === undefined
+            ? undefined
+            : alarm.moveTo(evaluation.state, evaluation.reason, now);
+        this.scheduleNext(alarm, task);
+        if (transition !== undefined) {
+            await this.#actions.fire(alarm, transition);
+        }
+    }
+    scheduleNext(alarm, task) {
+        this.#background.scheduleAt(simCloudWatchNextPeriodBoundary(this.#background.now(), alarm.definition.period), task);
+    }
+}
+//# sourceMappingURL=sim-cloudwatch-alarm-schedule.js.map

package/dist/service/cloudwatch/alarm/sim-cloudwatch-alarm-schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cloudwatch-alarm-schedule.js","sourceRoot":"","sources":["../../../../src/service/cloudwatch/alarm/sim-cloudwatch-alarm-schedule.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,EACL,yBAAyB,EACzB,+BAA+B,GAChC,MAAM,mCAAmC,CAAC;AAQ3C;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,0BAA0B;IAC5B,QAAQ,CAA2B;IACnC,QAAQ,CAA4B;IACpC,WAAW,CAAsB;IACjC,MAAM,GAAG,IAAI,GAAG,EAA0B,CAAC;IAEpD,YAAY,UAAgD;QAC1D,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,UAAU,CAAC;IAC3C,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,KAAyB;QAC7B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEtB,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;YACrC,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,SAAiB;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAExC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9B,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;;OAOG;IACK,KAAK,CAAC,QAAQ,CAAC,KAAyB;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEzC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,0BAA0B,CAC3C,yBAAyB,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,EAC/D,KAAK,CAAC,UAAU,CACjB,CAAC;QACF,MAAM,UAAU,GACd,UAAU,CAAC,KAAK,KAAK,SAAS;YAC5B,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAE7D,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAE/B,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,KAAyB,EAAE,IAAoB;QAClE,IAAI,CAAC,WAAW,CAAC,UAAU,CACzB,+BAA+B,CAC7B,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,EACtB,KAAK,CAAC,UAAU,CAAC,MAAM,CACxB,EACD,IAAI,CACL,CAAC;IACJ,CAAC;CACF"}