checkly 8.14.1 → 8.15.0

package/dist/constructs/traceroute-assertion-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceroute-assertion-validation.js","sourceRoot":"","sources":["../../src/constructs/traceroute-assertion-validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAGvF,mFAAmF;AACnF,sFAAsF;AACtF,uDAAuD;AACvD,MAAM,sBAAsB,GAAiD;IAC3E,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,MAAM,EAAE,IAAI;CACb,CAAA;AAED,MAAM,gBAAgB,GAAgD;IACpE,aAAa,EAAE,IAAI;IACnB,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,IAAI;CAClB,CAAA;AAED,iFAAiF;AACjF,+EAA+E;AAC/E,MAAM,uBAAuB,GAAyB;IACpD,MAAM,EAAE,IAAI;IACZ,UAAU,EAAE,IAAI;IAChB,YAAY,EAAE,IAAI;IAClB,SAAS,EAAE,IAAI;CAChB,CAAA;AAED,MAAM,kBAAkB,GAAyB;IAC/C,MAAM,EAAE,IAAI;IACZ,YAAY,EAAE,IAAI;IAClB,SAAS,EAAE,IAAI;CAChB,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,2BAA2B,CACzC,WAAwB,EACxB,SAA8B,EAC9B,KAAa;IAEb,MAAM,QAAQ,GAAG,sBAAsB,KAAK,GAAG,CAAA;IAE/C,QAAQ,SAAS,CAAC,MAAM,EAAE,CAAC;QACzB,KAAK,eAAe;YAClB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,sBAAsB,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/D,sBAAsB,CAAC,WAAW,EAChC,mCAAmC,QAAQ,4BAA4B;sBACrE,GAAG,SAAS,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,QAAQ,GAAG,IAAI;sBACvE,mBAAmB,UAAU,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAA;YAC/D,CAAC;YACD,kBAAkB,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,uBAAuB,CAAC,CAAA;YAC7E,MAAK;QACP,KAAK,WAAW,CAAC;QACf,gBAAgB;QAClB,KAAK,aAAa;YAChB,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;gBACvB,sBAAsB,CAAC,WAAW,EAChC,OAAO,SAAS,CAAC,MAAM,kBAAkB,QAAQ,iCAAiC;sBAChF,YAAY,SAAS,CAAC,QAAQ,IAAI,CAAC,CAAA;YACzC,CAAC;YACD,kBAAkB,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAA;YACxE,MAAK;QACP;YACE,sBAAsB,CAAC,WAAW,EAChC,qBAAqB,QAAQ,4BAA4B,SAAS,CAAC,MAAM,KAAK;kBAC5E,mBAAmB,UAAU,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAA;YACvD,kFAAkF;YAClF,iFAAiF;YACjF,oFAAoF;YACpF,SAAS,CAAC,MAAsB,CAAA;YAChC,MAAK;IACT,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,mFAAmF;AACnF,wBAAwB;AACxB,SAAS,kBAAkB,CACzB,WAAwB,EACxB,SAA8B,EAC9B,QAAgB,EAChB,OAA6B;IAE7B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;QAClD,sBAAsB,CAAC,WAAW,EAChC,OAAO,SAAS,CAAC,MAAM,kBAAkB,QAAQ,kCAAkC;cACjF,GAAG,SAAS,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,UAAU,GAAG,IAAI;cAC3E,mBAAmB,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAChD,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,67 @@
+import { Assertion as CoreAssertion } from './internal/assertion.js';
+type TracerouteAssertionSource = 'RESPONSE_TIME' | 'HOP_COUNT' | 'PACKET_LOSS';
+export type TracerouteAssertion = CoreAssertion<TracerouteAssertionSource>;
+export type TracerouteResponseTimeProperty = 'avg' | 'min' | 'max' | 'stdDev';
+/** Response time for a statistical property — accepts the full numeric operator set. */
+declare class ResponseTimeAssertionBuilder {
+    private property;
+    constructor(property: TracerouteResponseTimeProperty);
+    equals(target: number): TracerouteAssertion;
+    notEquals(target: number): TracerouteAssertion;
+    lessThan(target: number): TracerouteAssertion;
+    greaterThan(target: number): TracerouteAssertion;
+}
+/** Number of network hops — accepts EQUALS / LESS_THAN / GREATER_THAN (not NOT_EQUALS). */
+declare class HopCountAssertionBuilder {
+    equals(target: number): TracerouteAssertion;
+    lessThan(target: number): TracerouteAssertion;
+    greaterThan(target: number): TracerouteAssertion;
+}
+/** Packet loss percentage (0-100) — accepts EQUALS / LESS_THAN / GREATER_THAN (not NOT_EQUALS). */
+declare class PacketLossAssertionBuilder {
+    equals(target: number): TracerouteAssertion;
+    lessThan(target: number): TracerouteAssertion;
+    greaterThan(target: number): TracerouteAssertion;
+}
+/**
+ * Builder class for creating traceroute monitor assertions.
+ * Provides methods to create assertions for traceroute probe responses.
+ *
+ * @example
+ * ```typescript
+ * // Response time assertions
+ * TracerouteAssertionBuilder.responseTime().lessThan(1000)
+ * TracerouteAssertionBuilder.responseTime('avg').lessThan(1000)
+ * TracerouteAssertionBuilder.responseTime('max').lessThan(2000)
+ * TracerouteAssertionBuilder.responseTime('stdDev').lessThan(50)
+ *
+ * // Hop count assertions
+ * TracerouteAssertionBuilder.hopCount().lessThan(20)
+ *
+ * // Packet loss assertions (percentage, 0-100)
+ * TracerouteAssertionBuilder.packetLoss().lessThan(10)
+ * ```
+ */
+export declare class TracerouteAssertionBuilder {
+    /**
+     * Creates an assertion builder for traceroute response time metrics.
+     * @param property The response time property to assert against. Defaults to `avg`.
+     *   - `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 response time metric.
+     */
+    static responseTime(property?: TracerouteResponseTimeProperty): ResponseTimeAssertionBuilder;
+    /**
+     * Creates an assertion builder for the number of network hops.
+     * @returns A numeric assertion builder for the hop count.
+     */
+    static hopCount(): HopCountAssertionBuilder;
+    /**
+     * Creates an assertion builder for the percentage of packet loss (0-100).
+     * @returns A numeric assertion builder for packet loss.
+     */
+    static packetLoss(): PacketLossAssertionBuilder;
+}
+export {};

