@miragon/pulse-analytics-client 0.0.0-stage → 0.21.0

package/dist/prometheus.d.ts

@@ -0,0 +1,100 @@
+export interface PrometheusConfig {
+    /**
+     * Base URL of the Prometheus HTTP API. Userinfo (`https://user:pass@host`)
+     * is moved into a Basic `Authorization` header — fetch rejects credentialed
+     * URLs — and never appears in an error message.
+     */
+    url: string;
+    /** Bearer token (`Authorization: Bearer …`); exclusive with basic auth. */
+    bearerToken?: string;
+    /** Basic-auth user (with `password`); exclusive with `bearerToken` and URL userinfo. */
+    username?: string;
+    password?: string;
+    /** Extra request headers, e.g. a tenant header (`X-Scope-OrgID`) for Mimir/Cortex/Thanos. */
+    headers?: Record<string, string>;
+    /** Per-query deadline in ms (default {@link DEFAULT_PROMETHEUS_TIMEOUT_MS}). */
+    timeoutMs?: number;
+}
+/** Default per-query deadline (`timeoutMs`). */
+export declare const DEFAULT_PROMETHEUS_TIMEOUT_MS = 30000;
+/** One labeled sample from a Prometheus instant query. */
+export interface PromSample {
+    metric: Record<string, string>;
+    value: number;
+}
+/** Per-query options. */
+export interface PrometheusQueryOptions {
+    /** Aborts the query (combined with the client's deadline), e.g. an MCP request's `ctx.signal`. */
+    signal?: AbortSignal;
+}
+export interface PrometheusClient {
+    /** Run an instant PromQL query and return the labeled samples (NaN/∅ dropped). */
+    instant(query: string, options?: PrometheusQueryOptions): Promise<PromSample[]>;
+}
+/**
+ * Minimal Prometheus HTTP API client. The analytics queries are metric-first:
+ * they issue instant PromQL queries (`/api/v1/query`) whose range windows carry
+ * the time period, and map the labeled samples into the analytics row shapes.
+ *
+ * Every query runs under a deadline (`timeoutMs`, combined with an optional
+ * caller `signal`), and every failure is an `Error` whose message is safe to
+ * hand to the model: no URL, no credentials, upstream text truncated.
+ */
+export declare function createPrometheusClient(config: PrometheusConfig): PrometheusClient;
+/**
+ * A view of `client` whose queries honor the caller's `signal` (an MCP
+ * request's `ctx.signal`) on top of the client's own deadline — every
+ * Prometheus query is a read, so cancelling one is always safe. A per-call
+ * `signal` wins. Without a signal the client itself is returned.
+ */
+export declare function withCallerSignal(client: PrometheusClient, signal: AbortSignal | undefined): PrometheusClient;
+/** Escape a value for safe use inside a PromQL label matcher (`{k="<value>"}`). */
+export declare function escapeLabelValue(value: string): string;
+export type EngineFilterInput = string | string[] | undefined;
+/**
+ * The engine ids a filter names, or `null` for no filter (every engine
+ * Prometheus holds). Results echo this so a reader always knows which engines
+ * an aggregate covers.
+ */
+export declare function engineIdsOf(engine: EngineFilterInput): string[] | null;
+/**
+ * Builds a PromQL label matcher fragment for the optional `engine_id` filter,
+ * e.g. `engine_id="prod-a"` or `engine_id=~"prod-a|prod-b"` — one id is an
+ * exact matcher whether it comes as a string or a one-element list (the
+ * analytics tools always resolve `engine` to a list). Returns `undefined`
+ * when no filter is set so the caller can aggregate across all engines.
+ */
+export declare function engineMatcher(engine: EngineFilterInput): string | undefined;
+/**
+ * Assembles a `{...}` PromQL label selector from individual matcher fragments,
+ * dropping empties. Returns `""` (no selector) when nothing is set.
+ */
+export declare function selector(...matchers: Array<string | undefined>): string;
+/**
+ * The look-back the analytics module assumes Prometheus retains
+ * (`--storage.tsdb.retention.time`, 30 days in the repo's stack). Every
+ * window — the rolling periods, the compare windows, explicit date ranges —
+ * is held inside `[now − RETENTION_DAYS, now]`: data older than that is gone,
+ * so a longer window would silently read partial or zero data.
+ */
+export declare const RETENTION_DAYS = 30;
+/**
+ * PromQL range windows for the analytics `period` inputs, capped at
+ * {@link RETENTION_DAYS}; longer look-backs would silently read partial/zero
+ * data, so they are not offered.
+ */
+export declare const PERIOD_RANGE: {
+    readonly "1d": "1d";
+    readonly "3d": "3d";
+    readonly "7d": "7d";
+    readonly "14d": "14d";
+    readonly "30d": "30d";
+};
+export type Period = keyof typeof PERIOD_RANGE;
+/**
+ * The period values as a tuple, derived from {@link PERIOD_RANGE} — the single
+ * source of truth for every `z.enum`/step-enum/type that offers the periods.
+ * Adding a period to PERIOD_RANGE propagates everywhere.
+ */
+export declare const PERIODS: [Period, ...Period[]];
+//# sourceMappingURL=prometheus.d.ts.map

