checkly 0.0.0-canary.7b9cf29

package/dist/constructs/tcp-monitor.js

@@ -0,0 +1,83 @@
+import { Monitor } from './monitor.js';
+import { Session } from './session.js';
+import { NumericAssertionBuilder, GeneralAssertionBuilder } from './internal/assertion.js';
+import { validateResponseTimes } from './internal/common-diagnostics.js';
+/**
+ * Builder class for creating TCP monitor assertions.
+ * Provides methods to create assertions for TCP connection responses.
+ *
+ * @example
+ * ```typescript
+ * // Response time assertions
+ * TcpAssertionBuilder.responseTime().lessThan(1000)
+ * TcpAssertionBuilder.responseTime().greaterThan(100)
+ *
+ * // Response data assertions
+ * TcpAssertionBuilder.responseData().contains('SMTP')
+ * TcpAssertionBuilder.responseData().notContains('error')
+ * ```
+ */
+export class TcpAssertionBuilder {
+    /**
+     * Creates an assertion builder for TCP response data.
+     * @param property Optional property path for response data
+     * @returns A general assertion builder for response data content
+     */
+    static responseData(property) {
+        return new GeneralAssertionBuilder('RESPONSE_DATA', property);
+    }
+    /**
+     * Creates an assertion builder for TCP response time.
+     * @returns A numeric assertion builder for response time in milliseconds
+     */
+    static responseTime() {
+        return new NumericAssertionBuilder('RESPONSE_TIME');
+    }
+}
+/**
+ * Creates a TCP Monitor
+ */
+export class TcpMonitor extends Monitor {
+    request;
+    degradedResponseTime;
+    maxResponseTime;
+    /**
+     * Constructs the TCP Monitor instance
+     *
+     * @param logicalId unique project-scoped resource name identification
+     * @param props configuration properties
+     *
+     * {@link https://www.checklyhq.com/docs/constructs/tcp-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 `TcpMonitor:${this.logicalId}`;
+    }
+    async validate(diagnostics) {
+        await super.validate(diagnostics);
+        await validateResponseTimes(diagnostics, this, {
+            degradedResponseTime: 5_000,
+            maxResponseTime: 5_000,
+        });
+    }
+    synthesize() {
+        return {
+            ...super.synthesize(),
+            checkType: 'TCP',
+            request: this.request,
+            degradedResponseTime: this.degradedResponseTime,
+            maxResponseTime: this.maxResponseTime,
+        };
+    }
+}
+// Aliases for backwards compatibility.
+export { TcpMonitor as TcpCheck, };
+//# sourceMappingURL=tcp-monitor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tcp-monitor.js","sourceRoot":"","sources":["../../src/constructs/tcp-monitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAgB,MAAM,cAAc,CAAA;AAEpD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAA8B,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AAEtH,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAA;AAMxE;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,mBAAmB;IAC9B;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAE,QAAiB;QACpC,OAAO,IAAI,uBAAuB,CAAqB,eAAe,EAAE,QAAQ,CAAC,CAAA;IACnF,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,YAAY;QACjB,OAAO,IAAI,uBAAuB,CAAqB,eAAe,CAAC,CAAA;IACzE,CAAC;CACF;AAiFD;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,OAAO;IACrC,OAAO,CAAY;IACnB,oBAAoB,CAAS;IAC7B,eAAe,CAAS;IAExB;;;;;;;OAOG;IAEH,YAAa,SAAiB,EAAE,KAAsB;QACpD,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,cAAc,IAAI,CAAC,SAAS,EAAE,CAAA;IACvC,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,KAAK;YAC3B,eAAe,EAAE,KAAK;SACvB,CAAC,CAAA;IACJ,CAAC;IAED,UAAU;QACR,OAAO;YACL,GAAG,KAAK,CAAC,UAAU,EAAE;YACrB,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;YAC/C,eAAe,EAAE,IAAI,CAAC,eAAe;SACtC,CAAA;IACH,CAAC;CACF;AAED,uCAAuC;AACvC,OAAO,EAEL,UAAU,IAAI,QAAQ,GACvB,CAAA"}

package/dist/constructs/telegram-alert-channel-codegen.d.ts

@@ -0,0 +1,13 @@
+import { Codegen, Context } from './internal/codegen/index.js';
+import { WebhookAlertChannelResource, WebhookAlertChannelResourceConfig } from './webhook-alert-channel-codegen.js';
+export interface TelegramAlertChannelResource extends WebhookAlertChannelResource {
+    config: WebhookAlertChannelResourceConfig & {
+        webhookType: 'WEBHOOK_TELEGRAM';
+    };
+}
+export declare class TelegramAlertChannelCodegen extends Codegen<TelegramAlertChannelResource> {
+    validateSafety(resource: TelegramAlertChannelResource): void;
+    describe(resource: TelegramAlertChannelResource): string;
+    prepare(logicalId: string, resource: TelegramAlertChannelResource, context: Context): void;
+    gencode(logicalId: string, resource: TelegramAlertChannelResource, context: Context): void;
+}

package/dist/constructs/telegram-alert-channel-codegen.js

@@ -0,0 +1,98 @@
+import qs from 'node:querystring';
+import { Codegen, ImportSafetyViolation } from './internal/codegen/index.js';
+import { decl, expr, ident } from '../sourcegen/index.js';
+import { buildAlertChannelProps } from './alert-channel-codegen.js';
+import { TelegramAlertChannel } from './telegram-alert-channel.js';
+function apiKeyFromUrl(url) {
+    const match = /https:\/\/api.telegram.org\/bot([^/]+)\/sendMessage/.exec(url);
+    if (match) {
+        return match[1];
+    }
+}
+function parseTemplate(template) {
+    const values = qs.parse(template);
+    const singleValue = (key) => {
+        const value = values[key];
+        if (Array.isArray(value)) {
+            return value[0];
+        }
+        return value;
+    };
+    return {
+        chatId: singleValue('chat_id'),
+        text: singleValue('text'),
+    };
+}
+const construct = 'TelegramAlertChannel';
+export class TelegramAlertChannelCodegen extends Codegen {
+    validateSafety(resource) {
+        const { config } = resource;
+        if (config.method !== 'POST') {
+            throw new ImportSafetyViolation(`Unsupported value for property 'method' (expected 'POST')`);
+        }
+        if (config.headers !== undefined && config.headers.length !== 0) {
+            throw new ImportSafetyViolation(`Unsupported value for property 'headers' (expected no value or an empty array)`);
+        }
+        if (config.queryParameters !== undefined && config.queryParameters.length !== 0) {
+            throw new ImportSafetyViolation(`Unsupported value for property 'queryParameters' (expected no value or an empty array)`);
+        }
+        if (config.webhookSecret) {
+            throw new ImportSafetyViolation(`Unsupported value for property 'webhookSecret' (expected no value)`);
+        }
+    }
+    describe(resource) {
+        this.validateSafety(resource);
+        return `Telegram Alert Channel: ${resource.config.name}`;
+    }
+    prepare(logicalId, resource, context) {
+        this.validateSafety(resource);
+        const { name } = resource.config;
+        const filename = context.filePath('resources/alert-channels/telegram', name, {
+            unique: true,
+        });
+        context.registerAlertChannel(resource.id, `${name} telegram`, this.program.generatedConstructFile(filename.fullPath));
+    }
+    gencode(logicalId, resource, context) {
+        this.validateSafety(resource);
+        const { id, file } = context.lookupAlertChannel(resource.id);
+        file.namedImport(construct, 'checkly/constructs');
+        const { config } = resource;
+        file.section(decl(id, builder => {
+            builder.variable(expr(ident(construct), builder => {
+                builder.new(builder => {
+                    builder.string(logicalId);
+                    builder.object(builder => {
+                        builder.string('name', config.name);
+                        const apiKey = apiKeyFromUrl(config.url);
+                        if (apiKey) {
+                            builder.string('apiKey', apiKey);
+                        }
+                        else {
+                            throw new Error(`Failed to extract Telegram API Key from webhook template: ${config.template}`);
+                        }
+                        if (config.template) {
+                            const { chatId, text } = parseTemplate(config.template);
+                            if (chatId) {
+                                builder.string('chatId', chatId);
+                            }
+                            else {
+                                throw new Error(`Failed to extract Telegram Chat ID from webhook template: ${config.template}`);
+                            }
+                            if (text) {
+                                if (text !== TelegramAlertChannel.DEFAULT_PAYLOAD) {
+                                    builder.string('payload', text);
+                                }
+                            }
+                            else {
+                                throw new Error(`Failed to extract Telegram payload from webhook template: ${config.template}`);
+                            }
+                        }
+                        buildAlertChannelProps(builder, resource);
+                    });
+                });
+            }));
+            builder.export();
+        }));
+    }
+}
+//# sourceMappingURL=telegram-alert-channel-codegen.js.map

package/dist/constructs/telegram-alert-channel-codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-alert-channel-codegen.js","sourceRoot":"","sources":["../../src/constructs/telegram-alert-channel-codegen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAEjC,OAAO,EAAE,OAAO,EAAW,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AACrF,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AAEnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAQlE,SAAS,aAAa,CAAE,GAAW;IACjC,MAAM,KAAK,GAAG,qDAAqD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC7E,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,KAAK,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC;AAOD,SAAS,aAAa,CAAE,QAAgB;IACtC,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IAEjC,MAAM,WAAW,GAAG,CAAC,GAAW,EAAsB,EAAE;QACtD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;QACzB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC,CAAA;IAED,OAAO;QACL,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC;QAC9B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC;KAC1B,CAAA;AACH,CAAC;AAED,MAAM,SAAS,GAAG,sBAAsB,CAAA;AAExC,MAAM,OAAO,2BAA4B,SAAQ,OAAqC;IACpF,cAAc,CAAE,QAAsC;QACpD,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAA;QAE3B,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC7B,MAAM,IAAI,qBAAqB,CAAC,2DAA2D,CAAC,CAAA;QAC9F,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,qBAAqB,CAAC,gFAAgF,CAAC,CAAA;QACnH,CAAC;QAED,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChF,MAAM,IAAI,qBAAqB,CAAC,wFAAwF,CAAC,CAAA;QAC3H,CAAC;QAED,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YACzB,MAAM,IAAI,qBAAqB,CAAC,oEAAoE,CAAC,CAAA;QACvG,CAAC;IACH,CAAC;IAED,QAAQ,CAAE,QAAsC;QAC9C,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAA;QAE7B,OAAO,2BAA2B,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;IAC1D,CAAC;IAED,OAAO,CAAE,SAAiB,EAAE,QAAsC,EAAE,OAAgB;QAClF,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAA;QAE7B,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAA;QAEhC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,mCAAmC,EAAE,IAAI,EAAE;YAC3E,MAAM,EAAE,IAAI;SACb,CAAC,CAAA;QAEF,OAAO,CAAC,oBAAoB,CAC1B,QAAQ,CAAC,EAAE,EACX,GAAG,IAAI,WAAW,EAClB,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CACvD,CAAA;IACH,CAAC;IAED,OAAO,CAAE,SAAiB,EAAE,QAAsC,EAAE,OAAgB;QAClF,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAA;QAE7B,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;QAE5D,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAA;QAEjD,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAA;QAE3B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE;YAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,EAAE;gBAChD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;oBACpB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;oBACzB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;wBACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;wBAEnC,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;wBACxC,IAAI,MAAM,EAAE,CAAC;4BACX,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;wBAClC,CAAC;6BAAM,CAAC;4BACN,MAAM,IAAI,KAAK,CAAC,6DAA6D,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAA;wBACjG,CAAC;wBAED,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;4BACpB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;4BACvD,IAAI,MAAM,EAAE,CAAC;gCACX,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;4BAClC,CAAC;iCAAM,CAAC;gCACN,MAAM,IAAI,KAAK,CAAC,6DAA6D,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAA;4BACjG,CAAC;4BAED,IAAI,IAAI,EAAE,CAAC;gCACT,IAAI,IAAI,KAAK,oBAAoB,CAAC,eAAe,EAAE,CAAC;oCAClD,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;gCACjC,CAAC;4BACH,CAAC;iCAAM,CAAC;gCACN,MAAM,IAAI,KAAK,CAAC,6DAA6D,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAA;4BACjG,CAAC;wBACH,CAAC;wBAED,sBAAsB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;oBAC3C,CAAC,CAAC,CAAA;gBACJ,CAAC,CAAC,CAAA;YACJ,CAAC,CAAC,CAAC,CAAA;YAEH,OAAO,CAAC,MAAM,EAAE,CAAA;QAClB,CAAC,CAAC,CAAC,CAAA;IACL,CAAC;CACF"}

package/dist/constructs/telegram-alert-channel.d.ts

@@ -0,0 +1,44 @@
+import { WebhookAlertChannel } from './webhook-alert-channel.js';
+import { AlertChannelProps } from './alert-channel.js';
+export interface TelegramAlertChannelProps extends AlertChannelProps {
+    /**
+     * Friendly name to recognise the integration.
+     */
+    name: string;
+    /**
+     * The chat ID of your Telegram bot.
+     * {@link https://www.checklyhq.com/docs/integrations/alerts/telegram/}
+     */
+    chatId: string;
+    /**
+     * The API key for your Telegram bot.
+     * {@link https://www.checklyhq.com/docs/integrations/alerts/telegram/}
+     */
+    apiKey: string;
+    /**
+     * An optional custom payload. If not given,
+     * `TelegramAlertChannel.DEFAULT_PAYLOAD` will be used.
+     */
+    payload?: string;
+}
+/**
+ * Creates a Telegram Alert Channel
+ *
+ * @remarks
+ *
+ * This class make use of the Alert Channel endpoints.
+ */
+export declare class TelegramAlertChannel extends WebhookAlertChannel {
+    static DEFAULT_PAYLOAD: string;
+    /**
+       * Constructs the Telegram Alert Channel instance
+       *
+       * @param logicalId unique project-scoped resource name identification
+       * @param props Telegram alert channel configuration properties
+       * Fix following url:
+       * {@link https://checklyhq.com/docs/cli/constructs/#telegramalertchannel Read more in the docs}
+      */
+    constructor(logicalId: string, props: TelegramAlertChannelProps);
+    describe(): string;
+    synthesize(): any;
+}