package/dist/constructs/traceroute-assertion.js

@@ -0,0 +1,96 @@
+import { toAssertion } from './internal/assertion.js';
+// One builder class per source, each exposing only the operators the backend accepts
+// for that source. The classes are stateless — the source (and, for response time, the
+// statistical property) is baked into each `toAssertion` call — and are not exported:
+// they are reachable only through `TracerouteAssertionBuilder`.
+/** Response time for a statistical property — accepts the full numeric operator set. */
+class ResponseTimeAssertionBuilder {
+    property;
+    constructor(property) {
+        this.property = property;
+    }
+    equals(target) {
+        return toAssertion('RESPONSE_TIME', 'EQUALS', target, this.property);
+    }
+    notEquals(target) {
+        return toAssertion('RESPONSE_TIME', 'NOT_EQUALS', target, this.property);
+    }
+    lessThan(target) {
+        return toAssertion('RESPONSE_TIME', 'LESS_THAN', target, this.property);
+    }
+    greaterThan(target) {
+        return toAssertion('RESPONSE_TIME', 'GREATER_THAN', target, this.property);
+    }
+}
+/** Number of network hops — accepts EQUALS / LESS_THAN / GREATER_THAN (not NOT_EQUALS). */
+class HopCountAssertionBuilder {
+    equals(target) {
+        return toAssertion('HOP_COUNT', 'EQUALS', target);
+    }
+    lessThan(target) {
+        return toAssertion('HOP_COUNT', 'LESS_THAN', target);
+    }
+    greaterThan(target) {
+        return toAssertion('HOP_COUNT', 'GREATER_THAN', target);
+    }
+}
+/** Packet loss percentage (0-100) — accepts EQUALS / LESS_THAN / GREATER_THAN (not NOT_EQUALS). */
+class PacketLossAssertionBuilder {
+    equals(target) {
+        return toAssertion('PACKET_LOSS', 'EQUALS', target);
+    }
+    lessThan(target) {
+        return toAssertion('PACKET_LOSS', 'LESS_THAN', target);
+    }
+    greaterThan(target) {
+        return toAssertion('PACKET_LOSS', 'GREATER_THAN', target);
+    }
+}
+/**
+ * Builder class for creating traceroute monitor assertions.
+ * Provides methods to create assertions for traceroute probe responses.
+ *
+ * @example
+ * ```typescript
+ * // Response time assertions
+ * TracerouteAssertionBuilder.responseTime().lessThan(1000)
+ * TracerouteAssertionBuilder.responseTime('avg').lessThan(1000)
+ * TracerouteAssertionBuilder.responseTime('max').lessThan(2000)
+ * TracerouteAssertionBuilder.responseTime('stdDev').lessThan(50)
+ *
+ * // Hop count assertions
+ * TracerouteAssertionBuilder.hopCount().lessThan(20)
+ *
+ * // Packet loss assertions (percentage, 0-100)
+ * TracerouteAssertionBuilder.packetLoss().lessThan(10)
+ * ```
+ */
+export class TracerouteAssertionBuilder {
+    /**
+     * Creates an assertion builder for traceroute response time metrics.
+     * @param property The response time property to assert against. Defaults to `avg`.
+     *   - `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 response time metric.
+     */
+    static responseTime(property = 'avg') {
+        return new ResponseTimeAssertionBuilder(property);
+    }
+    /**
+     * Creates an assertion builder for the number of network hops.
+     * @returns A numeric assertion builder for the hop count.
+     */
+    static hopCount() {
+        return new HopCountAssertionBuilder();
+    }
+    /**
+     * Creates an assertion builder for the percentage of packet loss (0-100).
+     * @returns A numeric assertion builder for packet loss.
+     */
+    static packetLoss() {
+        return new PacketLossAssertionBuilder();
+    }
+}
+//# sourceMappingURL=traceroute-assertion.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"traceroute-assertion.js","sourceRoot":"","sources":["../../src/constructs/traceroute-assertion.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAWjF,qFAAqF;AACrF,uFAAuF;AACvF,sFAAsF;AACtF,gEAAgE;AAEhE,wFAAwF;AACxF,MAAM,4BAA4B;IACX;IAArB,YAAqB,QAAwC;QAAxC,aAAQ,GAAR,QAAQ,CAAgC;IAAG,CAAC;IACjE,MAAM,CAAE,MAAc;QACpB,OAAO,WAAW,CAAC,eAAe,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;IACtE,CAAC;IAED,SAAS,CAAE,MAAc;QACvB,OAAO,WAAW,CAAC,eAAe,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC1E,CAAC;IAED,QAAQ,CAAE,MAAc;QACtB,OAAO,WAAW,CAAC,eAAe,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;IACzE,CAAC;IAED,WAAW,CAAE,MAAc;QACzB,OAAO,WAAW,CAAC,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC5E,CAAC;CACF;AAED,2FAA2F;AAC3F,MAAM,wBAAwB;IAC5B,MAAM,CAAE,MAAc;QACpB,OAAO,WAAW,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;IACnD,CAAC;IAED,QAAQ,CAAE,MAAc;QACtB,OAAO,WAAW,CAAC,WAAW,EAAE,WAAW,EAAE,MAAM,CAAC,CAAA;IACtD,CAAC;IAED,WAAW,CAAE,MAAc;QACzB,OAAO,WAAW,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,CAAA;IACzD,CAAC;CACF;AAED,mGAAmG;AACnG,MAAM,0BAA0B;IAC9B,MAAM,CAAE,MAAc;QACpB,OAAO,WAAW,CAAC,aAAa,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;IACrD,CAAC;IAED,QAAQ,CAAE,MAAc;QACtB,OAAO,WAAW,CAAC,aAAa,EAAE,WAAW,EAAE,MAAM,CAAC,CAAA;IACxD,CAAC;IAED,WAAW,CAAE,MAAc;QACzB,OAAO,WAAW,CAAC,aAAa,EAAE,cAAc,EAAE,MAAM,CAAC,CAAA;IAC3D,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,0BAA0B;IACrC;;;;;;;;OAQG;IACH,MAAM,CAAC,YAAY,CAAE,WAA2C,KAAK;QACnE,OAAO,IAAI,4BAA4B,CAAC,QAAQ,CAAC,CAAA;IACnD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,QAAQ;QACb,OAAO,IAAI,wBAAwB,EAAE,CAAA;IACvC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,UAAU;QACf,OAAO,IAAI,0BAA0B,EAAE,CAAA;IACzC,CAAC;CACF"}

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

