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

package/dist/telemetry/headless/services/telemetry.js

@@ -0,0 +1,190 @@
+/**
+ * Telemetry API client (issue #537, epic #528).
+ *
+ * The routes this client calls (epic #528):
+ *
+ *   - `GET  /telemetry/config`                  (#534, any signed-in user)
+ *   - `GET  /admin/telemetry/config`            (#534, `telemetry:read`)
+ *   - `PUT  /admin/telemetry/config`            (#534, `telemetry:write`, If-Match)
+ *   - `GET  /admin/telemetry/status`            (#534, `telemetry:read`)
+ *   - `POST /admin/telemetry/query`             (#535, `telemetry:query`)
+ *   - `GET  /admin/telemetry/schema`            (#535, `telemetry:query`)
+ *   - `POST /admin/telemetry/export`            (#535, `telemetry:query`)
+ *   - `POST /admin/telemetry/assistant/stream`  (#536, `telemetry:query` + `ai:use`)
+ *
+ * The browser only presents and collects. Whether a statement is read-only,
+ * how many rows it may return and how long it may run are decided by the API;
+ * the SQL typed here is sent verbatim and the server's guard is the gate.
+ *
+ * THE WIRE SHAPES ARE `@marinoscar/platform-contract/telemetry` (#702): the
+ * same zod schemas the API's DTOs wrap. This file aliases the contract's types
+ * to the names the components already use, and re-exports its zod-free
+ * constants. Types are imported with `import type` and values come from the
+ * contract's constants module only, so zod never reaches the bundle
+ * (`"sideEffects": false`). Where a web type deliberately differs from the
+ * wire (looser, for a server ahead of or behind this build, or narrower, for
+ * a form), it is derived from the contract type, says why, and
+ * `src/__tests__/services/telemetryContract.test.ts` pins the relation.
+ */
+import { TELEMETRY_CONNECTION_DEFAULTS, TELEMETRY_CONNECTION_SOURCES, TELEMETRY_EXPORT_FORMATS as TELEMETRY_EXPORT_WIRE_FORMATS, TELEMETRY_INSTANCE_ID_PATTERN, TELEMETRY_LIMITS, TELEMETRY_SQL_MAX_LENGTH, } from '@marinoscar/platform-contract/telemetry';
+import { isPlatformApiError } from '../../../core/index.js';
+/** The bounds of every numeric setting; the settings schema is built from them. */
+export { TELEMETRY_LIMITS };
+/**
+ * `telemetry.instanceId`'s pattern: 1-63 characters, lowercase letters,
+ * digits, `.`, `_` or `-`, starting with a letter or digit. A convenience for
+ * inline feedback — the API is the gate.
+ */
+export { TELEMETRY_INSTANCE_ID_PATTERN };
+// =============================================================================
+// GreptimeDB connection (#558)
+// =============================================================================
+//
+//   - `GET    /admin/telemetry/connection`       (`telemetry:read`)
+//   - `PUT    /admin/telemetry/connection`       (`telemetry:write`, If-Match)
+//   - `DELETE /admin/telemetry/connection`       (`telemetry:write`, If-Match)
+//   - `POST   /admin/telemetry/connection/test`  (`telemetry:write`, always 200)
+//
+// Passwords are WRITE-ONLY: they appear in request bodies and never in a
+// response, which carries only a masked `credentials.<login>` status. Its
+// `version` is the stored connection's own counter — NOT `/config`'s.
+export { TELEMETRY_CONNECTION_SOURCES };
+/** GreptimeDB's Postgres-wire port and database when nothing says otherwise. */
+export { TELEMETRY_CONNECTION_DEFAULTS };
+/**
+ * Whether a connection-test probe was skipped rather than run.
+ *
+ * @param probe - one probe of a {@link TelemetryConnectionTestResult}.
+ * @returns `true` for a skipped probe.
+ *
+ * @stability experimental
+ */
+export function isTelemetryProbeSkipped(probe) {
+    return 'skipped' in probe && probe.skipped === true;
+}
+/**
+ * The longest statement `POST /admin/telemetry/query` accepts. The API
+ * enforces it; the browser uses it only to ignore an oversized SQL handoff
+ * into the explorer (#579).
+ */
+export { TELEMETRY_SQL_MAX_LENGTH };
+/**
+ * The export formats in MENU order (CSV, Excel, Parquet, NDJSON), which is
+ * not the wire enum's order (`csv, ndjson, xlsx, parquet`): a display list
+ * over the contract's `TELEMETRY_EXPORT_FORMATS`, holding exactly its values
+ * (pinned in telemetryContract.test.ts).
+ *
+ * @stability experimental
+ */
+export const TELEMETRY_EXPORT_MENU_ORDER = ['csv', 'xlsx', 'parquet', 'ndjson'];
+/**
+ * The export menu's formats, in menu order: {@link TELEMETRY_EXPORT_MENU_ORDER}.
+ *
+ * @stability experimental
+ */
+export const TELEMETRY_EXPORT_FORMATS = TELEMETRY_EXPORT_MENU_ORDER;
+/** The wire enum of export formats, in its own order. */
+export { TELEMETRY_EXPORT_WIRE_FORMATS };
+/**
+ * The export menu's label of each format.
+ *
+ * @stability experimental
+ */
+export const TELEMETRY_EXPORT_LABELS = {
+    csv: 'CSV',
+    xlsx: 'Excel (.xlsx)',
+    parquet: 'Parquet',
+    ndjson: 'NDJSON',
+};
+/**
+ * The telemetry REASONS the explorer routes answer with. The envelope's
+ * `code` is derived from the HTTP status; the reason is `details.reason`
+ * (read it with {@link telemetryErrorReason}).
+ *
+ * @stability experimental
+ */
+export const TELEMETRY_ERROR_REASONS = [
+    'TELEMETRY_NOT_CONFIGURED', // 503
+    'TELEMETRY_UNREACHABLE', // 503
+    'TELEMETRY_DISABLED', // 409
+    'TELEMETRY_QUERY_REJECTED', // 400 — the SQL guard refused it
+    'TELEMETRY_QUERY_FAILED', // 400 — the database reported an error (+ details.sqlState)
+    'TELEMETRY_QUERY_TIMEOUT', // 504 (+ details.timeoutMs)
+    'TELEMETRY_ASSISTANT_DISABLED', // 409
+];
+/**
+ * `details.reason` of a telemetry API error, or `null`.
+ *
+ * @stability experimental
+ */
+export function telemetryErrorReason(err) {
+    if (!isPlatformApiError(err))
+        return null;
+    const details = err.details;
+    if (typeof details === 'object' && details !== null && 'reason' in details) {
+        const reason = details.reason;
+        return typeof reason === 'string' ? reason : null;
+    }
+    return null;
+}
+/**
+ * `telemetry-<timestamp>.<ext>` — what the server's Content-Disposition names it too.
+ *
+ * @stability experimental
+ */
+export function telemetryExportFilename(format, now = new Date()) {
+    const stamp = now.toISOString().replace(/[:.]/g, '-');
+    return `telemetry-${stamp}.${format}`;
+}
+/**
+ * Hand a Blob to the browser as a download (object URL + anchor + revoke).
+ *
+ * @stability experimental
+ */
+export function downloadBlob(blob, filename) {
+    if (typeof document === 'undefined' || typeof URL.createObjectURL !== 'function')
+        return false;
+    const url = URL.createObjectURL(blob);
+    try {
+        const anchor = document.createElement('a');
+        anchor.href = url;
+        anchor.download = filename;
+        anchor.rel = 'noopener';
+        anchor.style.display = 'none';
+        document.body.appendChild(anchor);
+        anchor.click();
+        anchor.remove();
+        return true;
+    }
+    finally {
+        // Deferred: revoking synchronously can cancel the download in some browsers.
+        setTimeout(() => URL.revokeObjectURL(url), 0);
+    }
+}
+/**
+ * The filename from a `Content-Disposition` header (`filename*=UTF-8''…` or
+ * `filename="…"` / `filename=…`), or `null`. Path separators are stripped.
+ *
+ * @stability experimental
+ */
+export function filenameFromContentDisposition(header) {
+    if (!header)
+        return null;
+    let name = null;
+    const extended = /filename\*\s*=\s*(?:UTF-8|utf-8)''([^;]+)/.exec(header);
+    if (extended) {
+        try {
+            name = decodeURIComponent(extended[1].trim().replace(/^"|"$/g, ''));
+        }
+        catch {
+            name = null;
+        }
+    }
+    if (!name) {
+        const plain = /filename\s*=\s*("([^"]*)"|[^;]+)/i.exec(header);
+        name = plain ? (plain[2] ?? plain[1]).trim() : null;
+    }
+    const safe = name?.replace(/[/\\]/g, '_').trim();
+    return safe ? safe : null;
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry/headless/services/telemetry.js.map

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

