@marinoscar/platform-web 0.0.0-stage → 0.1.0-next.4

package/dist/telemetry/headless/lib/format.js

@@ -0,0 +1,354 @@
+/**
+ * Number, time and change formatting for the Telemetry Dashboard (#578).
+ * Pure functions, so the tiles and tables stay presentation-only.
+ */
+import { BUILTIN_METRIC_UNITS } from '@marinoscar/platform-contract/telemetry';
+/**
+ * A tile value as a number, or `null` (`int8` may arrive as a string).
+ *
+ * @stability experimental
+ */
+export function toNumber(value) {
+    if (value === null || value === undefined || value === '')
+        return null;
+    const n = typeof value === 'number' ? value : Number(value);
+    return Number.isFinite(n) ? n : null;
+}
+const compact = (n, digits = 1) => n.toLocaleString(undefined, { maximumFractionDigits: digits });
+/**
+ * A duration in milliseconds at a readable scale: `8.5 ms`, `120 ms`, `1.25 s`.
+ *
+ * @param ms - the duration in milliseconds.
+ * @returns the value and its unit, separated by a space.
+ *
+ * @stability experimental
+ */
+export function formatDuration(ms) {
+    if (ms >= 1000)
+        return `${compact(ms / 1000, 2)} s`;
+    return `${compact(ms, ms < 10 ? 1 : 0)} ms`;
+}
+/**
+ * A byte count in binary units: `512 B`, `1.5 KB`, `3.2 GB`.
+ *
+ * @param bytes - the count.
+ * @returns the value and its unit, separated by a space.
+ *
+ * @stability experimental
+ */
+export function formatBytes(bytes) {
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    let value = bytes;
+    let unit = 0;
+    while (Math.abs(value) >= 1024 && unit < units.length - 1) {
+        value /= 1024;
+        unit += 1;
+    }
+    return `${compact(value, unit === 0 ? 0 : 1)} ${units[unit]}`;
+}
+/**
+ * A duration in seconds at a readable scale: `42 s`, `12.5 min`, `3.2 h`,
+ * `4.1 d` — a queue age of 5400 s reads better as 1.5 h.
+ *
+ * @stability experimental
+ */
+export function formatSeconds(seconds) {
+    const abs = Math.abs(seconds);
+    if (abs < 1)
+        return `${compact(seconds * 1000, 0)} ms`;
+    if (abs < 60)
+        return `${compact(seconds, abs < 10 ? 2 : 1)} s`;
+    if (abs < 3600)
+        return `${compact(seconds / 60, 1)} min`;
+    if (abs < 48 * 3600)
+        return `${compact(seconds / 3600, 1)} h`;
+    return `${compact(seconds / 86_400, 1)} d`;
+}
+/**
+ * The platform's own unit ids. A descriptor never overrides one of them.
+ *
+ * @stability experimental
+ */
+export const BUILTIN_UNIT_IDS = new Set(BUILTIN_METRIC_UNITS);
+/**
+ * `value` in an app's unit, split as `formatTileValue` splits: `number`
+ * (grouped digits, `decimals`, `suffix`), `percent`, `bytes`, `duration-ms`,
+ * `duration-s`, `currency` (the browser's `Intl` currency format; the whole
+ * amount is in `value`), and `text`, `boolean`, `timestamp` as the built-ins.
+ *
+ * @param value - the cell or tile value.
+ * @param unit - the descriptor of the unit.
+ * @param now - the clock, for `timestamp`.
+ * @returns the value and its unit text.
+ *
+ * @stability experimental
+ */
+export function formatWithDescriptor(value, unit, now = Date.now()) {
+    switch (unit.format) {
+        case 'text':
+            return formatTileValue(value, 'text', now);
+        case 'boolean':
+            return formatTileValue(value, 'boolean', now);
+        case 'timestamp':
+            return formatTileValue(value, 'timestamp', now);
+        default:
+            break;
+    }
+    const n = toNumber(value);
+    if (n === null)
+        return { value: '—', unit: '' };
+    switch (unit.format) {
+        case 'percent':
+            return { value: compact(n, unit.decimals ?? 2), unit: '%' };
+        case 'bytes': {
+            const [amount, suffix] = formatBytes(n).split(' ');
+            return { value: amount, unit: suffix };
+        }
+        case 'duration-ms': {
+            const [amount, suffix] = formatDuration(n).split(' ');
+            return { value: amount, unit: suffix };
+        }
+        case 'duration-s':
+            return split(formatSeconds(n));
+        case 'currency': {
+            const digits = unit.decimals ?? 2;
+            try {
+                return {
+                    value: new Intl.NumberFormat(undefined, {
+                        style: 'currency',
+                        currency: unit.currency,
+                        minimumFractionDigits: digits,
+                        maximumFractionDigits: digits,
+                    }).format(n),
+                    unit: '',
+                };
+            }
+            catch {
+                return { value: compact(n, digits), unit: unit.currency ?? '' };
+            }
+        }
+        default:
+            return { value: compact(n, unit.decimals ?? 2), unit: (unit.suffix ?? '').trim() };
+    }
+}
+function split(text) {
+    const at = text.indexOf(' ');
+    return at < 0 ? { value: text, unit: '' } : { value: text.slice(0, at), unit: text.slice(at + 1) };
+}
+/**
+ * `value` and its unit, split so a tile can style them apart. Covers the
+ * summary's units (`req/min`, `%`, `ms`, `count`, `bytes`, `timestamp`) and
+ * every metric unit of `/metrics` (#601): `bytes/s`, `per_s`, `per_min`,
+ * `seconds`, `hours`, `days`, `cores`, `load`, `text` and `boolean`. An
+ * unknown unit is shown as given.
+ *
+ * @stability experimental
+ */
+export function formatTileValue(value, unit, now = Date.now(), formats) {
+    // An app's own unit is formatted from its descriptor; a built-in id never is (the cases below).
+    if (formats !== undefined && !BUILTIN_UNIT_IDS.has(unit)) {
+        const descriptor = formats.get(unit);
+        if (descriptor)
+            return formatWithDescriptor(value, descriptor, now);
+    }
+    if (unit === 'timestamp') {
+        if (typeof value !== 'string' || !Number.isFinite(Date.parse(value)))
+            return { value: '—', unit: '' };
+        return { value: formatRelative(value, now), unit: '' };
+    }
+    if (unit === 'text') {
+        return value === null || value === '' ? { value: '—', unit: '' } : { value: String(value), unit: '' };
+    }
+    const n = toNumber(value);
+    if (n === null)
+        return { value: '—', unit: '' };
+    switch (unit) {
+        case '%':
+            return { value: compact(n, 2), unit: '%' };
+        case 'ms': {
+            const [amount, suffix] = formatDuration(n).split(' ');
+            return { value: amount, unit: suffix };
+        }
+        case 'bytes': {
+            const [amount, suffix] = formatBytes(n).split(' ');
+            return { value: amount, unit: suffix };
+        }
+        case 'count':
+            return { value: Math.round(n).toLocaleString(), unit: '' };
+        case 'bytes/s': {
+            const [amount, suffix] = formatBytes(n).split(' ');
+            return { value: amount, unit: `${suffix}/s` };
+        }
+        case 'per_s':
+            return { value: compact(n, 2), unit: '/s' };
+        case 'per_min':
+            return { value: compact(n, 2), unit: '/min' };
+        case 'seconds':
+            return split(formatSeconds(n));
+        case 'hours':
+            return n >= 48 ? { value: compact(n / 24, 1), unit: 'd' } : { value: compact(n, 1), unit: 'h' };
+        case 'days':
+            return { value: compact(n, 1), unit: Math.abs(n) === 1 ? 'day' : 'days' };
+        case 'cores':
+            return { value: compact(n, 2), unit: Math.abs(n) === 1 ? 'core' : 'cores' };
+        case 'load':
+            return { value: compact(n, 2), unit: '' };
+        case 'boolean':
+            return { value: n >= 1 ? 'Yes' : 'No', unit: '' };
+        default:
+            return { value: compact(n, 2), unit };
+    }
+}
+/**
+ * A tile value or table cell as one string (`—` for nothing), e.g. `35.6%`, `1.2 GB`, `Yes`.
+ *
+ * @stability experimental
+ */
+export function formatMetricValue(value, unit, now = Date.now(), formats) {
+    if (value === undefined || value === null)
+        return '—';
+    if (typeof value === 'boolean')
+        return value ? 'Yes' : 'No';
+    const formatted = formatTileValue(value, unit, now, formats);
+    if (!formatted.unit)
+        return formatted.value;
+    return formatted.unit === '%' || formatted.unit.startsWith('/')
+        ? `${formatted.value}${formatted.unit}`
+        : `${formatted.value} ${formatted.unit}`;
+}
+/**
+ * "5s ago", "3m ago", "2h ago", "4d ago"; "just now" under a second.
+ *
+ * @stability experimental
+ */
+export function formatRelative(iso, now = Date.now()) {
+    const then = Date.parse(iso);
+    if (!Number.isFinite(then))
+        return '—';
+    const seconds = Math.max(0, Math.round((now - then) / 1000));
+    if (seconds < 1)
+        return 'just now';
+    if (seconds < 60)
+        return `${seconds}s ago`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 48)
+        return `${hours}h ago`;
+    return `${Math.floor(hours / 24)}d ago`;
+}
+/**
+ * A readable absolute timestamp (local time, to the second).
+ *
+ * @stability experimental
+ */
+export function formatTimestamp(iso) {
+    if (!iso)
+        return '—';
+    const then = Date.parse(iso);
+    if (!Number.isFinite(then))
+        return iso;
+    return new Date(then).toLocaleString(undefined, {
+        year: 'numeric',
+        month: 'short',
+        day: 'numeric',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+    });
+}
+/**
+ * A bucket's x-axis label: time of day, plus the date for multi-day spans.
+ *
+ * @stability experimental
+ */
+export function formatBucketLabel(iso, spanMs) {
+    const then = Date.parse(iso);
+    if (!Number.isFinite(then))
+        return iso;
+    const date = new Date(then);
+    if (spanMs > 24 * 60 * 60_000) {
+        return date.toLocaleString(undefined, { month: 'short', day: 'numeric', hour: '2-digit', minute: '2-digit' });
+    }
+    return date.toLocaleTimeString(undefined, { hour: '2-digit', minute: '2-digit' });
+}
+const TILE_DIRECTIONS = {
+    requestsPerMin: 'neutral',
+    errorRatePct: 'up-is-bad',
+    p95Ms: 'up-is-bad',
+    errorLogs: 'up-is-bad',
+    warnLogs: 'up-is-bad',
+    unknownRoutes: 'up-is-bad',
+    heapUsedBytes: 'up-is-bad',
+    eventLoopDelayP99Ms: 'up-is-bad',
+    // `/metrics` tiles (#601): utilization, ages, failures and stalls up is bad;
+    // headroom (cache hits, healthy nodes, certificate days) down is bad.
+    cpuUtilization: 'up-is-bad',
+    memoryUtilization: 'up-is-bad',
+    load1m: 'up-is-bad',
+    filesystemUtilization: 'up-is-bad',
+    dbConnectionUtilization: 'up-is-bad',
+    dbCacheHitRatio: 'down-is-bad',
+    dbRollbacks: 'up-is-bad',
+    dbDeadlocks: 'up-is-bad',
+    'queueDepth.pending': 'up-is-bad',
+    oldestPendingAge: 'up-is-bad',
+    jobFailureRatio: 'up-is-bad',
+    jobDurationP95: 'up-is-bad',
+    backupAge: 'up-is-bad',
+    'nodesByHealth.healthy': 'down-is-bad',
+    'nodesByHealth.stale': 'up-is-bad',
+    'nodesByHealth.offline': 'up-is-bad',
+    noEligibleNode: 'up-is-bad',
+    httpDuration: 'up-is-bad',
+    tlsDaysLeft: 'down-is-bad',
+    exporterFailed: 'up-is-bad',
+    exporterQueueUtilization: 'up-is-bad',
+    receiverRefused: 'up-is-bad',
+    greptimeWriteStalls: 'up-is-bad',
+    scrapeTargetsDown: 'up-is-bad',
+};
+/**
+ * Whether a rising value is bad, good or neither for the tile `key`.
+ *
+ * @param key - the tile's key.
+ * @returns the tile's direction (`neutral` for an unknown key).
+ *
+ * @stability experimental
+ */
+export function tileDirection(key) {
+    return TILE_DIRECTIONS[key] ?? 'neutral';
+}
+/**
+ * A tile's change against its previous value, toned by `direction`.
+ *
+ * @param value - the current value.
+ * @param previous - the previous window's value.
+ * @param direction - from {@link tileDirection}.
+ * @returns the change, its trend and its tone.
+ *
+ * @stability experimental
+ */
+export function tileChange(value, previous, direction) {
+    const current = toNumber(value);
+    const before = toNumber(previous);
+    if (current === null || before === null)
+        return { pct: null, trend: 'flat', tone: 'neutral' };
+    if (before === 0) {
+        if (current === 0)
+            return { pct: 0, trend: 'flat', tone: 'neutral' };
+        return { pct: null, trend: 'up', tone: direction === 'up-is-bad' ? 'bad' : direction === 'down-is-bad' ? 'good' : 'neutral' };
+    }
+    const pct = Math.round(((current - before) / Math.abs(before)) * 1000) / 10;
+    if (pct === 0)
+        return { pct: 0, trend: 'flat', tone: 'neutral' };
+    const trend = pct > 0 ? 'up' : 'down';
+    let tone = 'neutral';
+    if (direction === 'up-is-bad')
+        tone = trend === 'up' ? 'bad' : 'good';
+    if (direction === 'down-is-bad')
+        tone = trend === 'down' ? 'bad' : 'good';
+    return { pct, trend, tone };
+}
+//# sourceMappingURL=format.js.map

