checkly 0.0.0-canary.58c867e

package/dist/constructs/frequency.js

@@ -0,0 +1,66 @@
+/**
+ * Represents a check execution frequency with optional offset.
+ * Use the static constants for common scheduling patterns.
+ *
+ * @example
+ * ```typescript
+ * // High-frequency monitoring (every 30 seconds) - API/TCP only
+ * frequency: Frequency.EVERY_30S
+ *
+ * // Standard API monitoring (every 5 minutes)
+ * frequency: Frequency.EVERY_5M
+ *
+ * // Daily health checks (every 24 hours)
+ * frequency: Frequency.EVERY_24H
+ * ```
+ *
+ * @see {@link https://www.checklyhq.com/docs/detect/synthetic-monitoring/overview/ | Monitoring Documentation}
+ */
+export class Frequency {
+    /** Run every 10 seconds */
+    static EVERY_10S = new Frequency(0, 10);
+    /** Run every 20 seconds */
+    static EVERY_20S = new Frequency(0, 20);
+    /** Run every 30 seconds */
+    static EVERY_30S = new Frequency(0, 30);
+    /** Run every 1 minute */
+    static EVERY_1M = new Frequency(1);
+    /** Run every 2 minutes */
+    static EVERY_2M = new Frequency(2);
+    /** Run every 5 minutes */
+    static EVERY_5M = new Frequency(5);
+    /** Run every 10 minutes */
+    static EVERY_10M = new Frequency(10);
+    /** Run every 15 minutes */
+    static EVERY_15M = new Frequency(15);
+    /** Run every 30 minutes */
+    static EVERY_30M = new Frequency(30);
+    /** Run every 1 hour */
+    static EVERY_1H = new Frequency(1 * 60);
+    /** Run every 2 hours */
+    static EVERY_2H = new Frequency(2 * 60);
+    /** Run every 3 hours */
+    static EVERY_3H = new Frequency(3 * 60);
+    /** Run every 6 hours */
+    static EVERY_6H = new Frequency(6 * 60);
+    /** Run every 12 hours */
+    static EVERY_12H = new Frequency(12 * 60);
+    /** Run every 24 hours */
+    static EVERY_24H = new Frequency(24 * 60);
+    /** The frequency in minutes (or 0 for second-based frequencies) */
+    frequency;
+    /** The frequency offset in seconds (used for sub-minute frequencies) */
+    frequencyOffset;
+    /**
+     * Creates a new frequency instance.
+     * Use the static constants instead of creating instances directly.
+     *
+     * @param frequency The frequency in minutes, or 0 for second-based frequencies
+     * @param frequencyOffset The frequency offset in seconds (for sub-minute frequencies)
+     */
+    constructor(frequency, frequencyOffset) {
+        this.frequency = frequency;
+        this.frequencyOffset = frequencyOffset;
+    }
+}
+//# sourceMappingURL=frequency.js.map

package/dist/constructs/frequency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frequency.js","sourceRoot":"","sources":["../../src/constructs/frequency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,SAAS;IACpB,2BAA2B;IAC3B,MAAM,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACvC,2BAA2B;IAC3B,MAAM,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACvC,2BAA2B;IAC3B,MAAM,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAEvC,yBAAyB;IACzB,MAAM,CAAC,QAAQ,GAAG,IAAI,SAAS,CAAC,CAAC,CAAC,CAAA;IAClC,0BAA0B;IAC1B,MAAM,CAAC,QAAQ,GAAG,IAAI,SAAS,CAAC,CAAC,CAAC,CAAA;IAClC,0BAA0B;IAC1B,MAAM,CAAC,QAAQ,GAAG,IAAI,SAAS,CAAC,CAAC,CAAC,CAAA;IAClC,2BAA2B;IAC3B,MAAM,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,EAAE,CAAC,CAAA;IACpC,2BAA2B;IAC3B,MAAM,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,EAAE,CAAC,CAAA;IACpC,2BAA2B;IAC3B,MAAM,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,EAAE,CAAC,CAAA;IAEpC,uBAAuB;IACvB,MAAM,CAAC,QAAQ,GAAG,IAAI,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC,CAAA;IACvC,wBAAwB;IACxB,MAAM,CAAC,QAAQ,GAAG,IAAI,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC,CAAA;IACvC,wBAAwB;IACxB,MAAM,CAAC,QAAQ,GAAG,IAAI,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC,CAAA;IACvC,wBAAwB;IACxB,MAAM,CAAC,QAAQ,GAAG,IAAI,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC,CAAA;IACvC,yBAAyB;IACzB,MAAM,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;IACzC,yBAAyB;IACzB,MAAM,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;IAEzC,mEAAmE;IACnE,SAAS,CAAQ;IACjB,wEAAwE;IACxE,eAAe,CAAS;IAExB;;;;;;OAMG;IACH,YAAqB,SAAiB,EAAE,eAAwB;QAC9D,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,eAAe,GAAG,eAAe,CAAA;IACxC,CAAC"}

