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

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

@@ -0,0 +1,185 @@
+/**
+ * Resolving a metric group's presentation for the dashboard (PP-14.18).
+ *
+ * The API serves each group's `presentation` (data only: tiles, charts, tables,
+ * computed columns). This file turns it, and the response it is applied to,
+ * into the plan the section draws, with the dashboard's defaults for whatever the
+ * presentation leaves out. Pure functions; no React, no MUI.
+ */
+import { PLATFORM_METRIC_PRESENTATIONS } from '@marinoscar/platform-contract/telemetry';
+import { toNumber } from '../format.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 function presentationFor(group, served) {
+    if (served)
+        return served;
+    return Object.prototype.hasOwnProperty.call(PLATFORM_METRIC_PRESENTATIONS, group)
+        ? PLATFORM_METRIC_PRESENTATIONS[group]
+        : 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 function colorOfToken(token, tokens) {
+    const series = /^series-(\d)$/.exec(token);
+    if (series) {
+        const palette = tokens.chart.series;
+        return palette[(Number(series[1]) - 1) % palette.length];
+    }
+    return tokens.status[token];
+}
+/** The series label without its `groupBy` suffix (`Disk IO: read` → `Disk IO`). */
+function familyLabel(series) {
+    const suffix = series.groupBy === null ? '' : `: ${series.groupBy}`;
+    return suffix && series.label.endsWith(suffix) ? series.label.slice(0, -suffix.length) : series.label;
+}
+/** A "Top N" given as a bare number offers that many rows, or all of them. */
+export function normalizeTopN(topN) {
+    if (topN === undefined)
+        return undefined;
+    return typeof topN === 'number' ? { options: [topN, 'all'], default: topN } : 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 function sectionPlan(data, presentation) {
+    const seriesKeys = [...new Set(data.series.map((series) => series.key))];
+    return {
+        tiles: presentation?.tiles ?? data.tiles.map((tile) => ({ metric: tile.key })),
+        charts: presentation?.series?.map((chart) => ({
+            title: chart.title,
+            keys: chart.metrics,
+            ...(chart.colors ? { colors: chart.colors } : {}),
+        })) ??
+            seriesKeys.map((key) => ({
+                title: familyLabel(data.series.find((series) => series.key === key)),
+                keys: [key],
+            })),
+        tables: presentation?.tables?.map((table) => ({
+            key: table.metric,
+            ...(table.label ? { label: table.label } : {}),
+            ...(table.columns ? { columns: table.columns } : {}),
+            ...(table.sort ? { sort: table.sort } : {}),
+            ...(table.topN !== undefined ? { topN: normalizeTopN(table.topN) } : {}),
+        })) ?? data.tables.map((table) => ({ key: table.key })),
+        virtualColumns: presentation?.virtualColumns ?? [],
+    };
+}
+/**
+ * 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 function planTiles(data, plan) {
+    const byKey = new Map(data.tiles.map((tile) => [tile.key, tile]));
+    return plan.tiles.flatMap((spec) => {
+        const tile = byKey.get(spec.metric);
+        if (!tile)
+            return [];
+        return spec.label !== undefined || spec.unit !== undefined
+            ? [{ ...tile, ...(spec.label !== undefined ? { label: spec.label } : {}), ...(spec.unit !== undefined ? { unit: spec.unit } : {}) }]
+            : [tile];
+    });
+}
+/**
+ * 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 function withVirtualColumns(table, virtualColumns, spanMs) {
+    const present = new Set(table.columns.map((column) => column.key));
+    const applicable = virtualColumns.filter((column) => (column.table === undefined || column.table === table.key) && column.of.every((input) => present.has(input)) && !present.has(column.id));
+    if (applicable.length === 0)
+        return table;
+    const unitOf = (key) => table.columns.find((column) => column.key === key)?.unit ?? 'count';
+    const compute = (column, row) => {
+        const a = toNumber(row[column.of[0]]);
+        if (a === null)
+            return null;
+        if (column.expression === 'rate')
+            return spanMs > 0 ? round(a / (spanMs / 1000)) : null;
+        const b = toNumber(row[column.of[1]]);
+        if (b === null)
+            return null;
+        if (column.expression === 'delta')
+            return round(a - b);
+        return b === 0 ? null : round((a / b) * 100);
+    };
+    const defaultUnit = (column) => column.unit ?? (column.expression === 'ratio' ? '%' : column.expression === 'rate' ? 'per_s' : unitOf(column.of[0]));
+    return {
+        ...table,
+        columns: [...table.columns, ...applicable.map((column) => ({ key: column.id, label: column.label, unit: defaultUnit(column) }))],
+        rows: table.rows.map((row) => ({ ...row, ...Object.fromEntries(applicable.map((column) => [column.id, compute(column, row)])) })),
+    };
+}
+function round(value) {
+    return Math.round(value * 100) / 100;
+}
+/**
+ * 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 function byFirstValueDesc(table) {
+    const column = table.columns.find((candidate) => candidate.key !== 'key')?.key;
+    if (column === undefined)
+        return undefined;
+    const value = (row) => toNumber(row[column]);
+    return (a, b) => {
+        const left = value(a);
+        const right = value(b);
+        if (left === null && right === null)
+            return 0;
+        if (left === null)
+            return 1;
+        if (right === null)
+            return -1;
+        return right - left;
+    };
+}
+//# sourceMappingURL=presentation.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * The "Top N" row limit a viewer picked for a dashboard table — issue #632.
+ *
+ * Per-viewer convenience in `localStorage`, modelled on the explorer's query
+ * history (`../../queryHistory.ts`): every access is wrapped in try/catch
+ * (private mode, blocked storage), and a missing, corrupt or no-longer-offered
+ * value reads as `null`, so the caller falls back to the table's default.
+ */
+/** A row limit: a count, or every row the API returned. */
+export type TopNOption = number | 'all';
+export declare function topNStorageKey(tableKey: string): string;
+/** The stored choice for `tableKey`, if it is still one of `options`. */
+export declare function readTopN(tableKey: string, options: readonly TopNOption[]): TopNOption | null;
+export declare function writeTopN(tableKey: string, value: TopNOption): void;
+//# sourceMappingURL=topNPreference.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"topNPreference.d.ts","sourceRoot":"","sources":["../../../../../src/telemetry/headless/lib/metrics/topNPreference.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,2DAA2D;AAC3D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC;AAExC,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,yEAAyE;AACzE,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,GAAG,IAAI,CAS5F;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAMnE"}

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

@@ -0,0 +1,33 @@
+/**
+ * The "Top N" row limit a viewer picked for a dashboard table — issue #632.
+ *
+ * Per-viewer convenience in `localStorage`, modelled on the explorer's query
+ * history (`../../queryHistory.ts`): every access is wrapped in try/catch
+ * (private mode, blocked storage), and a missing, corrupt or no-longer-offered
+ * value reads as `null`, so the caller falls back to the table's default.
+ */
+export function topNStorageKey(tableKey) {
+    return `telemetry.dashboard.${tableKey}.topN`;
+}
+/** The stored choice for `tableKey`, if it is still one of `options`. */
+export function readTopN(tableKey, options) {
+    try {
+        const raw = window.localStorage.getItem(topNStorageKey(tableKey));
+        if (raw === null)
+            return null;
+        const value = raw === 'all' ? 'all' : Number(raw);
+        return options.includes(value) ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function writeTopN(tableKey, value) {
+    try {
+        window.localStorage.setItem(topNStorageKey(tableKey), String(value));
+    }
+    catch {
+        // Storage unavailable — the choice still holds for this page view.
+    }
+}
+//# sourceMappingURL=topNPreference.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"topNPreference.js","sourceRoot":"","sources":["../../../../../src/telemetry/headless/lib/metrics/topNPreference.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,OAAO,uBAAuB,QAAQ,OAAO,CAAC;AAChD,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,OAA8B;IACvE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;QAClE,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC9B,MAAM,KAAK,GAAe,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC9D,OAAO,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,KAAiB;IAC3D,IAAI,CAAC;QACH,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;IACrE,CAAC;AACH,CAAC"}

package/dist/telemetry/headless/lib/queryHistory.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The explorer's per-browser query history — issue #537, epic #528.
+ *
+ * The last {@link QUERY_HISTORY_LIMIT} distinct queries, newest first, in
+ * `localStorage`. A per-viewer convenience only: every access is wrapped in
+ * try/catch (private mode, blocked storage), and a missing or corrupt value
+ * reads as an empty history.
+ */
+/**
+ * The `localStorage` key of the explorer's query history.
+ *
+ * @stability experimental
+ */
+export declare const QUERY_HISTORY_KEY = "telemetry-explorer:history";
+export declare const QUERY_HISTORY_LIMIT = 20;
+export declare function readQueryHistory(): string[];
+/** Record `sql` as the newest entry and return the new history. */
+export declare function pushQueryHistory(sql: string): string[];
+export declare function clearQueryHistory(): void;
+//# sourceMappingURL=queryHistory.d.ts.map

package/dist/telemetry/headless/lib/queryHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryHistory.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/headless/lib/queryHistory.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,+BAA+B,CAAC;AAC9D,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAW3C;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CActD;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAMxC"}

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

@@ -0,0 +1,53 @@
+/**
+ * The explorer's per-browser query history — issue #537, epic #528.
+ *
+ * The last {@link QUERY_HISTORY_LIMIT} distinct queries, newest first, in
+ * `localStorage`. A per-viewer convenience only: every access is wrapped in
+ * try/catch (private mode, blocked storage), and a missing or corrupt value
+ * reads as an empty history.
+ */
+/**
+ * The `localStorage` key of the explorer's query history.
+ *
+ * @stability experimental
+ */
+export const QUERY_HISTORY_KEY = 'telemetry-explorer:history';
+export const QUERY_HISTORY_LIMIT = 20;
+export function readQueryHistory() {
+    try {
+        const raw = window.localStorage.getItem(QUERY_HISTORY_KEY);
+        if (!raw)
+            return [];
+        const parsed = JSON.parse(raw);
+        return Array.isArray(parsed)
+            ? parsed.filter((entry) => typeof entry === 'string').slice(0, QUERY_HISTORY_LIMIT)
+            : [];
+    }
+    catch {
+        return [];
+    }
+}
+/** Record `sql` as the newest entry and return the new history. */
+export function pushQueryHistory(sql) {
+    const trimmed = sql.trim();
+    const current = readQueryHistory();
+    if (!trimmed)
+        return current;
+    const next = [trimmed, ...current.filter((entry) => entry !== trimmed)].slice(0, QUERY_HISTORY_LIMIT);
+    try {
+        window.localStorage.setItem(QUERY_HISTORY_KEY, JSON.stringify(next));
+    }
+    catch {
+        // Storage unavailable — the in-memory list still updates for this session.
+    }
+    return next;
+}
+export function clearQueryHistory() {
+    try {
+        window.localStorage.removeItem(QUERY_HISTORY_KEY);
+    }
+    catch {
+        // Nothing to do.
+    }
+}
+//# sourceMappingURL=queryHistory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queryHistory.js","sourceRoot":"","sources":["../../../../src/telemetry/headless/lib/queryHistory.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,4BAA4B,CAAC;AAC9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAEtC,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAC3D,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAC1B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC;YACpG,CAAC,CAAC,EAAE,CAAC;IACT,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IACnC,IAAI,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC;IAC7B,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAC3E,CAAC,EACD,mBAAmB,CACpB,CAAC;IACF,IAAI,CAAC;QACH,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,2EAA2E;IAC7E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC;QACH,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;AACH,CAAC"}

package/dist/telemetry/headless/lib/starterQueries.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Starter queries for the Telemetry Explorer — issue #537, epic #528.
+ *
+ * Written against GreptimeDB's OpenTelemetry tables (`opentelemetry_traces`,
+ * `opentelemetry_logs`). Span attribute columns are flattened with dots in
+ * their names, so any such column must be double-quoted (see
+ * {@link quoteIdentifier}).
+ */
+/**
+ * One starter query of the explorer's menu.
+ *
+ * @stability experimental
+ */
+export interface StarterQuery {
+    /** A stable id (`recent-errors`, ...). */
+    id: string;
+    /** The menu label. */
+    title: string;
+    /** The statement the editor is seeded with. */
+    sql: string;
+}
+export declare const TRACE_ID_PLACEHOLDER = "<trace_id>";
+/**
+ * The explorer's starter queries, in menu order; the first seeds the editor.
+ *
+ * @stability experimental
+ */
+export declare const STARTER_QUERIES: StarterQuery[];
+/** Escape a value for a single-quoted SQL string literal. */
+export declare function sqlStringLiteral(value: string): string;
+/**
+ * The query a click on a `trace_id` value runs: every span of the trace, then
+ * every log line that carries it, in one result (a UNION over the shared
+ * columns, labelled by `kind`).
+ *
+ * @param traceId - the trace id (escaped as a string literal).
+ * @returns the statement.
+ *
+ * @stability experimental
+ */
+export declare function traceQuery(traceId: string): string;
+/**
+ * An identifier as it must be written in SQL: bare when it is a plain
+ * lower-case name, double-quoted (with `"` doubled) otherwise — which is every
+ * flattened attribute column (`span_attributes.http.route`).
+ */
+export declare function quoteIdentifier(name: string): string;
+//# sourceMappingURL=starterQueries.d.ts.map

package/dist/telemetry/headless/lib/starterQueries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starterQueries.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/headless/lib/starterQueries.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;CACb;AAED,eAAO,MAAM,oBAAoB,eAAe,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,YAAY,EA+BzC,CAAC;AAEF,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAalD;AAID;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD"}

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

@@ -0,0 +1,84 @@
+/**
+ * Starter queries for the Telemetry Explorer — issue #537, epic #528.
+ *
+ * Written against GreptimeDB's OpenTelemetry tables (`opentelemetry_traces`,
+ * `opentelemetry_logs`). Span attribute columns are flattened with dots in
+ * their names, so any such column must be double-quoted (see
+ * {@link quoteIdentifier}).
+ */
+export const TRACE_ID_PLACEHOLDER = '<trace_id>';
+/**
+ * The explorer's starter queries, in menu order; the first seeds the editor.
+ *
+ * @stability experimental
+ */
+export const STARTER_QUERIES = [
+    {
+        id: 'recent-errors',
+        title: 'Recent errors (24h)',
+        sql: "SELECT timestamp, service_name, span_name, span_status_message, trace_id FROM opentelemetry_traces WHERE span_status_code = 'STATUS_CODE_ERROR' AND timestamp > now() - INTERVAL '24 hours' ORDER BY timestamp DESC LIMIT 200",
+    },
+    {
+        id: 'slowest-routes',
+        title: 'Slowest routes (p95, 1h)',
+        sql: "SELECT span_name, count(*) AS calls, approx_percentile_cont(duration_nano / 1000000.0, 0.95) AS p95_ms, max(duration_nano) / 1000000.0 AS max_ms FROM opentelemetry_traces WHERE span_kind = 'SPAN_KIND_SERVER' AND timestamp > now() - INTERVAL '1 hour' GROUP BY span_name ORDER BY p95_ms DESC LIMIT 20",
+    },
+    {
+        id: 'requests-per-service',
+        title: 'Requests per service (24h)',
+        sql: "SELECT service_name, count(*) AS spans FROM opentelemetry_traces WHERE timestamp > now() - INTERVAL '24 hours' GROUP BY service_name ORDER BY spans DESC",
+    },
+    {
+        id: 'log-warnings',
+        title: 'Recent warnings and errors in logs',
+        sql: 'SELECT timestamp, severity_text, body, trace_id FROM opentelemetry_logs WHERE severity_number >= 13 ORDER BY timestamp DESC LIMIT 200',
+    },
+    {
+        id: 'trace-by-id',
+        title: 'Full trace by ID',
+        sql: `SELECT timestamp, span_name, duration_nano / 1000000.0 AS ms, span_status_code, parent_span_id, span_id FROM opentelemetry_traces WHERE trace_id = '${TRACE_ID_PLACEHOLDER}' ORDER BY timestamp`,
+    },
+    {
+        id: 'tables-and-sizes',
+        title: 'Tables and sizes',
+        sql: "SELECT table_name, table_rows FROM information_schema.tables WHERE table_schema = 'public' ORDER BY table_rows DESC",
+    },
+];
+/** Escape a value for a single-quoted SQL string literal. */
+export function sqlStringLiteral(value) {
+    return `'${value.replace(/'/g, "''")}'`;
+}
+/**
+ * The query a click on a `trace_id` value runs: every span of the trace, then
+ * every log line that carries it, in one result (a UNION over the shared
+ * columns, labelled by `kind`).
+ *
+ * @param traceId - the trace id (escaped as a string literal).
+ * @returns the statement.
+ *
+ * @stability experimental
+ */
+export function traceQuery(traceId) {
+    const id = sqlStringLiteral(traceId);
+    // Only columns the OTLP logs table is known to carry (the starter queries'
+    // own, plus `span_id`) are read from it; `ms` is a typed NULL for log rows
+    // so the UNION's column types line up.
+    return [
+        "SELECT 'span' AS kind, timestamp, span_name AS name, duration_nano / 1000000.0 AS ms, span_status_code AS status, span_id",
+        `FROM opentelemetry_traces WHERE trace_id = ${id}`,
+        'UNION ALL',
+        "SELECT 'log' AS kind, timestamp, body AS name, CAST(NULL AS DOUBLE) AS ms, severity_text AS status, span_id",
+        `FROM opentelemetry_logs WHERE trace_id = ${id}`,
+        'ORDER BY timestamp',
+    ].join('\n');
+}
+const BARE_IDENTIFIER = /^[a-z_][a-z0-9_]*$/;
+/**
+ * An identifier as it must be written in SQL: bare when it is a plain
+ * lower-case name, double-quoted (with `"` doubled) otherwise — which is every
+ * flattened attribute column (`span_attributes.http.route`).
+ */
+export function quoteIdentifier(name) {
+    return BARE_IDENTIFIER.test(name) ? name : `"${name.replace(/"/g, '""')}"`;
+}
+//# sourceMappingURL=starterQueries.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"starterQueries.js","sourceRoot":"","sources":["../../../../src/telemetry/headless/lib/starterQueries.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgBH,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAC;AAEjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC7C;QACE,EAAE,EAAE,eAAe;QACnB,KAAK,EAAE,qBAAqB;QAC5B,GAAG,EAAE,+NAA+N;KACrO;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,KAAK,EAAE,0BAA0B;QACjC,GAAG,EAAE,4SAA4S;KAClT;IACD;QACE,EAAE,EAAE,sBAAsB;QAC1B,KAAK,EAAE,4BAA4B;QACnC,GAAG,EAAE,0JAA0J;KAChK;IACD;QACE,EAAE,EAAE,cAAc;QAClB,KAAK,EAAE,oCAAoC;QAC3C,GAAG,EAAE,uIAAuI;KAC7I;IACD;QACE,EAAE,EAAE,aAAa;QACjB,KAAK,EAAE,kBAAkB;QACzB,GAAG,EAAE,uJAAuJ,oBAAoB,sBAAsB;KACvM;IACD;QACE,EAAE,EAAE,kBAAkB;QACtB,KAAK,EAAE,kBAAkB;QACzB,GAAG,EAAE,qHAAqH;KAC3H;CACF,CAAC;AAEF,6DAA6D;AAC7D,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;AAC1C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,MAAM,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACrC,2EAA2E;IAC3E,2EAA2E;IAC3E,uCAAuC;IACvC,OAAO;QACL,2HAA2H;QAC3H,8CAA8C,EAAE,EAAE;QAClD,WAAW;QACX,6GAA6G;QAC7G,4CAA4C,EAAE,EAAE;QAChD,oBAAoB;KACrB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAE7C;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;AAC7E,CAAC"}

package/dist/telemetry/headless/lib/traceLink.d.ts

@@ -0,0 +1,26 @@
+/**
+ * "View trace" from a dashboard log event — issue #579, epic #576.
+ *
+ * An OpenTelemetry trace id is 16 bytes, written as 32 lower-case hex digits
+ * (W3C Trace Context). Only an id of exactly that shape gets a link.
+ */
+export declare const TRACE_ID_PATTERN: RegExp;
+export declare function isTraceId(value: unknown): value is string;
+/**
+ * Every span of one trace, for the explorer.
+ *
+ * THE ONE STATEMENT THE BROWSER BUILDS. Every other dashboard → explorer
+ * handoff carries SQL the API reported running; this one is written here
+ * because no dashboard endpoint runs it. It is safe because:
+ *
+ *   1. the only interpolated value is `traceId`, and it is accepted only when
+ *      it matches {@link TRACE_ID_PATTERN} — 32 characters from `[0-9a-f]`, so
+ *      it cannot contain a quote, whitespace, a comment or anything else that
+ *      could end the string literal; any other input throws;
+ *   2. it is never run by the browser: it lands in the explorer's editor and
+ *      runs only when the reader presses Run, as any typed statement would;
+ *   3. the API's SQL guard, not this function, decides whether it may run
+ *      (read-only, row and time limits) — exactly as for typed SQL.
+ */
+export declare function traceExplorerSql(traceId: string): string;
+//# sourceMappingURL=traceLink.d.ts.map

package/dist/telemetry/headless/lib/traceLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceLink.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/headless/lib/traceLink.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,gBAAgB,QAAmB,CAAC;AAEjD,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEzD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGxD"}

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

@@ -0,0 +1,32 @@
+/**
+ * "View trace" from a dashboard log event — issue #579, epic #576.
+ *
+ * An OpenTelemetry trace id is 16 bytes, written as 32 lower-case hex digits
+ * (W3C Trace Context). Only an id of exactly that shape gets a link.
+ */
+export const TRACE_ID_PATTERN = /^[0-9a-f]{32}$/;
+export function isTraceId(value) {
+    return typeof value === 'string' && TRACE_ID_PATTERN.test(value);
+}
+/**
+ * Every span of one trace, for the explorer.
+ *
+ * THE ONE STATEMENT THE BROWSER BUILDS. Every other dashboard → explorer
+ * handoff carries SQL the API reported running; this one is written here
+ * because no dashboard endpoint runs it. It is safe because:
+ *
+ *   1. the only interpolated value is `traceId`, and it is accepted only when
+ *      it matches {@link TRACE_ID_PATTERN} — 32 characters from `[0-9a-f]`, so
+ *      it cannot contain a quote, whitespace, a comment or anything else that
+ *      could end the string literal; any other input throws;
+ *   2. it is never run by the browser: it lands in the explorer's editor and
+ *      runs only when the reader presses Run, as any typed statement would;
+ *   3. the API's SQL guard, not this function, decides whether it may run
+ *      (read-only, row and time limits) — exactly as for typed SQL.
+ */
+export function traceExplorerSql(traceId) {
+    if (!isTraceId(traceId))
+        throw new Error('Not an OpenTelemetry trace id');
+    return `SELECT * FROM opentelemetry_traces WHERE trace_id = '${traceId}' ORDER BY "timestamp" LIMIT 1000`;
+}
+//# sourceMappingURL=traceLink.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"traceLink.js","sourceRoot":"","sources":["../../../../src/telemetry/headless/lib/traceLink.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAEjD,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC1E,OAAO,wDAAwD,OAAO,mCAAmC,CAAC;AAC5G,CAAC"}

package/dist/telemetry/headless/lib/unknownRoutes.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Unknown API routes on the Telemetry Dashboard — issue #650.
+ *
+ * Pure helpers for the "Unknown API routes" panel (`UnknownRoutesPanel.tsx`),
+ * kept apart from the component so the page can use them too.
+ */
+import { type DashboardUnknownRoutes } from '../services/telemetryDashboard.js';
+/** DOM id of the panel's region: the verdict reason about unknown routes scrolls here. */
+export declare const UNKNOWN_ROUTES_ANCHOR = "telemetry-unknown-routes";
+/**
+ * The statements the API reports it ran for `unknownRoutes`, for "Open in
+ * Explorer": `unknownRoutes.sql` as sent (per-route list first, then the
+ * totals), never rebuilt or picked out of the summary's `sql`. Empty when an
+ * older API omits the field, which disables the action.
+ */
+export declare function unknownRoutesSql(block: DashboardUnknownRoutes | null | undefined): string[];
+/** Whether the panel has anything to show: the block is present and counted at least one request. */
+export declare function hasUnknownRoutes(block: DashboardUnknownRoutes | undefined | null): block is DashboardUnknownRoutes;
+/** A verdict reason about unknown API routes (the API's wording, #650). */
+export declare function isUnknownRoutesReason(reason: string): boolean;
+/** Scroll the panel into view and move focus to it. */
+export declare function scrollToUnknownRoutes(): void;
+//# sourceMappingURL=unknownRoutes.d.ts.map

package/dist/telemetry/headless/lib/unknownRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknownRoutes.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/headless/lib/unknownRoutes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAW,KAAK,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAEzF,0FAA0F;AAC1F,eAAO,MAAM,qBAAqB,6BAA6B,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAE3F;AAED,qGAAqG;AACrG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,sBAAsB,GAAG,SAAS,GAAG,IAAI,GAAG,KAAK,IAAI,sBAAsB,CAElH;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,uDAAuD;AACvD,wBAAgB,qBAAqB,IAAI,IAAI,CAK5C"}

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

@@ -0,0 +1,35 @@
+/**
+ * Unknown API routes on the Telemetry Dashboard — issue #650.
+ *
+ * Pure helpers for the "Unknown API routes" panel (`UnknownRoutesPanel.tsx`),
+ * kept apart from the component so the page can use them too.
+ */
+import { sqlList } from '../services/telemetryDashboard.js';
+/** DOM id of the panel's region: the verdict reason about unknown routes scrolls here. */
+export const UNKNOWN_ROUTES_ANCHOR = 'telemetry-unknown-routes';
+/**
+ * The statements the API reports it ran for `unknownRoutes`, for "Open in
+ * Explorer": `unknownRoutes.sql` as sent (per-route list first, then the
+ * totals), never rebuilt or picked out of the summary's `sql`. Empty when an
+ * older API omits the field, which disables the action.
+ */
+export function unknownRoutesSql(block) {
+    return sqlList(block?.sql);
+}
+/** Whether the panel has anything to show: the block is present and counted at least one request. */
+export function hasUnknownRoutes(block) {
+    return !!block && block.requests > 0;
+}
+/** A verdict reason about unknown API routes (the API's wording, #650). */
+export function isUnknownRoutesReason(reason) {
+    return /\bto unknown API routes\b/.test(reason);
+}
+/** Scroll the panel into view and move focus to it. */
+export function scrollToUnknownRoutes() {
+    const target = document.getElementById(UNKNOWN_ROUTES_ANCHOR);
+    if (!target)
+        return;
+    target.scrollIntoView?.({ behavior: 'smooth', block: 'start' });
+    target.focus({ preventScroll: true });
+}
+//# sourceMappingURL=unknownRoutes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unknownRoutes.js","sourceRoot":"","sources":["../../../../src/telemetry/headless/lib/unknownRoutes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAA+B,MAAM,mCAAmC,CAAC;AAEzF,0FAA0F;AAC1F,MAAM,CAAC,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAgD;IAC/E,OAAO,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,gBAAgB,CAAC,KAAgD;IAC/E,OAAO,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvC,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,OAAO,2BAA2B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAClD,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,qBAAqB;IACnC,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC;IAC9D,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"}