package/dist/telemetry/headless/services/telemetryDashboard.d.ts

@@ -0,0 +1,321 @@
+/**
+ * Telemetry Dashboard API client — issue #578, epic #576.
+ *
+ * The wire shapes are `@marinoscar/platform-contract/telemetry` (#702), the
+ * same zod schemas `packages/platform-api/src/telemetry/dto/telemetry-dashboard.dto.ts`
+ * wraps:
+ *
+ *   - `GET /admin/telemetry/dashboard/summary`     (`telemetry:query`)
+ *   - `GET /admin/telemetry/dashboard/timeseries`  (`telemetry:query`, `panel=api|logs`)
+ *   - `GET /admin/telemetry/dashboard/top`         (`telemetry:query`, `kind=routes|errors`)
+ *   - `GET /admin/telemetry/dashboard/events`      (`telemetry:query`)
+ *   - `GET /admin/telemetry/dashboard/filters`     (`telemetry:query`)
+ *   - `GET /admin/telemetry/dashboard/metrics`     (`telemetry:query`, `group=host|database|…`, #601/#602)
+ *
+ * The browser only presents. The verdict, its reasons, the tiles, what a
+ * "route" is and how severities are banded are all decided by the API; the SQL
+ * it ran comes back in `sql` so a panel can offer "open in explorer" (#579).
+ *
+ * This file aliases the contract's types to the names the components use and
+ * re-exports its zod-free constants (`import type` and constants only, so zod
+ * never reaches the bundle). Where a web type deliberately differs from the
+ * wire it is derived from the contract type and says why;
+ * `src/__tests__/services/telemetryContract.test.ts` pins each relation.
+ */
+import { DASHBOARD_FILTER_VALUE_MAX, DASHBOARD_MAX_SPAN_MS, DASHBOARD_RANGE_MS, DASHBOARD_RANGES, DASHBOARD_SEARCH_MAX_LENGTH, DEFAULT_DASHBOARD_RANGE } from '@marinoscar/platform-contract/telemetry';
+import type { DashboardBucketCount, DashboardEventSeverity, DashboardRange as ContractDashboardRange, DashboardTopKind as ContractDashboardTopKind, DashboardPanel, MetricGroupId, MetricUnit, TelemetryDashboardApiBucket, TelemetryDashboardEnvelope, TelemetryDashboardEvent, TelemetryDashboardEvents, TelemetryDashboardEventsQuery, TelemetryDashboardFilters, TelemetryDashboardLogsBucket, TelemetryDashboardMetricCell, TelemetryDashboardMetricColumn, TelemetryDashboardMetricGroup, TelemetryDashboardMetricPoint, TelemetryDashboardMetrics, TelemetryDashboardMetricSeries, TelemetryDashboardMetricsQuery, TelemetryDashboardMetricTable, TelemetryDashboardQuery, TelemetryDashboardSummary, TelemetryDashboardTile, TelemetryDashboardTimeseries, TelemetryDashboardTop, TelemetryDashboardTopError, TelemetryDashboardTopRoute, TelemetryDashboardUnknownRoute, TelemetryDashboardUnknownRoutes, VerdictLevel } from '@marinoscar/platform-contract/telemetry';
+export { DASHBOARD_RANGES, DEFAULT_DASHBOARD_RANGE, DASHBOARD_RANGE_MS };
+/**
+ * A relative dashboard window: `15m`, `1h`, `6h`, `24h` or `7d`.
+ *
+ * @stability experimental
+ */
+export type DashboardRange = ContractDashboardRange;
+/**
+ * Display labels of the relative windows (web only).
+ *
+ * @stability experimental
+ */
+export declare const DASHBOARD_RANGE_LABELS: Record<DashboardRange, string>;
+/**
+ * The severities `events` filters on (the contract's `DASHBOARD_EVENT_SEVERITIES`).
+ *
+ * @stability experimental
+ */
+export declare const DASHBOARD_SEVERITIES: readonly ["error", "warn", "info"];
+/**
+ * A log severity the event panels filter on (`error`, `warn`, `info`).
+ *
+ * @stability experimental
+ */
+export type DashboardSeverity = DashboardEventSeverity;
+/**
+ * What the events feed asks for until the user picks (web only; the API's own default is the same).
+ *
+ * @stability experimental
+ */
+export declare const DEFAULT_DASHBOARD_SEVERITIES: DashboardSeverity[];
+/** The longest `q` the events route accepts. */
+export { DASHBOARD_SEARCH_MAX_LENGTH };
+/** The longest absolute window, and the longest filter value, the dashboard routes accept. */
+export { DASHBOARD_MAX_SPAN_MS, DASHBOARD_FILTER_VALUE_MAX };
+/**
+ * How many time buckets a timeseries asks for.
+ *
+ * @stability experimental
+ */
+export type DashboardBuckets = DashboardBucketCount;
+/**
+ * The query every endpoint shares. `range` XOR `from` + `to`.
+ *
+ * @stability experimental
+ */
+export type DashboardQuery = TelemetryDashboardQuery;
+/**
+ * `/metrics` also takes `host` (a value of `/filters` `hosts`). It applies to
+ * the collector-scraped tables only, so it is sent to `/metrics` alone.
+ * `group` is not part of it: {@link TelemetryClient.getDashboardMetrics} takes it separately.
+ *
+ * @stability experimental
+ */
+export type DashboardMetricsQuery = Omit<TelemetryDashboardMetricsQuery, 'group'>;
+/**
+ * The events query. INTENTIONALLY DIFFERENT from the wire: `severity` is a
+ * list here, serialised to the wire's comma-separated string by
+ * {@link dashboardSearchParams}.
+ *
+ * @stability experimental
+ */
+export type DashboardEventsQuery = Omit<TelemetryDashboardEventsQuery, 'severity'> & {
+    /** The severities to include; serialised as a comma-separated list. */
+    severity?: DashboardSeverity[];
+};
+/**
+ * What every dashboard response except `/metrics` starts with: the resolved window and bucket size, when the store was read, whether a row cap cut a list short, and the statements run.
+ *
+ * @stability experimental
+ */
+export type DashboardEnvelope = TelemetryDashboardEnvelope;
+/**
+ * The summary's verdict: `healthy`, `degraded`, `critical` or `no_data`.
+ *
+ * @stability experimental
+ */
+export type DashboardVerdictLevel = VerdictLevel;
+/**
+ * A tile. `value` may be a string (`int8`/`numeric`, or a timestamp's ISO text).
+ *
+ * @stability experimental
+ */
+export type DashboardTile = TelemetryDashboardTile;
+/**
+ * One unknown API route of the summary (#650): a method + path no route of the running API matches.
+ *
+ * @stability experimental
+ */
+export type DashboardUnknownRoute = TelemetryDashboardUnknownRoute;
+/**
+ * Requests to API routes that do not exist (#650). INTENTIONALLY LOOSER than
+ * the wire: `sql` is optional so a web build ahead of its API renders (the
+ * "Open in Explorer" action is then disabled). The contract's type is
+ * assignable to it.
+ *
+ * @stability experimental
+ */
+export type DashboardUnknownRoutes = Omit<TelemetryDashboardUnknownRoutes, 'sql'> & {
+    /** The explorer statements behind the block, primary first (a list here). */
+    sql?: string[];
+};
+/**
+ * `GET …/summary`, with the looser {@link DashboardUnknownRoutes}.
+ *
+ * @stability experimental
+ */
+export type DashboardSummary = Omit<TelemetryDashboardSummary, 'unknownRoutes'> & {
+    /** #650. Absent when the store cannot tell unknown routes apart yet: unknown, not zero. */
+    unknownRoutes?: DashboardUnknownRoutes;
+};
+/**
+ * One API timeline bucket: request counts by status class and latency.
+ *
+ * @stability experimental
+ */
+export type DashboardApiBucket = TelemetryDashboardApiBucket;
+/**
+ * One log timeline bucket: record counts by severity.
+ *
+ * @stability experimental
+ */
+export type DashboardLogsBucket = TelemetryDashboardLogsBucket;
+/**
+ * `GET …/timeseries?panel=api`. INTENTIONALLY NARROWER than the wire (whose
+ * `buckets` is a union for either panel): the panel requested decides the
+ * bucket shape. Assignable to the contract's type.
+ *
+ * @stability experimental
+ */
+export type DashboardApiTimeseries = Omit<TelemetryDashboardTimeseries, 'panel' | 'buckets'> & {
+    /** The API timeline. */
+    panel: 'api';
+    /** The API buckets, oldest first. */
+    buckets: DashboardApiBucket[];
+};
+/**
+ * `GET …/timeseries?panel=logs`; narrowed like {@link DashboardApiTimeseries}.
+ *
+ * @stability experimental
+ */
+export type DashboardLogsTimeseries = Omit<TelemetryDashboardTimeseries, 'panel' | 'buckets'> & {
+    /** The log timeline. */
+    panel: 'logs';
+    /** The log buckets, oldest first. */
+    buckets: DashboardLogsBucket[];
+};
+/**
+ * Which timeline `GET …/timeseries` draws: `api` or `logs`.
+ *
+ * @stability experimental
+ */
+export type DashboardTimeseriesPanel = DashboardPanel;
+/**
+ * The `GET …/timeseries` answer for `panel`: {@link DashboardApiTimeseries} or {@link DashboardLogsTimeseries}.
+ *
+ * @stability experimental
+ */
+export type DashboardTimeseries<P extends DashboardTimeseriesPanel> = P extends 'api' ? DashboardApiTimeseries : DashboardLogsTimeseries;
+/**
+ * One route of `top?kind=routes`. INTENTIONALLY LOOSER than the wire:
+ * `clientErrors`, `unknownRequests` and `unknown` (#650) are optional so a web
+ * build ahead of its API renders; the API always sends them. The contract's
+ * type is assignable to it.
+ *
+ * @stability experimental
+ */
+export type DashboardTopRoute = Omit<TelemetryDashboardTopRoute, 'clientErrors' | 'unknownRequests' | 'unknown'> & Partial<Pick<TelemetryDashboardTopRoute, 'clientErrors' | 'unknownRequests' | 'unknown'>>;
+/**
+ * One row of the top failing errors.
+ *
+ * @stability experimental
+ */
+export type DashboardTopError = TelemetryDashboardTopError;
+/**
+ * Which list `GET …/top` returns: `routes` or `errors`.
+ *
+ * @stability experimental
+ */
+export type DashboardTopKind = ContractDashboardTopKind;
+/**
+ * `GET …/top?kind=routes`; narrowed like {@link DashboardApiTimeseries}.
+ *
+ * @stability experimental
+ */
+export type DashboardTopRoutes = Omit<TelemetryDashboardTop, 'kind' | 'items'> & {
+    /** The top failing routes. */
+    kind: 'routes';
+    /** The routes, worst first. */
+    items: DashboardTopRoute[];
+};
+/**
+ * `GET …/top?kind=errors`; narrowed like {@link DashboardApiTimeseries}.
+ *
+ * @stability experimental
+ */
+export type DashboardTopErrors = Omit<TelemetryDashboardTop, 'kind' | 'items'> & {
+    /** The top errors. */
+    kind: 'errors';
+    /** The errors, most frequent first. */
+    items: DashboardTopError[];
+};
+/**
+ * The `GET …/top` answer for `kind`: {@link DashboardTopRoutes} or {@link DashboardTopErrors}.
+ *
+ * @stability experimental
+ */
+export type DashboardTop<K extends DashboardTopKind> = K extends 'routes' ? DashboardTopRoutes : DashboardTopErrors;
+/**
+ * One log event. `severity` is lower-case text (`error`, `warn`, `info`, `debug`, …).
+ *
+ * @stability experimental
+ */
+export type DashboardEvent = TelemetryDashboardEvent;
+/**
+ * `GET …/events`: a page of log and span events, newest first, with the next cursor.
+ *
+ * @stability experimental
+ */
+export type DashboardEvents = TelemetryDashboardEvents;
+/**
+ * `GET …/filters`: the services, instances and hosts seen in the window (the filter bar's choices).
+ *
+ * @stability experimental
+ */
+export type DashboardFilters = TelemetryDashboardFilters;
+/**
+ * A metric group id, as `/metric-groups` lists it (#680): the platform's six
+ * (`host`, `database`, `queue`, `nodes`, `uptime`, `pipeline`) and any the
+ * application registers. The page renders whatever the API lists.
+ *
+ * @stability experimental
+ */
+export type DashboardMetricGroup = MetricGroupId;
+/**
+ * One entry of `GET …/metric-groups` (#680): a dashboard section, in `order`.
+ *
+ * @stability experimental
+ */
+export type DashboardMetricGroupMeta = TelemetryDashboardMetricGroup;
+/**
+ * The display unit of a tile, series or table column (the contract's `METRIC_UNITS`).
+ *
+ * @stability experimental
+ */
+export type DashboardMetricUnit = MetricUnit;
+/**
+ * One point of a metric series: a bucket start and its value.
+ *
+ * @stability experimental
+ */
+export type DashboardMetricPoint = TelemetryDashboardMetricPoint;
+/**
+ * One metric line: its key, label, unit and points (optionally one per `groupBy` value).
+ *
+ * @stability experimental
+ */
+export type DashboardMetricSeries = TelemetryDashboardMetricSeries;
+/**
+ * One column of a metric table: key, label and unit.
+ *
+ * @stability experimental
+ */
+export type DashboardMetricColumn = TelemetryDashboardMetricColumn;
+/**
+ * One cell of a metric table row (a number, a string, a boolean or `null`).
+ *
+ * @stability experimental
+ */
+export type DashboardMetricCell = TelemetryDashboardMetricCell;
+/**
+ * One metric table: columns and rows (for example disks, or databases).
+ *
+ * @stability experimental
+ */
+export type DashboardMetricTable = TelemetryDashboardMetricTable;
+/**
+ * `GET …/metrics?group=…`: one metric group's tiles, series and tables.
+ *
+ * @stability experimental
+ */
+export type DashboardMetrics = TelemetryDashboardMetrics;
+/**
+ * Serialise a dashboard query. Absent values are left out, never sent empty.
+ *
+ * @stability experimental
+ */
+export declare function dashboardSearchParams(query: DashboardQuery & Partial<Pick<DashboardEventsQuery, 'severity' | 'q' | 'cursor'>> & Partial<Pick<DashboardMetricsQuery, 'host'>>, extra?: Record<string, string>): URLSearchParams;
+/**
+ * `sql` as a list, primary first — what a panel's actions (#579) receive.
+ *
+ * @stability experimental
+ */
+export declare function sqlList(sql: string | string[] | undefined | null): string[];
+//# sourceMappingURL=telemetryDashboard.d.ts.map