package/dist/constructs/heartbeat-monitor-codegen.d.ts

@@ -0,0 +1,11 @@
+import { Codegen, Context } from './internal/codegen/index.js';
+import { MonitorResource } from './monitor-codegen.js';
+import { Heartbeat } from './heartbeat-monitor.js';
+export interface HeartbeatMonitorResource extends MonitorResource {
+    checkType: 'HEARTBEAT';
+    heartbeat: Heartbeat;
+}
+export declare class HeartbeatMonitorCodegen extends Codegen<HeartbeatMonitorResource> {
+    describe(resource: HeartbeatMonitorResource): string;
+    gencode(logicalId: string, resource: HeartbeatMonitorResource, context: Context): void;
+}

package/dist/constructs/heartbeat-monitor-codegen.js

@@ -0,0 +1,29 @@
+import { Codegen } from './internal/codegen/index.js';
+import { expr, ident } from '../sourcegen/index.js';
+import { buildMonitorProps } from './monitor-codegen.js';
+export class HeartbeatMonitorCodegen extends Codegen {
+    describe(resource) {
+        return `Heartbeat Monitor: ${resource.name}`;
+    }
+    gencode(logicalId, resource, context) {
+        const filePath = context.filePath('resources/heartbeat-monitors', resource.name, {
+            tags: resource.tags,
+            unique: true,
+        });
+        const file = this.program.generatedConstructFile(filePath.fullPath);
+        file.namedImport('HeartbeatMonitor', 'checkly/constructs');
+        file.section(expr(ident('HeartbeatMonitor'), builder => {
+            builder.new(builder => {
+                builder.string(logicalId);
+                builder.object(builder => {
+                    builder.number('period', resource.heartbeat.period);
+                    builder.string('periodUnit', resource.heartbeat.periodUnit);
+                    builder.number('grace', resource.heartbeat.grace);
+                    builder.string('graceUnit', resource.heartbeat.graceUnit);
+                    buildMonitorProps(this.program, file, builder, resource, context);
+                });
+            });
+        }));
+    }
+}
+//# sourceMappingURL=heartbeat-monitor-codegen.js.map

package/dist/constructs/heartbeat-monitor-codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-monitor-codegen.js","sourceRoot":"","sources":["../../src/constructs/heartbeat-monitor-codegen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAW,MAAM,6BAA6B,CAAA;AAC9D,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAE,iBAAiB,EAAmB,MAAM,sBAAsB,CAAA;AAQzE,MAAM,OAAO,uBAAwB,SAAQ,OAAiC;IAC5E,QAAQ,CAAE,QAAkC;QAC1C,OAAO,sBAAsB,QAAQ,CAAC,IAAI,EAAE,CAAA;IAC9C,CAAC;IAED,OAAO,CAAE,SAAiB,EAAE,QAAkC,EAAE,OAAgB;QAC9E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,8BAA8B,EAAE,QAAQ,CAAC,IAAI,EAAE;YAC/E,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,MAAM,EAAE,IAAI;SACb,CAAC,CAAA;QAEF,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAEnE,IAAI,CAAC,WAAW,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,CAAA;QAE1D,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC,EAAE;YACrD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;gBACpB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;gBACzB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;oBACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;oBACnD,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;oBAC3D,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;oBACjD,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;oBAEzD,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;gBACnE,CAAC,CAAC,CAAA;YACJ,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAC,CAAA;IACL,CAAC;CACF"}

package/dist/constructs/heartbeat-monitor.d.ts

@@ -0,0 +1,40 @@
+import { Monitor, MonitorProps } from './monitor.js';
+type TimeUnits = 'seconds' | 'minutes' | 'hours' | 'days';
+export interface Heartbeat {
+    /**
+     * The expected period of time between each ping. Between 30 seconds and 365 days.
+     */
+    period: number;
+    /**
+     * The unit of time for the period.
+     */
+    periodUnit: TimeUnits;
+    /**
+     * The grace period to wait for before sending an alert. Between 0 seconds and 365 days.
+     */
+    grace: number;
+    graceUnit: TimeUnits;
+}
+export interface HeartbeatMonitorProps extends MonitorProps {
+    period: number;
+    periodUnit: TimeUnits;
+    grace: number;
+    graceUnit: TimeUnits;
+}
+/**
+ * Creates a Heartbeat Monitor
+ */
+export declare class HeartbeatMonitor extends Monitor {
+    heartbeat: Heartbeat;
+    /**
+     * Constructs the Heartbeat Monitor instance
+     *
+     * @param logicalId unique project-scoped resource name identification
+     * @param props configuration properties
+     * {@link https://www.checklyhq.com/docs/constructs/heartbeat-monitor/ Read more in the docs}
+     */
+    constructor(logicalId: string, props: HeartbeatMonitorProps);
+    describe(): string;
+    synthesize(): any | null;
+}
+export { HeartbeatMonitorProps as HeartbeatCheckProps, HeartbeatMonitor as HeartbeatCheck, };

