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

package/dist/telemetry/headless/hooks/useTelemetryConnection.js

@@ -0,0 +1,133 @@
+/**
+ * The GreptimeDB connection section's data — issue #558, epic #528.
+ *
+ * Loads `GET /admin/telemetry/connection`; saves (`PUT`) and reverts
+ * (`DELETE`) with `If-Match: <the connection's version>` — its own counter,
+ * not `/config`'s. A stale version answers 409, surfaced as `conflict` so the
+ * page can offer a reload. `test` probes a candidate connection: the route
+ * always answers 200 with a diagnosis, so a refused login lands in
+ * `testResult`, and only a failed CALL lands in `testError`.
+ *
+ * Writes resolve `true`/`false` and never throw.
+ */
+import { useCallback, useEffect, useState } from 'react';
+import { isPlatformApiError } from '../../../core/index.js';
+import { useTelemetryClient } from '../services/client.js';
+import { useIsMounted } from '../../internal/useIsMounted.js';
+function message(err, fallback) {
+    return isPlatformApiError(err) || err instanceof Error ? err.message : fallback;
+}
+/**
+ * The GreptimeDB connection section's data: `GET`, `PUT` and `DELETE /admin/telemetry/connection` (with `If-Match`; a 409 sets `conflict`) and `POST …/connection/test`. Passwords are write-only: they are sent, never read back.
+ *
+ * @returns the connection and its actions.
+ * @throws Error outside a `PlatformHostProvider`.
+ *
+ * @stability experimental
+ */
+export function useTelemetryConnection() {
+    const client = useTelemetryClient();
+    const [connection, setConnection] = useState(null);
+    const [isLoading, setIsLoading] = useState(true);
+    const [loadError, setLoadError] = useState(null);
+    const [isSaving, setIsSaving] = useState(false);
+    const [saveError, setSaveError] = useState(null);
+    const [conflict, setConflict] = useState(false);
+    const [isTesting, setIsTesting] = useState(false);
+    const [testResult, setTestResult] = useState(null);
+    const [testError, setTestError] = useState(null);
+    const isMounted = useIsMounted();
+    const reload = useCallback(async () => {
+        setIsLoading(true);
+        setLoadError(null);
+        setSaveError(null);
+        setConflict(false);
+        try {
+            const next = await client.getTelemetryConnection();
+            if (isMounted())
+                setConnection(next);
+        }
+        catch (err) {
+            if (isMounted())
+                setLoadError(message(err, 'Failed to load the telemetry connection'));
+        }
+        finally {
+            if (isMounted())
+                setIsLoading(false);
+        }
+    }, [client, isMounted]);
+    useEffect(() => {
+        void reload();
+    }, [reload]);
+    const write = useCallback(async (run, fallback) => {
+        setIsSaving(true);
+        setSaveError(null);
+        setConflict(false);
+        try {
+            const next = await run();
+            if (isMounted()) {
+                setConnection(next);
+                setTestResult(null);
+                setTestError(null);
+            }
+            return true;
+        }
+        catch (err) {
+            if (isMounted()) {
+                if (isPlatformApiError(err) && err.status === 409) {
+                    setConflict(true);
+                }
+                else {
+                    setSaveError(message(err, fallback));
+                }
+            }
+            return false;
+        }
+        finally {
+            if (isMounted())
+                setIsSaving(false);
+        }
+    }, [isMounted]);
+    const version = connection?.version;
+    const save = useCallback((input) => write(() => client.updateTelemetryConnection(input, version), 'Failed to save the telemetry connection'), [client, write, version]);
+    const revert = useCallback(() => write(() => client.resetTelemetryConnection(version), 'Failed to revert the telemetry connection'), [client, write, version]);
+    const test = useCallback(async (input) => {
+        setIsTesting(true);
+        setTestResult(null);
+        setTestError(null);
+        try {
+            const result = await client.testTelemetryConnection(input);
+            if (isMounted())
+                setTestResult(result);
+        }
+        catch (err) {
+            if (isMounted())
+                setTestError(message(err, 'The connection test could not be run'));
+        }
+        finally {
+            if (isMounted())
+                setIsTesting(false);
+        }
+    }, [client, isMounted]);
+    const clearTestResult = useCallback(() => {
+        setTestResult(null);
+        setTestError(null);
+    }, []);
+    return {
+        connection,
+        isLoading,
+        loadError,
+        isSaving,
+        saveError,
+        conflict,
+        isTesting,
+        testResult,
+        testError,
+        reload,
+        save,
+        revert,
+        test,
+        clearTestResult,
+    };
+}
+//# sourceMappingURL=useTelemetryConnection.js.map

