@intentius/chant-lexicon-prometheus 0.97.0 → 0.99.0

package/dist/model.d.ts

@@ -12,6 +12,7 @@
  * so a declaration reads the same as the file it produces and the upstream
  * docs apply word for word.
  */
+import { type DiscordConfig, type EmailConfig, type HttpClientConfig, type IncidentioConfig, type JiraConfig, type MattermostConfig, type MSTeamsConfig, type MSTeamsV2Config, type OpsGenieConfig, type PagerDutyConfig, type PushoverConfig, type ReceiverIntegration, type RocketchatConfig, type SlackConfig, type SNSConfig, type TelegramConfig, type TlsConfig, type VictorOpsConfig, type WebexConfig, type WebhookConfig, type WechatConfig } from "./integrations.js";
 /** Labels or annotations: string keys to string values. */
 export type LabelSet = Record<string, string>;
 /** A recording rule: evaluates `expr` and stores the result as the series `record`. */
@@ -60,126 +61,30 @@ export declare function isRecordingRuleConfig(rule: unknown): rule is RecordingR
 export declare function isAlertingRuleConfig(rule: unknown): rule is AlertingRuleConfig;
 /** The rule's name: `record` for a recording rule, `alert` for an alerting rule. */
 export declare function ruleName(rule: RuleConfig): string;