package/dist/constructs/heartbeat-monitor.js

@@ -0,0 +1,56 @@
+import { Monitor } from './monitor.js';
+import { Session } from './session.js';
+import { DateTime } from 'luxon';
+import { CheckTypes } from '../constants.js';
+function _customPeriodGraceValidation(heartbeat) {
+    const now = DateTime.now();
+    const addedTimePeriod = now.plus({ [heartbeat.periodUnit]: heartbeat.period });
+    const addedGracePeriod = now.plus({ [heartbeat.graceUnit]: heartbeat.grace });
+    const MAX_PERIOD_GRACE_DAYS = 365;
+    const MIN_PERIOD_SECONDS = 30;
+    if (addedTimePeriod.diff(now, 'days').days > MAX_PERIOD_GRACE_DAYS
+        || addedTimePeriod.diff(now, 'seconds').seconds < MIN_PERIOD_SECONDS) {
+        throw new Error('Period must be between 30 seconds and 365 days.');
+    }
+    if (addedGracePeriod.diff(now, 'days').days > MAX_PERIOD_GRACE_DAYS) {
+        throw new Error('Grace must be less than 366 days.');
+    }
+}
+/**
+ * Creates a Heartbeat Monitor
+ */
+export class HeartbeatMonitor extends Monitor {
+    heartbeat;
+    /**
+     * Constructs the Heartbeat Monitor instance
+     *
+     * @param logicalId unique project-scoped resource name identification
+     * @param props configuration properties
+     * {@link https://www.checklyhq.com/docs/constructs/heartbeat-monitor/ Read more in the docs}
+     */
+    constructor(logicalId, props) {
+        super(logicalId, props);
+        _customPeriodGraceValidation(props);
+        this.heartbeat = {
+            period: props.period,
+            periodUnit: props.periodUnit,
+            grace: props.grace,
+            graceUnit: props.graceUnit,
+        };
+        Session.registerConstruct(this);
+        this.addSubscriptions();
+    }
+    describe() {
+        return `HeartbeatMonitor:${this.logicalId}`;
+    }
+    synthesize() {
+        return {
+            ...super.synthesize(),
+            checkType: CheckTypes.HEARTBEAT,
+            heartbeat: this.heartbeat,
+        };
+    }
+}
+// Aliases for backwards compatibility.
+export { HeartbeatMonitor as HeartbeatCheck, };
+//# sourceMappingURL=heartbeat-monitor.js.map

package/dist/constructs/heartbeat-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-monitor.js","sourceRoot":"","sources":["../../src/constructs/heartbeat-monitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAgB,MAAM,cAAc,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AA8B5C,SAAS,4BAA4B,CAAE,SAAoB;IACzD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAA;IAC1B,MAAM,eAAe,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,CAAA;IAC9E,MAAM,gBAAgB,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAA;IAE7E,MAAM,qBAAqB,GAAG,GAAG,CAAA;IACjC,MAAM,kBAAkB,GAAG,EAAE,CAAA;IAE7B,IACE,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,IAAI,GAAG,qBAAqB;WAC3D,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,OAAO,GAAG,kBAAkB,EACpE,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;IACpE,CAAC;IAED,IAAI,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,IAAI,GAAG,qBAAqB,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;IACtD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,OAAO;IAC3C,SAAS,CAAW;IAEpB;;;;;;OAMG;IACH,YAAa,SAAiB,EAAE,KAA4B;QAC1D,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;QAEvB,4BAA4B,CAAC,KAAK,CAAC,CAAA;QACnC,IAAI,CAAC,SAAS,GAAG;YACf,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAA;QAED,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAA;QAC/B,IAAI,CAAC,gBAAgB,EAAE,CAAA;IACzB,CAAC;IAED,QAAQ;QACN,OAAO,oBAAoB,IAAI,CAAC,SAAS,EAAE,CAAA;IAC7C,CAAC;IAED,UAAU;QACR,OAAO;YACL,GAAG,KAAK,CAAC,UAAU,EAAE;YACrB,SAAS,EAAE,UAAU,CAAC,SAAS;YAC/B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAA;IACH,CAAC;CACF;AAED,uCAAuC;AACvC,OAAO,EAEL,gBAAgB,IAAI,cAAc,GACnC,CAAA"}

