@composurecdk/cloudwatch 0.3.0

package/README.md

@@ -0,0 +1,68 @@
+# @composurecdk/cloudwatch
+
+CloudWatch alarm primitives for [ComposureCDK](../../README.md).
+
+This package provides the shared types and utilities that ComposureCDK resource packages use to create CloudWatch alarms. It separates generic alarm machinery from resource-specific alarm definitions, so the same primitives can be reused across `@composurecdk/lambda` and future resource packages.
+
+Most users interact with alarms through a resource package (e.g., `@composurecdk/lambda`'s `recommendedAlarms` and `addAlarm`). Use this package directly when building custom alarm definitions or creating a new ComposureCDK resource package.
+
+## AlarmConfig
+
+Partial override type for tuning alarm thresholds without replacing the entire alarm configuration. Resource packages use this as the user-facing knob for recommended alarms.
+
+```ts
+import type { AlarmConfig } from "@composurecdk/cloudwatch";
+
+const overrides: AlarmConfig = {
+  threshold: 5,
+  evaluationPeriods: 3,
+  datapointsToAlarm: 2,
+};
+```
+
+## AlarmDefinitionBuilder
+
+Fluent builder for constructing deferred alarm definitions. The metric factory is stored at configuration time and resolved later against a concrete construct during `build()`.
+
+```ts
+import { AlarmDefinitionBuilder } from "@composurecdk/cloudwatch";
+import type { Function as LambdaFunction } from "aws-cdk-lib/aws-lambda";
+
+const builder = new AlarmDefinitionBuilder<LambdaFunction>("highInvocations")
+  .metric((fn) => fn.metricInvocations({ period: Duration.minutes(1) }))
+  .threshold(1000)
+  .greaterThanOrEqual()
+  .evaluationPeriods(3)
+  .datapointsToAlarm(2)
+  .description("Invocation count is unusually high");
+
+// Later, during build:
+const definition = builder.resolve(lambdaFunction);
+```
+
+The `description` method also accepts a factory for contextual descriptions:
+
+```ts
+builder.description((def) => `Alert when invocations >= ${def.threshold} per minute`);
+```
+
+## createAlarms
+
+Factory function that creates CDK [Alarm](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_cloudwatch.Alarm.html) constructs from fully-resolved `AlarmDefinition`s. Returns a `Record<string, Alarm>` keyed by each definition's key.
+
+```ts
+import { createAlarms } from "@composurecdk/cloudwatch";
+
+const alarms = createAlarms(scope, "MyFunction", definitions);
+// alarms.errors, alarms.throttles, etc.
+```
+
+Construct IDs follow the pattern `${id}${Capitalize(key)}Alarm` (e.g., `MyFunctionErrorsAlarm`).
+
+## AlarmDefinition
+
+The fully-resolved alarm descriptor consumed by `createAlarms`. All fields are required — this is the canonical form after defaults and overrides have been merged.
+
+```ts
+import type { AlarmDefinition } from "@composurecdk/cloudwatch";
+```

package/dist/alarm-config.d.ts

@@ -0,0 +1,17 @@
+import type { TreatMissingData } from "aws-cdk-lib/aws-cloudwatch";
+/**
+ * Configuration for a single recommended CloudWatch alarm.
+ * Every field has a documented default; users override individual
+ * fields to tune thresholds without replacing the entire alarm.
+ */
+export interface AlarmConfig {
+    /** Alarm threshold. Default varies per alarm type. */
+    threshold?: number;
+    /** Number of evaluation periods before triggering. @default 1 */
+    evaluationPeriods?: number;
+    /** Datapoints within evaluation periods required to trigger. @default 1 */
+    datapointsToAlarm?: number;
+    /** How to treat missing data points. @default TreatMissingData.NOT_BREACHING */
+    treatMissingData?: TreatMissingData;
+}
+//# sourceMappingURL=alarm-config.d.ts.map

package/dist/alarm-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alarm-config.d.ts","sourceRoot":"","sources":["../src/alarm-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC"}

package/dist/alarm-config.js

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

package/dist/alarm-config.js.map

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

package/dist/alarm-definition-builder.d.ts

@@ -0,0 +1,40 @@
+import { type Metric, TreatMissingData } from "aws-cdk-lib/aws-cloudwatch";
+import type { AlarmDefinition } from "./alarm-definition.js";
+/**
+ * Fluent builder for constructing deferred {@link AlarmDefinition}s.
+ *
+ * Stores a metric factory `(construct: T) => Metric` at configuration time.
+ * Call {@link resolve} during build to invoke the factory and produce a
+ * complete {@link AlarmDefinition}.
+ *
+ * @typeParam TConstruct - The construct type the metric factory receives.
+ */
+export declare class AlarmDefinitionBuilder<TConstruct> {
+    private readonly _key;
+    private _metricFactory?;
+    private _threshold;
+    private _comparisonOperator;
+    private _evaluationPeriods;
+    private _datapointsToAlarm;
+    private _treatMissingData;
+    private _description;
+    constructor(key: string);
+    metric(factory: (construct: TConstruct) => Metric): this;
+    threshold(value: number): this;
+    greaterThan(): this;
+    greaterThanOrEqual(): this;
+    lessThan(): this;
+    lessThanOrEqual(): this;
+    evaluationPeriods(n: number): this;
+    datapointsToAlarm(n: number): this;
+    treatMissingData(treatment: TreatMissingData): this;
+    description(text: string | ((definition: AlarmDefinition) => string)): this;
+    /**
+     * Resolves the deferred metric factory against a construct and
+     * returns a complete {@link AlarmDefinition}.
+     *
+     * @throws If {@link metric} was not called before resolve.
+     */
+    resolve(construct: TConstruct): AlarmDefinition;
+}
+//# sourceMappingURL=alarm-definition-builder.d.ts.map

package/dist/alarm-definition-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alarm-definition-builder.d.ts","sourceRoot":"","sources":["../src/alarm-definition-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,MAAM,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC/F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;;GAQG;AACH,qBAAa,sBAAsB,CAAC,UAAU;IAC5C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAC,CAAoC;IAC3D,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,mBAAmB,CAA6C;IACxE,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,YAAY,CAA0D;gBAElE,GAAG,EAAE,MAAM;IAIvB,MAAM,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,MAAM,GAAG,IAAI;IAKxD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK9B,WAAW,IAAI,IAAI;IAKnB,kBAAkB,IAAI,IAAI;IAK1B,QAAQ,IAAI,IAAI;IAKhB,eAAe,IAAI,IAAI;IAKvB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKlC,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKlC,gBAAgB,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI;IAKnD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,UAAU,EAAE,eAAe,KAAK,MAAM,CAAC,GAAG,IAAI;IAK3E;;;;;OAKG;IACH,OAAO,CAAC,SAAS,EAAE,UAAU,GAAG,eAAe;CAuBhD"}

package/dist/alarm-definition-builder.js

@@ -0,0 +1,88 @@
+import { ComparisonOperator, TreatMissingData } from "aws-cdk-lib/aws-cloudwatch";
+/**
+ * Fluent builder for constructing deferred {@link AlarmDefinition}s.
+ *
+ * Stores a metric factory `(construct: T) => Metric` at configuration time.
+ * Call {@link resolve} during build to invoke the factory and produce a
+ * complete {@link AlarmDefinition}.
+ *
+ * @typeParam TConstruct - The construct type the metric factory receives.
+ */
+export class AlarmDefinitionBuilder {
+    _key;
+    _metricFactory;
+    _threshold = 0;
+    _comparisonOperator = ComparisonOperator.GREATER_THAN_THRESHOLD;
+    _evaluationPeriods = 1;
+    _datapointsToAlarm = 1;
+    _treatMissingData = TreatMissingData.NOT_BREACHING;
+    _description = "";
+    constructor(key) {
+        this._key = key;
+    }
+    metric(factory) {
+        this._metricFactory = factory;
+        return this;
+    }
+    threshold(value) {
+        this._threshold = value;
+        return this;
+    }
+    greaterThan() {
+        this._comparisonOperator = ComparisonOperator.GREATER_THAN_THRESHOLD;
+        return this;
+    }
+    greaterThanOrEqual() {
+        this._comparisonOperator = ComparisonOperator.GREATER_THAN_OR_EQUAL_TO_THRESHOLD;
+        return this;
+    }
+    lessThan() {
+        this._comparisonOperator = ComparisonOperator.LESS_THAN_THRESHOLD;
+        return this;
+    }
+    lessThanOrEqual() {
+        this._comparisonOperator = ComparisonOperator.LESS_THAN_OR_EQUAL_TO_THRESHOLD;
+        return this;
+    }
+    evaluationPeriods(n) {
+        this._evaluationPeriods = n;
+        return this;
+    }
+    datapointsToAlarm(n) {
+        this._datapointsToAlarm = n;
+        return this;
+    }
+    treatMissingData(treatment) {
+        this._treatMissingData = treatment;
+        return this;
+    }
+    description(text) {
+        this._description = text;
+        return this;
+    }
+    /**
+     * Resolves the deferred metric factory against a construct and
+     * returns a complete {@link AlarmDefinition}.
+     *
+     * @throws If {@link metric} was not called before resolve.
+     */
+    resolve(construct) {
+        if (!this._metricFactory) {
+            throw new Error(`AlarmDefinitionBuilder "${this._key}": metric() must be called before resolve()`);
+        }
+        const definition = {
+            key: this._key,
+            metric: this._metricFactory(construct),
+            threshold: this._threshold,
+            comparisonOperator: this._comparisonOperator,
+            evaluationPeriods: this._evaluationPeriods,
+            datapointsToAlarm: this._datapointsToAlarm,
+            treatMissingData: this._treatMissingData,
+            description: "",
+        };
+        definition.description =
+            typeof this._description === "function" ? this._description(definition) : this._description;
+        return definition;
+    }
+}
+//# sourceMappingURL=alarm-definition-builder.js.map

package/dist/alarm-definition-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alarm-definition-builder.js","sourceRoot":"","sources":["../src/alarm-definition-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAe,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAG/F;;;;;;;;GAQG;AACH,MAAM,OAAO,sBAAsB;IAChB,IAAI,CAAS;IACtB,cAAc,CAAqC;IACnD,UAAU,GAAG,CAAC,CAAC;IACf,mBAAmB,GAAG,kBAAkB,CAAC,sBAAsB,CAAC;IAChE,kBAAkB,GAAG,CAAC,CAAC;IACvB,kBAAkB,GAAG,CAAC,CAAC;IACvB,iBAAiB,GAAG,gBAAgB,CAAC,aAAa,CAAC;IACnD,YAAY,GAAuD,EAAE,CAAC;IAE9E,YAAY,GAAW;QACrB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IAED,MAAM,CAAC,OAA0C;QAC/C,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,CAAC,KAAa;QACrB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,WAAW;QACT,IAAI,CAAC,mBAAmB,GAAG,kBAAkB,CAAC,sBAAsB,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kBAAkB;QAChB,IAAI,CAAC,mBAAmB,GAAG,kBAAkB,CAAC,kCAAkC,CAAC;QACjF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,mBAAmB,GAAG,kBAAkB,CAAC,mBAAmB,CAAC;QAClE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,eAAe;QACb,IAAI,CAAC,mBAAmB,GAAG,kBAAkB,CAAC,+BAA+B,CAAC;QAC9E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iBAAiB,CAAC,CAAS;QACzB,IAAI,CAAC,kBAAkB,GAAG,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iBAAiB,CAAC,CAAS;QACzB,IAAI,CAAC,kBAAkB,GAAG,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gBAAgB,CAAC,SAA2B;QAC1C,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,WAAW,CAAC,IAAwD;QAClE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,SAAqB;QAC3B,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,2BAA2B,IAAI,CAAC,IAAI,6CAA6C,CAClF,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAoB;YAClC,GAAG,EAAE,IAAI,CAAC,IAAI;YACd,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC;YACtC,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,kBAAkB,EAAE,IAAI,CAAC,mBAAmB;YAC5C,iBAAiB,EAAE,IAAI,CAAC,kBAAkB;YAC1C,iBAAiB,EAAE,IAAI,CAAC,kBAAkB;YAC1C,gBAAgB,EAAE,IAAI,CAAC,iBAAiB;YACxC,WAAW,EAAE,EAAE;SAChB,CAAC;QAEF,UAAU,CAAC,WAAW;YACpB,OAAO,IAAI,CAAC,YAAY,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;QAE9F,OAAO,UAAU,CAAC;IACpB,CAAC;CACF"}

package/dist/alarm-definition.d.ts

@@ -0,0 +1,16 @@
+import type { ComparisonOperator, Metric, TreatMissingData } from "aws-cdk-lib/aws-cloudwatch";
+/**
+ * A fully-resolved alarm descriptor. All fields are required —
+ * this is the canonical form consumed by {@link createAlarms}.
+ */
+export interface AlarmDefinition {
+    key: string;
+    metric: Metric;
+    threshold: number;
+    comparisonOperator: ComparisonOperator;
+    evaluationPeriods: number;
+    datapointsToAlarm: number;
+    treatMissingData: TreatMissingData;
+    description: string;
+}
+//# sourceMappingURL=alarm-definition.d.ts.map

package/dist/alarm-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alarm-definition.d.ts","sourceRoot":"","sources":["../src/alarm-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE/F;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/alarm-definition.js

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

package/dist/alarm-definition.js.map

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

package/dist/create-alarms.d.ts

@@ -0,0 +1,16 @@
+import { Alarm } from "aws-cdk-lib/aws-cloudwatch";
+import type { IConstruct } from "constructs";
+import type { AlarmDefinition } from "./alarm-definition.js";
+/**
+ * Creates CDK {@link Alarm} constructs from fully-resolved {@link AlarmDefinition}s.
+ *
+ * Validates that all definition keys are unique before creating alarms.
+ *
+ * @param scope - CDK construct scope.
+ * @param id - Base identifier; each alarm ID is `${id}${Capitalize(key)}Alarm`.
+ * @param definitions - Fully-resolved alarm definitions.
+ * @returns A record mapping each definition's key to its created Alarm.
+ * @throws If duplicate keys are found in the definitions.
+ */
+export declare function createAlarms(scope: IConstruct, id: string, definitions: AlarmDefinition[]): Record<string, Alarm>;
+//# sourceMappingURL=create-alarms.d.ts.map

package/dist/create-alarms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-alarms.d.ts","sourceRoot":"","sources":["../src/create-alarms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAM7D;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,EACjB,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,eAAe,EAAE,GAC7B,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAqBvB"}

package/dist/create-alarms.js

@@ -0,0 +1,33 @@
+function capitalize(s) {
+    return s[0].toUpperCase() + s.slice(1);
+}
+/**
+ * Creates CDK {@link Alarm} constructs from fully-resolved {@link AlarmDefinition}s.
+ *
+ * Validates that all definition keys are unique before creating alarms.
+ *
+ * @param scope - CDK construct scope.
+ * @param id - Base identifier; each alarm ID is `${id}${Capitalize(key)}Alarm`.
+ * @param definitions - Fully-resolved alarm definitions.
+ * @returns A record mapping each definition's key to its created Alarm.
+ * @throws If duplicate keys are found in the definitions.
+ */
+export function createAlarms(scope, id, definitions) {
+    const alarms = {};
+    for (const def of definitions) {
+        if (def.key in alarms) {
+            throw new Error(`Duplicate alarm key "${def.key}". Custom alarms cannot use the same key as a recommended alarm. ` +
+                `Disable the recommended alarm first, or use a different key.`);
+        }
+        alarms[def.key] = def.metric.createAlarm(scope, `${id}${capitalize(def.key)}Alarm`, {
+            threshold: def.threshold,
+            evaluationPeriods: def.evaluationPeriods,
+            datapointsToAlarm: def.datapointsToAlarm,
+            treatMissingData: def.treatMissingData,
+            comparisonOperator: def.comparisonOperator,
+            alarmDescription: def.description,
+        });
+    }
+    return alarms;
+}
+//# sourceMappingURL=create-alarms.js.map

package/dist/create-alarms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-alarms.js","sourceRoot":"","sources":["../src/create-alarms.ts"],"names":[],"mappings":"AAIA,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAiB,EACjB,EAAU,EACV,WAA8B;IAE9B,MAAM,MAAM,GAA0B,EAAE,CAAC;IAEzC,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,IAAI,GAAG,CAAC,GAAG,IAAI,MAAM,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,wBAAwB,GAAG,CAAC,GAAG,mEAAmE;gBAChG,8DAA8D,CACjE,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE;YAClF,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;YACxC,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;YACxC,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;YACtC,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;YAC1C,gBAAgB,EAAE,GAAG,CAAC,WAAW;SAClC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export type { AlarmConfig } from "./alarm-config.js";
+export type { AlarmDefinition } from "./alarm-definition.js";
+export { AlarmDefinitionBuilder } from "./alarm-definition-builder.js";
+export { createAlarms } from "./create-alarms.js";
+export { resolveAlarmConfig, type ResolvedAlarmConfig } from "./resolve-alarm-config.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { AlarmDefinitionBuilder } from "./alarm-definition-builder.js";
+export { createAlarms } from "./create-alarms.js";
+export { resolveAlarmConfig } from "./resolve-alarm-config.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAA4B,MAAM,2BAA2B,CAAC"}