-/** HTTP client settings shared by the receivers that make HTTP calls. */
-export interface HttpClientConfig {
-    basic_auth?: {
-        username?: string;
-        username_file?: string;
-        password?: string;
-        password_file?: string;
-    };
-    authorization?: {
-        type?: string;
-        credentials?: string;
-        credentials_file?: string;
-    };
-    bearer_token?: string;
-    bearer_token_file?: string;
-    oauth2?: Record<string, unknown>;
-    proxy_url?: string;
-    follow_redirects?: boolean;
-    enable_http2?: boolean;
-    tls_config?: {
-        ca_file?: string;
-        cert_file?: string;
-        key_file?: string;
-        server_name?: string;
-        insecure_skip_verify?: boolean;
-        min_version?: string;
-    };
-}
-interface NotifierBase {
-    /** Whether to notify about resolved alerts too. */
-    send_resolved?: boolean;
-}
-export interface WebhookConfig extends NotifierBase {
-    /** Where alerts are POSTed. Set this or `url_file`. */
-    url?: string;
-    url_file?: string;
-    http_config?: HttpClientConfig;
-    /** Most alerts per message; 0 sends them all. */
-    max_alerts?: number;
-    timeout?: string;
-}
-export interface EmailConfig extends NotifierBase {
-    to: string;
-    from?: string;
-    /** `host:port` of the SMTP server. Falls back to `global.smtp_smarthost`. */
-    smarthost?: string;
-    hello?: string;
-    auth_username?: string;
-    auth_password?: string;
-    auth_password_file?: string;
-    auth_secret?: string;
-    auth_secret_file?: string;
-    auth_identity?: string;
-    require_tls?: boolean;
-    tls_config?: HttpClientConfig["tls_config"];
-    html?: string;
-    text?: string;
-    headers?: Record<string, string>;
-}
-export interface SlackConfig extends NotifierBase {
-    /** The incoming-webhook URL. It is a credential: prefer `api_url_file`. */
-    api_url?: string;
-    api_url_file?: string;
-    channel?: string;
-    username?: string;
-    color?: string;
-    title?: string;
-    title_link?: string;
-    pretext?: string;
-    text?: string;
-    footer?: string;
-    fallback?: string;
-    icon_emoji?: string;
-    icon_url?: string;
-    link_names?: boolean;
-    short_fields?: boolean;
-    mrkdwn_in?: string[];
-    fields?: Array<{
-        title: string;
-        value: string;
-        short?: boolean;
-    }>;
-    actions?: Array<Record<string, unknown>>;
-    http_config?: HttpClientConfig;
-}
-export interface PagerDutyConfig extends NotifierBase {
-    /** Events API v2 integration key. A credential: prefer `routing_key_file`. */
-    routing_key?: string;
-    routing_key_file?: string;
-    /** Events API v1 integration key. A credential: prefer `service_key_file`. */
-    service_key?: string;
-    service_key_file?: string;
-    url?: string;
-    client?: string;
-    client_url?: string;
-    description?: string;
-    severity?: string;
-    class?: string;
-    component?: string;
-    group?: string;
-    source?: string;
-    details?: Record<string, string>;
-    links?: Array<{
-        href: string;
-        text?: string;
-    }>;
-    images?: Array<{
-        src: string;
-        alt?: string;
-        href?: string;
-    }>;
-    http_config?: HttpClientConfig;
-}
+export * from "./integrations.js";
 /** One entry under `receivers:`. */
 export interface ReceiverConfig {
     name: string;
-    webhook_configs?: WebhookConfig[];
+    /** Labels on the receiver, exposed to notification templates. */
+    labels?: LabelSet;
+    discord_configs?: DiscordConfig[];
     email_configs?: EmailConfig[];
-    slack_configs?: SlackConfig[];
+    incidentio_configs?: IncidentioConfig[];
     pagerduty_configs?: PagerDutyConfig[];
+    slack_configs?: SlackConfig[];
+    webhook_configs?: WebhookConfig[];
+    opsgenie_configs?: OpsGenieConfig[];
+    wechat_configs?: WechatConfig[];
+    pushover_configs?: PushoverConfig[];
+    victorops_configs?: VictorOpsConfig[];
+    sns_configs?: SNSConfig[];
+    telegram_configs?: TelegramConfig[];
+    webex_configs?: WebexConfig[];
+    msteams_configs?: MSTeamsConfig[];
+    msteamsv2_configs?: MSTeamsV2Config[];
+    jira_configs?: JiraConfig[];
+    rocketchat_configs?: RocketchatConfig[];
+    mattermost_configs?: MattermostConfig[];
 }
 /** A route in the routing tree. The top-level `route:` is the root. */
 export interface RouteConfig {
@@ -193,10 +98,17 @@ export interface RouteConfig {
     repeat_interval?: string;
     mute_time_intervals?: string[];
     active_time_intervals?: string[];
+    /**
+     * Labels on the route, inherited by child routes and exposed to
+     * notification templates as `routeLabels`. Values may be Go templates.
+     */
+    labels?: LabelSet;
     routes?: RouteConfig[];
 }
 /** One entry under `inhibit_rules:`. */
 export interface InhibitRuleConfig {
+    /** A name for the rule, shown in Alertmanager's logs and metrics. */
+    name?: string;
     source_matchers?: string[];
     target_matchers?: string[];
     /** Labels that must be equal on source and target for the inhibition to apply. */
@@ -225,12 +137,18 @@ export interface TimeIntervalConfig {
     name: string;
     time_intervals: TimePeriodConfig[];
 }
-/** `global:` settings. */
+/**
+ * `global:` settings: defaults the receivers fall back to. Credentials with
+ * a `*_file` sibling are best set through it; PROM001 flags a literal.
+ */
 export interface AlertmanagerGlobalConfig {
+    /** How long an alert that stops being updated stays firing. */
     resolve_timeout?: string;
+    http_config?: HttpClientConfig;
+    jira_api_url?: string;
     smtp_from?: string;
-    smtp_smarthost?: string;
     smtp_hello?: string;
+    smtp_smarthost?: string;
     smtp_auth_username?: string;
     smtp_auth_password?: string;
     smtp_auth_password_file?: string;
@@ -238,10 +156,48 @@ export interface AlertmanagerGlobalConfig {
     smtp_auth_secret_file?: string;
     smtp_auth_identity?: string;
     smtp_require_tls?: boolean;
+    smtp_tls_config?: TlsConfig;
+    smtp_force_implicit_tls?: boolean;
     slack_api_url?: string;
     slack_api_url_file?: string;
+    slack_app_token?: string;
+    slack_app_token_file?: string;
+    slack_app_url?: string;
     pagerduty_url?: string;
-    http_config?: HttpClientConfig;
+    opsgenie_api_url?: string;
+    opsgenie_api_key?: string;
+    opsgenie_api_key_file?: string;
+    wechat_api_url?: string;
+    wechat_api_secret?: string;
+    wechat_api_secret_file?: string;
+    wechat_api_corp_id?: string;
+    victorops_api_url?: string;
+    victorops_api_key?: string;
+    victorops_api_key_file?: string;
+    telegram_api_url?: string;
+    telegram_bot_token?: string;
+    telegram_bot_token_file?: string;
+    webex_api_url?: string;
+    rocketchat_api_url?: string;
+    rocketchat_token?: string;
+    rocketchat_token_file?: string;
+    rocketchat_token_id?: string;
+    rocketchat_token_id_file?: string;
+    mattermost_webhook_url?: string;
+    mattermost_webhook_url_file?: string;
+}
+/** Every `global:` field, as a list, for code that reads a parsed file. */
+export declare const ALERTMANAGER_GLOBAL_FIELDS: readonly (keyof AlertmanagerGlobalConfig)[];
+/** `tracing:` settings: where Alertmanager sends its own traces. */
+export interface AlertmanagerTracingConfig {
+    client_type?: "grpc" | "http";
+    endpoint?: string;
+    sampling_fraction?: number;
+    insecure?: boolean;
+    headers?: Record<string, string>;
+    compression?: string;
+    timeout?: string;
+    tls_config?: TlsConfig;
 }
 /** A whole `alertmanager.yml`, the file `amtool check-config` reads. */
 export interface AlertmanagerConfig {
@@ -251,12 +207,12 @@ export interface AlertmanagerConfig {
     inhibit_rules?: InhibitRuleConfig[];
     receivers?: ReceiverConfig[];
     time_intervals?: TimeIntervalConfig[];
+    tracing?: AlertmanagerTracingConfig;
 }
-/** The four receiver integrations this lexicon types. */
-export declare const RECEIVER_INTEGRATIONS: readonly ["webhook_configs", "email_configs", "slack_configs", "pagerduty_configs"];
+/** The receiver integrations, every one Alertmanager defines. */
+export declare const RECEIVER_INTEGRATIONS: readonly ReceiverIntegration[];
 /** True when a parsed document has the shape of a Prometheus rule file. */
 export declare function looksLikeRuleFile(value: unknown): value is RuleFileConfig;
 /** True when a parsed document has the shape of an `alertmanager.yml`. */
 export declare function looksLikeAlertmanagerConfig(value: unknown): value is AlertmanagerConfig;
-export {};
 //# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AAExB,2DAA2D;AAC3D,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9C,uFAAuF;AACvF,MAAM,WAAW,mBAAmB;IAClC,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB;AAED,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,oFAAoF;IACpF,WAAW,CAAC,EAAE,QAAQ,CAAC;CACxB;AAED,MAAM,MAAM,UAAU,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;AAElE,qGAAqG;AACrG,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oGAAoG;IACpG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,4FAA4F;AAC5F,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,mBAAmB,CAEhF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,kBAAkB,CAE9E;AAED,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEjD;AAID,cAAc,gBAAgB,CAAC;AAE/B,oCAAoC;AACpC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC;IAClC,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;IAC9B,kBAAkB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACxC,iBAAiB,CAAC,EAAE,eAAe,EAAE,CAAC;IACtC,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;IAC9B,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC;IAClC,gBAAgB,CAAC,EAAE,cAAc,EAAE,CAAC;IACpC,cAAc,CAAC,EAAE,YAAY,EAAE,CAAC;IAChC,gBAAgB,CAAC,EAAE,cAAc,EAAE,CAAC;IACpC,iBAAiB,CAAC,EAAE,eAAe,EAAE,CAAC;IACtC,WAAW,CAAC,EAAE,SAAS,EAAE,CAAC;IAC1B,gBAAgB,CAAC,EAAE,cAAc,EAAE,CAAC;IACpC,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;IAC9B,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC;IAClC,iBAAiB,CAAC,EAAE,eAAe,EAAE,CAAC;IACtC,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;IAC5B,kBAAkB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACxC,kBAAkB,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACzC;AAED,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,wCAAwC;AACxC,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,kFAAkF;AAClF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,eAAe,EAAE,CAAC;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,wBAAwB;IACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,gBAAgB,EAAE,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5B,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,2BAA2B,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,2EAA2E;AAC3E,eAAO,MAAM,0BAA0B,EA2CuB,SAAS,CAAC,MAAM,wBAAwB,CAAC,EAAE,CAAC;AAE1G,oEAAoE;AACpE,MAAM,WAAW,yBAAyB;IACxC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED,wEAAwE;AACxE,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,aAAa,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACpC,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,cAAc,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACtC,OAAO,CAAC,EAAE,yBAAyB,CAAC;CACrC;AAED,iEAAiE;AACjE,eAAO,MAAM,qBAAqB,EAA8C,SAAS,mBAAmB,EAAE,CAAC;AAE/G,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAczE;AAED,0EAA0E;AAC1E,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CASvF"}

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AA4B9D;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,aA6F9B,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AA+B9D;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,aAyG9B,CAAC"}

package/dist/rules/literal-credential.ts

@@ -1,26 +1,53 @@
 import * as ts from "typescript";
 import type { LintRule, LintDiagnostic, LintContext } from "@intentius/chant/lint/rule";
-import { calleeName, CREDENTIAL_CLASS, literalText, position, propertyName } from "./prom-ast";
+import { calleeName, constInitializers, CREDENTIAL_CLASS, literalText, position, propertyName, resolveConst } from "./prom-ast";
 
 /**
  * Alertmanager fields that hold a secret, each with a `*_file` sibling that
  * reads it from a mounted file instead.
  */
 export const SECRET_FIELDS = new Set([
-  "api_url", // slack_configs: the incoming-webhook URL is the credential
-  "slack_api_url",
-  "routing_key",
+  "api_url", // slack_configs only: the incoming-webhook URL is the credential (see SECRET_ONLY_IN)
+  "webhook_url", // discord, msteams, msteamsv2 and mattermost
+  "app_token",
+  "routing_key", // pagerduty (victorops' routing_key names a route, see SECRET_ONLY_IN)
   "service_key",
+  "api_key",
+  "api_secret",
+  "bot_token",
+  "token",
+  "token_id",
+  "user_key",
+  "alert_source_token",
   "auth_password",
   "auth_secret",
   "smtp_auth_password",
   "smtp_auth_secret",
+  "slack_api_url",
+  "slack_app_token",
+  "opsgenie_api_key",
+  "wechat_api_secret",
+  "victorops_api_key",
+  "telegram_bot_token",
+  "rocketchat_token",
+  "rocketchat_token_id",
+  "mattermost_webhook_url",
   "password",
   "credentials",
   "bearer_token",
   "client_secret",
 ]);
 
+/**
+ * Fields that are a secret in one integration and plain elsewhere: `api_url`
+ * is Slack's webhook credential but only an endpoint for the others, and a
+ * VictorOps `routing_key` names a route.
+ */
+const SECRET_ONLY_IN: Record<string, string> = {
+  api_url: "slack_configs",
+  routing_key: "pagerduty_configs",
+};
+
 /**
  * PROM001: a credential written as a literal in a `Receiver` or
  * `AlertmanagerSettings`.
@@ -41,16 +68,25 @@ export const literalCredentialRule: LintRule = {
     const diagnostics: LintDiagnostic[] = [];
     const source = context.sourceFile;
 
-    const scanValue = (key: string | undefined, init: ts.Expression) => {
-      if (ts.isObjectLiteralExpression(init)) {
-        scan(init);
-        return;
-      }
-      if (ts.isArrayLiteralExpression(init)) {
-        for (const el of init.elements) if (ts.isObjectLiteralExpression(el)) scan(el);
+    const consts = constInitializers(source);
+    const scanned = new Set<ts.Node>();
+
+    // A value is followed to the const it names, so a list lifted out of the
+    // constructor (`email_configs: heartbeatEmail`) is scanned where it is used.
+    // `integration` is the `*_configs` list a value sits in, when that is known.
+    const scanValue = (key: string | undefined, value: ts.Expression, integration?: string) => {
+      const init = resolveConst(value, consts);
+      const within = key?.endsWith("_configs") ? key : integration;
+      if (ts.isObjectLiteralExpression(init) || ts.isArrayLiteralExpression(init)) {
+        if (scanned.has(init)) return;
+        scanned.add(init);
+        if (ts.isObjectLiteralExpression(init)) scan(init, within);
+        else for (const el of init.elements) scanValue(undefined, el, within);
         return;
       }
       if (!key || !SECRET_FIELDS.has(key)) return;
+      const only = SECRET_ONLY_IN[key];
+      if (only && integration !== undefined && integration !== only) return;
       const text = literalText(init);
       if (text === undefined || text === "") return;
       diagnostics.push({
@@ -62,10 +98,11 @@ export const literalCredentialRule: LintRule = {
       });
     };
 
-    const scan = (obj: ts.ObjectLiteralExpression) => {
+    const scan = (obj: ts.ObjectLiteralExpression, integration?: string) => {
       for (const prop of obj.properties) {
-        if (!ts.isPropertyAssignment(prop)) continue;
-        scanValue(propertyName(prop), prop.initializer);
+        if (ts.isPropertyAssignment(prop)) scanValue(propertyName(prop), prop.initializer, integration);
+        else if (ts.isShorthandPropertyAssignment(prop)) scanValue(prop.name.text, prop.name, integration);
+        else if (ts.isSpreadAssignment(prop)) scanValue(undefined, prop.expression, integration);
       }
     };
 
@@ -73,7 +110,7 @@ export const literalCredentialRule: LintRule = {
       if (ts.isNewExpression(node) || ts.isCallExpression(node)) {
         const name = calleeName(node);
         const arg = node.arguments?.[0];
-        if (name && CREDENTIAL_CLASS.test(name) && arg && ts.isObjectLiteralExpression(arg)) scan(arg);
+        if (name && CREDENTIAL_CLASS.test(name) && arg) scanValue(undefined, arg);
       }
       ts.forEachChild(node, visit);
     };

package/dist/rules/prom-ast.ts

@@ -28,3 +28,39 @@ export function position(source: ts.SourceFile, node: ts.Node): { line: number;
   const { line, character } = source.getLineAndCharacterOfPosition(node.getStart(source));
   return { line: line + 1, column: character + 1 };
 }
+
+/**
+ * Every `const name = <initializer>` in the file, so a rule can follow a
+ * value lifted out of a constructor into a named const (the way COR001 asks
+ * for it, and the way `chant import` writes it) back to its literal.
+ */
+export function constInitializers(source: ts.SourceFile): Map<string, ts.Expression> {
+  const consts = new Map<string, ts.Expression>();
+  const collect = (node: ts.Node) => {
+    if (ts.isVariableDeclarationList(node) && node.flags & ts.NodeFlags.Const) {
+      for (const d of node.declarations) {
+        if (ts.isIdentifier(d.name) && d.initializer) consts.set(d.name.text, d.initializer);
+      }
+    }
+    ts.forEachChild(node, collect);
+  };
+  collect(source);
+  return consts;
+}
+
+/** `expr` itself, or the initializer of the const it names (followed through `as` and `satisfies`). */
+export function resolveConst(expr: ts.Expression, consts: Map<string, ts.Expression>): ts.Expression {
+  let cur = expr;
+  for (let hops = 0; hops < 8; hops++) {
+    if (ts.isAsExpression(cur) || ts.isSatisfiesExpression(cur) || ts.isParenthesizedExpression(cur)) {
+      cur = cur.expression;
+      continue;
+    }
+    if (ts.isIdentifier(cur) && consts.has(cur.text)) {
+      cur = consts.get(cur.text)!;
+      continue;
+    }
+    break;
+  }
+  return cur;
+}

package/dist/rules/promql-literal.ts

@@ -1,6 +1,6 @@
 import * as ts from "typescript";
 import type { LintRule, LintDiagnostic, LintContext } from "@intentius/chant/lint/rule";
-import { calleeName, literalText, position, propertyName } from "./prom-ast";
+import { calleeName, constInitializers, literalText, position, propertyName, resolveConst } from "./prom-ast";
 import { checkPromql } from "../../promql";
 
 /**
@@ -21,7 +21,21 @@ export const promqlLiteralRule: LintRule = {
     const diagnostics: LintDiagnostic[] = [];
     const source = context.sourceFile;
 
+    const consts = constInitializers(source);
+    const scanned = new Set<ts.Node>();
+
+    // Rules lifted into a const (`rules: apiRules`) are followed to it and
+    // checked where the group uses them.
+    const follow = (value: ts.Expression) => {
+      const init = resolveConst(value, consts);
+      if (init !== value && !scanned.has(init)) {
+        scanned.add(init);
+        scan(init);
+      }
+    };
     const scan = (node: ts.Node) => {
+      if (ts.isShorthandPropertyAssignment(node)) follow(node.name);
+      if (ts.isPropertyAssignment(node) && ts.isIdentifier(node.initializer)) follow(node.initializer);
       if (ts.isPropertyAssignment(node) && propertyName(node) === "expr") {
         const text = literalText(node.initializer);
         if (text !== undefined) {

package/dist/skills/chant-prometheus-alertmanager.md

@@ -47,6 +47,10 @@ export const pageMutesTicket = new InhibitRule({
 });
 ```
 
+## Starting from an existing alertmanager.yml
+
+Import it rather than retyping it: `chant import alertmanager.yml --output src` (with `--lexicon prometheus` outside a chant project). The importer writes `receivers.ts`, `time-intervals.ts`, `routes.ts` (the root `Route`, children as `RouteProps` that reference receivers and time intervals by variable), `inhibit-rules.ts` and `settings.ts`. `*_file` paths and Go templates are kept as written; a literal credential is imported as found and PROM001 reports it, so offer to move it to the `*_file` field. Every integration comes back typed (`OpsGenieConfig[]`, `MSTeamsV2Config[]`, ...); a receiver or `global` key Alertmanager doesn't define is spread in from an untyped const, with a warning. `match`/`match_re` and the top-level `mute_time_intervals` come back in their current spelling (`matchers`, `time_intervals`), and `chant import` prints a warning for each.
+
 ## What the checks hold you to
 
 - One root route (the `Route` no other route nests), with a receiver and no matchers (PROM205).

package/dist/skills/chant-prometheus.md

@@ -15,6 +15,17 @@ The prometheus lexicon (`@intentius/chant-lexicon-prometheus`) types Prometheus
 export default { lexicons: ["prometheus"] };
 ```
 
+## Starting from an existing rule file
+
+When the user already has a rule file, import it rather than retyping it:
+
+```bash
+chant import rules.yml --output src          # add --lexicon prometheus outside a chant project
+chant build src --lexicon prometheus -o rules.yml   # the same groups back
+```
+
+The importer writes `rules.ts` (per group, a `Rule[]` const of plain objects and a `RuleGroup`) and `slos.ts` for any group an `Slo()` built, as the `Slo` call. Multi-line expressions become template literals and Go templates in annotations stay as written. Read the warnings `chant import` prints: they name any field Prometheus doesn't define, which is not carried.
+
 ## Declaring a group
 
 A group takes the rule file's own keys (`name`, `interval`, `query_offset`, `limit`, `labels`, `rules`). Rules are plain objects: `record` + `expr` for a recording rule, `alert` + `expr` (+ `for`, `keep_firing_for`, `labels`, `annotations`) for an alerting rule.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-prometheus",
-  "version": "0.97.0",
+  "version": "0.99.0",
   "description": "Prometheus lexicon for chant — typed recording and alerting rule groups and Alertmanager routing, serialized to a rule file and alertmanager.yml",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",
@@ -71,7 +71,7 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@intentius/chant": "^0.97.0",
+    "@intentius/chant": "^0.99.0",
     "typescript": "^5.9.3"
   }
 }

package/src/alertmanager.ts

@@ -16,6 +16,7 @@ import { createResource } from "@intentius/chant/runtime";
 import type { Declarable } from "@intentius/chant/declarable";
 import type {
   AlertmanagerGlobalConfig,
+  AlertmanagerTracingConfig,
   InhibitRuleConfig,
   ReceiverConfig,
   RouteConfig,
@@ -112,13 +113,15 @@ export interface AlertmanagerSettingsProps {
   global?: AlertmanagerGlobalConfig;
   /** Paths of notification template files. */
   templates?: string[];
+  /** Where Alertmanager sends its own traces. */
+  tracing?: AlertmanagerTracingConfig;
 }
 
 export interface AlertmanagerSettingsEntity extends Declarable {
   readonly props: AlertmanagerSettingsProps;
 }
 
-/** The `global:` block and `templates:` list. Optional; declare at most one. */
+/** The `global:` block, `templates:` list and `tracing:` block. Optional; declare at most one. */
 export const AlertmanagerSettings = entityClass<AlertmanagerSettingsProps, AlertmanagerSettingsEntity>(
   SETTINGS_TYPE,
   "AlertmanagerSettings",

package/src/build.ts

@@ -109,6 +109,7 @@ function routeConfig(route: RouteEntity | RouteProps): RouteConfig {
   if (p.repeat_interval !== undefined) out.repeat_interval = p.repeat_interval;
   if (p.mute_time_intervals !== undefined) out.mute_time_intervals = p.mute_time_intervals.map(intervalName);
   if (p.active_time_intervals !== undefined) out.active_time_intervals = p.active_time_intervals.map(intervalName);
+  if (p.labels !== undefined) out.labels = { ...p.labels };
   if (p.routes !== undefined) out.routes = p.routes.map(routeConfig);
   return out;
 }
@@ -177,6 +178,7 @@ export function buildAlertmanagerConfig(entities: Iterable<Declarable> | Map<str
   intervals.sort((a, b) => byName(a.props.name, b.props.name));
   if (receivers.length > 0) config.receivers = receivers.map((r) => plain(r.props) as ReceiverConfig);
   if (intervals.length > 0) config.time_intervals = intervals.map((t) => plain(t.props) as TimeIntervalConfig);
+  if (settings?.props.tracing) config.tracing = plain(settings.props.tracing) as AlertmanagerConfig["tracing"];
 
   return { config, warnings, count };
 }

package/src/codegen/docs.ts

@@ -47,6 +47,10 @@ group names (PROM101), valid durations (PROM103), routes that name
 declared receivers (PROM201), and every alert severity routed by some route
 (PROM202). \`promtool check rules\` and \`amtool check-config\` are wrapped as
 helpers for tests and CI, and run when installed.
+
+\`chant import\` turns an existing rule file or \`alertmanager.yml\` into this
+TypeScript, and \`chant build\` on the result gives the file back (see
+Importing Rule Files and alertmanager.yml).
 `;
 
 const outputFormat = `The prometheus lexicon serializes two files:
@@ -58,7 +62,7 @@ const outputFormat = `The prometheus lexicon serializes two files:
 - **\`alertmanager.yml\`**, from the \`AlertmanagerSettings\`, \`Route\`,
   \`InhibitRule\`, \`Receiver\` and \`TimeInterval\` entities, in that section
   order: \`global\`, \`templates\`, \`route\`, \`inhibit_rules\`, \`receivers\`,
-  \`time_intervals\`.
+  \`time_intervals\`, \`tracing\`.
 
 The rule file is the primary output when the build declares any rule
 groups, and \`alertmanager.yml\` is written beside it (\`-o dist/rules.yml\`