package/dist/constructs/telegram-alert-channel.js

@@ -0,0 +1,60 @@
+import { WebhookAlertChannel } from './webhook-alert-channel.js';
+/**
+ * Creates a Telegram Alert Channel
+ *
+ * @remarks
+ *
+ * This class make use of the Alert Channel endpoints.
+ */
+export class TelegramAlertChannel extends WebhookAlertChannel {
+    static DEFAULT_PAYLOAD = `<b>{{ALERT_TITLE}}</b> at {{RUN_LOCATION}} ({{RESPONSE_TIME}}ms)
+{{#if AI_ANALYSIS_CLASSIFICATION}}
+AI Analysis: <i>{{AI_ANALYSIS_CLASSIFICATION}}</i>
+
+{{AI_ANALYSIS_ROOT_CAUSE}}
+<a href="{{AI_ANALYSIS_LINK}}">Read full analysis</a>
+{{/if}}
+
+Tags: {{#each TAGS}} <i><b>{{this}}</b></i> {{#unless @last}},{{/unless}} {{/each}}
+<a href="{{RESULT_LINK}}">View check result</a>
+`;
+    /**
+       * Constructs the Telegram Alert Channel instance
+       *
+       * @param logicalId unique project-scoped resource name identification
+       * @param props Telegram alert channel configuration properties
+       * Fix following url:
+       * {@link https://checklyhq.com/docs/cli/constructs/#telegramalertchannel Read more in the docs}
+      */
+    constructor(logicalId, props) {
+        // @ts-ignore
+        super(logicalId, props);
+        this.webhookType = 'WEBHOOK_TELEGRAM';
+        this.method = 'POST';
+        const payload = props.payload ?? TelegramAlertChannel.DEFAULT_PAYLOAD;
+        // For historical reasons the payload is not escaped even though it
+        // should be.
+        this.template = `chat_id=${props.chatId}&parse_mode=HTML&text=${payload}`;
+        this.url = `https://api.telegram.org/bot${props.apiKey}/sendMessage`;
+    }
+    describe() {
+        return `TelegramAlertChannel:${this.logicalId}`;
+    }
+    synthesize() {
+        return {
+            ...super.synthesize(),
+            type: 'WEBHOOK',
+            config: {
+                name: this.name,
+                webhookType: this.webhookType,
+                url: this.url,
+                template: this.template,
+                method: this.method,
+                headers: this.headers,
+                queryParameters: this.queryParameters,
+                webhookSecret: this.webhookSecret,
+            },
+        };
+    }
+}
+//# sourceMappingURL=telegram-alert-channel.js.map