package/dist/resolve-alarm-config.d.ts

@@ -0,0 +1,19 @@
+import type { TreatMissingData } from "aws-cdk-lib/aws-cloudwatch";
+import type { AlarmConfig } from "./alarm-config.js";
+/**
+ * A fully-resolved alarm configuration where every field is required.
+ * Produced by {@link resolveAlarmConfig} after merging user overrides
+ * onto defaults.
+ */
+export interface ResolvedAlarmConfig {
+    threshold: number;
+    evaluationPeriods: number;
+    datapointsToAlarm: number;
+    treatMissingData: TreatMissingData;
+}
+/**
+ * Resolves an absolute-threshold alarm config by layering user overrides
+ * onto the defaults.
+ */
+export declare function resolveAlarmConfig(userConfig: AlarmConfig | undefined, defaults: Required<AlarmConfig>): ResolvedAlarmConfig;
+//# sourceMappingURL=resolve-alarm-config.d.ts.map

package/dist/resolve-alarm-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-alarm-config.d.ts","sourceRoot":"","sources":["../src/resolve-alarm-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,WAAW,GAAG,SAAS,EACnC,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC9B,mBAAmB,CAOrB"}

package/dist/resolve-alarm-config.js

@@ -0,0 +1,13 @@
+/**
+ * Resolves an absolute-threshold alarm config by layering user overrides
+ * onto the defaults.
+ */
+export function resolveAlarmConfig(userConfig, defaults) {
+    return {
+        threshold: userConfig?.threshold ?? defaults.threshold,
+        evaluationPeriods: userConfig?.evaluationPeriods ?? defaults.evaluationPeriods,
+        datapointsToAlarm: userConfig?.datapointsToAlarm ?? defaults.datapointsToAlarm,
+        treatMissingData: userConfig?.treatMissingData ?? defaults.treatMissingData,
+    };
+}
+//# sourceMappingURL=resolve-alarm-config.js.map

package/dist/resolve-alarm-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-alarm-config.js","sourceRoot":"","sources":["../src/resolve-alarm-config.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAmC,EACnC,QAA+B;IAE/B,OAAO;QACL,SAAS,EAAE,UAAU,EAAE,SAAS,IAAI,QAAQ,CAAC,SAAS;QACtD,iBAAiB,EAAE,UAAU,EAAE,iBAAiB,IAAI,QAAQ,CAAC,iBAAiB;QAC9E,iBAAiB,EAAE,UAAU,EAAE,iBAAiB,IAAI,QAAQ,CAAC,iBAAiB;QAC9E,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,IAAI,QAAQ,CAAC,gBAAgB;KAC5E,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@composurecdk/cloudwatch",
+  "version": "0.3.0",
+  "description": "Composable CloudWatch alarm primitives for composureCDK resource packages",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/laazyj/composureCDK",
+    "directory": "packages/cloudwatch"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  },
+  "keywords": [],
+  "author": "Jason Duffett (https://github.com/laazyj)",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "peerDependencies": {
+    "aws-cdk-lib": "^2.0.0",
+    "constructs": "^10.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "aws-cdk-lib": "^2.245.0",
+    "constructs": "^10.6.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
+  }
+}