checkly 9.5.0 → 10.0.0-prerelease-4f88d60

package/dist/rest/usage.d.ts

@@ -1,31 +1,62 @@
 import type { AxiosInstance } from 'axios';
 export declare const USAGE_INTERVALS: readonly ["total", "day", "week", "month"];
 export type UsageInterval = typeof USAGE_INTERVALS[number];
-export declare const USAGE_GROUP_BY: readonly ["account", "checkType", "account,checkType"];
-export type UsageGroupBy = typeof USAGE_GROUP_BY[number];
-export type UsageWarningCode = 'PARTIAL_WINDOW' | 'USAGE_TERMS_FLAGGED' | 'UNKNOWN_BUDGET';
-export type UsageErrorCode = 'ACCOUNT_NOT_IN_USAGE_TERMS' | 'INVALID_CURSOR' | 'INVALID_RANGE' | 'NO_USAGE_TERMS' | 'USAGE_STORE_UNAVAILABLE' | 'USAGE_TERMS_CONFLICT';
-export interface UsageTermsParams {
-    /** YYYY-MM-DD, inclusive. Resolves the usage terms that cover this date. Defaults to today. */
-    to?: string;
+export declare const USAGE_GROUP_DIMENSIONS: readonly ["account", "usageTerm", "pricingRule", "checkType"];
+export type UsageGroupDimension = typeof USAGE_GROUP_DIMENSIONS[number];
+export declare const USAGE_SERIES_INCLUDES: readonly ["calculations", "runs"];
+export type UsageSeriesInclude = typeof USAGE_SERIES_INCLUDES[number];
+export declare const USAGE_PRICING_RULE_KEYS: readonly ["apiChecks", "multistepChecks", "browserChecks", "playwrightCheckSuites", "uptimeMonitors", "aiInvocations", "statusPages", "statusPageAdditionalServices", "statusPageAdditionalSubscribers", "additionalSms", "additionalPhoneAlerts"];
+export type UsagePricingRuleKey = typeof USAGE_PRICING_RULE_KEYS[number];
+export type UsageCheckType = 'AGENTIC' | 'API' | 'BROWSER' | 'HEARTBEAT' | 'ICMP' | 'MULTI_STEP' | 'TCP' | 'PLAYWRIGHT' | 'URL' | 'DNS' | 'SSL' | 'GRPC' | 'TRACEROUTE';
+export type UsageCreditsUsed = number | null;
+export type UsagePackageModel = 'limits' | 'credits';
+export interface UsagePeriod {
+    from: string;
+    to: string;
+}
+export interface UsageCoverage {
+    gaps: UsagePeriod[];
+}
+export interface UnitPricingRule {
+    method: 'per_unit';
+    quantity: number;
+    unit: string;
+    credits: number;
+    rates?: Array<{
+        when: string;
+        credits: number;
+    }>;
+    included?: {
+        quantity: number;
+        period?: string;
+    };
 }
-export interface UsageRangeParams extends UsageTermsParams {
-    /** YYYY-MM-DD, inclusive. */
-    from?: string;
-    accountIds?: string[];
-    checkTypes?: string[];
+export interface PeriodPricingRule {
+    method: 'per_period';
+    period: 'day';
+    price: {
+        annualCredits: number;
+    };
 }
-export interface UsageSeriesParams extends UsageRangeParams {
-    interval?: UsageInterval;
-    groupBy?: UsageGroupBy;
-    limit?: number;
-    nextId?: string;
+export interface CapacityBlockPricingRule {
+    method: 'capacity_blocks_per_period';
+    period: 'day';
+    unit: string;
+    included: {
+        quantity: number;
+    };
+    block: {
+        quantity: number;
+        annualCredits: number;
+    };
 }
+export type UsagePricingRule = UnitPricingRule | PeriodPricingRule | CapacityBlockPricingRule;
+export type UsagePricingRules = Partial<Record<UsagePricingRuleKey, UsagePricingRule>>;
 export interface UsageAccount {
     id: string;
     name: string;
 }
-export interface UsageTerms {
+export interface UsageTerm {
     id: string;
     name: string;
     accounts: UsageAccount[];
@@ -35,56 +66,119 @@ export interface UsageTerms {
     creditBudget: number | null;
     standardCreditsPerUnit: number | null;
     premiumCreditsPerUnit: number | null;
+    packageModel: UsagePackageModel | null;
+    pricingRules: UsagePricingRules | null;
+}
+export interface UsageTermsCollection {
+    data: UsageTerm[];
+    nextId: string | null;
 }
-export interface UsageCredits {
-    used: number | null;
-    percentOfBudget: number | null;
+export interface UnitUsageCalculation {
+    rateCondition: string | null;
+    measuredQuantity: number;
+    includedQuantity: number | null;
+    billableQuantity: number | null;
+    creditsUsed: UsageCreditsUsed;
+}
+export interface PeriodUsageCalculation {
+    billableResourceDays: number;
+    appliedDailyCredits: number;
+    proration: {
+        daysPerYear: 365;
+    };
+    creditsUsed: UsageCreditsUsed;
+}
+export interface CapacityBlockUsageCalculation {
+    scope: 'statusPage';
+    measuredQuantity: number;
+    includedQuantity: number;
+    billableBlockDays: number;
+    appliedDailyCreditsPerBlock: number;
+    proration: {
+        daysPerYear: 365;
+    };
+    creditsUsed: UsageCreditsUsed;
+}
+export type UsageCalculation = UnitUsageCalculation | PeriodUsageCalculation | CapacityBlockUsageCalculation;
+export interface UsageBreakdown {
+    usageTermsId: string;
+    pricingRuleKey: UsagePricingRuleKey;
+    accountId?: string;
+    period: UsagePeriod;
+    pricingRule: UsagePricingRule | null;
+    calculations: UsageCalculation[];
+    creditsUsed: UsageCreditsUsed;
+}
+export interface UsageSummary {
+    period: UsagePeriod;
+    usageTermsIds: string[];
+    totals: {
+        creditsUsed: UsageCreditsUsed;
+    };
+    breakdown: UsageBreakdown[];
+    coverage: UsageCoverage;
+}
+export interface UsageContribution {
+    usageTermsId: string;
+    pricingRuleKey: UsagePricingRuleKey;
+    creditsUsed: UsageCreditsUsed;
+    period?: UsagePeriod;
+    pricingRule?: UsagePricingRule | null;
+    calculations?: UsageCalculation[];
 }
-export interface CheckRunMeasures {
+export interface UsageRunCounts {
     totalRuns: number;
     finalRuns: number;
     retryRuns: number;
     cancelledRuns: number;
-    multiStepRequests: number;
-    playwrightBillableDurationMs: number;
     degradedRuns: number;
     failedRuns: number;
     errorRuns: number;
     abortedRuns: number;
     overMaxResponseTimeRuns: number;
-    standardBillableUnits: number;
-    premiumBillableUnits: number;
-}
-export interface AiInvocationMeasures {
-    invocations: number;
-    durationMs: number;
-}
-export type UsageMeter = {
-    meterType: 'CHECK_RUN';
-    measures: CheckRunMeasures;
-} | {
-    meterType: 'AI_INVOCATION';
-    measures: AiInvocationMeasures;
-};
-export interface UsageMetrics {
-    credits: UsageCredits;
-    meters: UsageMeter[];
-}
-export interface UsageWarning {
-    code: UsageWarningCode;
-    message: string;
+}
+export interface UsageSeriesRow {
+    periodStart: string;
+    periodEnd: string;
+    dimensions: {
+        accountId?: string;
+        usageTermsId?: string;
+        pricingRuleKey?: UsagePricingRuleKey;
+        checkType?: UsageCheckType | null;
+    };
+    creditsUsed: UsageCreditsUsed;
+    contributions: UsageContribution[];
+    runs?: UsageRunCounts | null;
+}
+export interface UsageSeries {
+    period: UsagePeriod;
+    usageTermsIds: string[];
+    interval: UsageInterval;
+    groupBy: UsageGroupDimension[];
+    data: UsageSeriesRow[];
+    coverage: UsageCoverage;
+    nextId: string | null;
 }
 export interface UsageProjectionWindow {
-    usage: UsageMetrics;
+    period: UsagePeriod | null;
+    observedDays: number;
+    creditsUsed: UsageCreditsUsed;
+    averageDailyCredits: number | null;
     projectedAnnualPercentOfBudget: number | null;
     projectedCreditsAtContractEnd: number | null;
+    projectedRemainingCredits: number | null;
     projectedPercentAtContractEnd: number | null;
     projectedWeeksUntilExhausted: number | null;
 }
 export interface UsageProjections {
+    usageTermsId: string;
+    asOf: string;
+    period: UsagePeriod | null;
     weeksSinceStart: number;
     weeksRemaining: number;
+    creditsUsed: UsageCreditsUsed;
     remainingCredits: number | null;
+    budgetedDailyCredits: number | null;
     windows: {
         sinceStart: UsageProjectionWindow;
         last30Days: UsageProjectionWindow;
@@ -92,39 +186,36 @@ export interface UsageProjections {
         last1Day: UsageProjectionWindow;
     };
 }
-export interface UsageSummary {
-    usageTermsId: string;
-    period: {
-        from: string;
-        to: string;
-    };
-    totals: UsageMetrics;
-    projections: UsageProjections;
+export interface UsageTermsParams {
+    from?: string;
+    to?: string;
+    limit?: number;
+    nextId?: string;
 }
-export interface UsageRow extends UsageMetrics {
-    periodStart: string;
-    periodEnd: string;
-    accountId?: string;
-    checkType?: string;
+export interface UsageRangeParams {
+    from?: string;
+    to?: string;
+    usageTermsIds?: string[];
+    accountIds?: string[];
+    pricingRuleKeys?: UsagePricingRuleKey[];
 }
-export interface UsageSeries {
-    usageTermsId: string;
-    period: {
-        from: string;
-        to: string;
-        interval: UsageInterval;
-        groupBy: UsageGroupBy;
-    };
-    data: UsageRow[];
-    length: number;
-    nextId: string | null;
-    warnings: UsageWarning[];
+export interface UsageSeriesParams extends UsageRangeParams {
+    interval?: UsageInterval;
+    groupBy?: UsageGroupDimension[];
+    include?: UsageSeriesInclude[];
+    limit?: number;
+    nextId?: string;
+}
+export interface UsageProjectionsParams {
+    asOf?: string;
 }
 declare class Usage {
-    api: AxiosInstance;
+    private readonly api;
     constructor(api: AxiosInstance);
-    getTerms(params?: UsageTermsParams): Promise<import("axios").AxiosResponse<UsageTerms, any, {}, any>>;
+    listTerms(params?: UsageTermsParams): Promise<import("axios").AxiosResponse<UsageTermsCollection, any, {}, any>>;
+    getTerm(id: string): Promise<import("axios").AxiosResponse<UsageTerm, any, {}, any>>;
     getSummary(params?: UsageRangeParams): Promise<import("axios").AxiosResponse<UsageSummary, any, {}, any>>;
     getSeries(params?: UsageSeriesParams): Promise<import("axios").AxiosResponse<UsageSeries, any, {}, any>>;
+    getProjections(id: string, params?: UsageProjectionsParams): Promise<import("axios").AxiosResponse<UsageProjections, any, {}, any>>;
 }
 export default Usage;

package/dist/rest/usage.js

@@ -1,20 +1,25 @@
 export const USAGE_INTERVALS = ['total', 'day', 'week', 'month'];
-export const USAGE_GROUP_BY = ['account', 'checkType', 'account,checkType'];
-// The API accepts repeated or comma-separated values. Axios would serialize
-// arrays as `accountIds[]=...`, which the API does not parse as a list, so join them.
+export const USAGE_GROUP_DIMENSIONS = ['account', 'usageTerm', 'pricingRule', 'checkType'];
+export const USAGE_SERIES_INCLUDES = ['calculations', 'runs'];
+export const USAGE_PRICING_RULE_KEYS = [
+    'apiChecks', 'multistepChecks', 'browserChecks', 'playwrightCheckSuites', 'uptimeMonitors', 'aiInvocations',
+    'statusPages', 'statusPageAdditionalServices', 'statusPageAdditionalSubscribers', 'additionalSms', 'additionalPhoneAlerts',
+];
 function toQuery(params) {
     const query = {};
     const set = (key, value) => {
         if (value !== undefined)
             query[key] = value;
     };
-    const joined = (values) => (values?.length ? values.join(',') : undefined);
+    const joined = (values) => values?.length ? values.join(',') : undefined;
     set('from', params.from);
     set('to', params.to);
+    set('usageTermsIds', joined(params.usageTermsIds));
     set('accountIds', joined(params.accountIds));
-    set('checkTypes', joined(params.checkTypes));
+    set('pricingRuleKeys', joined(params.pricingRuleKeys));
     set('interval', params.interval);
-    set('groupBy', params.groupBy);
+    set('groupBy', joined(params.groupBy));
+    set('include', joined(params.include));
     set('limit', params.limit);
     set('nextId', params.nextId);
     return query;
@@ -24,14 +29,20 @@ class Usage {
     constructor(api) {
         this.api = api;
     }
-    getTerms(params = {}) {
-        return this.api.get('/v1/usage/terms', { params: toQuery(params) });
+    listTerms(params = {}) {
+        return this.api.get('/v2/usage/terms', { params: toQuery(params) });
+    }
+    getTerm(id) {
+        return this.api.get(`/v2/usage/terms/${encodeURIComponent(id)}`);
     }
     getSummary(params = {}) {
-        return this.api.get('/v1/usage/summary', { params: toQuery(params) });
+        return this.api.get('/v2/usage/summary', { params: toQuery(params) });
     }
     getSeries(params = {}) {
-        return this.api.get('/v1/usage/series', { params: toQuery(params) });
+        return this.api.get('/v2/usage/series', { params: toQuery(params) });
+    }
+    getProjections(id, params = {}) {
+        return this.api.get(`/v2/usage/terms/${encodeURIComponent(id)}/projections`, { params });
     }
 }
 export default Usage;

package/dist/rest/usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/rest/usage.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAU,CAAA;AAGzE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,mBAAmB,CAAU,CAAA;AAoIpF,4EAA4E;AAC5E,sFAAsF;AACtF,SAAS,OAAO,CAAE,MAAyB;IACzC,MAAM,KAAK,GAA+B,EAAE,CAAA;IAC5C,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,KAA6B,EAAE,EAAE;QACzD,IAAI,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IAC7C,CAAC,CAAA;IACD,MAAM,MAAM,GAAG,CAAC,MAA4B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAEhG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;IACxB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAA;IACpB,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAA;IAC5C,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAA;IAC5C,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;IAChC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;IAC9B,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;IAC1B,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IAC5B,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,KAAK;IACT,GAAG,CAAe;IAClB,YAAa,GAAkB;QAC7B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;IAChB,CAAC;IAED,QAAQ,CAAE,SAA2B,EAAE;QACrC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAa,iBAAiB,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IACjF,CAAC;IAED,UAAU,CAAE,SAA2B,EAAE;QACvC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAe,mBAAmB,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IACrF,CAAC;IAED,SAAS,CAAE,SAA4B,EAAE;QACvC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAc,kBAAkB,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IACnF,CAAC;CACF;AAED,eAAe,KAAK,CAAA"}
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/rest/usage.ts"],"names":[],"mappings":"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"}

package/dist/services/abstract-check-runner.d.ts

@@ -14,7 +14,8 @@ export declare enum Events {
     MAX_SCHEDULING_DELAY_EXCEEDED = "MAX_SCHEDULING_DELAY_EXCEEDED",
     STREAM_LOGS = "STREAM_LOGS",
     CANCEL = "CANCEL",
-    DETACH = "DETACH"
+    DETACH = "DETACH",
+    MAX_FAILURES_REACHED = "MAX_FAILURES_REACHED"
 }
 export type PrivateRunLocation = {
     type: 'PRIVATE';
@@ -28,8 +29,12 @@ export type PublicRunLocation = {
 export type RunLocation = PublicRunLocation | PrivateRunLocation;
 export type CheckRunId = string;
 export type SequenceId = string;
+export type CheckFailure = {
+    timedOut?: boolean;
+};
 export declare const DEFAULT_CHECK_RUN_TIMEOUT_SECONDS = 600;
 export declare const DEFAULT_PLAYWRIGHT_CHECK_RUN_TIMEOUT_SECONDS = 1200;
+export declare const MAX_SCHEDULING_DELAY_SECONDS = 900;
 export default abstract class AbstractCheckRunner extends EventEmitter {
     checks: Map<SequenceId, {
         check: any;
@@ -42,7 +47,10 @@ export default abstract class AbstractCheckRunner extends EventEmitter {
     verbose: boolean;
     protected detach: boolean;
     queue: PQueue;
-    constructor(accountId: string, timeout: number, verbose: boolean, detach?: boolean);
+    readonly maxFailures?: number;
+    private _maxFailuresReached;
+    constructor(accountId: string, timeout: number, verbose: boolean, detach?: boolean, maxFailures?: number);
+    get maxFailuresReached(): boolean;
     abstract scheduleChecks(checkRunSuiteId: string): Promise<{
         testSessionId?: string;
         /** Present when the run was dispatched asynchronously (POST /v1/test-sessions/run). */
@@ -71,7 +79,31 @@ export default abstract class AbstractCheckRunner extends EventEmitter {
     private processMessage;
     processCheckResult(result: any): Promise<void>;
     private allChecksFinished;
+    /**
+     * Resolves once `maxFailures` checks have failed while other checks are
+     * still unfinished; never resolves otherwise (including when the failure
+     * that reaches the limit is the last check, which finishes the run
+     * normally). A failure is a check's final outcome: failed retry attempts
+     * and cancelled results do not count, so a check that passes on retry never
+     * stops the run.
+     *
+     * The stop happens synchronously in the CHECK_FINISHED listener, which every
+     * terminal path emits right after the outcome event. Stopping before the
+     * promise resolves keeps any result processed in the meantime from being
+     * reported.
+     */
+    private maxFailuresReachedOrNever;
     private setAllTimeouts;
+    /**
+     * Restart the result timeout for a check that is still running, without
+     * the scheduling-delay headroom. Called when the run starts and on every
+     * retry attempt. The timeout guards against a
+     * result that never arrives, not against a long but progressing retry
+     * sequence; the backend caps retries by count and cumulative time, so the
+     * total wait stays bounded. Only call this while the check is not terminal.
+     */
+    private resetTimeout;
+    private armTimeout;
     private disableAllTimeouts;
     private startSchedulingDelayTimeout;
     private disableTimeout;