package/dist/constructs/http-header.d.ts

@@ -0,0 +1,18 @@
+import KeyValuePair from './key-value-pair.js';
+/**
+ * Represents an HTTP header for API checks.
+ *
+ * @example
+ * ```typescript
+ * const authHeader: HttpHeader = {
+ *   key: 'Authorization',
+ *   value: 'Bearer {{API_TOKEN}}'
+ * }
+ *
+ * const contentTypeHeader: HttpHeader = {
+ *   key: 'Content-Type',
+ *   value: 'application/json'
+ * }
+ * ```
+ */
+export type HttpHeader = KeyValuePair;

package/dist/constructs/http-header.js

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

package/dist/constructs/http-header.js.map

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

package/dist/constructs/http-request.d.ts

@@ -0,0 +1,2 @@
+/** HTTP request methods supported by API checks */
+export type HttpRequestMethod = 'get' | 'GET' | 'post' | 'POST' | 'put' | 'PUT' | 'patch' | 'PATCH' | 'head' | 'HEAD' | 'delete' | 'DELETE' | 'options' | 'OPTIONS';

package/dist/constructs/http-request.js

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

package/dist/constructs/http-request.js.map

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

package/dist/constructs/icmp-assertion-codegen.d.ts

@@ -0,0 +1,3 @@
+import { GeneratedFile, Value } from '../sourcegen/index.js';
+import { IcmpAssertion } from './icmp-assertion.js';
+export declare function valueForIcmpAssertion(genfile: GeneratedFile, assertion: IcmpAssertion): Value;

package/dist/constructs/icmp-assertion-codegen.js

@@ -0,0 +1,18 @@
+import { valueForGeneralAssertion, valueForNumericAssertion } from './internal/assertion-codegen.js';
+export function valueForIcmpAssertion(genfile, assertion) {
+    genfile.namedImport('IcmpAssertionBuilder', 'checkly/constructs');
+    switch (assertion.source) {
+        case 'LATENCY':
+            return valueForNumericAssertion('IcmpAssertionBuilder', 'latency', assertion, {
+                hasProperty: true,
+            });
+        case 'JSON_RESPONSE':
+            return valueForGeneralAssertion('IcmpAssertionBuilder', 'jsonResponse', assertion, {
+                hasProperty: true,
+                hasRegex: false,
+            });
+        default:
+            throw new Error(`Unsupported ICMP assertion source ${assertion.source}`);
+    }
+}
+//# sourceMappingURL=icmp-assertion-codegen.js.map

package/dist/constructs/icmp-assertion-codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icmp-assertion-codegen.js","sourceRoot":"","sources":["../../src/constructs/icmp-assertion-codegen.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAA;AAGpG,MAAM,UAAU,qBAAqB,CAAE,OAAsB,EAAE,SAAwB;IACrF,OAAO,CAAC,WAAW,CAAC,sBAAsB,EAAE,oBAAoB,CAAC,CAAA;IAEjE,QAAQ,SAAS,CAAC,MAAM,EAAE,CAAC;QACzB,KAAK,SAAS;YACZ,OAAO,wBAAwB,CAAC,sBAAsB,EAAE,SAAS,EAAE,SAAS,EAAE;gBAC5E,WAAW,EAAE,IAAI;aAClB,CAAC,CAAA;QACJ,KAAK,eAAe;YAClB,OAAO,wBAAwB,CAAC,sBAAsB,EAAE,cAAc,EAAE,SAAS,EAAE;gBACjF,WAAW,EAAE,IAAI;gBACjB,QAAQ,EAAE,KAAK;aAChB,CAAC,CAAA;QACJ;YACE,MAAM,IAAI,KAAK,CAAC,qCAAqC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAA;IAC5E,CAAC;AACH,CAAC"}

package/dist/constructs/icmp-assertion.d.ts