package/dist/telemetry/headless/lib/format.js.map

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

package/dist/telemetry/headless/lib/metrics/metricSections.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The Telemetry Dashboard's infrastructure sections — issue #602, epic #576.
+ *
+ * One section per `/metrics` group (#601). WHICH sections, their titles and
+ * their order come from the API's `GET …/metric-groups` (#680,
+ * `DashboardMetricGroupMeta`), so a group an application registers renders
+ * without a web change. This file keeps the anchor a verdict reason links to,
+ * and which reason belongs to which section, read off the wording of the API's
+ * infrastructure verdict rules (`telemetry-dashboard.verdict.ts`,
+ * docs/specs/telemetry.md §11.7); a reason no pattern matches (the traffic
+ * rules, "no data", an app group) simply gets no link.
+ */
+import type { DashboardMetricGroup, DashboardMetricGroupMeta } from '../../services/telemetryDashboard.js';
+/** A section's metadata: one `/metric-groups` entry. */
+export type MetricSectionMeta = DashboardMetricGroupMeta;
+/**
+ * Fallback titles for two platform groups whose dashboard title is not their
+ * id, used only while (or when) the API's group metadata does not list the
+ * group. The metadata always wins: an app group (EvoPath's `coach`) is titled
+ * from it with no entry here.
+ *
+ * @stability experimental
+ */
+export declare const METRIC_SECTION_TITLES: Readonly<Partial<Record<DashboardMetricGroup, string>>>;
+/**
+ * The section title the API gives `group`; else {@link METRIC_SECTION_TITLES};
+ * else the id itself.
+ *
+ * @param group - the metric group id.
+ * @param groups - the API's group metadata (`GET …/metric-groups`).
+ * @returns the title to show.
+ *
+ * @stability experimental
+ */
+export declare function metricSectionTitle(group: DashboardMetricGroup, groups?: readonly Pick<DashboardMetricGroupMeta, 'id' | 'title'>[]): string;
+/** The DOM id of a section's anchor (the verdict banner scrolls to it). */
+export declare function metricSectionAnchor(group: DashboardMetricGroup): string;
+/** The section's `DashboardPanel` id (tests, and the ⋮ menu focus return). */
+export declare function metricPanelId(group: DashboardMetricGroup): string;
+/** The section a verdict reason is about, or null for the traffic and no-data rules. */
+export declare function verdictReasonGroup(reason: string): DashboardMetricGroup | null;
+/** Scroll a section into view and move focus to it (its region is focusable for this). */
+export declare function scrollToMetricSection(group: DashboardMetricGroup): void;
+//# sourceMappingURL=metricSections.d.ts.map

