@marinoscar/platform-api 0.0.0-stage → 0.1.0-next.11

package/dist/telemetry/dashboard/telemetry-dashboard.verdict.d.ts

@@ -0,0 +1,235 @@
+import { VERDICT_LEVELS, type VerdictLevel } from '@marinoscar/platform-contract/telemetry';
+/**
+ * A `degraded` and a `critical` bound of one verdict rule.
+ *
+ * @stability experimental
+ */
+export interface VerdictLevelThresholds {
+    /** The bound past which the rule reports `degraded`. */
+    readonly degraded: number;
+    /** The bound past which the rule reports `critical`. */
+    readonly critical: number;
+}
+/**
+ * The error-log rule: the current window against the previous one.
+ *
+ * @stability experimental
+ */
+export interface VerdictErrorLogThresholds {
+    /** Error logs needed in the current window before the ratio rule may fire. */
+    readonly minCurrent: number;
+    /** Ratio to the previous window, `>=`, for degraded. */
+    readonly degradedRatio: number;
+    /** Ratio to the previous window, `>=`, for critical. */
+    readonly criticalRatio: number;
+}
+/**
+ * The unknown-API-route rule (bearer requests only): any is degraded; either
+ * bound, `>=`, is critical.
+ *
+ * @stability experimental
+ */
+export interface VerdictUnknownRouteThresholds {
+    /** Bearer requests to unknown routes that make the rule critical. */
+    readonly criticalBearerRequests: number;
+    /** Distinct unknown `METHOD /path` that make the rule critical. */
+    readonly criticalDistinctRoutes: number;
+}
+/**
+ * The collector rule: any failed point is degraded.
+ *
+ * @stability experimental
+ */
+export interface VerdictCollectorThresholds {
+    /** The share of attempted points that failed, %, `>=`, that makes the rule critical. */
+    readonly critical: number;
+}
+/**
+ * The thresholds of the dashboard's health verdict, as numbers. See
+ * {@link DEFAULT_VERDICT_THRESHOLDS} for the shipped values.
+ *
+ * @stability experimental
+ */
+export interface VerdictThresholds {
+    /** Requests needed before the 5xx and p95 rules may fire. */
+    readonly minRequests: number;
+    /** 5xx rate, %, `>`. */
+    readonly errorRatePct: VerdictLevelThresholds;
+    /** Window p95, ms, `>`. */
+    readonly p95Ms: VerdictLevelThresholds;
+    /** Error logs against the previous window. */
+    readonly errorLogs: VerdictErrorLogThresholds;
+    /** Minutes without any trace or log after which the verdict is `no_data`. */
+    readonly noDataMinutes: number;
+    /** Unknown API routes, bearer requests only. */
+    readonly unknownRoutes: VerdictUnknownRouteThresholds;
+    /** Worst mountpoint, %, `>=`. */
+    readonly diskUtilizationPct: VerdictLevelThresholds;
+    /** Worst host, %, `>=`. */
+    readonly memoryUtilizationPct: VerdictLevelThresholds;
+    /** Backends against `max_connections`, %, worst server, `>=`. */
+    readonly dbConnectionsPct: VerdictLevelThresholds;
+    /** Oldest due pending job, minutes, worst job type, `>=`. */
+    readonly oldestPendingJobMinutes: VerdictLevelThresholds;
+    /** Certificate lifetime left, days, soonest URL, `<` (fewer is worse). */
+    readonly tlsDaysLeft: VerdictLevelThresholds;
+    /** Checks an uptime target must have in the lookback before "every check failed" may be critical. */
+    readonly uptimeMinChecksForCritical: number;
+    /** Share of attempted exporter points that failed, %, `>=`, for critical (any failure is degraded). */
+    readonly collectorFailedPct: VerdictCollectorThresholds;
+    /** Age of the last successful backup, hours, `>`. */
+    readonly backupAgeHours: VerdictLevelThresholds;
+}
+/**
+ * The shipped verdict thresholds (the values of the rules in this file's
+ * header). An app overrides any of them with
+ * `TelemetryModule.forRoot({ dashboard: { verdictThresholds } })`.
+ *
+ * @example
+ * ```ts
+ * const resolved = resolveVerdictThresholds({ noDataMinutes: 10 }); // every other value is the default
+ * ```
+ *
+ * @extensionPoint option
+ * @stability stable
+ */
+export declare const DEFAULT_VERDICT_THRESHOLDS: VerdictThresholds;
+/**
+ * The shipped verdict thresholds, under their pre-#703 name.
+ *
+ * @deprecated Use {@link DEFAULT_VERDICT_THRESHOLDS}, or inject the resolved
+ *   thresholds (`TELEMETRY_VERDICT_THRESHOLDS`) to honour an app's override.
+ *
+ * @stability experimental
+ */
+export declare const DASHBOARD_VERDICT_THRESHOLDS: VerdictThresholds;
+export { VERDICT_LEVELS, type VerdictLevel };
+/**
+ * The summary's health verdict.
+ *
+ * @stability stable
+ */
+export interface DashboardVerdict {
+    /** The worst rule that fired (`no_data` overrides every other rule). */
+    level: VerdictLevel;
+    /** One line per fired rule: its value, the threshold it crossed and the worst offender. */
+    reasons: string[];
+}
+/**
+ * The numbers the summary computed, which a {@link VerdictPolicy} judges. An
+ * infrastructure input left `undefined` or `null` skips its rule.
+ *
+ * @stability experimental
+ */
+export interface VerdictInput {
+    /** The instant the summary was computed for. */
+    now: Date;
+    /** Latest trace or log timestamp seen (null when none in the lookback). */
+    lastDataAt: Date | null;
+    /** Server requests in the window. */
+    requests: number;
+    /** Of which answered 5xx. */
+    errors5xx: number;
+    /** Window p95, null without requests. */
+    p95Ms: number | null;
+    /** Error logs in the window. */
+    errorLogs: number;
+    /** Error logs in the previous window of equal length. */
+    previousErrorLogs: number;
+    /** `METHOD /path` with the most 5xx, if any. */
+    topErrorRoute?: string | null;
+    /** `METHOD /path` with the highest p95, if any. */
+    slowestRoute?: string | null;
+    /** The most frequent error message, if any. */
+    topErrorMessage?: string | null;
+    /**
+     * Requests WITH a bearer to an unknown route (#650): how many, over how
+     * many distinct `METHOD /path` (counted from the bounded top list, which is
+     * enough for the threshold), and the top one. Undefined/null when the store
+     * cannot tell (no `app.route.matched` column yet): the rule is skipped.
+     */
+    unknownRoutes?: {
+        /** Bearer requests to unknown routes. */
+        bearerRequests: number;
+        /** Distinct unknown `METHOD /path` among them. */
+        bearerRoutes: number;
+        /** The most requested one. */
+        topRoute: string | null;
+    } | null;
+    /** Highest filesystem utilization (%) and its mountpoint. */
+    disk?: {
+        /** Utilization, %. */
+        utilizationPct: number;
+        /** The mountpoint. */
+        mountpoint: string | null;
+    } | null;
+    /** Highest memory utilization (%) and its host. */
+    memory?: {
+        /** Utilization, %. */
+        utilizationPct: number;
+        /** The host. */
+        host: string | null;
+    } | null;
+    /** Highest backends / max_connections (%) and its server (`instance`). */
+    dbConnections?: {
+        /** Backends against `max_connections`, %. */
+        utilizationPct: number;
+        /** The server. */
+        instance: string | null;
+    } | null;
+    /** Oldest due pending job age (seconds) and its job type. */
+    oldestPendingJob?: {
+        /** Its age, seconds. */
+        ageSeconds: number;
+        /** Its job type. */
+        jobType: string | null;
+    } | null;
+    /** Worker nodes: how many are stale, and node-offered job types with pending work but no eligible node. */
+    nodes?: {
+        /** Nodes that missed heartbeats. */
+        stale: number;
+        /** Node-offered job types with pending work and no eligible node. */
+        noEligibleNodeTypes: readonly string[];
+    } | null;
+    /** Soonest certificate expiry (days) and its URL. */
+    tls?: {
+        /** Days until the certificate expires (negative: expired). */
+        daysLeft: number;
+        /** The URL. */
+        url: string | null;
+    } | null;
+    /** Uptime targets whose latest check failed; `allFailed` when every check in the lookback failed. */
+    uptimeFailures?: ReadonlyArray<{
+        /** The target URL. */
+        url: string;
+        /** Whether every check in the lookback failed. */
+        allFailed: boolean;
+        /** Checks in the lookback. */
+        checks: number;
+    }> | null;
+    /** Collector exporter points over the window: failed and sent, and the exporter with the most failures. */
+    collector?: {
+        /** Points that failed to export. */
+        failed: number;
+        /** Points sent. */
+        sent: number;
+        /** The exporter with the most failures. */
+        exporter: string | null;
+    } | null;
+    /** Hours since the last successful backup. */
+    backupAgeHours?: number | null;
+}
+/** Characters of an offender (route or message) a reason line keeps. */
+export declare const VERDICT_OFFENDER_CHARS = 80;
+/**
+ * The dashboard's health verdict: the worst rule that fired, with one reason
+ * per fired rule. The default {@link VerdictPolicy}'s rule set.
+ *
+ * @param input - the numbers the summary computed.
+ * @param thresholds - the resolved thresholds; defaults to {@link DEFAULT_VERDICT_THRESHOLDS}.
+ * @returns the level and the reasons.
+ *
+ * @stability stable
+ */
+export declare function computeVerdict(input: VerdictInput, thresholds?: VerdictThresholds): DashboardVerdict;
+//# sourceMappingURL=telemetry-dashboard.verdict.d.ts.map