@@ -0,0 +1,56 @@
+import { Assertion as CoreAssertion, NumericAssertionBuilder, GeneralAssertionBuilder } from './internal/assertion.js';
+type IcmpAssertionSource = 'LATENCY' | 'JSON_RESPONSE';
+export type IcmpAssertion = CoreAssertion<IcmpAssertionSource>;
+export type IcmpLatencyProperty = 'avg' | 'min' | 'max' | 'stdDev';
+/**
+ * Builder class for creating ICMP monitor assertions.
+ * Provides methods to create assertions for ICMP ping responses.
+ *
+ * @example
+ * ```typescript
+ * // Latency assertions
+ * IcmpAssertionBuilder.latency('avg').lessThan(100)
+ * IcmpAssertionBuilder.latency('max').lessThan(200)
+ * IcmpAssertionBuilder.latency('stdDev').lessThan(50)
+ *
+ * // JSON response assertions
+ * IcmpAssertionBuilder.jsonResponse('$.packetLoss').lessThan(10)
+ * IcmpAssertionBuilder.jsonResponse('$.packetsReceived').greaterThan(8)
+ * ```
+ */
+export declare class IcmpAssertionBuilder {
+    /**
+     * Creates an assertion builder for ICMP latency metrics.
+     * @param property The latency property to assert against:
+     *   - `avg`: Average round-trip time in milliseconds
+     *   - `min`: Minimum round-trip time in milliseconds
+     *   - `max`: Maximum round-trip time in milliseconds
+     *   - `stdDev`: Standard deviation of round-trip times
+     * @returns A numeric assertion builder for the specified latency metric.
+     */
+    static latency(property: IcmpLatencyProperty): NumericAssertionBuilder<IcmpAssertionSource, IcmpLatencyProperty>;
+    /**
+     * Creates an assertion builder for the JSON formatted response.
+     * Use JSONPath expressions to access specific response fields.
+     *
+     * Available fields include:
+     * - `$.hostname`: The target host that was pinged
+     * - `$.resolvedIp`: The resolved IP address (if host was a domain name)
+     * - `$.ipFamily`: IP family used ('IPv4' or 'IPv6')
+     * - `$.pingCount`: Number of pings configured
+     * - `$.packetsSent`: Number of ICMP echo requests sent
+     * - `$.packetsReceived`: Number of ICMP echo replies received
+     * - `$.packetLoss`: Percentage of packets lost (0-100)
+     * - `$.latency.avg`: Average round-trip time in milliseconds
+     * - `$.latency.min`: Minimum round-trip time in milliseconds
+     * - `$.latency.max`: Maximum round-trip time in milliseconds
+     * - `$.latency.stdDev`: Standard deviation of round-trip times
+     * - `$.pingResults[*].rtt`: Round-trip time for each ping
+     * - `$.pingResults[*].ttl`: Time-to-live for each ping
+     *
+     * @param property Optional JSONPath to specific property (e.g., '$.packetLoss')
+     * @returns A general assertion builder for the JSON formatted response.
+     */
+    static jsonResponse(property?: string): GeneralAssertionBuilder<IcmpAssertionSource>;
+}
+export {};

package/dist/constructs/icmp-assertion.js

@@ -0,0 +1,57 @@
+import { NumericAssertionBuilder, GeneralAssertionBuilder } from './internal/assertion.js';
+/**
+ * Builder class for creating ICMP monitor assertions.
+ * Provides methods to create assertions for ICMP ping responses.
+ *
+ * @example
+ * ```typescript
+ * // Latency assertions
+ * IcmpAssertionBuilder.latency('avg').lessThan(100)
+ * IcmpAssertionBuilder.latency('max').lessThan(200)
+ * IcmpAssertionBuilder.latency('stdDev').lessThan(50)
+ *
+ * // JSON response assertions
+ * IcmpAssertionBuilder.jsonResponse('$.packetLoss').lessThan(10)
+ * IcmpAssertionBuilder.jsonResponse('$.packetsReceived').greaterThan(8)
+ * ```
+ */
+export class IcmpAssertionBuilder {
+    /**
+     * Creates an assertion builder for ICMP latency metrics.
+     * @param property The latency property to assert against:
+     *   - `avg`: Average round-trip time in milliseconds
+     *   - `min`: Minimum round-trip time in milliseconds
+     *   - `max`: Maximum round-trip time in milliseconds
+     *   - `stdDev`: Standard deviation of round-trip times
+     * @returns A numeric assertion builder for the specified latency metric.
+     */
+    static latency(property) {
+        return new NumericAssertionBuilder('LATENCY', property);
+    }
+    /**
+     * Creates an assertion builder for the JSON formatted response.
+     * Use JSONPath expressions to access specific response fields.
+     *
+     * Available fields include:
+     * - `$.hostname`: The target host that was pinged
+     * - `$.resolvedIp`: The resolved IP address (if host was a domain name)
+     * - `$.ipFamily`: IP family used ('IPv4' or 'IPv6')
+     * - `$.pingCount`: Number of pings configured
+     * - `$.packetsSent`: Number of ICMP echo requests sent
+     * - `$.packetsReceived`: Number of ICMP echo replies received
+     * - `$.packetLoss`: Percentage of packets lost (0-100)
+     * - `$.latency.avg`: Average round-trip time in milliseconds
+     * - `$.latency.min`: Minimum round-trip time in milliseconds
+     * - `$.latency.max`: Maximum round-trip time in milliseconds
+     * - `$.latency.stdDev`: Standard deviation of round-trip times
+     * - `$.pingResults[*].rtt`: Round-trip time for each ping
+     * - `$.pingResults[*].ttl`: Time-to-live for each ping
+     *
+     * @param property Optional JSONPath to specific property (e.g., '$.packetLoss')
+     * @returns A general assertion builder for the JSON formatted response.
+     */
+    static jsonResponse(property) {
+        return new GeneralAssertionBuilder('JSON_RESPONSE', property);
+    }
+}
+//# sourceMappingURL=icmp-assertion.js.map