package/dist/telemetry/headless/hooks/useTelemetryConnection.js.map

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

package/dist/telemetry/headless/hooks/useTelemetryDashboard.d.ts

@@ -0,0 +1,147 @@
+import { type DashboardEvent, type DashboardEvents, type DashboardEventsQuery, type DashboardMetricGroup, type DashboardMetricsQuery, type DashboardQuery, type DashboardSummary, type DashboardTimeseries, type DashboardTimeseriesPanel, type DashboardTop, type DashboardTopKind } from '../services/telemetryDashboard.js';
+import { type TelemetryErrorInfo } from './useTelemetryExplorer.js';
+/**
+ * One dashboard panel's data, as every `useDashboard*` hook returns it.
+ *
+ * @stability experimental
+ */
+export interface DashboardResource<T> {
+    /** The last result, or `null` before the first. */
+    data: T | null;
+    /** The last request's error, or `null`. */
+    error: TelemetryErrorInfo | null;
+    /** No result yet and a request in flight. */
+    isLoading: boolean;
+    /** A result is on screen and a newer one is in flight. */
+    isRefreshing: boolean;
+    /** `Date.now()` when the last result arrived. */
+    fetchedAt: number | null;
+    /** Refetch now (a panel's Retry). */
+    reload: () => void;
+}
+/**
+ * `GET …/summary` — verdict, tiles and optional runtime tiles.
+ *
+ * @stability experimental
+ */
+export declare function useDashboardSummary(query: DashboardQuery, tick: number): DashboardResource<DashboardSummary>;
+/**
+ * `GET …/timeseries?panel=api|logs`.
+ *
+ * @stability experimental
+ */
+export declare function useDashboardTimeseries<P extends DashboardTimeseriesPanel>(panel: P, query: DashboardQuery, tick: number): DashboardResource<DashboardTimeseries<P>>;
+/**
+ * `GET …/top?kind=routes|errors`.
+ *
+ * @stability experimental
+ */
+export declare function useDashboardTop<K extends DashboardTopKind>(kind: K, query: DashboardQuery, tick: number): DashboardResource<DashboardTop<K>>;
+/**
+ * `GET …/metrics?group=…` (#601) — one metric group per call, so each of the
+ * page's infrastructure sections (one per `/metric-groups` entry, #680) loads,
+ * fails and retries on its own, on the page's shared refresh tick.
+ *
+ * @stability experimental
+ */
+export declare function useDashboardMetrics(group: DashboardMetricGroup, query: DashboardMetricsQuery, tick: number): DashboardResource<{
+    range: {
+        from: string;
+        to: string;
+        bucketSeconds: number;
+    };
+    generatedAt: string;
+    truncated: boolean;
+    sql: string[];
+    group: string;
+    available: boolean;
+    tiles: {
+        key: string;
+        label: string;
+        value: string | number | null;
+        previous: string | number | null;
+        unit: string;
+        sparkline: (number | null)[];
+    }[];
+    series: {
+        key: string;
+        label: string;
+        unit: "boolean" | "days" | "hours" | "seconds" | "ms" | "text" | "timestamp" | "count" | "%" | "bytes" | "bytes/s" | "per_s" | "per_min" | "cores" | "load";
+        dimension: string | null;
+        groupBy: string | null;
+        points: {
+            t: string;
+            v: number | null;
+        }[];
+    }[];
+    tables: {
+        key: string;
+        label: string;
+        columns: {
+            key: string;
+            label: string;
+            unit: "boolean" | "days" | "hours" | "seconds" | "ms" | "text" | "timestamp" | "count" | "%" | "bytes" | "bytes/s" | "per_s" | "per_min" | "cores" | "load";
+        }[];
+        rows: Record<string, string | number | boolean | null>[];
+    }[];
+    skipped: string[];
+    freshMs?: number | undefined;
+}>;
+/**
+ * `GET …/metric-groups` (#680) — the sections the page renders, sorted by
+ * `order` then id. Fetched once with the page's initial requests (the list
+ * only changes with a deploy), not on the refresh tick; Retry refetches it.
+ *
+ * @stability experimental
+ */
+export declare function useDashboardMetricGroups(): DashboardResource<{
+    id: string;
+    label: string;
+    title: string;
+    order: number;
+}[]>;
+/**
+ * `GET …/filters` — the services, instances and hosts seen in the window.
+ *
+ * @stability experimental
+ */
+export declare function useDashboardFilters(query: Pick<DashboardQuery, 'range' | 'from' | 'to'>, tick: number): DashboardResource<{
+    services: string[];
+    instances: string[];
+    hosts: string[];
+    range: {
+        from: string;
+        to: string;
+        bucketSeconds: number;
+    };
+    generatedAt: string;
+    truncated: boolean;
+    sql: string | string[];
+}>;
+/**
+ * What {@link useDashboardEvents} returns: the panel's data plus keyset paging.
+ *
+ * @stability experimental
+ */
+export interface DashboardEventsResource extends DashboardResource<DashboardEvents> {
+    /** Every page loaded so far, newest first. */
+    items: DashboardEvent[];
+    /** Another page exists. */
+    hasMore: boolean;
+    /** The next page is in flight. */
+    isLoadingMore: boolean;
+    /** Why the next page failed, or `null`. */
+    loadMoreError: TelemetryErrorInfo | null;
+    /** Load the next page. */
+    loadMore: () => void;
+}
+/**
+ * `GET …/events` with keyset paging. A new query (filters, severity, search)
+ * or a refresh replaces the list with its first page — EXCEPT that an
+ * auto-refresh tick is skipped while the reader has paged past the first page,
+ * so the rows they scrolled to do not collapse under them every 30 seconds.
+ *
+ * @stability experimental
+ */
+export declare function useDashboardEvents(query: DashboardEventsQuery, tick: number): DashboardEventsResource;
+//# sourceMappingURL=useTelemetryDashboard.d.ts.map