package/dist/telemetry/dashboard/telemetry-dashboard.verdict.d.ts.map

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

package/dist/telemetry/dashboard/telemetry-dashboard.verdict.js

@@ -0,0 +1,269 @@
+"use strict";
+// =============================================================================
+// The dashboard's health verdict (issue #577, epic #576)
+// =============================================================================
+//
+// One pure function over numbers the summary already computed. Four rules,
+// each with a VOLUME GUARD so a quiet deployment does not flap red on one
+// failed request:
+//
+//   5xx rate      > 2 % degraded, > 5 % critical        (>= 20 requests)
+//   p95 latency   > 1000 ms degraded, > 3000 ms critical (>= 20 requests)
+//   error logs    >= 3x the previous window degraded,
+//                 >= 10x critical                       (>= 10 errors now;
+//                                                        previous 0 counts as 1)
+//   no data       now - latest trace/log > 5 min        → no_data, overriding
+//                                                        every other rule
+//   unknown API   any request WITH a bearer to an unknown route (#650)
+//   routes        degraded; >= 20 such requests or >= 3 distinct
+//                 METHOD /path critical. No volume guard: one request from
+//                 our own client to a route this build lacks is already a
+//                 defect (a deploy skew). Anonymous unknown-route requests
+//                 (scanners) never fire; the summary tile still counts them.
+//                 A 404 from a MATCHED route never counts here.
+//
+// The level is the worst rule that fired; `reasons` has one line per fired
+// rule with its value, the threshold it crossed and the worst offender.
+//
+// INFRASTRUCTURE RULES (#601), each evaluated only when its input is present
+// (the summary leaves an input undefined when the metric tables behind it do
+// not exist, or hold no fresh rows). No volume guard: each input is already a
+// level, not a rate over a sample.
+//
+//   disk utilization   >= 85 % degraded, >= 95 % critical  (worst mountpoint)
+//   memory utilization >= 90 % degraded, >= 97 % critical  (worst host)
+//   DB connections     >= 80 % degraded, >= 95 % critical  of max_connections
+//   oldest pending job >= 10 min degraded, >= 30 min critical (worst job type)
+//   worker nodes       any stale node degraded; a node-offered job type with
+//                      pending work and no eligible node critical
+//   TLS certificate    < 14 days degraded, < 7 days critical (soonest URL)
+//   uptime check       latest check failed degraded; every check in the
+//                      lookback failed (>= 2 checks) critical
+//   collector exports  any failed point degraded; >= 10 % of attempted
+//                      points failed critical
+//   last backup        > 26 h degraded, > 50 h critical
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERDICT_OFFENDER_CHARS = exports.VERDICT_LEVELS = exports.DASHBOARD_VERDICT_THRESHOLDS = exports.DEFAULT_VERDICT_THRESHOLDS = void 0;
+exports.computeVerdict = computeVerdict;
+const telemetry_1 = require("@marinoscar/platform-contract/telemetry");
+Object.defineProperty(exports, "VERDICT_LEVELS", { enumerable: true, get: function () { return telemetry_1.VERDICT_LEVELS; } });
+/**
+ * The shipped verdict thresholds (the values of the rules in this file's
+ * header). An app overrides any of them with
+ * `TelemetryModule.forRoot({ dashboard: { verdictThresholds } })`.
+ *
+ * @example
+ * ```ts
+ * const resolved = resolveVerdictThresholds({ noDataMinutes: 10 }); // every other value is the default
+ * ```
+ *
+ * @extensionPoint option
+ * @stability stable
+ */
+exports.DEFAULT_VERDICT_THRESHOLDS = {
+    /** Requests needed before the 5xx and p95 rules may fire. */
+    minRequests: 20,
+    errorRatePct: { degraded: 2, critical: 5 },
+    p95Ms: { degraded: 1000, critical: 3000 },
+    errorLogs: {
+        /** Error logs needed in the current window before the ratio rule may fire. */
+        minCurrent: 10,
+        degradedRatio: 3,
+        criticalRatio: 10,
+    },
+    /** Minutes without any trace or log after which the verdict is `no_data`. */
+    noDataMinutes: 5,
+    /**
+     * Unknown API routes (#650), bearer requests only. Any is degraded; either
+     * bound below (`>=`) is critical.
+     */
+    unknownRoutes: { criticalBearerRequests: 20, criticalDistinctRoutes: 3 },
+    // ---- infrastructure rules (#601) ----
+    /** Worst mountpoint, `>=`. */
+    diskUtilizationPct: { degraded: 85, critical: 95 },
+    /** Worst host, `>=`. */
+    memoryUtilizationPct: { degraded: 90, critical: 97 },
+    /** Backends against `max_connections`, worst server, `>=`. */
+    dbConnectionsPct: { degraded: 80, critical: 95 },
+    /** Oldest due pending job, worst job type, `>=`. */
+    oldestPendingJobMinutes: { degraded: 10, critical: 30 },
+    /** Certificate lifetime left, soonest URL, `<`. */
+    tlsDaysLeft: { degraded: 14, critical: 7 },
+    /** Checks an uptime target must have in the lookback before "every check failed" may be critical. */
+    uptimeMinChecksForCritical: 2,
+    /** Share of attempted exporter points that failed, `>=`, for critical (any failure is degraded). */
+    collectorFailedPct: { critical: 10 },
+    /** Age of the last successful backup, `>`. */
+    backupAgeHours: { degraded: 26, critical: 50 },
+};
+/**
+ * The shipped verdict thresholds, under their pre-#703 name.
+ *
+ * @deprecated Use {@link DEFAULT_VERDICT_THRESHOLDS}, or inject the resolved
+ *   thresholds (`TELEMETRY_VERDICT_THRESHOLDS`) to honour an app's override.
+ *
+ * @stability experimental
+ */
+exports.DASHBOARD_VERDICT_THRESHOLDS = exports.DEFAULT_VERDICT_THRESHOLDS;
+const RANK = { healthy: 0, degraded: 1, critical: 2, no_data: 3 };
+/** Characters of an offender (route or message) a reason line keeps. */
+exports.VERDICT_OFFENDER_CHARS = 80;
+/**
+ * The dashboard's health verdict: the worst rule that fired, with one reason
+ * per fired rule. The default {@link VerdictPolicy}'s rule set.
+ *
+ * @param input - the numbers the summary computed.
+ * @param thresholds - the resolved thresholds; defaults to {@link DEFAULT_VERDICT_THRESHOLDS}.
+ * @returns the level and the reasons.
+ *
+ * @stability stable
+ */
+function computeVerdict(input, thresholds = exports.DEFAULT_VERDICT_THRESHOLDS) {
+    const t = thresholds;
+    // No data overrides everything: the other rules would be judging silence.
+    const staleMs = input.lastDataAt ? input.now.getTime() - input.lastDataAt.getTime() : Number.POSITIVE_INFINITY;
+    if (staleMs > t.noDataMinutes * 60_000) {
+        return {
+            level: 'no_data',
+            reasons: [
+                input.lastDataAt
+                    ? `No telemetry received for ${Math.floor(staleMs / 60_000)} min`
+                    : 'No telemetry received recently',
+            ],
+        };
+    }
+    let level = 'healthy';
+    const reasons = [];
+    const fire = (fired, reason) => {
+        if (RANK[fired] > RANK[level])
+            level = fired;
+        reasons.push(reason);
+    };
+    if (input.requests >= t.minRequests) {
+        const ratePct = (input.errors5xx / input.requests) * 100;
+        const at = ratePct > t.errorRatePct.critical ? 'critical' : ratePct > t.errorRatePct.degraded ? 'degraded' : null;
+        if (at) {
+            fire(at, `5xx rate ${formatNumber(ratePct)}% (> ${t.errorRatePct[at]}%)${offender('top', input.topErrorRoute)}`);
+        }
+        if (input.p95Ms !== null) {
+            const p95 = input.p95Ms;
+            const at95 = p95 > t.p95Ms.critical ? 'critical' : p95 > t.p95Ms.degraded ? 'degraded' : null;
+            if (at95) {
+                fire(at95, `p95 latency ${formatNumber(p95)} ms (> ${t.p95Ms[at95]} ms)${offender('slowest', input.slowestRoute)}`);
+            }
+        }
+    }
+    if (input.errorLogs >= t.errorLogs.minCurrent) {
+        const ratio = input.errorLogs / Math.max(input.previousErrorLogs, 1);
+        const at = ratio >= t.errorLogs.criticalRatio ? 'critical' : ratio >= t.errorLogs.degradedRatio ? 'degraded' : null;
+        if (at) {
+            const threshold = at === 'critical' ? t.errorLogs.criticalRatio : t.errorLogs.degradedRatio;
+            fire(at, `Error logs ${input.errorLogs} vs ${input.previousErrorLogs} in the previous window ` +
+                `(${formatNumber(ratio)}× ≥ ${threshold}×)${offender('top', input.topErrorMessage)}`);
+        }
+    }
+    if (input.unknownRoutes && input.unknownRoutes.bearerRequests > 0) {
+        const { bearerRequests, bearerRoutes, topRoute } = input.unknownRoutes;
+        const critical = bearerRequests >= t.unknownRoutes.criticalBearerRequests ||
+            bearerRoutes >= t.unknownRoutes.criticalDistinctRoutes;
+        fire(critical ? 'critical' : 'degraded', `${bearerRequests} ${bearerRequests === 1 ? 'request' : 'requests'} to unknown API routes` +
+            (bearerRoutes > 1 ? ` across ${bearerRoutes} routes` : '') +
+            (topRoute ? ` (${shorten(topRoute)})` : ''));
+    }
+    infrastructureRules(input, fire, t);
+    return { level, reasons };
+}
+/** `>=` thresholds: the level reached, or null. */
+function atLeast(value, levels) {
+    return value >= levels.critical ? 'critical' : value >= levels.degraded ? 'degraded' : null;
+}
+/** The infrastructure rules (#601). Each runs only when its input is present. */
+function infrastructureRules(input, fire, t) {
+    if (input.disk) {
+        const at = atLeast(input.disk.utilizationPct, t.diskUtilizationPct);
+        if (at) {
+            fire(at, `Disk ${formatNumber(input.disk.utilizationPct)}% full (≥ ${t.diskUtilizationPct[at]}%)` +
+                offender('mountpoint', input.disk.mountpoint));
+        }
+    }
+    if (input.memory) {
+        const at = atLeast(input.memory.utilizationPct, t.memoryUtilizationPct);
+        if (at) {
+            fire(at, `Memory ${formatNumber(input.memory.utilizationPct)}% used (≥ ${t.memoryUtilizationPct[at]}%)` +
+                offender('host', input.memory.host));
+        }
+    }
+    if (input.dbConnections) {
+        const at = atLeast(input.dbConnections.utilizationPct, t.dbConnectionsPct);
+        if (at) {
+            fire(at, `Database connections at ${formatNumber(input.dbConnections.utilizationPct)}% of max ` +
+                `(≥ ${t.dbConnectionsPct[at]}%)${offender('server', input.dbConnections.instance)}`);
+        }
+    }
+    if (input.oldestPendingJob) {
+        const minutes = input.oldestPendingJob.ageSeconds / 60;
+        const at = atLeast(minutes, t.oldestPendingJobMinutes);
+        if (at) {
+            fire(at, `Oldest pending job waiting ${formatNumber(minutes)} min (≥ ${t.oldestPendingJobMinutes[at]} min)` +
+                offender('type', input.oldestPendingJob.jobType));
+        }
+    }
+    if (input.nodes) {
+        const stuck = input.nodes.noEligibleNodeTypes;
+        if (stuck.length > 0) {
+            fire('critical', `${stuck.length} job type(s) have pending work and no eligible worker node` +
+                offender('type', [...stuck].sort().join(', ')));
+        }
+        if (input.nodes.stale > 0) {
+            fire('degraded', `${input.nodes.stale} worker node(s) stale (missed heartbeats)`);
+        }
+    }
+    if (input.tls) {
+        const days = input.tls.daysLeft;
+        const at = days < t.tlsDaysLeft.critical ? 'critical' : days < t.tlsDaysLeft.degraded ? 'degraded' : null;
+        if (at) {
+            fire(at, (days < 0
+                ? `TLS certificate expired ${formatNumber(-days)} days ago`
+                : `TLS certificate expires in ${formatNumber(days)} days`) +
+                ` (< ${t.tlsDaysLeft[at]} days)${offender('url', input.tls.url)}`);
+        }
+    }
+    if (input.uptimeFailures && input.uptimeFailures.length > 0) {
+        const failures = [...input.uptimeFailures].sort((a, b) => a.url.localeCompare(b.url));
+        const down = failures.filter((f) => f.allFailed && f.checks >= t.uptimeMinChecksForCritical);
+        const worst = down[0] ?? failures[0];
+        fire(down.length > 0 ? 'critical' : 'degraded', down.length > 0
+            ? `Uptime check failing for every check in the lookback (${down.length} URL(s))${offender('url', worst.url)}`
+            : `Uptime check failed on its latest run (${failures.length} URL(s))${offender('url', worst.url)}`);
+    }
+    if (input.collector && input.collector.failed > 0) {
+        const attempted = input.collector.failed + input.collector.sent;
+        const pct = attempted > 0 ? (input.collector.failed / attempted) * 100 : 100;
+        const at = pct >= t.collectorFailedPct.critical ? 'critical' : 'degraded';
+        fire(at, `Collector failed to export ${formatNumber(input.collector.failed)} points (${formatNumber(pct)}% of attempted` +
+            `${at === 'critical' ? `, ≥ ${t.collectorFailedPct.critical}%` : ''})${offender('exporter', input.collector.exporter)}`);
+    }
+    if (input.backupAgeHours !== undefined && input.backupAgeHours !== null) {
+        const hours = input.backupAgeHours;
+        const at = hours > t.backupAgeHours.critical ? 'critical' : hours > t.backupAgeHours.degraded ? 'degraded' : null;
+        if (at)
+            fire(at, `Last successful backup ${formatNumber(hours)} h ago (> ${t.backupAgeHours[at]} h)`);
+    }
+}
+function offender(label, value) {
+    if (!value)
+        return '';
+    return ` — ${label}: ${shorten(value)}`;
+}
+/** One line, at most `VERDICT_OFFENDER_CHARS`. */
+function shorten(value) {
+    const oneLine = value.replace(/\s+/g, ' ').trim();
+    return oneLine.length > exports.VERDICT_OFFENDER_CHARS ? `${oneLine.slice(0, exports.VERDICT_OFFENDER_CHARS - 1)}…` : oneLine;
+}
+/** One decimal, without a trailing `.0`. */
+function formatNumber(value) {
+    const rounded = Math.round(value * 10) / 10;
+    return Number.isInteger(rounded) ? String(rounded) : rounded.toFixed(1);
+}
+//# sourceMappingURL=telemetry-dashboard.verdict.js.map