@@ -0,0 +1,13 @@
+import { Codegen, Context } from './internal/codegen/index.js';
+import { MonitorResource } from './monitor-codegen.js';
+import { TracerouteRequest } from './traceroute-request.js';
+export interface TracerouteMonitorResource extends MonitorResource {
+    checkType: 'TRACEROUTE';
+    request: TracerouteRequest;
+    degradedResponseTime?: number;
+    maxResponseTime?: number;
+}
+export declare class TracerouteMonitorCodegen extends Codegen<TracerouteMonitorResource> {
+    describe(resource: TracerouteMonitorResource): string;
+    gencode(logicalId: string, resource: TracerouteMonitorResource, context: Context): void;
+}

package/dist/constructs/traceroute-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 { valueForTracerouteRequest } from './traceroute-request-codegen.js';
+const construct = 'TracerouteMonitor';
+export class TracerouteMonitorCodegen extends Codegen {
+    describe(resource) {
+        return `Traceroute Monitor: ${resource.name}`;
+    }
+    gencode(logicalId, resource, context) {
+        const filePath = context.filePath('resources/traceroute-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 => {
+                    if (resource.degradedResponseTime !== undefined) {
+                        builder.number('degradedResponseTime', resource.degradedResponseTime);
+                    }
+                    if (resource.maxResponseTime !== undefined) {
+                        builder.number('maxResponseTime', resource.maxResponseTime);
+                    }
+                    buildMonitorProps(this.program, file, builder, resource, context);
+                    builder.value('request', valueForTracerouteRequest(this.program, file, context, resource.request));
+                });
+            });
+        }));
+    }
+}
+//# sourceMappingURL=traceroute-monitor-codegen.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"traceroute-monitor-codegen.js","sourceRoot":"","sources":["../../src/constructs/traceroute-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,yBAAyB,EAAE,MAAM,iCAAiC,CAAA;AAS3E,MAAM,SAAS,GAAG,mBAAmB,CAAA;AAErC,MAAM,OAAO,wBAAyB,SAAQ,OAAkC;IAC9E,QAAQ,CAAE,QAAmC;QAC3C,OAAO,uBAAuB,QAAQ,CAAC,IAAI,EAAE,CAAA;IAC/C,CAAC;IAED,OAAO,CAAE,SAAiB,EAAE,QAAmC,EAAE,OAAgB;QAC/E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,+BAA+B,EAAE,QAAQ,CAAC,IAAI,EAAE;YAChF,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,IAAI,QAAQ,CAAC,oBAAoB,KAAK,SAAS,EAAE,CAAC;wBAChD,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAA;oBACvE,CAAC;oBAED,IAAI,QAAQ,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;wBAC3C,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAA;oBAC7D,CAAC;oBAED,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;oBAEjE,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,yBAAyB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;gBACpG,CAAC,CAAC,CAAA;YACJ,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAC,CAAA;IACL,CAAC;CACF"}

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