package/dist/telemetry/headless/lib/metrics/metricSections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricSections.d.ts","sourceRoot":"","sources":["../../../../../src/telemetry/headless/lib/metrics/metricSections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAE3G,wDAAwD;AACxD,MAAM,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AAEzD;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,CAGxF,CAAC;AAEH;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,oBAAoB,EAC3B,MAAM,GAAE,SAAS,IAAI,CAAC,wBAAwB,EAAE,IAAI,GAAG,OAAO,CAAC,EAAO,GACrE,MAAM,CAER;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAEvE;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAEjE;AAeD,wFAAwF;AACxF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAG9E;AAED,0FAA0F;AAC1F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAKvE"}

package/dist/telemetry/headless/lib/metrics/metricSections.js

@@ -0,0 +1,61 @@
+/**
+ * Fallback titles for two platform groups whose dashboard title is not their
+ * id, used only while (or when) the API's group metadata does not list the
+ * group. The metadata always wins: an app group (EvoPath's `coach`) is titled
+ * from it with no entry here.
+ *
+ * @stability experimental
+ */
+export const METRIC_SECTION_TITLES = Object.freeze({
+    host: 'Infrastructure',
+    uptime: 'Uptime & dependencies',
+});
+/**
+ * The section title the API gives `group`; else {@link METRIC_SECTION_TITLES};
+ * else the id itself.
+ *
+ * @param group - the metric group id.
+ * @param groups - the API's group metadata (`GET …/metric-groups`).
+ * @returns the title to show.
+ *
+ * @stability experimental
+ */
+export function metricSectionTitle(group, groups = []) {
+    return groups.find((section) => section.id === group)?.title ?? METRIC_SECTION_TITLES[group] ?? group;
+}
+/** The DOM id of a section's anchor (the verdict banner scrolls to it). */
+export function metricSectionAnchor(group) {
+    return `telemetry-section-${group}`;
+}
+/** The section's `DashboardPanel` id (tests, and the ⋮ menu focus return). */
+export function metricPanelId(group) {
+    return `panel-metrics-${group}`;
+}
+const REASON_PATTERNS = [
+    [/^Disk \S+% full/, 'host'],
+    [/^Memory \S+% used/, 'host'],
+    [/^Database connections at/, 'database'],
+    [/^Oldest pending job waiting/, 'queue'],
+    [/^Last successful backup/, 'queue'],
+    [/job type\(s\) have pending work and no eligible worker node/, 'nodes'],
+    [/worker node\(s\) stale/, 'nodes'],
+    [/^TLS certificate (expires|expired)/, 'uptime'],
+    [/^Uptime check (failed|failing)/, 'uptime'],
+    [/^Collector failed to export/, 'pipeline'],
+];
+/** The section a verdict reason is about, or null for the traffic and no-data rules. */
+export function verdictReasonGroup(reason) {
+    for (const [pattern, group] of REASON_PATTERNS)
+        if (pattern.test(reason))
+            return group;
+    return null;
+}
+/** Scroll a section into view and move focus to it (its region is focusable for this). */
+export function scrollToMetricSection(group) {
+    const target = document.getElementById(metricSectionAnchor(group));
+    if (!target)
+        return;
+    target.scrollIntoView?.({ behavior: 'smooth', block: 'start' });
+    target.focus({ preventScroll: true });
+}
+//# sourceMappingURL=metricSections.js.map