package/dist/telemetry/dashboard/telemetry-dashboard.verdict.js.map

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

package/dist/telemetry/dashboard/verdict-policy.d.ts

@@ -0,0 +1,51 @@
+import { type DashboardVerdict, type VerdictInput, type VerdictThresholds } from './telemetry-dashboard.verdict';
+/**
+ * Computes the dashboard summary's health verdict.
+ *
+ * @stability experimental
+ */
+export interface VerdictPolicy {
+    /**
+     * The verdict for one summary.
+     *
+     * @param input - the numbers the summary computed.
+     * @param thresholds - the resolved thresholds (`TELEMETRY_VERDICT_THRESHOLDS`).
+     * @returns the level and one reason per fired rule.
+     */
+    compute(input: VerdictInput, thresholds: VerdictThresholds): DashboardVerdict;
+}
+/**
+ * Injection token of the {@link VerdictPolicy} the dashboard uses. Bound by
+ * `TelemetryModule.forRoot()` to {@link DefaultVerdictPolicy}, or to the
+ * app's `dashboard.verdictPolicy`.
+ *
+ * @example
+ * ```ts
+ * const moduleRef = await Test.createTestingModule({ imports: [AppModule] })
+ *   .overrideProvider(VERDICT_POLICY)
+ *   .useValue({ compute: () => ({ level: 'critical', reasons: ['test'] }) })
+ *   .compile();
+ * ```
+ *
+ * @extensionPoint token
+ * @stability experimental
+ */
+export declare const VERDICT_POLICY: unique symbol;
+/**
+ * The platform's verdict rules (`computeVerdict`). Always provided by the
+ * telemetry module, so an app policy can inject it and delegate.
+ *
+ * @stability experimental
+ */
+export declare class DefaultVerdictPolicy implements VerdictPolicy {
+    /**
+     * The platform rules: no data, 5xx rate, p95, error logs, unknown routes and
+     * the infrastructure rules.
+     *
+     * @param input - the numbers the summary computed.
+     * @param thresholds - the resolved thresholds.
+     * @returns the level and one reason per fired rule.
+     */
+    compute(input: VerdictInput, thresholds: VerdictThresholds): DashboardVerdict;
+}
+//# sourceMappingURL=verdict-policy.d.ts.map