@@ -0,0 +1,83 @@
+import { Monitor, MonitorProps } from './monitor.js';
+import { Diagnostics } from './diagnostics.js';
+import { TracerouteRequest } from './traceroute-request.js';
+export interface TracerouteMonitorProps extends MonitorProps {
+    /**
+     * Determines the request that the monitor is going to run.
+     */
+    request: TracerouteRequest;
+    /**
+     * The response time in milliseconds where the monitor should be considered
+     * degraded.
+     *
+     * @defaultValue 10000
+     * @minimum 0
+     * @maximum 30000
+     * @example
+     * ```typescript
+     * degradedResponseTime: 5000  // Alert when the traceroute takes longer than 5 seconds
+     * ```
+     */
+    degradedResponseTime?: number;
+    /**
+     * The response time in milliseconds where the monitor should be considered
+     * failing.
+     *
+     * @defaultValue 20000
+     * @minimum 0
+     * @maximum 30000
+     * @example
+     * ```typescript
+     * maxResponseTime: 20000  // Fail if the traceroute takes longer than 20 seconds
+     * ```
+     */
+    maxResponseTime?: number;
+}
+/**
+ * Creates a Traceroute Monitor
+ */
+export declare class TracerouteMonitor extends Monitor {
+    request: TracerouteRequest;
+    degradedResponseTime?: number;
+    maxResponseTime?: number;
+    /**
+     * Constructs the Traceroute Monitor instance
+     *
+     * @param logicalId unique project-scoped resource name identification
+     * @param props configuration properties
+     *
+     * {@link https://www.checklyhq.com/docs/constructs/traceroute-monitor/ Read more in the docs}
+     */
+    constructor(logicalId: string, props: TracerouteMonitorProps);
+    describe(): string;
+    validate(diagnostics: Diagnostics): Promise<void>;
+    synthesize(): {
+        checkType: string;
+        request: TracerouteRequest;
+        degradedResponseTime: number | undefined;
+        maxResponseTime: 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/traceroute-monitor.js

@@ -0,0 +1,54 @@
+import { Monitor } from './monitor.js';
+import { Session } from './session.js';
+import { validateResponseTimes } from './internal/common-diagnostics.js';
+import { validateTracerouteAssertion } from './traceroute-assertion-validation.js';
+/**
+ * Creates a Traceroute Monitor
+ */
+export class TracerouteMonitor extends Monitor {
+    request;
+    degradedResponseTime;
+    maxResponseTime;
+    /**
+     * Constructs the Traceroute Monitor instance
+     *
+     * @param logicalId unique project-scoped resource name identification
+     * @param props configuration properties
+     *
+     * {@link https://www.checklyhq.com/docs/constructs/traceroute-monitor/ Read more in the docs}
+     */
+    constructor(logicalId, props) {
+        super(logicalId, props);
+        this.request = props.request;
+        this.degradedResponseTime = props.degradedResponseTime;
+        this.maxResponseTime = props.maxResponseTime;
+        Session.registerConstruct(this);
+        this.addSubscriptions();
+        this.addPrivateLocationCheckAssignments();
+    }
+    describe() {
+        return `TracerouteMonitor:${this.logicalId}`;
+    }
+    async validate(diagnostics) {
+        await super.validate(diagnostics);
+        await validateResponseTimes(diagnostics, this, {
+            degradedResponseTime: 30_000,
+            maxResponseTime: 30_000,
+            // Backend default applied when maxResponseTime is omitted.
+            defaultMaxResponseTime: 20_000,
+        });
+        for (const [index, assertion] of (this.request.assertions ?? []).entries()) {
+            validateTracerouteAssertion(diagnostics, assertion, index);
+        }
+    }
+    synthesize() {
+        return {
+            ...super.synthesize(),
+            checkType: 'TRACEROUTE',
+            request: this.request,
+            degradedResponseTime: this.degradedResponseTime,
+            maxResponseTime: this.maxResponseTime,
+        };
+    }
+}
+//# sourceMappingURL=traceroute-monitor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"traceroute-monitor.js","sourceRoot":"","sources":["../../src/constructs/traceroute-monitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAgB,MAAM,cAAc,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAA;AACxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAA;AAsClF;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,OAAO;IAC5C,OAAO,CAAmB;IAC1B,oBAAoB,CAAS;IAC7B,eAAe,CAAS;IAExB;;;;;;;OAOG;IAEH,YAAa,SAAiB,EAAE,KAA6B;QAC3D,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;QAEvB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA;QAC5B,IAAI,CAAC,oBAAoB,GAAG,KAAK,CAAC,oBAAoB,CAAA;QACtD,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAA;QAE5C,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,qBAAqB,IAAI,CAAC,SAAS,EAAE,CAAA;IAC9C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAE,WAAwB;QACtC,MAAM,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;QAEjC,MAAM,qBAAqB,CAAC,WAAW,EAAE,IAAI,EAAE;YAC7C,oBAAoB,EAAE,MAAM;YAC5B,eAAe,EAAE,MAAM;YACvB,2DAA2D;YAC3D,sBAAsB,EAAE,MAAM;SAC/B,CAAC,CAAA;QAEF,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3E,2BAA2B,CAAC,WAAW,EAAE,SAAS,EAAE,KAAK,CAAC,CAAA;QAC5D,CAAC;IACH,CAAC;IAED,UAAU;QACR,OAAO;YACL,GAAG,KAAK,CAAC,UAAU,EAAE;YACrB,SAAS,EAAE,YAAY;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;YAC/C,eAAe,EAAE,IAAI,CAAC,eAAe;SACtC,CAAA;IACH,CAAC;CACF"}

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

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

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

@@ -0,0 +1,41 @@
+import { object } from '../sourcegen/index.js';
+import { valueForTracerouteAssertion } from './traceroute-assertion-codegen.js';
+export function valueForTracerouteRequest(program, genfile, context, request) {
+    return object(builder => {
+        builder.string('url', request.url);
+        if (request.protocol && request.protocol !== 'TCP') {
+            builder.string('protocol', request.protocol);
+        }
+        // `port` is not sent for ICMP probes (the backend strips it), so only emit
+        // it for the protocols that use it.
+        if (request.port !== undefined && request.protocol !== 'ICMP') {
+            builder.number('port', request.port);
+        }
+        if (request.ipFamily && request.ipFamily !== 'IPv4') {
+            builder.string('ipFamily', request.ipFamily);
+        }
+        if (request.maxHops !== undefined) {
+            builder.number('maxHops', request.maxHops);
+        }
+        if (request.maxUnknownHops !== undefined) {
+            builder.number('maxUnknownHops', request.maxUnknownHops);
+        }
+        if (request.ptrLookup !== undefined) {
+            builder.boolean('ptrLookup', request.ptrLookup);
+        }
+        if (request.timeout !== undefined) {
+            builder.number('timeout', request.timeout);
+        }
+        if (request.assertions) {
+            const assertions = request.assertions;
+            if (assertions.length > 0) {
+                builder.array('assertions', builder => {
+                    for (const assertion of assertions) {
+                        builder.value(valueForTracerouteAssertion(genfile, assertion));
+                    }
+                });
+            }
+        }
+    });
+}
+//# sourceMappingURL=traceroute-request-codegen.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"traceroute-request-codegen.js","sourceRoot":"","sources":["../../src/constructs/traceroute-request-codegen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,MAAM,EAAkB,MAAM,uBAAuB,CAAA;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAA;AAI/E,MAAM,UAAU,yBAAyB,CACvC,OAAgB,EAChB,OAAsB,EACtB,OAAgB,EAChB,OAA0B;IAE1B,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;QAElC,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YACnD,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;QAC9C,CAAC;QAED,2EAA2E;QAC3E,oCAAoC;QACpC,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC9D,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;QACtC,CAAC;QAED,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,OAAO,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;QAC5C,CAAC;QAED,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACzC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;QAC1D,CAAC;QAED,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACpC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;QACjD,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;QAC5C,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,2BAA2B,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAA;oBAChE,CAAC;gBACH,CAAC,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}

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

@@ -0,0 +1,81 @@
+import { TracerouteAssertion } from './traceroute-assertion.js';
+import { IPFamily } from './ip.js';
+/**
+ * The traceroute probe protocol.
+ *
+ * - `TCP` sends SYN probes (default).
+ * - `UDP` sends datagrams to a high port.
+ * - `ICMP` sends Echo Requests.
+ * - `SCTP` sends INIT chunks.
+ */
+export type TracerouteProtocol = 'TCP' | 'UDP' | 'ICMP' | 'SCTP';
+/**
+ * Configuration for traceroute requests.
+ * Defines the probe parameters and validation rules.
+ */
+export interface TracerouteRequest {
+    /**
+     * The host to trace the network path to. Do not include a scheme or a port in
+     * this value.
+     *
+     * @example "example.com"
+     */
+    url: string;
+    /**
+     * The probe protocol.
+     *
+     * @defaultValue "TCP"
+     */
+    protocol?: TracerouteProtocol;
+    /**
+     * The destination port for TCP/UDP/SCTP probes. Ignored (and not sent) when
+     * `protocol` is `ICMP`.
+     *
+     * @minimum 1
+     * @maximum 65535
+     * @defaultValue 443
+     */
+    port?: number;
+    /**
+     * The IP family to use when executing the traceroute.
+     *
+     * @defaultValue "IPv4"
+     */
+    ipFamily?: IPFamily;
+    /**
+     * The maximum number of network hops to probe before stopping.
+     *
+     * @minimum 1
+     * @maximum 64
+     * @defaultValue 30
+     */
+    maxHops?: number;
+    /**
+     * The maximum number of consecutive unresponsive hops to tolerate before
+     * stopping the trace.
+     *
+     * @minimum 1
+     * @maximum 30
+     * @defaultValue 15
+     */
+    maxUnknownHops?: number;
+    /**
+     * Whether to perform reverse-DNS (PTR) lookups on each hop's IP address.
+     *
+     * @defaultValue true
+     */
+    ptrLookup?: boolean;
+    /**
+     * The number of seconds to wait for the traceroute to complete before timing
+     * out.
+     *
+     * @minimum 1
+     * @maximum 30
+     * @defaultValue 10
+     */
+    timeout?: number;
+    /**
+     * Assertions to validate the traceroute response.
+     */
+    assertions?: Array<TracerouteAssertion>;
+}

package/dist/constructs/traceroute-request.js

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

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

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

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

@@ -1,11 +1,11 @@
-import { valueForNumericAssertion } from './internal/assertion-codegen.js';
+import { unsupportedAssertionSource, valueForNumericAssertion } from './internal/assertion-codegen.js';
 export function valueForUrlAssertion(genfile, assertion) {
     genfile.namedImport('UrlAssertionBuilder', 'checkly/constructs');
     switch (assertion.source) {
         case 'STATUS_CODE':
             return valueForNumericAssertion('UrlAssertionBuilder', 'statusCode', assertion);
         default:
-            throw new Error(`Unsupported URL assertion source ${assertion.source}`);
+            return unsupportedAssertionSource(assertion.source, 'URL');
     }
 }
 //# sourceMappingURL=url-assertion-codegen.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"url-assertion-codegen.js","sourceRoot":"","sources":["../../src/constructs/url-assertion-codegen.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAA;AAE1E,MAAM,UAAU,oBAAoB,CAAE,OAAsB,EAAE,SAAuB;IACnF,OAAO,CAAC,WAAW,CAAC,qBAAqB,EAAE,oBAAoB,CAAC,CAAA;IAEhE,QAAQ,SAAS,CAAC,MAAM,EAAE,CAAC;QACzB,KAAK,aAAa;YAChB,OAAO,wBAAwB,CAAC,qBAAqB,EAAE,YAAY,EAAE,SAAS,CAAC,CAAA;QACjF;YACE,MAAM,IAAI,KAAK,CAAC,oCAAoC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAA;IAC3E,CAAC;AACH,CAAC"}
+{"version":3,"file":"url-assertion-codegen.js","sourceRoot":"","sources":["../../src/constructs/url-assertion-codegen.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAA;AAEtG,MAAM,UAAU,oBAAoB,CAAE,OAAsB,EAAE,SAAuB;IACnF,OAAO,CAAC,WAAW,CAAC,qBAAqB,EAAE,oBAAoB,CAAC,CAAA;IAEhE,QAAQ,SAAS,CAAC,MAAM,EAAE,CAAC;QACzB,KAAK,aAAa;YAChB,OAAO,wBAAwB,CAAC,qBAAqB,EAAE,YAAY,EAAE,SAAS,CAAC,CAAA;QACjF;YACE,OAAO,0BAA0B,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IAC9D,CAAC;AACH,CAAC"}

package/dist/formatters/assertion-line.d.ts

@@ -0,0 +1,27 @@
+export type TruncateOptions = {
+    chars?: number;
+    lines?: number;
+    ending?: string;
+};
+export declare function truncate(val: any, opts: TruncateOptions): {
+    truncated: boolean;
+    result: string;
+    lines: number;
+};
+export type AssertionLike = {
+    source?: string;
+    property?: string | null;
+    comparison?: string;
+    target?: unknown;
+    regex?: string | null;
+    error?: string | null;
+    actual?: unknown;
+};
+export type FormatAssertionLineOptions = {
+    truncate?: TruncateOptions;
+};
+export declare const assertionSymbols: {
+    readonly success: "✔";
+    readonly error: "✖";
+};
+export declare function formatAssertionLine(assertion: AssertionLike, options?: FormatAssertionLineOptions): string;