package/dist/telemetry/headless/lib/metrics/metricSections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricSections.js","sourceRoot":"","sources":["../../../../../src/telemetry/headless/lib/metrics/metricSections.ts"],"names":[],"mappings":"AAiBA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA4D,MAAM,CAAC,MAAM,CAAC;IAC1G,IAAI,EAAE,gBAAgB;IACtB,MAAM,EAAE,uBAAuB;CAChC,CAAC,CAAC;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAA2B,EAC3B,SAAoE,EAAE;IAEtE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,KAAK,IAAI,qBAAqB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;AACxG,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,mBAAmB,CAAC,KAA2B;IAC7D,OAAO,qBAAqB,KAAK,EAAE,CAAC;AACtC,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,aAAa,CAAC,KAA2B;IACvD,OAAO,iBAAiB,KAAK,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,eAAe,GAA8C;IACjE,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAC3B,CAAC,mBAAmB,EAAE,MAAM,CAAC;IAC7B,CAAC,0BAA0B,EAAE,UAAU,CAAC;IACxC,CAAC,6BAA6B,EAAE,OAAO,CAAC;IACxC,CAAC,yBAAyB,EAAE,OAAO,CAAC;IACpC,CAAC,6DAA6D,EAAE,OAAO,CAAC;IACxE,CAAC,wBAAwB,EAAE,OAAO,CAAC;IACnC,CAAC,oCAAoC,EAAE,QAAQ,CAAC;IAChD,CAAC,gCAAgC,EAAE,QAAQ,CAAC;IAC5C,CAAC,6BAA6B,EAAE,UAAU,CAAC;CAC5C,CAAC;AAEF,wFAAwF;AACxF,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,eAAe;QAAE,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;IACvF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,qBAAqB,CAAC,KAA2B;IAC/D,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;IACnE,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,CAAC,cAAc,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAChE,MAAM,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;AACxC,CAAC"}

