checkly 0.0.0-canary.7166ed8

package/dist/constructs/agentic-check.d.ts

@@ -0,0 +1,130 @@
+import { Check, CheckProps } from './check.js';
+import { Frequency } from './frequency.js';
+import { Diagnostics } from './diagnostics.js';
+/**
+ * Frequencies for agentic checks are accepted locally and enforced by the
+ * backend according to the account's entitlements.
+ */
+export type AgenticCheckFrequency = number | Frequency;
+/**
+ * Configures the runtime context the agent has access to during a check.
+ *
+ * `agentRuntime` lets you add extra skills on top of the defaults the runner
+ * provides automatically.
+ */
+export interface AgentRuntime {
+    /**
+     * Additional skills to load into the agent's runtime, on top of the
+     * defaults the runner provides automatically (currently the
+     * `playwright-cli` skill is preloaded for browser automation).
+     *
+     * Each entry is passed verbatim to `npx skills add` on the runner, so
+     * any third-party skill published to [skills.sh](https://skills.sh)
+     * works — not just Checkly's own. Supported identifier forms:
+     *
+     * - A full skills.sh URL — e.g. `'https://skills.sh/microsoft/playwright-cli/playwright-cli'`
+     * - A `<owner>/<repo>` shorthand — e.g. `'addyosmani/web-quality-skills'`
+     * - A plain skill name registered on skills.sh — e.g. `'cost-optimization'`
+     *
+     * @example ['addyosmani/web-quality-skills']
+     */
+    skills?: string[];
+}
+/**
+ * Configuration properties for {@link AgenticCheck}.
+ *
+ * Agentic checks intentionally expose only the subset of options that the
+ * Checkly platform currently supports for them. Properties such as
+ * `privateLocations`, `runParallel`, `retryStrategy`, `shouldFail`,
+ * `doubleCheck`, `triggerIncident` and `groupId` are omitted because the
+ * platform does not yet honor them for agentic checks. They will be added back
+ * as additive, non-breaking changes once support lands.
+ */
+export interface AgenticCheckProps extends Omit<CheckProps, 'privateLocations' | 'runParallel' | 'retryStrategy' | 'shouldFail' | 'doubleCheck' | 'triggerIncident' | 'groupId' | 'frequency'> {
+    /**
+     * The prompt that defines what the agentic check should verify.
+     * Maximum 10,000 characters.
+     */
+    prompt: string;
+    /**
+     * How often the check should run. The backend enforces the fastest allowed
+     * cadence according to the account's entitlements. Defaults to
+     * {@link Frequency.EVERY_30M}.
+     *
+     * @example
+     * ```typescript
+     * frequency: Frequency.EVERY_5M
+     * // or equivalently
+     * frequency: 5
+     * ```
+     */
+    frequency?: AgenticCheckFrequency;
+    /**
+     * Configures additional skills the agent can use during execution.
+     */
+    agentRuntime?: AgentRuntime;
+}
+/**
+ * Creates an Agentic Check that uses AI to monitor websites and applications.
+ *
+ * Agentic checks use a prompt to define what should be verified, without
+ * requiring traditional scripts. The AI agent interprets the prompt and
+ * performs the checks.
+ *
+ * @example
+ * ```typescript
+ * new AgenticCheck('homepage-health', {
+ *   name: 'Homepage Health Check',
+ *   prompt: `
+ *     Navigate to https://example.com and verify:
+ *     1. The page loads with a 200 status
+ *     2. The main heading is visible
+ *     3. No console errors are present
+ *   `,
+ * })
+ * ```
+ */
+export declare class AgenticCheck extends Check {
+    readonly prompt: string;
+    readonly agentRuntime?: AgentRuntime;
+    /**
+     * Constructs the Agentic Check instance.
+     *
+     * @param logicalId unique project-scoped resource name identification
+     * @param props check configuration properties
+     */
+    constructor(logicalId: string, props: AgenticCheckProps);
+    describe(): string;
+    validate(diagnostics: Diagnostics): Promise<void>;
+    protected validateAgentRuntime(diagnostics: Diagnostics): Promise<void>;
+    synthesize(): {
+        checkType: "AGENTIC";
+        prompt: string;
+        agentRuntime: {
+            skills: string[];
+        };
+        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;
+        doubleCheck: boolean | 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/agentic-check.js

@@ -0,0 +1,100 @@
+import { Check } from './check.js';
+import { Session } from './session.js';
+import { CheckTypes } from '../constants.js';
+import { InvalidPropertyValueDiagnostic } from './construct-diagnostics.js';
+/**
+ * Backwards-compatible default for checks that do not set a location and do
+ * not inherit one from the project config.
+ */
+const DEFAULT_AGENTIC_CHECK_LOCATION = 'us-east-1';
+/**
+ * Creates an Agentic Check that uses AI to monitor websites and applications.
+ *
+ * Agentic checks use a prompt to define what should be verified, without
+ * requiring traditional scripts. The AI agent interprets the prompt and
+ * performs the checks.
+ *
+ * @example
+ * ```typescript
+ * new AgenticCheck('homepage-health', {
+ *   name: 'Homepage Health Check',
+ *   prompt: `
+ *     Navigate to https://example.com and verify:
+ *     1. The page loads with a 200 status
+ *     2. The main heading is visible
+ *     3. No console errors are present
+ *   `,
+ * })
+ * ```
+ */
+export class AgenticCheck extends Check {
+    prompt;
+    agentRuntime;
+    /**
+     * Constructs the Agentic Check instance.
+     *
+     * @param logicalId unique project-scoped resource name identification
+     * @param props check configuration properties
+     */
+    constructor(logicalId, props) {
+        super(logicalId, props);
+        this.prompt = props.prompt;
+        this.agentRuntime = props.agentRuntime;
+        // Preserve the old implicit single-region behavior for checks that do not
+        // set locations directly and do not inherit project-level locations.
+        this.locations ??= [DEFAULT_AGENTIC_CHECK_LOCATION];
+        // Defensive overrides: even though these props are omitted from the type,
+        // `Check.applyConfigDefaults()` may pull them in from the project-level
+        // `checks` config defaults. Force them to values the platform currently
+        // honors so the construct never claims to support something it doesn't.
+        this.privateLocations = undefined;
+        this.runParallel = false;
+        this.retryStrategy = undefined;
+        this.shouldFail = undefined;
+        this.doubleCheck = undefined;
+        this.triggerIncident = undefined;
+        // Default frequency to 30m if the user did not specify one.
+        if (this.frequency === undefined) {
+            this.frequency = 30;
+        }
+        Session.registerConstruct(this);
+        this.addSubscriptions();
+    }
+    describe() {
+        return `AgenticCheck:${this.logicalId}`;
+    }
+    async validate(diagnostics) {
+        await super.validate(diagnostics);
+        if (!this.prompt || this.prompt.trim().length === 0) {
+            diagnostics.add(new InvalidPropertyValueDiagnostic('prompt', new Error('"prompt" is required and must not be empty.')));
+        }
+        else if (this.prompt.length > 10_000) {
+            diagnostics.add(new InvalidPropertyValueDiagnostic('prompt', new Error(`"prompt" must be at most 10000 characters, got ${this.prompt.length}.`)));
+        }
+        this.validateAgentRuntime(diagnostics);
+    }
+    // eslint-disable-next-line require-await
+    async validateAgentRuntime(diagnostics) {
+        if (this.agentRuntime?.skills) {
+            for (const [index, skill] of this.agentRuntime.skills.entries()) {
+                if (typeof skill !== 'string' || skill.trim().length === 0) {
+                    diagnostics.add(new InvalidPropertyValueDiagnostic('agentRuntime.skills', new Error(`"agentRuntime.skills[${index}]" must be a non-empty string.`)));
+                }
+            }
+        }
+    }
+    synthesize() {
+        return {
+            ...super.synthesize(),
+            checkType: CheckTypes.AGENTIC,
+            prompt: this.prompt,
+            // Always emit `agentRuntime` so the backend has an explicit picture of
+            // the skills the user wants. Omitted skills mean "the agent should not
+            // have them", not "preserve whatever was there before".
+            agentRuntime: {
+                skills: this.agentRuntime?.skills ?? [],
+            },
+        };
+    }
+}
+//# sourceMappingURL=agentic-check.js.map

package/dist/constructs/agentic-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentic-check.js","sourceRoot":"","sources":["../../src/constructs/agentic-check.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,37 @@
+import { Codegen, Context } from './internal/codegen/index.js';
+import { Program, GeneratedFile, ObjectValueBuilder, Value } from '../sourcegen/index.js';
+import { EmailAlertChannelCodegen } from './email-alert-channel-codegen.js';
+import { OpsgenieAlertChannelCodegen } from './opsgenie-alert-channel-codegen.js';
+import { PagerdutyAlertChannelCodegen } from './pagerduty-alert-channel-codegen.js';
+import { PhoneCallAlertChannelCodegen } from './phone-call-alert-channel-codegen.js';
+import { SlackAlertChannelCodegen } from './slack-alert-channel-codegen.js';
+import { SlackAppAlertChannelCodegen } from './slack-app-alert-channel-codegen.js';
+import { SmsAlertChannelCodegen } from './sms-alert-channel-codegen.js';
+import { WebhookAlertChannelCodegen } from './webhook-alert-channel-codegen.js';
+export type AlertChannelType = 'CALL' | 'EMAIL' | 'OPSGENIE' | 'PAGERDUTY' | 'SLACK' | 'SLACK_APP' | 'SMS' | 'WEBHOOK';
+export interface AlertChannelResource {
+    id: number;
+    type: AlertChannelType;
+    sendRecovery: boolean;
+    sendFailure: boolean;
+    sendDegraded: boolean;
+    sslExpiry: boolean;
+    sslExpiryThreshold: number;
+}
+export declare function buildAlertChannelProps(builder: ObjectValueBuilder, resource: AlertChannelResource): void;
+export declare function valueForAlertChannelFromId(genfile: GeneratedFile, physicalId: number): Value;
+export declare class AlertChannelCodegen extends Codegen<AlertChannelResource> {
+    phoneCallCodegen: PhoneCallAlertChannelCodegen;
+    emailCodegen: EmailAlertChannelCodegen;
+    opsgenieCodegen: OpsgenieAlertChannelCodegen;
+    pagerdutyCodegen: PagerdutyAlertChannelCodegen;
+    slackCodegen: SlackAlertChannelCodegen;
+    slackAppCodegen: SlackAppAlertChannelCodegen;
+    smsCodegen: SmsAlertChannelCodegen;
+    webhookCodegen: WebhookAlertChannelCodegen;
+    codegensByType: Record<AlertChannelType, Codegen<any>>;
+    constructor(program: Program);
+    describe(resource: AlertChannelResource): string;
+    prepare(logicalId: string, resource: AlertChannelResource, context: Context): void;
+    gencode(logicalId: string, resource: AlertChannelResource, context: Context): void;
+}

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

@@ -0,0 +1,96 @@
+import { Codegen } from './internal/codegen/index.js';
+import { expr, ident } from '../sourcegen/index.js';
+import { EmailAlertChannelCodegen } from './email-alert-channel-codegen.js';
+import { OpsgenieAlertChannelCodegen } from './opsgenie-alert-channel-codegen.js';
+import { PagerdutyAlertChannelCodegen } from './pagerduty-alert-channel-codegen.js';
+import { PhoneCallAlertChannelCodegen } from './phone-call-alert-channel-codegen.js';
+import { SlackAlertChannelCodegen } from './slack-alert-channel-codegen.js';
+import { SlackAppAlertChannelCodegen } from './slack-app-alert-channel-codegen.js';
+import { SmsAlertChannelCodegen } from './sms-alert-channel-codegen.js';
+import { WebhookAlertChannelCodegen } from './webhook-alert-channel-codegen.js';
+export function buildAlertChannelProps(builder, resource) {
+    // The default value for sendRecovery is true, only include if false.
+    if (resource.sendRecovery !== undefined && !resource.sendRecovery) {
+        builder.boolean('sendRecovery', resource.sendRecovery);
+    }
+    // The default value for sendFailure is true, only include if false.
+    if (resource.sendFailure !== undefined && !resource.sendFailure) {
+        builder.boolean('sendFailure', resource.sendFailure);
+    }
+    // The default value for sendDegraded is false, only include if true.
+    if (resource.sendDegraded !== undefined && resource.sendDegraded) {
+        builder.boolean('sendDegraded', resource.sendDegraded);
+    }
+    // The default value for sslExpiry is false, only include if true.
+    if (resource.sslExpiry !== undefined && resource.sslExpiry) {
+        builder.boolean('sslExpiry', resource.sslExpiry);
+    }
+    // The default value for sslExpiryThreshold is 30, only include if other.
+    if (resource.sslExpiryThreshold !== undefined && resource.sslExpiryThreshold !== 30) {
+        builder.number('sslExpiryThreshold', resource.sslExpiryThreshold);
+    }
+}
+const construct = 'AlertChannel';
+export function valueForAlertChannelFromId(genfile, physicalId) {
+    genfile.namedImport(construct, 'checkly/constructs');
+    return expr(ident(construct), builder => {
+        builder.member(ident('fromId'));
+        builder.call(builder => {
+            builder.number(physicalId);
+        });
+    });
+}
+export class AlertChannelCodegen extends Codegen {
+    phoneCallCodegen;
+    emailCodegen;
+    opsgenieCodegen;
+    pagerdutyCodegen;
+    slackCodegen;
+    slackAppCodegen;
+    smsCodegen;
+    webhookCodegen;
+    codegensByType;
+    constructor(program) {
+        super(program);
+        this.phoneCallCodegen = new PhoneCallAlertChannelCodegen(program);
+        this.emailCodegen = new EmailAlertChannelCodegen(program);
+        this.opsgenieCodegen = new OpsgenieAlertChannelCodegen(program);
+        this.pagerdutyCodegen = new PagerdutyAlertChannelCodegen(program);
+        this.slackCodegen = new SlackAlertChannelCodegen(program);
+        this.slackAppCodegen = new SlackAppAlertChannelCodegen(program);
+        this.smsCodegen = new SmsAlertChannelCodegen(program);
+        this.webhookCodegen = new WebhookAlertChannelCodegen(program);
+        this.codegensByType = {
+            CALL: this.phoneCallCodegen,
+            EMAIL: this.emailCodegen,
+            OPSGENIE: this.opsgenieCodegen,
+            PAGERDUTY: this.pagerdutyCodegen,
+            SLACK: this.slackCodegen,
+            SLACK_APP: this.slackAppCodegen,
+            SMS: this.smsCodegen,
+            WEBHOOK: this.webhookCodegen,
+        };
+    }
+    describe(resource) {
+        const codegen = this.codegensByType[resource.type];
+        if (codegen === undefined) {
+            throw new Error(`Unable to describe unsupported alert channel type '${resource.type}'.`);
+        }
+        return codegen.describe(resource);
+    }
+    prepare(logicalId, resource, context) {
+        const codegen = this.codegensByType[resource.type];
+        if (codegen === undefined) {
+            throw new Error(`Unable to generate code for unsupported alert channel type '${resource.type}'.`);
+        }
+        codegen.prepare(logicalId, resource, context);
+    }
+    gencode(logicalId, resource, context) {
+        const codegen = this.codegensByType[resource.type];
+        if (codegen === undefined) {
+            throw new Error(`Unable to generate code for unsupported alert channel type '${resource.type}'.`);
+        }
+        codegen.gencode(logicalId, resource, context);
+    }
+}
+//# sourceMappingURL=alert-channel-codegen.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"alert-channel-codegen.js","sourceRoot":"","sources":["../../src/constructs/alert-channel-codegen.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,11 @@
+import { Codegen, Context } from './internal/codegen/index.js';
+export interface AlertChannelSubscriptionResource {
+    alertChannelId: number;
+    groupId?: number;
+    checkId?: string;
+}
+export declare class AlertChannelSubscriptionCodegen extends Codegen<AlertChannelSubscriptionResource> {
+    describe(resource: AlertChannelSubscriptionResource): string;
+    prepare(logicalId: string, resource: AlertChannelSubscriptionResource, context: Context): void;
+    gencode(logicalId: string, resource: AlertChannelSubscriptionResource, context: Context): void;
+}

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

@@ -0,0 +1,20 @@
+import { Codegen } from './internal/codegen/index.js';
+export class AlertChannelSubscriptionCodegen extends Codegen {
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    describe(resource) {
+        return 'Alert Channel Subscription';
+    }
+    prepare(logicalId, resource, context) {
+        if (resource.checkId !== undefined) {
+            context.registerAlertChannelCheckSubscription(resource.alertChannelId, resource.checkId);
+        }
+        if (resource.groupId !== undefined) {
+            context.registerAlertChannelGroupSubscription(resource.alertChannelId, resource.groupId);
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    gencode(logicalId, resource, context) {
+        // Nothing to generate for this resource.
+    }
+}
+//# sourceMappingURL=alert-channel-subscription-codegen.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"alert-channel-subscription-codegen.js","sourceRoot":"","sources":["../../src/constructs/alert-channel-subscription-codegen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAW,MAAM,6BAA6B,CAAA;AAQ9D,MAAM,OAAO,+BAAgC,SAAQ,OAAyC;IAC5F,6DAA6D;IAC7D,QAAQ,CAAE,QAA0C;QAClD,OAAO,4BAA4B,CAAA;IACrC,CAAC;IAED,OAAO,CAAE,SAAiB,EAAE,QAA0C,EAAE,OAAgB;QACtF,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACnC,OAAO,CAAC,qCAAqC,CAAC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;QAC1F,CAAC;QAED,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACnC,OAAO,CAAC,qCAAqC,CAAC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;QAC1F,CAAC;IACH,CAAC;IAED,6DAA6D;IAC7D,OAAO,CAAE,SAAiB,EAAE,QAA0C,EAAE,OAAgB;QACtF,yCAAyC;IAC3C,CAAC;CACF"}

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

@@ -0,0 +1,46 @@
+import { Ref } from './ref.js';
+import { Construct } from './construct.js';
+export interface AlertChannelSubscriptionProps {
+    alertChannelId: Ref;
+    /**
+     * You can either pass a checkId or a groupId, but not both.
+     */
+    checkId?: Ref;
+    /**
+     * You can either pass a groupId or a checkId, but not both.
+     */
+    groupId?: Ref;
+    /**
+     * Determines if the suscription active or not.
+     */
+    activated: boolean;
+}
+/**
+ * Creates an Alert Channel Subscription
+ *
+ * @remarks
+ *
+ * This class make use of the Alert Channel Subscriptions endpoints.
+ */
+export declare class AlertChannelSubscription extends Construct {
+    alertChannelId: Ref;
+    checkId?: Ref;
+    groupId?: Ref;
+    activated: boolean;
+    static readonly __checklyType = "alert-channel-subscription";
+    /**
+     * Constructs the Alert Channel Syscription instance
+     *
+     * @param logicalId unique project-scoped resource name identification
+     * @param props alert channel subscription configuration properties
+     */
+    constructor(logicalId: string, props: AlertChannelSubscriptionProps);
+    describe(): string;
+    allowInChecklyConfig(): boolean;
+    synthesize(): {
+        alertChannelId: Ref;
+        checkId: Ref | undefined;
+        groupId: Ref | undefined;
+        activated: boolean;
+    };
+}

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

@@ -0,0 +1,45 @@
+import { Construct } from './construct.js';
+import { Session } from './session.js';
+/**
+ * Creates an Alert Channel Subscription
+ *
+ * @remarks
+ *
+ * This class make use of the Alert Channel Subscriptions endpoints.
+ */
+export class AlertChannelSubscription extends Construct {
+    alertChannelId;
+    checkId;
+    groupId;
+    activated;
+    static __checklyType = 'alert-channel-subscription';
+    /**
+     * Constructs the Alert Channel Syscription instance
+     *
+     * @param logicalId unique project-scoped resource name identification
+     * @param props alert channel subscription configuration properties
+     */
+    constructor(logicalId, props) {
+        super(AlertChannelSubscription.__checklyType, logicalId);
+        this.alertChannelId = props.alertChannelId;
+        this.checkId = props.checkId;
+        this.groupId = props.groupId;
+        this.activated = props.activated;
+        Session.registerConstruct(this);
+    }
+    describe() {
+        return `AlertChannelSubscription:${this.logicalId}`;
+    }
+    allowInChecklyConfig() {
+        return true;
+    }
+    synthesize() {
+        return {
+            alertChannelId: this.alertChannelId,
+            checkId: this.checkId,
+            groupId: this.groupId,
+            activated: this.activated,
+        };
+    }
+}
+//# sourceMappingURL=alert-channel-subscription.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"alert-channel-subscription.js","sourceRoot":"","sources":["../../src/constructs/alert-channel-subscription.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAkBtC;;;;;;GAMG;AACH,MAAM,OAAO,wBAAyB,SAAQ,SAAS;IACrD,cAAc,CAAK;IACnB,OAAO,CAAM;IACb,OAAO,CAAM;IACb,SAAS,CAAS;IAElB,MAAM,CAAU,aAAa,GAAG,4BAA4B,CAAA;IAE5D;;;;;OAKG;IACH,YAAa,SAAiB,EAAE,KAAoC;QAClE,KAAK,CAAC,wBAAwB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAA;QACxD,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,CAAA;QAC1C,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA;QAC5B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA;QAC5B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAA;QAChC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAA;IACjC,CAAC;IAED,QAAQ;QACN,OAAO,4BAA4B,IAAI,CAAC,SAAS,EAAE,CAAA;IACrD,CAAC;IAED,oBAAoB;QAClB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,UAAU;QACR,OAAO;YACL,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAA;IACH,CAAC"}

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

@@ -0,0 +1,130 @@
+import { Construct } from './construct.js';
+import { Diagnostics } from './diagnostics.js';
+/**
+ * Configuration properties for alert channels.
+ * These properties control when and how alerts are sent.
+ *
+ * @example
+ * ```typescript
+ * // Alert channel with custom settings
+ * {
+ *   sendRecovery: true,      // Alert when check recovers (default)
+ *   sendFailure: true,       // Alert when check fails (default)
+ *   sendDegraded: false,     // Don't alert for degraded performance (default)
+ *   sslExpiry: true,         // Alert for SSL certificate expiration
+ *   sslExpiryThreshold: 7    // Alert 7 days before SSL expiry
+ * }
+ * ```
+ */
+export interface AlertChannelProps {
+    /**
+     * Determines if an alert should be sent for check recoveries.
+     * When a failing check starts passing again, recovery alerts notify that the issue is resolved.
+     *
+     * @defaultValue true
+     */
+    sendRecovery?: boolean;
+    /**
+     * Determines if an alert should be sent for check failures.
+     * When a check fails, failure alerts notify that there's an issue requiring attention.
+     *
+     * @defaultValue true
+     */
+    sendFailure?: boolean;
+    /**
+     * Determines if an alert should be sent when a check is degraded.
+     * Degraded alerts are triggered when response times exceed the degraded threshold.
+     *
+     * @defaultValue false
+     */
+    sendDegraded?: boolean;
+    /**
+     * Determines if an alert should be sent for expiring SSL certificates.
+     * SSL expiry alerts help prevent certificate-related outages.
+     *
+     * @defaultValue false
+     */
+    sslExpiry?: boolean;
+    /**
+     * At what moment in time to start alerting on SSL certificates.
+     * Specifies how many days before expiration to send the first SSL alert.
+     *
+     * @defaultValue 30
+     * @minimum 1
+     * @maximum 30
+     * @example
+     * ```typescript
+     * sslExpiryThreshold: 7  // Alert 7 days before SSL certificate expires
+     * sslExpiryThreshold: 30 // Alert 30 days before expiration (default)
+     * ```
+     */
+    sslExpiryThreshold?: number;
+}
+/**
+ * Creates a reference to an existing Alert Channel.
+ *
+ * References link existing resources to a project without managing them.
+ *
+ * Use {@link AlertChannel.fromId()} instead of instantiating this class directly.
+ */
+export declare class AlertChannelRef extends Construct {
+    constructor(logicalId: string, physicalId: number);
+    describe(): string;
+    validate(diagnostics: Diagnostics): Promise<void>;
+    allowInChecklyConfig(): boolean;
+    synthesize(): null;
+}
+/**
+ * Base class for creating alert channels that notify when checks fail or recover.
+ *
+ * Alert channels define how and when to send notifications when monitoring checks
+ * fail, recover, or enter a degraded state. Checkly supports multiple alert channel types
+ * including email, SMS, Slack, webhooks, and third-party integrations.
+ *
+ * **Plan Limitations:**
+ * - **Hobby**: Up to 50 alert channels
+ * - **Trial**: Up to 200 alert channels
+ * - **Pay-as-you-go**: Up to 200 alert channels
+ * - **Contract**: Up to 500 alert channels
+ *
+ * @example
+ * ```typescript
+ * // Email alert channel
+ * const emailAlert = new EmailAlertChannel('team-email', {
+ *   address: 'alerts@example.com',
+ *   sendFailure: true,
+ *   sendRecovery: true,
+ *   sendDegraded: false
+ * })
+ *
+ * // Slack App alert channel with SSL monitoring
+ * const slackAlert = new SlackAppAlertChannel('team-slack', {
+ *   slackChannels: ['#alerts'],
+ *   sslExpiry: true,
+ *   sslExpiryThreshold: 7  // Alert 7 days before SSL expiry
+ * })
+ * ```
+ *
+ * @see {@link https://www.checklyhq.com/docs/communicate/alerts/channels/ | Alert Channels Documentation}
+ */
+export declare abstract class AlertChannel extends Construct {
+    sendRecovery?: boolean;
+    sendFailure?: boolean;
+    sendDegraded?: boolean;
+    sslExpiry?: boolean;
+    sslExpiryThreshold?: number;
+    static readonly __checklyType = "alert-channel";
+    /**
+     * Constructs the Alert Channel instance
+     *
+     * @param logicalId unique project-scoped resource name identification
+     * @param props alert channel configuration properties
+     */
+    constructor(logicalId: string, props: AlertChannelProps);
+    /**
+     * @param id - The numeric ID of the existing alert channel
+     */
+    static fromId(id: number): AlertChannelRef;
+    allowInChecklyConfig(): boolean;
+    synthesize(): any | null;
+}