package/dist/telemetry/headless/services/telemetryDashboard.d.ts.map

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

package/dist/telemetry/headless/services/telemetryDashboard.js

@@ -0,0 +1,103 @@
+/**
+ * Telemetry Dashboard API client — issue #578, epic #576.
+ *
+ * The wire shapes are `@marinoscar/platform-contract/telemetry` (#702), the
+ * same zod schemas `packages/platform-api/src/telemetry/dto/telemetry-dashboard.dto.ts`
+ * wraps:
+ *
+ *   - `GET /admin/telemetry/dashboard/summary`     (`telemetry:query`)
+ *   - `GET /admin/telemetry/dashboard/timeseries`  (`telemetry:query`, `panel=api|logs`)
+ *   - `GET /admin/telemetry/dashboard/top`         (`telemetry:query`, `kind=routes|errors`)
+ *   - `GET /admin/telemetry/dashboard/events`      (`telemetry:query`)
+ *   - `GET /admin/telemetry/dashboard/filters`     (`telemetry:query`)
+ *   - `GET /admin/telemetry/dashboard/metrics`     (`telemetry:query`, `group=host|database|…`, #601/#602)
+ *
+ * The browser only presents. The verdict, its reasons, the tiles, what a
+ * "route" is and how severities are banded are all decided by the API; the SQL
+ * it ran comes back in `sql` so a panel can offer "open in explorer" (#579).
+ *
+ * This file aliases the contract's types to the names the components use and
+ * re-exports its zod-free constants (`import type` and constants only, so zod
+ * never reaches the bundle). Where a web type deliberately differs from the
+ * wire it is derived from the contract type and says why;
+ * `src/__tests__/services/telemetryContract.test.ts` pins each relation.
+ */
+import { DASHBOARD_EVENT_SEVERITIES, DASHBOARD_FILTER_VALUE_MAX, DASHBOARD_MAX_SPAN_MS, DASHBOARD_RANGE_MS, DASHBOARD_RANGES, DASHBOARD_SEARCH_MAX_LENGTH, DEFAULT_DASHBOARD_RANGE, } from '@marinoscar/platform-contract/telemetry';
+// =============================================================================
+// Request
+// =============================================================================
+export { DASHBOARD_RANGES, DEFAULT_DASHBOARD_RANGE, DASHBOARD_RANGE_MS };
+/**
+ * Display labels of the relative windows (web only).
+ *
+ * @stability experimental
+ */
+export const DASHBOARD_RANGE_LABELS = {
+    '15m': 'Last 15 minutes',
+    '1h': 'Last hour',
+    '6h': 'Last 6 hours',
+    '24h': 'Last 24 hours',
+    '7d': 'Last 7 days',
+};
+/**
+ * The severities `events` filters on (the contract's `DASHBOARD_EVENT_SEVERITIES`).
+ *
+ * @stability experimental
+ */
+export const DASHBOARD_SEVERITIES = DASHBOARD_EVENT_SEVERITIES;
+/**
+ * What the events feed asks for until the user picks (web only; the API's own default is the same).
+ *
+ * @stability experimental
+ */
+export const DEFAULT_DASHBOARD_SEVERITIES = ['error', 'warn'];
+/** The longest `q` the events route accepts. */
+export { DASHBOARD_SEARCH_MAX_LENGTH };
+/** The longest absolute window, and the longest filter value, the dashboard routes accept. */
+export { DASHBOARD_MAX_SPAN_MS, DASHBOARD_FILTER_VALUE_MAX };
+// =============================================================================
+// Calls
+// =============================================================================
+/**
+ * Serialise a dashboard query. Absent values are left out, never sent empty.
+ *
+ * @stability experimental
+ */
+export function dashboardSearchParams(query, extra = {}) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(extra))
+        params.set(key, value);
+    if (query.from && query.to) {
+        params.set('from', query.from);
+        params.set('to', query.to);
+    }
+    else if (query.range) {
+        params.set('range', query.range);
+    }
+    if (query.service)
+        params.set('service', query.service);
+    if (query.instance)
+        params.set('instance', query.instance);
+    if (query.host)
+        params.set('host', query.host);
+    if (query.buckets)
+        params.set('buckets', query.buckets);
+    if (query.severity && query.severity.length > 0)
+        params.set('severity', query.severity.join(','));
+    if (query.q)
+        params.set('q', query.q);
+    if (query.cursor)
+        params.set('cursor', query.cursor);
+    return params;
+}
+/**
+ * `sql` as a list, primary first — what a panel's actions (#579) receive.
+ *
+ * @stability experimental
+ */
+export function sqlList(sql) {
+    if (!sql)
+        return [];
+    return (Array.isArray(sql) ? sql : [sql]).filter((statement) => statement.trim() !== '');
+}
+//# sourceMappingURL=telemetryDashboard.js.map