package/dist/constructs/telegram-alert-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-alert-channel.js","sourceRoot":"","sources":["../../src/constructs/telegram-alert-channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAyBhE;;;;;;GAMG;AACH,MAAM,OAAO,oBAAqB,SAAQ,mBAAmB;IAC3D,MAAM,CAAC,eAAe,GAAG;;;;;;;;;;CAU1B,CAAA;IAEC;;;;;;;QAOI;IACJ,YAAa,SAAiB,EAAE,KAAgC;QAC9D,aAAa;QACb,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;QACvB,IAAI,CAAC,WAAW,GAAG,kBAAkB,CAAA;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,oBAAoB,CAAC,eAAe,CAAA;QACrE,mEAAmE;QACnE,aAAa;QACb,IAAI,CAAC,QAAQ,GAAG,WAAW,KAAK,CAAC,MAAM,yBAAyB,OAAO,EAAE,CAAA;QACzE,IAAI,CAAC,GAAG,GAAG,+BAA+B,KAAK,CAAC,MAAM,cAAc,CAAA;IACtE,CAAC;IAED,QAAQ;QACN,OAAO,wBAAwB,IAAI,CAAC,SAAS,EAAE,CAAA;IACjD,CAAC;IAED,UAAU;QACR,OAAO;YACL,GAAG,KAAK,CAAC,UAAU,EAAE;YACrB,IAAI,EAAE,SAAS;YACf,MAAM,EAAE;gBACN,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,eAAe,EAAE,IAAI,CAAC,eAAe;gBACrC,aAAa,EAAE,IAAI,CAAC,aAAa;aAClC;SACF,CAAA;IACH,CAAC"}

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

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

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