package/dist/constructs/icmp-assertion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icmp-assertion.js","sourceRoot":"","sources":["../../src/constructs/icmp-assertion.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AAUtH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,oBAAoB;IAC/B;;;;;;;;OAQG;IACH,MAAM,CAAC,OAAO,CAAE,QAA6B;QAC3C,OAAO,IAAI,uBAAuB,CAA2C,SAAS,EAAE,QAAQ,CAAC,CAAA;IACnG,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,YAAY,CAAE,QAAiB;QACpC,OAAO,IAAI,uBAAuB,CAAsB,eAAe,EAAE,QAAQ,CAAC,CAAA;IACpF,CAAC;CACF"}

package/dist/constructs/icmp-monitor-codegen.d.ts

@@ -0,0 +1,13 @@
+import { Codegen, Context } from './internal/codegen/index.js';
+import { MonitorResource } from './monitor-codegen.js';
+import { IcmpRequest } from './icmp-request.js';
+export interface IcmpMonitorResource extends MonitorResource {
+    checkType: 'ICMP';
+    request: IcmpRequest;
+    degradedPacketLossThreshold?: number;
+    maxPacketLossThreshold?: number;
+}
+export declare class IcmpMonitorCodegen extends Codegen<IcmpMonitorResource> {
+    describe(resource: IcmpMonitorResource): string;
+    gencode(logicalId: string, resource: IcmpMonitorResource, context: Context): void;
+}

package/dist/constructs/icmp-monitor-codegen.js

@@ -0,0 +1,34 @@
+import { Codegen } from './internal/codegen/index.js';
+import { expr, ident } from '../sourcegen/index.js';
+import { buildMonitorProps } from './monitor-codegen.js';
+import { valueForIcmpRequest } from './icmp-request-codegen.js';
+const construct = 'IcmpMonitor';
+export class IcmpMonitorCodegen extends Codegen {
+    describe(resource) {
+        return `ICMP Monitor: ${resource.name}`;
+    }
+    gencode(logicalId, resource, context) {
+        const filePath = context.filePath('resources/icmp-monitors', resource.name, {
+            tags: resource.tags,
+            unique: true,
+        });
+        const file = this.program.generatedConstructFile(filePath.fullPath);
+        file.namedImport(construct, 'checkly/constructs');
+        file.section(expr(ident(construct), builder => {
+            builder.new(builder => {
+                builder.string(logicalId);
+                builder.object(builder => {
+                    builder.value('request', valueForIcmpRequest(this.program, file, context, resource.request));
+                    if (resource.degradedPacketLossThreshold !== undefined) {
+                        builder.number('degradedPacketLossThreshold', resource.degradedPacketLossThreshold);
+                    }
+                    if (resource.maxPacketLossThreshold !== undefined) {
+                        builder.number('maxPacketLossThreshold', resource.maxPacketLossThreshold);
+                    }
+                    buildMonitorProps(this.program, file, builder, resource, context);
+                });
+            });
+        }));
+    }
+}
+//# sourceMappingURL=icmp-monitor-codegen.js.map

package/dist/constructs/icmp-monitor-codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icmp-monitor-codegen.js","sourceRoot":"","sources":["../../src/constructs/icmp-monitor-codegen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAW,MAAM,6BAA6B,CAAA;AAC9D,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAE,iBAAiB,EAAmB,MAAM,sBAAsB,CAAA;AAEzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAS/D,MAAM,SAAS,GAAG,aAAa,CAAA;AAE/B,MAAM,OAAO,kBAAmB,SAAQ,OAA4B;IAClE,QAAQ,CAAE,QAA6B;QACrC,OAAO,iBAAiB,QAAQ,CAAC,IAAI,EAAE,CAAA;IACzC,CAAC;IAED,OAAO,CAAE,SAAiB,EAAE,QAA6B,EAAE,OAAgB;QACzE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,yBAAyB,EAAE,QAAQ,CAAC,IAAI,EAAE;YAC1E,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,MAAM,EAAE,IAAI;SACb,CAAC,CAAA;QAEF,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAEnE,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAA;QAEjD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,EAAE;YAC5C,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;gBACpB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;gBACzB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;oBACvB,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;oBAE5F,IAAI,QAAQ,CAAC,2BAA2B,KAAK,SAAS,EAAE,CAAC;wBACvD,OAAO,CAAC,MAAM,CAAC,6BAA6B,EAAE,QAAQ,CAAC,2BAA2B,CAAC,CAAA;oBACrF,CAAC;oBAED,IAAI,QAAQ,CAAC,sBAAsB,KAAK,SAAS,EAAE,CAAC;wBAClD,OAAO,CAAC,MAAM,CAAC,wBAAwB,EAAE,QAAQ,CAAC,sBAAsB,CAAC,CAAA;oBAC3E,CAAC;oBAED,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;gBACnE,CAAC,CAAC,CAAA;YACJ,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAC,CAAA;IACL,CAAC;CACF"}