package/dist/telemetry/headless/services/telemetryDashboard.js.map

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

package/dist/telemetry/internal/useIsMounted.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns a stable getter for "is this component still mounted?".
+ *
+ * Used to guard `setState` in the tail of an async operation. A ref rather
+ * than state, and a getter rather than the ref itself, so callers can hold it
+ * in a `useCallback` dependency list without invalidating on every render.
+ */
+export declare function useIsMounted(): () => boolean;
+//# sourceMappingURL=useIsMounted.d.ts.map

package/dist/telemetry/internal/useIsMounted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIsMounted.d.ts","sourceRoot":"","sources":["../../../src/telemetry/internal/useIsMounted.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,YAAY,IAAI,MAAM,OAAO,CAW5C"}

package/dist/telemetry/internal/useIsMounted.js

@@ -0,0 +1,19 @@
+import { useCallback, useEffect, useRef } from 'react';
+/**
+ * Returns a stable getter for "is this component still mounted?".
+ *
+ * Used to guard `setState` in the tail of an async operation. A ref rather
+ * than state, and a getter rather than the ref itself, so callers can hold it
+ * in a `useCallback` dependency list without invalidating on every render.
+ */
+export function useIsMounted() {
+    const mounted = useRef(true);
+    useEffect(() => {
+        mounted.current = true;
+        return () => {
+            mounted.current = false;
+        };
+    }, []);
+    return useCallback(() => mounted.current, []);
+}
+//# sourceMappingURL=useIsMounted.js.map