package/dist/telemetry/headless/lib/metrics/presentation.d.ts

@@ -0,0 +1,137 @@
+import type { MetricGroupPresentation, PresentationColumn, PresentationTableSort, PresentationTile, PresentationTopN, PresentationVirtualColumn, ThemeColorToken } from '@marinoscar/platform-contract/telemetry';
+import type { TelemetryTokens } from '../../../theme/telemetryTokens.js';
+import type { DashboardMetricCell, DashboardMetricGroup, DashboardMetricTable, DashboardMetrics, DashboardTile } from '../../services/telemetryDashboard.js';
+/**
+ * The presentation to draw for `group`: the one the API served; else, for a
+ * platform group, the platform's own (so a section looks the same against an API
+ * that predates presentations); else none (the dashboard's defaults).
+ *
+ * @param group - the group id.
+ * @param served - the `presentation` of the group's `/metric-groups` entry.
+ * @returns the presentation, or `undefined` for the defaults.
+ *
+ * @stability experimental
+ */
+export declare function presentationFor(group: DashboardMetricGroup, served?: MetricGroupPresentation | null): MetricGroupPresentation | undefined;
+/**
+ * The CSS colour of a presentation colour token under the telemetry theme
+ * tokens: `ok`, `warn`, `crit`, `info`, `neutral` are `palette.status`, and
+ * `series-N` is the Nth `palette.chart.series` colour (wrapping).
+ *
+ * @param token - the token a presentation named.
+ * @param tokens - the theme's telemetry tokens.
+ * @returns the colour string.
+ *
+ * @stability experimental
+ */
+export declare function colorOfToken(token: ThemeColorToken, tokens: TelemetryTokens): string;
+/**
+ * One chart of a section.
+ *
+ * @stability experimental
+ */
+export interface ChartPlan {
+    /** The chart's title: its accessible name. */
+    title: string;
+    /** Series keys, in legend order; every series of a key (one per `groupBy`) is drawn. */
+    keys: string[];
+    /** Theme colour tokens by `groupBy` value. */
+    colors?: Record<string, ThemeColorToken>;
+}
+/**
+ * One column of a table in a section.
+ *
+ * @stability experimental
+ */
+export interface ColumnPlan extends PresentationColumn {
+}
+/**
+ * One table of a section.
+ *
+ * @stability experimental
+ */
+export interface TablePlan {
+    /** The table key of the `/metrics` response. */
+    key: string;
+    /** Replaces the table's label. */
+    label?: string;
+    /** The columns drawn, in order; absent: every column of the response. */
+    columns?: ColumnPlan[];
+    /** The row order. */
+    sort?: PresentationTableSort;
+    /** The row limit offered; absent: every row. */
+    topN?: {
+        /** The counts offered, ascending, optionally ending in `'all'`. */
+        options: readonly (number | 'all')[];
+        /** The count shown until the viewer chooses. */
+        default: number | 'all';
+    };
+}
+/**
+ * What a section draws.
+ *
+ * @stability experimental
+ */
+export interface SectionPlan {
+    /** The tiles, in order. */
+    tiles: PresentationTile[];
+    /** The charts, in order. */
+    charts: ChartPlan[];
+    /** The tables, in order. */
+    tables: TablePlan[];
+    /** The columns the browser computes. */
+    virtualColumns: PresentationVirtualColumn[];
+}
+/** A "Top N" given as a bare number offers that many rows, or all of them. */
+export declare function normalizeTopN(topN: PresentationTopN | undefined): TablePlan['topN'];
+/**
+ * What a section draws for a response: each part of the presentation that is
+ * present is exactly what is drawn (an empty list draws nothing); each part it
+ * leaves out takes the default: every tile in the response's order, one chart per
+ * series key, every table.
+ *
+ * @param data - the group's `/metrics` response.
+ * @param presentation - the group's presentation, or `undefined` for all defaults.
+ * @returns the plan.
+ *
+ * @stability experimental
+ */
+export declare function sectionPlan(data: DashboardMetrics, presentation: MetricGroupPresentation | undefined): SectionPlan;
+/**
+ * The section's tiles, in the plan's order, that the response carries, with the
+ * plan's label and unit applied. A tile with no override is the response's own
+ * object.
+ *
+ * @param data - the `/metrics` response.
+ * @param plan - the section plan.
+ * @returns the tiles to draw.
+ *
+ * @stability experimental
+ */
+export declare function planTiles(data: DashboardMetrics, plan: SectionPlan): DashboardTile[];
+/**
+ * A table with the presentation's virtual columns appended: `ratio` (`a / b` as
+ * a percentage), `delta` (`a - b`), `rate` (`a` per second over `spanMs`). A row
+ * where an input is not a number, or a ratio's divisor is zero, gets `null`.
+ * Returns `table` itself when no virtual column applies.
+ *
+ * @param table - a response table.
+ * @param virtualColumns - the presentation's computed columns.
+ * @param spanMs - the window's length, for `rate`.
+ * @returns the table to draw.
+ *
+ * @stability experimental
+ */
+export declare function withVirtualColumns(table: DashboardMetricTable, virtualColumns: readonly PresentationVirtualColumn[], spanMs: number): DashboardMetricTable;
+/**
+ * The comparator for `sort: 'value-desc'` over `table`: the first column after
+ * the key, largest first, rows with no number last. Stable (equal values keep
+ * the API's order). `undefined` when the table has no value column.
+ *
+ * @param table - the response table the rows belong to.
+ * @returns the comparator, or `undefined`.
+ *
+ * @stability experimental
+ */
+export declare function byFirstValueDesc(table: DashboardMetricTable): ((a: Record<string, DashboardMetricCell>, b: Record<string, DashboardMetricCell>) => number) | undefined;
+//# sourceMappingURL=presentation.d.ts.map