@@ -0,0 +1,11 @@
+import { 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}`);
+    }
+}
+//# sourceMappingURL=url-assertion-codegen.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,60 @@
+import { Assertion as CoreAssertion, NumericAssertionBuilder } from './internal/assertion.js';
+/**
+ * Sources that can be used for URL monitor assertions.
+ * URL monitors only support status code validation.
+ */
+type UrlAssertionSource = 'STATUS_CODE';
+/**
+ * Assertion configuration for URL monitors.
+ * Allows validation of HTTP response status codes.
+ */
+export type UrlAssertion = CoreAssertion<UrlAssertionSource>;
+/**
+ * Builder class for creating URL monitor assertions.
+ * Provides methods to create assertions for validating HTTP responses.
+ *
+ * URL monitors have limited assertion capabilities compared to API checks.
+ * They can only validate status codes. For more advanced assertions
+ * (headers, body content, response times), use ApiCheck instead.
+ *
+ * @example
+ * ```typescript
+ * // Check for specific status code
+ * UrlAssertionBuilder.statusCode().equals(200)
+ *
+ * // Check for successful response (2xx)
+ * UrlAssertionBuilder.statusCode().greaterThan(199)
+ * UrlAssertionBuilder.statusCode().lessThan(300)
+ *
+ * // Check for any non-error response
+ * UrlAssertionBuilder.statusCode().lessThan(400)
+ *
+ * // Check for specific client error
+ * UrlAssertionBuilder.statusCode().equals(404)
+ *
+ * // Check for server errors
+ * UrlAssertionBuilder.statusCode().greaterThan(499)
+ * UrlAssertionBuilder.statusCode().lessThan(600)
+ * ```
+ *
+ * @see {@link https://www.checklyhq.com/docs/detect/uptime-monitoring/url-monitors/overview/ | URL Monitors Documentation}
+ */
+export declare class UrlAssertionBuilder {
+    /**
+     * Creates an assertion builder for HTTP status codes.
+     * This is the only type of assertion supported by URL monitors.
+     *
+     * @returns A numeric assertion builder for status codes
+     *
+     * @example
+     * ```typescript
+     * // Basic usage
+     * const assertion = UrlAssertionBuilder.statusCode().equals(200)
+     *
+     * // Check for range of status codes
+     * const successAssertion = UrlAssertionBuilder.statusCode().lessThan(400)
+     * ```
+     */
+    static statusCode(): NumericAssertionBuilder<"STATUS_CODE", string>;
+}
+export {};

package/dist/constructs/url-assertion.js

@@ -0,0 +1,52 @@
+import { NumericAssertionBuilder, } from './internal/assertion.js';
+/**
+ * Builder class for creating URL monitor assertions.
+ * Provides methods to create assertions for validating HTTP responses.
+ *
+ * URL monitors have limited assertion capabilities compared to API checks.
+ * They can only validate status codes. For more advanced assertions
+ * (headers, body content, response times), use ApiCheck instead.
+ *
+ * @example
+ * ```typescript
+ * // Check for specific status code
+ * UrlAssertionBuilder.statusCode().equals(200)
+ *
+ * // Check for successful response (2xx)
+ * UrlAssertionBuilder.statusCode().greaterThan(199)
+ * UrlAssertionBuilder.statusCode().lessThan(300)
+ *
+ * // Check for any non-error response
+ * UrlAssertionBuilder.statusCode().lessThan(400)
+ *
+ * // Check for specific client error
+ * UrlAssertionBuilder.statusCode().equals(404)
+ *
+ * // Check for server errors
+ * UrlAssertionBuilder.statusCode().greaterThan(499)
+ * UrlAssertionBuilder.statusCode().lessThan(600)
+ * ```
+ *
+ * @see {@link https://www.checklyhq.com/docs/detect/uptime-monitoring/url-monitors/overview/ | URL Monitors Documentation}
+ */
+export class UrlAssertionBuilder {
+    /**
+     * Creates an assertion builder for HTTP status codes.
+     * This is the only type of assertion supported by URL monitors.
+     *
+     * @returns A numeric assertion builder for status codes
+     *
+     * @example
+     * ```typescript
+     * // Basic usage
+     * const assertion = UrlAssertionBuilder.statusCode().equals(200)
+     *
+     * // Check for range of status codes
+     * const successAssertion = UrlAssertionBuilder.statusCode().lessThan(400)
+     * ```
+     */
+    static statusCode() {
+        return new NumericAssertionBuilder('STATUS_CODE');
+    }
+}
+//# sourceMappingURL=url-assertion.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"url-assertion.js","sourceRoot":"","sources":["../../src/constructs/url-assertion.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,uBAAuB,GACxB,MAAM,yBAAyB,CAAA;AAehC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,OAAO,mBAAmB;IAC9B;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,UAAU;QACf,OAAO,IAAI,uBAAuB,CAAqB,aAAa,CAAC,CAAA;IACvE,CAAC;CACF"}

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"url-monitor-codegen.js","sourceRoot":"","sources":["../../src/constructs/url-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,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAS7D,MAAM,SAAS,GAAG,YAAY,CAAA;AAE9B,MAAM,OAAO,iBAAkB,SAAQ,OAA2B;IAChE,QAAQ,CAAE,QAA4B;QACpC,OAAO,gBAAgB,QAAQ,CAAC,IAAI,EAAE,CAAA;IACxC,CAAC;IAED,OAAO,CAAE,SAAiB,EAAE,QAA4B,EAAE,OAAgB;QACxE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,wBAAwB,EAAE,QAAQ,CAAC,IAAI,EAAE;YACzE,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,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;oBAEjE,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,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,kBAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;gBAC7F,CAAC,CAAC,CAAA;YACJ,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAC,CAAA;IACL,CAAC;CACF"}

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

@@ -0,0 +1,151 @@
+import { Diagnostics } from './diagnostics.js';
+import { Monitor, MonitorProps } from './monitor.js';
+import { UrlRequest } from './url-request.js';
+/**
+ * Configuration properties for UrlMonitor.
+ * Extends MonitorProps with URL-specific settings.
+ */
+export interface UrlMonitorProps extends MonitorProps {
+    /**
+     * Determines the request that the monitor is going to run.
+     * Defines the URL and validation rules for the HTTP check.
+     */
+    request: UrlRequest;
+    /**
+     * The response time in milliseconds where the monitor should be considered degraded.
+     * Used for performance monitoring and alerting on slow responses.
+     *
+     * @defaultValue 3000
+     * @minimum 0
+     * @maximum 30000
+     * @example
+     * ```typescript
+     * degradedResponseTime: 2000  // Alert when URL responds slower than 2 seconds
+     * ```
+     */
+    degradedResponseTime?: number;
+    /**
+     * The response time in milliseconds where the monitor should be considered failing.
+     * The monitor fails if the response takes longer than this threshold.
+     *
+     * @defaultValue 5000
+     * @minimum 0
+     * @maximum 30000
+     * @example
+     * ```typescript
+     * maxResponseTime: 5000  // Fail monitor if URL takes longer than 5 seconds
+     * ```
+     */
+    maxResponseTime?: number;
+}
+/**
+ * Creates a URL Monitor to check HTTP endpoint availability and response times.
+ *
+ * URL monitors are simplified HTTP checks that verify if a URL is accessible and responding
+ * within acceptable time limits. They only support GET requests and status code assertions.
+ * For more advanced HTTP monitoring with custom methods, headers, and body assertions,
+ * use ApiCheck instead.
+ *
+ * @example
+ * ```typescript
+ * // Basic URL monitor
+ * new UrlMonitor('homepage-monitor', {
+ *   name: 'Homepage Monitor',
+ *   frequency: Frequency.EVERY_5M,
+ *   locations: ['us-east-1', 'eu-west-1'],
+ *   request: {
+ *     url: 'https://example.com',
+ *     assertions: [
+ *       UrlAssertionBuilder.statusCode().equals(200)
+ *     ]
+ *   }
+ * })
+ *
+ * // URL monitor with performance thresholds
+ * new UrlMonitor('api-health', {
+ *   name: 'API Health Check',
+ *   frequency: Frequency.EVERY_1M,
+ *   locations: ['us-east-1', 'eu-west-1', 'ap-southeast-1'],
+ *   request: {
+ *     url: 'https://api.example.com/health',
+ *     followRedirects: false,
+ *     assertions: [
+ *       UrlAssertionBuilder.statusCode().equals(200)
+ *     ]
+ *   },
+ *   degradedResponseTime: 1000,
+ *   maxResponseTime: 3000,
+ *   alertChannels: [emailAlert, slackAlert]
+ * })
+ *
+ * // URL monitor with SSL verification disabled (for internal/dev endpoints)
+ * new UrlMonitor('internal-service', {
+ *   name: 'Internal Service Check',
+ *   frequency: Frequency.EVERY_10M,
+ *   privateLocations: ['datacenter-1'],
+ *   request: {
+ *     url: 'https://internal.company.local:8443/status',
+ *     skipSSL: true,
+ *     assertions: [
+ *       UrlAssertionBuilder.statusCode().lessThan(400)
+ *     ]
+ *   }
+ * })
+ * ```
+ *
+ * @see {@link https://www.checklyhq.com/docs/constructs/url-monitor/ | UrlMonitor API Reference}
+ * @see {@link https://www.checklyhq.com/docs/detect/uptime-monitoring/url-monitors/overview/ | URL Monitors Documentation}
+ */
+export declare class UrlMonitor extends Monitor {
+    readonly request: UrlRequest;
+    readonly degradedResponseTime?: number;
+    readonly maxResponseTime?: number;
+    /**
+     * Constructs the URL Monitor instance
+     *
+     * @param logicalId unique project-scoped resource name identification
+     * @param props configuration properties
+     *
+     * {@link https://www.checklyhq.com/docs/constructs/url-monitor/ Read more in the docs}
+     */
+    constructor(logicalId: string, props: UrlMonitorProps);
+    describe(): string;
+    protected supportsOnlyOnNetworkErrorRetryStrategy(): boolean;
+    validate(diagnostics: Diagnostics): Promise<void>;
+    synthesize(): {
+        checkType: string;
+        request: {
+            method: string;
+            url: string;
+            ipFamily?: import("./ip.js").IPFamily;
+            followRedirects?: boolean;
+            skipSSL?: boolean;
+            assertions?: import("./url-assertion.js").UrlAssertion[];
+        };
+        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;
+    };
+}