package/dist/telemetry/headless/hooks/useTelemetryDashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTelemetryDashboard.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/headless/hooks/useTelemetryDashboard.ts"],"names":[],"mappings":"AAmBA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAEzB,KAAK,oBAAoB,EAGzB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEtF;;;;GAIG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,mDAAmD;IACnD,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,2CAA2C;IAC3C,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACjC,6CAA6C;IAC7C,SAAS,EAAE,OAAO,CAAC;IACnB,0DAA0D;IAC1D,YAAY,EAAE,OAAO,CAAC;IACtB,iDAAiD;IACjD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,qCAAqC;IACrC,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AA4DD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,uCAQtE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,wBAAwB,EACvE,KAAK,EAAE,CAAC,EACR,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,MAAM,6CASb;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,gBAAgB,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,sCAQvG;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAQ1G;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB;;;;;KAWvC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM;;;;;;;;;;;;GAQrG;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB,CAAC,eAAe,CAAC;IACjF,8CAA8C;IAC9C,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,aAAa,EAAE,OAAO,CAAC;IACvB,2CAA2C;IAC3C,aAAa,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACzC,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,GAAG,uBAAuB,CA8FrG"}

package/dist/telemetry/headless/hooks/useTelemetryDashboard.js

@@ -0,0 +1,231 @@
+/**
+ * The Telemetry Dashboard's data — issue #578, epic #576.
+ *
+ * One hook per endpoint, each fetching INDEPENDENTLY: a panel whose request
+ * fails (or is slow) never holds up or blanks another. Every hook
+ *
+ * - aborts the request in flight when a newer one starts (a filter change, an
+ *   auto-refresh tick or a Retry), so overlapping responses can never land out
+ *   of order;
+ * - keeps the last good result on screen while it refreshes (`isRefreshing`),
+ *   and reports `isLoading` only before the first result;
+ * - reports failures as {@link TelemetryErrorInfo}, whose `reason` is the
+ *   API's `details.reason` (`TELEMETRY_UNREACHABLE`, …).
+ *
+ * `tick` is the page's refresh counter: bumping it refetches with the same
+ * parameters. Polling itself (and pausing it in a hidden tab) is the page's
+ * job, through `useVisiblePolling`.
+ */
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { useTelemetryClient } from '../services/client.js';
+import { toTelemetryError } from './useTelemetryExplorer.js';
+function isAbort(err) {
+    return typeof err === 'object' && err !== null && err.name === 'AbortError';
+}
+/**
+ * The shared fetch-with-abort engine. `key` identifies the parameters (a new
+ * key refetches); `fetcher` is read through a ref so a fresh closure every
+ * render does not refetch on its own.
+ */
+function useDashboardResource(key, fetcher, tick, fallbackMessage) {
+    const [data, setData] = useState(null);
+    const [error, setError] = useState(null);
+    const [isFetching, setIsFetching] = useState(true);
+    const [fetchedAt, setFetchedAt] = useState(null);
+    const [reloadCount, setReloadCount] = useState(0);
+    const fetcherRef = useRef(fetcher);
+    fetcherRef.current = fetcher;
+    useEffect(() => {
+        const controller = new AbortController();
+        setIsFetching(true);
+        fetcherRef
+            .current(controller.signal)
+            .then((next) => {
+            if (controller.signal.aborted)
+                return;
+            setData(next);
+            setError(null);
+            setFetchedAt(Date.now());
+        })
+            .catch((err) => {
+            if (isAbort(err) || controller.signal.aborted)
+                return;
+            setError(toTelemetryError(err, fallbackMessage));
+        })
+            .finally(() => {
+            if (!controller.signal.aborted)
+                setIsFetching(false);
+        });
+        return () => controller.abort();
+    }, [key, tick, reloadCount, fallbackMessage]);
+    const reload = useCallback(() => setReloadCount((count) => count + 1), []);
+    return {
+        data,
+        error,
+        isLoading: isFetching && data === null,
+        isRefreshing: isFetching && data !== null,
+        fetchedAt,
+        reload,
+    };
+}
+const keyOf = (value) => JSON.stringify(value);
+/**
+ * `GET …/summary` — verdict, tiles and optional runtime tiles.
+ *
+ * @stability experimental
+ */
+export function useDashboardSummary(query, tick) {
+    const client = useTelemetryClient();
+    return useDashboardResource(keyOf(query), (signal) => client.getDashboardSummary(query, { signal }), tick, 'Failed to load the summary');
+}
+/**
+ * `GET …/timeseries?panel=api|logs`.
+ *
+ * @stability experimental
+ */
+export function useDashboardTimeseries(panel, query, tick) {
+    const client = useTelemetryClient();
+    return useDashboardResource(keyOf([panel, query]), (signal) => client.getDashboardTimeseries(panel, query, { signal }), tick, 'Failed to load the time series');
+}
+/**
+ * `GET …/top?kind=routes|errors`.
+ *
+ * @stability experimental
+ */
+export function useDashboardTop(kind, query, tick) {
+    const client = useTelemetryClient();
+    return useDashboardResource(keyOf([kind, query]), (signal) => client.getDashboardTop(kind, query, { signal }), tick, 'Failed to load the top list');
+}
+/**
+ * `GET …/metrics?group=…` (#601) — one metric group per call, so each of the
+ * page's infrastructure sections (one per `/metric-groups` entry, #680) loads,
+ * fails and retries on its own, on the page's shared refresh tick.
+ *
+ * @stability experimental
+ */
+export function useDashboardMetrics(group, query, tick) {
+    const client = useTelemetryClient();
+    return useDashboardResource(keyOf([group, query]), (signal) => client.getDashboardMetrics(group, query, { signal }), tick, 'Failed to load the metrics');
+}
+/**
+ * `GET …/metric-groups` (#680) — the sections the page renders, sorted by
+ * `order` then id. Fetched once with the page's initial requests (the list
+ * only changes with a deploy), not on the refresh tick; Retry refetches it.
+ *
+ * @stability experimental
+ */
+export function useDashboardMetricGroups() {
+    const client = useTelemetryClient();
+    return useDashboardResource('metric-groups', async (signal) => [...(await client.getDashboardMetricGroups({ signal }))].sort((a, b) => a.order - b.order || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0)), 0, 'Failed to load the metric sections');
+}
+/**
+ * `GET …/filters` — the services, instances and hosts seen in the window.
+ *
+ * @stability experimental
+ */
+export function useDashboardFilters(query, tick) {
+    const client = useTelemetryClient();
+    return useDashboardResource(keyOf(query), (signal) => client.getDashboardFilters(query, { signal }), tick, 'Failed to load the filter values');
+}
+/**
+ * `GET …/events` with keyset paging. A new query (filters, severity, search)
+ * or a refresh replaces the list with its first page — EXCEPT that an
+ * auto-refresh tick is skipped while the reader has paged past the first page,
+ * so the rows they scrolled to do not collapse under them every 30 seconds.
+ *
+ * @stability experimental
+ */
+export function useDashboardEvents(query, tick) {
+    const client = useTelemetryClient();
+    const key = keyOf(query);
+    const [pages, setPages] = useState([]);
+    const [error, setError] = useState(null);
+    const [isFetching, setIsFetching] = useState(true);
+    const [fetchedAt, setFetchedAt] = useState(null);
+    const [isLoadingMore, setIsLoadingMore] = useState(false);
+    const [loadMoreError, setLoadMoreError] = useState(null);
+    const [reloadCount, setReloadCount] = useState(0);
+    const queryRef = useRef(query);
+    queryRef.current = query;
+    const controllerRef = useRef(null);
+    const pagedRef = useRef({ key, paged: false });
+    const lastRunRef = useRef(null);
+    useEffect(() => {
+        const last = lastRunRef.current;
+        const onlyTick = last !== null && last.key === key && last.reloadCount === reloadCount;
+        if (onlyTick && pagedRef.current.key === key && pagedRef.current.paged)
+            return;
+        lastRunRef.current = { key, reloadCount };
+        controllerRef.current?.abort();
+        const controller = new AbortController();
+        controllerRef.current = controller;
+        setIsFetching(true);
+        setIsLoadingMore(false);
+        setLoadMoreError(null);
+        client.getDashboardEvents(queryRef.current, { signal: controller.signal })
+            .then((page) => {
+            if (controller.signal.aborted)
+                return;
+            pagedRef.current = { key, paged: false };
+            setPages([page]);
+            setError(null);
+            setFetchedAt(Date.now());
+        })
+            .catch((err) => {
+            if (isAbort(err) || controller.signal.aborted)
+                return;
+            setError(toTelemetryError(err, 'Failed to load events'));
+        })
+            .finally(() => {
+            if (controllerRef.current === controller) {
+                controllerRef.current = null;
+                setIsFetching(false);
+            }
+        });
+    }, [key, tick, reloadCount]);
+    useEffect(() => () => controllerRef.current?.abort(), []);
+    const last = pages.length > 0 ? pages[pages.length - 1] : null;
+    const nextCursor = last?.nextCursor ?? null;
+    const loadMore = useCallback(() => {
+        if (!nextCursor || controllerRef.current)
+            return;
+        const controller = new AbortController();
+        controllerRef.current = controller;
+        setIsLoadingMore(true);
+        setLoadMoreError(null);
+        client.getDashboardEvents({ ...queryRef.current, cursor: nextCursor }, { signal: controller.signal })
+            .then((page) => {
+            if (controller.signal.aborted)
+                return;
+            pagedRef.current = { key: keyOf(queryRef.current), paged: true };
+            setPages((prev) => [...prev, page]);
+        })
+            .catch((err) => {
+            if (isAbort(err) || controller.signal.aborted)
+                return;
+            setLoadMoreError(toTelemetryError(err, 'Failed to load more events'));
+        })
+            .finally(() => {
+            if (controllerRef.current === controller) {
+                controllerRef.current = null;
+                setIsLoadingMore(false);
+            }
+        });
+    }, [nextCursor]);
+    const reload = useCallback(() => setReloadCount((count) => count + 1), []);
+    const data = pages[0] ?? null;
+    return {
+        data,
+        error,
+        isLoading: isFetching && data === null,
+        isRefreshing: isFetching && data !== null,
+        fetchedAt,
+        reload,
+        items: pages.flatMap((page) => page.items),
+        hasMore: nextCursor !== null,
+        isLoadingMore,
+        loadMoreError,
+        loadMore,
+    };
+}
+//# sourceMappingURL=useTelemetryDashboard.js.map