package/dist/telemetry/headless/lib/metrics/presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.d.ts","sourceRoot":"","sources":["../../../../../src/telemetry/headless/lib/metrics/presentation.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EAGlB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,EACzB,eAAe,EAChB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEzE,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EAEpB,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACd,MAAM,sCAAsC,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,oBAAoB,EAC3B,MAAM,CAAC,EAAE,uBAAuB,GAAG,IAAI,GACtC,uBAAuB,GAAG,SAAS,CAKrC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,CAOpF;AAID;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC1C;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAW,SAAQ,kBAAkB;CAAG;AAEzD;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,qBAAqB;IACrB,IAAI,CAAC,EAAE,qBAAqB,CAAC;IAC7B,gDAAgD;IAChD,IAAI,CAAC,EAAE;QACL,mEAAmE;QACnE,OAAO,EAAE,SAAS,CAAC,MAAM,GAAG,KAAK,CAAC,EAAE,CAAC;QACrC,gDAAgD;QAChD,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;KACzB,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,4BAA4B;IAC5B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,4BAA4B;IAC5B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,wCAAwC;IACxC,cAAc,EAAE,yBAAyB,EAAE,CAAC;CAC7C;AAQD,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAGnF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,gBAAgB,EAAE,YAAY,EAAE,uBAAuB,GAAG,SAAS,GAAG,WAAW,CA4BlH;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,aAAa,EAAE,CASpF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,oBAAoB,EAC3B,cAAc,EAAE,SAAS,yBAAyB,EAAE,EACpD,MAAM,EAAE,MAAM,GACb,oBAAoB,CAyBtB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,oBAAoB,GAC1B,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,KAAK,MAAM,CAAC,GAAG,SAAS,CAY1G"}