package/dist/prometheus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prometheus.d.ts","sourceRoot":"","sources":["../src/prometheus.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAA;IACX,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,gDAAgD;AAChD,eAAO,MAAM,6BAA6B,QAAS,CAAA;AAQnD,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,KAAK,EAAE,MAAM,CAAA;CACd;AAED,yBAAyB;AACzB,MAAM,WAAW,sBAAsB;IACrC,kGAAkG;IAClG,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,kFAAkF;IAClF,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;CAChF;AAmJD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAwFjF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,gBAAgB,CAMlB;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAWD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAA;AAE7D;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,EAAE,GAAG,IAAI,CAItE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAS3E;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,CAGvE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,KAAK,CAAA;AAEhC;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;;;CAMf,CAAA;AACV,MAAM,MAAM,MAAM,GAAG,MAAM,OAAO,YAAY,CAAA;AAE9C;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAgC,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA"}

package/dist/prometheus.js

@@ -0,0 +1,295 @@
+/** Default per-query deadline (`timeoutMs`). */
+export const DEFAULT_PROMETHEUS_TIMEOUT_MS = 30_000;
+/** The longest delay a Node timer holds — a longer deadline would fire at once. */
+const MAX_TIMEOUT_MS = 2_147_483_647;
+/** Upper bound for upstream text in an error message (bodies can be pages long). */
+const MAX_ERROR_TEXT = 500;
+/**
+ * Base URL without userinfo, plus the userinfo it carried. The raw value is
+ * never echoed: it may hold credentials.
+ */
+function splitUserinfo(raw) {
+    let url;
+    try {
+        url = new URL(raw); // not URL.parse: that needs Node 22.1, the package supports 22.0
+    }
+    catch {
+        // Not chained: the parse error carries the raw input.
+        throw new Error("Prometheus URL (PROMETHEUS_URL) is not a valid URL");
+    }
+    const username = decodeURIComponent(url.username) || undefined;
+    const password = decodeURIComponent(url.password) || undefined;
+    url.username = "";
+    url.password = "";
+    return { base: url.toString().replace(/\/+$/, ""), username, password };
+}
+/**
+ * The `Authorization` value from bearer token, explicit basic credentials or
+ * URL userinfo — exactly one source; ambiguous combinations fail the boot.
+ */
+function authorizationFor(config, userinfo) {
+    const explicitBasic = config.username !== undefined || config.password !== undefined;
+    if (userinfo.username !== undefined && (explicitBasic || config.bearerToken)) {
+        throw new Error("Prometheus auth is ambiguous: the URL carries credentials AND PROMETHEUS_USERNAME/PROMETHEUS_PASSWORD or PROMETHEUS_BEARER_TOKEN are set — use one");
+    }
+    if (config.bearerToken && explicitBasic) {
+        throw new Error("Prometheus auth is ambiguous: set either PROMETHEUS_BEARER_TOKEN or PROMETHEUS_USERNAME + PROMETHEUS_PASSWORD, not both");
+    }
+    if (explicitBasic && !(config.username && config.password)) {
+        throw new Error("Prometheus basic auth needs both PROMETHEUS_USERNAME and PROMETHEUS_PASSWORD");
+    }
+    if (config.bearerToken) {
+        return { authorization: `Bearer ${config.bearerToken}`, secrets: [config.bearerToken] };
+    }
+    const username = config.username ?? userinfo.username;
+    if (username === undefined)
+        return { secrets: [] };
+    const password = config.password ?? userinfo.password ?? "";
+    const basic = Buffer.from(`${username}:${password}`).toString("base64");
+    return { authorization: `Basic ${basic}`, secrets: [password, basic] };
+}
+/** RFC 9110 field-name token; a value must not break the header line. */
+const HEADER_NAME = /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/;
+const HEADER_VALUE = /^[^\r\n\0]*$/;
+/**
+ * Every form a secret can take in echoed text — as configured, trimmed
+ * (header values are sent trimmed) and whitespace-collapsed — longest first,
+ * so a value is masked whole before any shorter one inside it. Values under
+ * 4 characters are skipped: masking those would shred ordinary text.
+ */
+function secretForms(secrets) {
+    const forms = new Set();
+    for (const secret of secrets) {
+        if (!secret)
+            continue;
+        for (const form of [secret, secret.trim(), secret.replace(/\s+/g, " ").trim()]) {
+            if (form.length >= 4)
+                forms.add(form);
+        }
+    }
+    return [...forms].sort((a, b) => b.length - a.length);
+}
+function mask(text, secrets) {
+    let masked = text;
+    for (const secret of secrets)
+        masked = masked.split(secret).join("***");
+    return masked;
+}
+/** A Prometheus API `errorType` (`bad_data`, `timeout`, …); anything else is not echoed. */
+const ERROR_TYPE = /^[a-z_]{1,40}$/;
+/** The request headers (custom + auth) and every secret an upstream could echo back. */
+function buildHeaders(config, userinfo) {
+    const headers = new Headers();
+    for (const [name, value] of Object.entries(config.headers ?? {})) {
+        // Checked up front so the value (often a secret, e.g. an API key) never
+        // lands in an error — only the header name is named.
+        if (!HEADER_NAME.test(name) || !HEADER_VALUE.test(value)) {
+            throw new Error(`Prometheus header "${name}" (PROMETHEUS_HEADERS) has an invalid name or value`);
+        }
+        headers.set(name, value);
+    }
+    const { authorization, secrets } = authorizationFor(config, userinfo);
+    if (authorization && headers.has("Authorization")) {
+        throw new Error("Prometheus auth is ambiguous: PROMETHEUS_HEADERS sets Authorization next to configured credentials");
+    }
+    if (authorization)
+        headers.set("Authorization", authorization);
+    // The configured credential (not its header line, so an echo keeps the
+    // scheme readable) plus every custom header value.
+    return { headers, secrets: secretForms([...secrets, ...Object.values(config.headers ?? {})]) };
+}
+function resolveTimeout(timeoutMs) {
+    if (timeoutMs === undefined)
+        return DEFAULT_PROMETHEUS_TIMEOUT_MS;
+    if (!Number.isInteger(timeoutMs) || timeoutMs <= 0 || timeoutMs > MAX_TIMEOUT_MS) {
+        throw new RangeError(`Prometheus timeout must be a positive integer of at most ${MAX_TIMEOUT_MS} ms, got ${timeoutMs}`);
+    }
+    return timeoutMs;
+}
+/** `JSON.parse` that yields `undefined` instead of throwing (bodies may be HTML or empty). */
+function parseJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The OS-level code of a fetch network error (`ECONNREFUSED`, `ENOTFOUND`, …). */
+function networkCode(error) {
+    const cause = error.cause;
+    const code = cause?.code ?? cause?.errors?.find((e) => e.code)?.code;
+    return typeof code === "string" && code.length > 0 ? code : "network error";
+}
+/**
+ * Minimal Prometheus HTTP API client. The analytics queries are metric-first:
+ * they issue instant PromQL queries (`/api/v1/query`) whose range windows carry
+ * the time period, and map the labeled samples into the analytics row shapes.
+ *
+ * Every query runs under a deadline (`timeoutMs`, combined with an optional
+ * caller `signal`), and every failure is an `Error` whose message is safe to
+ * hand to the model: no URL, no credentials, upstream text truncated.
+ */
+export function createPrometheusClient(config) {
+    const userinfo = splitUserinfo(config.url);
+    const { base } = userinfo;
+    const { headers, secrets } = buildHeaders(config, userinfo);
+    const timeoutMs = resolveTimeout(config.timeoutMs);
+    /**
+     * Upstream text with every configured secret masked (before AND after
+     * collapsing whitespace, so neither form slips through), then truncated.
+     */
+    const safe = (text) => {
+        const flat = mask(mask(text, secrets).replace(/\s+/g, " ").trim(), secrets);
+        return flat.length > MAX_ERROR_TEXT ? `${flat.slice(0, MAX_ERROR_TEXT)}…` : flat;
+    };
+    /** The envelope's `errorType` when it is a Prometheus one (masked all the same). */
+    const errorTypeOf = (value) => typeof value === "string" && ERROR_TYPE.test(value) ? safe(value) : undefined;
+    function httpError(response, text) {
+        // The API's JSON error envelope when it is one, else the raw text.
+        const body = parseJson(text);
+        const errorType = errorTypeOf(body?.errorType);
+        const raw = typeof body?.error === "string" ? body.error : text;
+        const detail = safe(raw) || `${response.statusText || "HTTP error"} — empty response body`;
+        const auth = response.status === 401 || response.status === 403;
+        return new Error(`Prometheus query failed (${response.status}${errorType ? ` ${errorType}` : ""}): ${detail}${auth ? " — check the configured Prometheus credentials" : ""}`);
+    }
+    /** Response + body under the deadline (and the caller's signal), failures mapped. */
+    async function fetchText(url, caller) {
+        const deadline = AbortSignal.timeout(timeoutMs);
+        const signal = caller ? AbortSignal.any([caller, deadline]) : deadline;
+        try {
+            const response = await fetch(url, { method: "GET", headers, signal });
+            return { response, text: await response.text() };
+        }
+        catch (err) {
+            const message = deadline.aborted
+                ? `Prometheus did not respond within ${timeoutMs} ms (timeout)`
+                : caller?.aborted
+                    ? "Prometheus query cancelled by the caller"
+                    : `Prometheus unreachable (${networkCode(err)})`;
+            throw new Error(message, { cause: err });
+        }
+    }
+    /** The API envelope of a 2xx response; a non-JSON body (a login page) says so. */
+    function parseEnvelope(response, text) {
+        const body = parseJson(text);
+        if (body !== null && typeof body === "object")
+            return body;
+        const type = response.headers.get("Content-Type")?.split(";")[0];
+        throw new Error(`Prometheus returned a non-JSON response (HTTP ${response.status}${type ? `, ${type}` : ""}) — is a proxy or login page in front of it?`);
+    }
+    return {
+        async instant(query, options = {}) {
+            const url = `${base}/api/v1/query?query=${encodeURIComponent(query)}`;
+            const { response, text } = await fetchText(url, options.signal);
+            if (!response.ok)
+                throw httpError(response, text);
+            const body = parseEnvelope(response, text);
+            if (body.status !== "success" || !body.data) {
+                const errorType = errorTypeOf(body.errorType);
+                throw new Error(`Prometheus query error${errorType ? ` (${errorType})` : ""}: ${safe(body.error ?? "unknown")}`);
+            }
+            const out = [];
+            for (const r of body.data.result) {
+                const value = Number(r.value[1]);
+                if (Number.isNaN(value))
+                    continue;
+                out.push({ metric: r.metric, value });
+            }
+            return out;
+        },
+    };
+}
+/**
+ * A view of `client` whose queries honor the caller's `signal` (an MCP
+ * request's `ctx.signal`) on top of the client's own deadline — every
+ * Prometheus query is a read, so cancelling one is always safe. A per-call
+ * `signal` wins. Without a signal the client itself is returned.
+ */
+export function withCallerSignal(client, signal) {
+    if (!signal)
+        return client;
+    return {
+        instant: (query, options) => client.instant(query, { ...options, signal: options?.signal ?? signal }),
+    };
+}
+/** Escape a value for safe use inside a PromQL label matcher (`{k="<value>"}`). */
+export function escapeLabelValue(value) {
+    return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+/**
+ * Escape RE2 metacharacters so a value matches literally inside a `=~"…"`
+ * matcher. Without this, an id like `engine.prod` also matches `engineXprod`,
+ * and one containing `|` silently splits into two alternatives.
+ */
+function escapeRegexValue(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * The engine ids a filter names, or `null` for no filter (every engine
+ * Prometheus holds). Results echo this so a reader always knows which engines
+ * an aggregate covers.
+ */
+export function engineIdsOf(engine) {
+    if (engine === undefined || engine === null)
+        return null;
+    const ids = (Array.isArray(engine) ? engine : [engine]).filter((id) => id.length > 0);
+    return ids.length > 0 ? ids : null;
+}
+/**
+ * Builds a PromQL label matcher fragment for the optional `engine_id` filter,
+ * e.g. `engine_id="prod-a"` or `engine_id=~"prod-a|prod-b"` — one id is an
+ * exact matcher whether it comes as a string or a one-element list (the
+ * analytics tools always resolve `engine` to a list). Returns `undefined`
+ * when no filter is set so the caller can aggregate across all engines.
+ */
+export function engineMatcher(engine) {
+    if (engine === undefined || engine === null)
+        return undefined;
+    if (Array.isArray(engine)) {
+        if (engine.length === 0)
+            return undefined;
+        if (engine.length === 1)
+            return engineMatcher(engine[0]);
+        return `engine_id=~"${engine.map((e) => escapeLabelValue(escapeRegexValue(e))).join("|")}"`;
+    }
+    if (engine.length === 0)
+        return undefined;
+    return `engine_id="${escapeLabelValue(engine)}"`;
+}
+/**
+ * Assembles a `{...}` PromQL label selector from individual matcher fragments,
+ * dropping empties. Returns `""` (no selector) when nothing is set.
+ */
+export function selector(...matchers) {
+    const parts = matchers.filter((m) => !!m && m.length > 0);
+    return parts.length ? `{${parts.join(",")}}` : "";
+}
+/**
+ * The look-back the analytics module assumes Prometheus retains
+ * (`--storage.tsdb.retention.time`, 30 days in the repo's stack). Every
+ * window — the rolling periods, the compare windows, explicit date ranges —
+ * is held inside `[now − RETENTION_DAYS, now]`: data older than that is gone,
+ * so a longer window would silently read partial or zero data.
+ */
+export const RETENTION_DAYS = 30;
+/**
+ * PromQL range windows for the analytics `period` inputs, capped at
+ * {@link RETENTION_DAYS}; longer look-backs would silently read partial/zero
+ * data, so they are not offered.
+ */
+export const PERIOD_RANGE = {
+    "1d": "1d",
+    "3d": "3d",
+    "7d": "7d",
+    "14d": "14d",
+    "30d": "30d",
+};
+/**
+ * The period values as a tuple, derived from {@link PERIOD_RANGE} — the single
+ * source of truth for every `z.enum`/step-enum/type that offers the periods.
+ * Adding a period to PERIOD_RANGE propagates everywhere.
+ */
+export const PERIODS = Object.keys(PERIOD_RANGE);
+//# sourceMappingURL=prometheus.js.map

package/dist/prometheus.js.map

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

package/dist/prometheus.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=prometheus.test.d.ts.map

package/dist/prometheus.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prometheus.test.d.ts","sourceRoot":"","sources":["../src/prometheus.test.ts"],"names":[],"mappings":""}

package/dist/prometheus.test.js

@@ -0,0 +1,54 @@
+import { describe, expect, it } from "vitest";
+import { engineMatcher, escapeLabelValue, selector } from "./prometheus.js";
+describe("escapeLabelValue", () => {
+    it("leaves plain values untouched", () => {
+        expect(escapeLabelValue("miraveloLeasing")).toBe("miraveloLeasing");
+    });
+    it("escapes backslashes and double quotes (PromQL label-matcher injection safety)", () => {
+        expect(escapeLabelValue('a"b')).toBe('a\\"b');
+        expect(escapeLabelValue("a\\b")).toBe("a\\\\b");
+        expect(escapeLabelValue('"; bad')).toBe('\\"; bad');
+    });
+});
+describe("engineMatcher", () => {
+    it("returns undefined when no engine filter is set (aggregate across engines)", () => {
+        expect(engineMatcher(undefined)).toBeUndefined();
+        expect(engineMatcher("")).toBeUndefined();
+        expect(engineMatcher([])).toBeUndefined();
+    });
+    it("builds an exact matcher for a single engine", () => {
+        expect(engineMatcher("prod-a")).toBe('engine_id="prod-a"');
+    });
+    it("builds a regex matcher for a list of engines", () => {
+        expect(engineMatcher(["prod-a", "prod-b"])).toBe('engine_id=~"prod-a|prod-b"');
+    });
+    it("escapes engine ids", () => {
+        expect(engineMatcher('a"b')).toBe('engine_id="a\\"b"');
+    });
+    it("escapes regex metacharacters in the =~ list matcher (literal match only)", () => {
+        // A dot must not act as a wildcard, and a pipe in an id must not split the
+        // matcher into two alternatives. The regex backslash is itself doubled for
+        // the PromQL string literal (Go escape rules), so the wire text carries
+        // `\\.` and RE2 sees `\.`.
+        expect(engineMatcher(["engine.prod-1", "x"])).toBe('engine_id=~"engine\\\\.prod-1|x"');
+        expect(engineMatcher(["a|b", "c+d"])).toBe('engine_id=~"a\\\\|b|c\\\\+d"');
+    });
+    it("builds an exact (literal) matcher for a one-element list", () => {
+        // The analytics tools always resolve `engine` to a list: one engine must
+        // still read as the exact match it is.
+        expect(engineMatcher(["engine.prod-1"])).toBe('engine_id="engine.prod-1"');
+    });
+});
+describe("selector", () => {
+    it("returns an empty string when nothing is set", () => {
+        expect(selector()).toBe("");
+        expect(selector(undefined, "", undefined)).toBe("");
+    });
+    it("wraps and comma-joins the non-empty matchers", () => {
+        expect(selector('process_definition_key="k"', undefined, 'state="COMPLETED"')).toBe('{process_definition_key="k",state="COMPLETED"}');
+    });
+    it("wraps a single matcher", () => {
+        expect(selector('engine_id="prod-a"')).toBe('{engine_id="prod-a"}');
+    });
+});
+//# sourceMappingURL=prometheus.test.js.map

package/dist/prometheus.test.js.map

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

package/dist/promql-labels.test-support.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Test support for the metrics-contract guards — never imported by runtime
+ * code. Resolves every selector of a parsed PromQL expression
+ * (`promql-parse.test-support.ts`) to its contract series and asserts that
+ * each label the expression names — in a matcher, a `by`/`without` grouping, an
+ * `on`/`ignoring` vector match or a `group_left`/`group_right` include list —
+ * is a label that operand can carry.
+ *
+ * Label availability propagates the way PromQL evaluates: a selector carries
+ * its series' declared labels (`le` added on `_bucket`), `increase()` keeps
+ * them, `sum by (a)` narrows to `a`, `histogram_quantile` consumes `le`, a
+ * one-to-one `on (a)` match keeps `a`. So `sum by (a)(sum by (b)(x))` fails
+ * even when `a` is declared on `x`. Unknown functions and series are reported
+ * as violations instead of passing silently.
+ */
+/** What a series may carry: its label names plus documented label values. */
+export interface SeriesInfo {
+    labels: readonly string[];
+    knownValues?: Readonly<Record<string, readonly string[]>>;
+}
+/** Resolves a series name to its declared labels, or undefined when unknown. */
+export type SeriesCatalog = (series: string) => SeriesInfo | undefined;
+/** The subset of a `metrics-contract.json` entry the catalogue needs. */
+export interface ContractMetricLike {
+    promName: string;
+    type: string;
+    labels: string[];
+    knownValues?: Record<string, string[]>;
+}
+/**
+ * Catalogue over the contract: counters/gauges by `promName`, histograms as
+ * their `_sum`/`_count`/`_bucket` series (`_bucket` adds `le`). The bare
+ * histogram name is deliberately absent — classic histograms expose no such
+ * series, so a query on it reads nothing. `extra` adds non-contract series
+ * (Prometheus' own `ALERTS`, `up`, …) with their documented labels.
+ */
+export declare function contractCatalog(metrics: readonly ContractMetricLike[], extra?: Readonly<Record<string, SeriesInfo>>): SeriesCatalog;
+export interface LabelCheck {
+    /** Human-readable contract violations; empty when the expression is clean. */
+    violations: string[];
+    /** Every series the expression selects. */
+    series: string[];
+    /** Label references verified — lets a caller detect a silently empty scan. */
+    checkedLabels: number;
+    /** Labels the result can carry (undefined for a scalar/string result). */
+    resultLabels: string[] | undefined;
+}
+/**
+ * Parse `query` and check every label it names against `catalog`. Throws on a
+ * syntax outside the supported subset; everything else lands in `violations`.
+ */
+export declare function checkQueryLabels(query: string, catalog: SeriesCatalog): LabelCheck;
+//# sourceMappingURL=promql-labels.test-support.d.ts.map

package/dist/promql-labels.test-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promql-labels.test-support.d.ts","sourceRoot":"","sources":["../src/promql-labels.test-support.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAYH,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAA;CAC1D;AAED,gFAAgF;AAChF,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,UAAU,GAAG,SAAS,CAAA;AAEtE,yEAAyE;AACzE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CACvC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,kBAAkB,EAAE,EACtC,KAAK,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAM,GAC/C,aAAa,CAaf;AAoCD,MAAM,WAAW,UAAU;IACzB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,8EAA8E;IAC9E,aAAa,EAAE,MAAM,CAAA;IACrB,0EAA0E;IAC1E,YAAY,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;CACnC;AA8KD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,UAAU,CASlF"}