package/dist/constructs/icmp-monitor.d.ts

@@ -0,0 +1,83 @@
+import { Monitor, MonitorProps } from './monitor.js';
+import { Diagnostics } from './diagnostics.js';
+import { IcmpRequest } from './icmp-request.js';
+export interface IcmpMonitorProps extends MonitorProps {
+    /**
+     * Determines the request that the monitor is going to run.
+     */
+    request: IcmpRequest;
+    /**
+     * The percentage of packet loss where the monitor should be considered
+     * degraded.
+     *
+     * @defaultValue 10
+     * @minimum 0
+     * @maximum 100
+     * @example
+     * ```typescript
+     * degradedPacketLossThreshold: 10  // Alert when 10% or more packets are lost
+     * ```
+     */
+    degradedPacketLossThreshold?: number;
+    /**
+     * The percentage of packet loss where the monitor should be considered
+     * failing.
+     *
+     * @defaultValue 20
+     * @minimum 0
+     * @maximum 100
+     * @example
+     * ```typescript
+     * maxPacketLossThreshold: 20  // Fail if 20% or more packets are lost
+     * ```
+     */
+    maxPacketLossThreshold?: number;
+}
+/**
+ * Creates an ICMP Monitor
+ */
+export declare class IcmpMonitor extends Monitor {
+    request: IcmpRequest;
+    degradedPacketLossThreshold?: number;
+    maxPacketLossThreshold?: number;
+    /**
+     * Constructs the ICMP Monitor instance
+     *
+     * @param logicalId unique project-scoped resource name identification
+     * @param props configuration properties
+     *
+     * {@link https://www.checklyhq.com/docs/constructs/icmp-monitor/ Read more in the docs}
+     */
+    constructor(logicalId: string, props: IcmpMonitorProps);
+    describe(): string;
+    validate(diagnostics: Diagnostics): Promise<void>;
+    synthesize(): {
+        checkType: string;
+        request: IcmpRequest;
+        degradedPacketLossThreshold: number | undefined;
+        maxPacketLossThreshold: number | undefined;
+        doubleCheck: boolean;
+        activated: boolean | undefined;
+        muted: boolean | undefined;
+        shouldFail: boolean | undefined;
+        locations: (keyof import("../index.js").Region)[] | undefined;
+        privateLocations: undefined;
+        tags: string[] | undefined;
+        frequency: number | undefined;
+        frequencyOffset: number | undefined;
+        groupId: import("./ref.js").Ref | null;
+        retryStrategy: import("./retry-strategy.js").LinearRetryStrategy | import("./retry-strategy.js").ExponentialRetryStrategy | import("./retry-strategy.js").FixedRetryStrategy | import("./retry-strategy.js").SingleRetryRetryStrategy | null | undefined;
+        alertSettings: import("./alert-escalation-policy.js").AlertEscalation | undefined;
+        useGlobalAlertSettings: boolean | undefined;
+        runParallel: boolean | undefined;
+        triggerIncident: {
+            serviceId: import("./ref.js").Ref;
+            severity: "MINOR" | "MEDIUM" | "MAJOR" | "CRITICAL";
+            name: string;
+            description: string;
+            notifySubscribers: boolean;
+        } | undefined;
+        description?: string | undefined;
+        name: string;
+    };
+}

package/dist/constructs/icmp-monitor.js