package/dist/telemetry/dashboard/verdict-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verdict-policy.d.ts","sourceRoot":"","sources":["../../../src/telemetry/dashboard/verdict-policy.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAkB,KAAK,gBAAgB,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEjI;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,iBAAiB,GAAG,gBAAgB,CAAC;CAC/E;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,cAAc,EAAE,OAAO,MAAoE,CAAC;AAEzG;;;;;GAKG;AACH,qBACa,oBAAqB,YAAW,aAAa;IACxD;;;;;;;OAOG;IACH,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,iBAAiB,GAAG,gBAAgB;CAG9E"}

package/dist/telemetry/dashboard/verdict-policy.js

@@ -0,0 +1,77 @@
+"use strict";
+// =============================================================================
+// VERDICT_POLICY: the dashboard's health verdict as a seam (issue #703,
+// Extension Contract rung 3)
+// =============================================================================
+//
+// `TelemetryDashboardService` asks the policy bound to `VERDICT_POLICY` for
+// the summary's verdict, with the resolved thresholds. The default is
+// `DefaultVerdictPolicy`, which is exactly `computeVerdict`. An app that adds
+// a metric group with a rule of its own binds its own policy and DELEGATES to
+// the default for every platform rule:
+//
+//   @Injectable()
+//   export class AppVerdictPolicy implements VerdictPolicy {
+//     constructor(private readonly platform: DefaultVerdictPolicy) {}
+//     compute(input: VerdictInput, thresholds: VerdictThresholds): DashboardVerdict {
+//       const verdict = this.platform.compute(input, thresholds);
+//       // ...add the app's own rule, never weaken a platform one
+//       return verdict;
+//     }
+//   }
+//
+//   TelemetryModule.forRoot({ ..., dashboard: { verdictPolicy: { useClass: AppVerdictPolicy } } })
+//
+// and a test swaps it with `.overrideProvider(VERDICT_POLICY).useValue(...)`.
+// =============================================================================
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultVerdictPolicy = exports.VERDICT_POLICY = void 0;
+const common_1 = require("@nestjs/common");
+const telemetry_dashboard_verdict_1 = require("./telemetry-dashboard.verdict");
+/**
+ * Injection token of the {@link VerdictPolicy} the dashboard uses. Bound by
+ * `TelemetryModule.forRoot()` to {@link DefaultVerdictPolicy}, or to the
+ * app's `dashboard.verdictPolicy`.
+ *
+ * @example
+ * ```ts
+ * const moduleRef = await Test.createTestingModule({ imports: [AppModule] })
+ *   .overrideProvider(VERDICT_POLICY)
+ *   .useValue({ compute: () => ({ level: 'critical', reasons: ['test'] }) })
+ *   .compile();
+ * ```
+ *
+ * @extensionPoint token
+ * @stability experimental
+ */
+exports.VERDICT_POLICY = Symbol.for('@marinoscar/platform/telemetry/VERDICT_POLICY');
+/**
+ * The platform's verdict rules (`computeVerdict`). Always provided by the
+ * telemetry module, so an app policy can inject it and delegate.
+ *
+ * @stability experimental
+ */
+let DefaultVerdictPolicy = class DefaultVerdictPolicy {
+    /**
+     * The platform rules: no data, 5xx rate, p95, error logs, unknown routes and
+     * the infrastructure rules.
+     *
+     * @param input - the numbers the summary computed.
+     * @param thresholds - the resolved thresholds.
+     * @returns the level and one reason per fired rule.
+     */
+    compute(input, thresholds) {
+        return (0, telemetry_dashboard_verdict_1.computeVerdict)(input, thresholds);
+    }
+};
+exports.DefaultVerdictPolicy = DefaultVerdictPolicy;
+exports.DefaultVerdictPolicy = DefaultVerdictPolicy = __decorate([
+    (0, common_1.Injectable)()
+], DefaultVerdictPolicy);
+//# sourceMappingURL=verdict-policy.js.map