package/dist/telemetry/headless/hooks/useTelemetryDashboard.js.map

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

package/dist/telemetry/headless/hooks/useTelemetryExplorer.d.ts

@@ -0,0 +1,95 @@
+import { type TelemetryQueryResult, type TelemetrySchemaTable } from '../services/telemetry.js';
+/**
+ * A failed telemetry call, as the pages show it: the message plus the envelope code, `details.reason`, the status and the query-specific details.
+ *
+ * @stability experimental
+ */
+export interface TelemetryErrorInfo {
+    /** What to show. */
+    message: string;
+    /** The envelope `code` — derived from the HTTP status. */
+    code: string | null;
+    /** `details.reason` — the telemetry-specific reason (`TELEMETRY_QUERY_REJECTED`, …). */
+    reason: string | null;
+    /** The HTTP status, or `null` for a network failure. */
+    status: number | null;
+    /** `details.sqlState` for `TELEMETRY_QUERY_FAILED`. */
+    sqlState: string | null;
+    /** `details.timeoutMs` for `TELEMETRY_QUERY_TIMEOUT`. */
+    timeoutMs: number | null;
+}
+/**
+ * A rejection as a {@link TelemetryErrorInfo}: a `PlatformApiError`'s status, code and details, or any other error's message.
+ *
+ * @param err - whatever a {@link TelemetryClient} call rejected with.
+ * @param fallback - the message when `err` carries none.
+ * @returns the error as the pages show it.
+ *
+ * @stability experimental
+ */
+export declare function toTelemetryError(err: unknown, fallback: string): TelemetryErrorInfo;
+/**
+ * A short human heading for a telemetry error, branching on `details.reason`.
+ *
+ * @stability experimental
+ */
+export declare function telemetryErrorTitle(error: TelemetryErrorInfo): string;
+/**
+ * What {@link useTelemetrySchema} returns.
+ *
+ * @stability experimental
+ */
+export interface UseTelemetrySchemaReturn {
+    /** The tables the reader login may query (empty until loaded). */
+    tables: TelemetrySchemaTable[];
+    /** A (re)load is in flight. */
+    isLoading: boolean;
+    /** Why the schema could not be loaded, or `null`. */
+    error: string | null;
+    /** Load the schema again. */
+    reload: () => Promise<void>;
+}
+/**
+ * `GET /admin/telemetry/schema`, once on mount: the tables the explorer's schema panel and editor completion read.
+ *
+ * @returns `tables`, `isLoading`, `error` (a message or `null`) and `reload`.
+ * @throws Error outside a `PlatformHostProvider`.
+ *
+ * @stability experimental
+ */
+export declare function useTelemetrySchema(): UseTelemetrySchemaReturn;
+/**
+ * What {@link useTelemetryQuery} returns.
+ *
+ * @stability experimental
+ */
+export interface UseTelemetryQueryReturn {
+    /** The last result, or `null` before the first. */
+    result: TelemetryQueryResult | null;
+    /** The last run's error, or `null`. */
+    error: TelemetryErrorInfo | null;
+    /** A run is in flight. */
+    isRunning: boolean;
+    /** Resolves `true` when a result arrived. */
+    run: (sql: string) => Promise<boolean>;
+    /** Abort the run in flight. */
+    cancel: () => void;
+}
+/**
+ * `POST /admin/telemetry/query` with cancel. A newer run aborts the one in flight; an aborted run leaves the previous result on screen and reports nothing. Whether a statement is allowed is the API's decision.
+ *
+ * @returns the result, the error and the run and cancel actions.
+ * @throws Error outside a `PlatformHostProvider`.
+ *
+ * @stability experimental
+ */
+export declare function useTelemetryQuery(): UseTelemetryQueryReturn;
+/**
+ * The assistant's configured provider and model, as a caption — read from the
+ * admin config, so only fetched for a holder of `telemetry:read` (`enabled`).
+ * Best effort: any failure just means no caption.
+ *
+ * @stability experimental
+ */
+export declare function useTelemetryAssistantModel(enabled: boolean): string | null;
+//# sourceMappingURL=useTelemetryExplorer.d.ts.map

package/dist/telemetry/headless/hooks/useTelemetryExplorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTelemetryExplorer.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/headless/hooks/useTelemetryExplorer.ts"],"names":[],"mappings":"AAcA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC1B,MAAM,0BAA0B,CAAC;AAIlC;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,wFAAwF;IACxF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,wDAAwD;IACxD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,yDAAyD;IACzD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AASD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAmBnF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAqBrE;AAMD;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,kEAAkE;IAClE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,+BAA+B;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,qDAAqD;IACrD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,wBAAwB,CAyB7D;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,mDAAmD;IACnD,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACpC,uCAAuC;IACvC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACjC,0BAA0B;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,+BAA+B;IAC/B,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,uBAAuB,CA2C3D;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAkB1E"}