@@ -0,0 +1,43 @@
+import { Monitor } from './monitor.js';
+import { Session } from './session.js';
+/**
+ * Creates an ICMP Monitor
+ */
+export class IcmpMonitor extends Monitor {
+    request;
+    degradedPacketLossThreshold;
+    maxPacketLossThreshold;
+    /**
+     * Constructs the ICMP Monitor instance
+     *
+     * @param logicalId unique project-scoped resource name identification
+     * @param props configuration properties
+     *
+     * {@link https://www.checklyhq.com/docs/constructs/icmp-monitor/ Read more in the docs}
+     */
+    constructor(logicalId, props) {
+        super(logicalId, props);
+        this.request = props.request;
+        this.degradedPacketLossThreshold = props.degradedPacketLossThreshold;
+        this.maxPacketLossThreshold = props.maxPacketLossThreshold;
+        Session.registerConstruct(this);
+        this.addSubscriptions();
+        this.addPrivateLocationCheckAssignments();
+    }
+    describe() {
+        return `IcmpMonitor:${this.logicalId}`;
+    }
+    async validate(diagnostics) {
+        await super.validate(diagnostics);
+    }
+    synthesize() {
+        return {
+            ...super.synthesize(),
+            checkType: 'ICMP',
+            request: this.request,
+            degradedPacketLossThreshold: this.degradedPacketLossThreshold,
+            maxPacketLossThreshold: this.maxPacketLossThreshold,
+        };
+    }
+}
+//# sourceMappingURL=icmp-monitor.js.map

package/dist/constructs/icmp-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icmp-monitor.js","sourceRoot":"","sources":["../../src/constructs/icmp-monitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAgB,MAAM,cAAc,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAuCtC;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,OAAO;IACtC,OAAO,CAAa;IACpB,2BAA2B,CAAS;IACpC,sBAAsB,CAAS;IAE/B;;;;;;;OAOG;IAEH,YAAa,SAAiB,EAAE,KAAuB;QACrD,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;QAEvB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA;QAC5B,IAAI,CAAC,2BAA2B,GAAG,KAAK,CAAC,2BAA2B,CAAA;QACpE,IAAI,CAAC,sBAAsB,GAAG,KAAK,CAAC,sBAAsB,CAAA;QAE1D,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAA;QAC/B,IAAI,CAAC,gBAAgB,EAAE,CAAA;QACvB,IAAI,CAAC,kCAAkC,EAAE,CAAA;IAC3C,CAAC;IAED,QAAQ;QACN,OAAO,eAAe,IAAI,CAAC,SAAS,EAAE,CAAA;IACxC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAE,WAAwB;QACtC,MAAM,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;IACnC,CAAC;IAED,UAAU;QACR,OAAO;YACL,GAAG,KAAK,CAAC,UAAU,EAAE;YACrB,SAAS,EAAE,MAAM;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,2BAA2B,EAAE,IAAI,CAAC,2BAA2B;YAC7D,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;SACpD,CAAA;IACH,CAAC;CACF"}

package/dist/constructs/icmp-request-codegen.d.ts

@@ -0,0 +1,4 @@
+import { GeneratedFile, Program, Value } from '../sourcegen/index.js';
+import { IcmpRequest } from './icmp-request.js';
+import { Context } from './internal/codegen/index.js';
+export declare function valueForIcmpRequest(program: Program, genfile: GeneratedFile, context: Context, request: IcmpRequest): Value;

package/dist/constructs/icmp-request-codegen.js

@@ -0,0 +1,24 @@
+import { object } from '../sourcegen/index.js';
+import { valueForIcmpAssertion } from './icmp-assertion-codegen.js';
+export function valueForIcmpRequest(program, genfile, context, request) {
+    return object(builder => {
+        builder.string('hostname', request.hostname);
+        if (request.ipFamily && request.ipFamily !== 'IPv4') {
+            builder.string('ipFamily', request.ipFamily);
+        }
+        if (request.pingCount !== undefined) {
+            builder.number('pingCount', request.pingCount);
+        }
+        if (request.assertions) {
+            const assertions = request.assertions;
+            if (assertions.length > 0) {
+                builder.array('assertions', builder => {
+                    for (const assertion of assertions) {
+                        builder.value(valueForIcmpAssertion(genfile, assertion));
+                    }
+                });
+            }
+        }
+    });
+}
+//# sourceMappingURL=icmp-request-codegen.js.map

package/dist/constructs/icmp-request-codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icmp-request-codegen.js","sourceRoot":"","sources":["../../src/constructs/icmp-request-codegen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,MAAM,EAAkB,MAAM,uBAAuB,CAAA;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AAInE,MAAM,UAAU,mBAAmB,CACjC,OAAgB,EAChB,OAAsB,EACtB,OAAgB,EAChB,OAAoB;IAEpB,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE;QACtB,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;QAE5C,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YACpD,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;QAC9C,CAAC;QAED,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACpC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;QAChD,CAAC;QAED,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAA;YACrC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE;oBACpC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;wBACnC,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAA;oBAC1D,CAAC;gBACH,CAAC,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}