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

package/dist/telemetry/query/telemetry-query-facade.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryFacadeLimitError = exports.FACADE_DEFAULT_ROWS = exports.FACADE_MAX_ROWS = exports.FACADE_MAX_STATEMENTS = void 0;
+exports.createQueryFacade = createQueryFacade;
+const telemetry_query_errors_1 = require("./telemetry-query.errors");
+const sql_literals_1 = require("../dashboard/sql-literals");
+const telemetry_query_dto_1 = require("../dto/telemetry-query.dto");
+// =============================================================================
+// The guarded query facade (PP-14.18)
+// =============================================================================
+//
+// What an app's code gets when it extends the telemetry slice: a dashboard
+// panel's `data` function (`registerDashboardPanel`) and an assistant tool's
+// `run` function (`registerTelemetryAssistantTool`). It is the ONLY way such
+// code reaches the telemetry store:
+//
+//   - never a client, a pool, a connection or the store port: the facade is a
+//     closure over the query service, frozen, with two members (`query`, `sql`)
+//     and the dialect's pure spelling helpers;
+//   - every statement goes through `TelemetryQueryService.run`, the same entry
+//     point as the explorer: ONE statement, read-only (the SQL guard refuses
+//     anything else, a write included), a row cap, the policy's timeout, and an
+//     audit row naming the caller and the source (`panel` or `assistant`);
+//   - bounded per facade (one panel read, one tool call): at most
+//     `FACADE_MAX_STATEMENTS` statements and `FACADE_MAX_ROWS` rows each, so an
+//     extension cannot turn a request into a scan loop;
+//   - values go into SQL through `sql.literal` / `sql.ident` / `sql.timestamp`,
+//     which quote (there are no bind parameters on the store's wire).
+//
+// The caller's identity is bound when the facade is made, from the request: the
+// extension cannot pick another user, another source or another store.
+// =============================================================================
+/**
+ * The most statements one facade runs (one panel read, one assistant tool call).
+ *
+ * @stability experimental
+ */
+exports.FACADE_MAX_STATEMENTS = 10;
+/**
+ * The most rows one facade statement returns, whatever `maxRows` asks and the
+ * `telemetry.query.maxRows` setting allows.
+ *
+ * @stability experimental
+ */
+exports.FACADE_MAX_ROWS = 1_000;
+/**
+ * The rows a facade statement returns when it does not say.
+ *
+ * @stability experimental
+ */
+exports.FACADE_DEFAULT_ROWS = 100;
+/**
+ * The statement budget of a facade is spent.
+ *
+ * @stability experimental
+ */
+class TelemetryFacadeLimitError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'TelemetryFacadeLimitError';
+    }
+}
+exports.TelemetryFacadeLimitError = TelemetryFacadeLimitError;
+const SQL_BUILDERS = Object.freeze({
+    literal: sql_literals_1.literal,
+    ident: sql_literals_1.ident,
+    timestamp: sql_literals_1.timestampLiteral,
+    between: sql_literals_1.between,
+});
+/**
+ * Makes the facade for one request: bound to `userId`, a source and a budget.
+ *
+ * @param service - the query service every statement goes through.
+ * @param userId - the user the request is for (the audit row names them).
+ * @param options - the source, dialect, budget and abort signal.
+ * @returns a frozen facade.
+ *
+ * @stability experimental
+ */
+function createQueryFacade(service, userId, options) {
+    const budget = options.maxStatements ?? exports.FACADE_MAX_STATEMENTS;
+    const rowCeiling = Math.min(options.maxRows ?? exports.FACADE_MAX_ROWS, exports.FACADE_MAX_ROWS);
+    let used = 0;
+    return Object.freeze({
+        async query(sql, queryOptions = {}) {
+            if (typeof sql !== 'string' || sql.trim() === '') {
+                throw new telemetry_query_errors_1.TelemetryHttpError(telemetry_query_errors_1.TELEMETRY_ERROR_REASONS.QUERY_REJECTED, 'A telemetry query needs a SQL statement.');
+            }
+            if (sql.length > telemetry_query_dto_1.TELEMETRY_SQL_MAX_LENGTH) {
+                throw new telemetry_query_errors_1.TelemetryHttpError(telemetry_query_errors_1.TELEMETRY_ERROR_REASONS.QUERY_REJECTED, `A telemetry query is at most ${telemetry_query_dto_1.TELEMETRY_SQL_MAX_LENGTH} characters.`);
+            }
+            if (used >= budget) {
+                throw new TelemetryFacadeLimitError(`This extension has used its ${budget} telemetry statements; combine them into fewer queries.`);
+            }
+            // Counted before it runs, so a refused statement (a write attempt, which the
+            // query service refuses AND audits) spends budget like any other.
+            used += 1;
+            const requested = queryOptions.maxRows;
+            const maxRows = Math.max(1, Math.min(Number.isFinite(requested) ? Math.floor(requested) : exports.FACADE_DEFAULT_ROWS, rowCeiling));
+            const result = await service.run(userId, sql, { source: options.source, maxRows, signal: options.signal });
+            return Object.freeze({
+                columns: Object.freeze(result.columns.map((column) => Object.freeze({ name: column.name, type: String(column.type) }))),
+                rows: result.rows,
+                rowCount: result.rowCount,
+                truncated: result.truncated,
+            });
+        },
+        sql: SQL_BUILDERS,
+        dialect: options.dialect,
+    });
+}
+//# sourceMappingURL=telemetry-query-facade.js.map

package/dist/telemetry/query/telemetry-query-facade.js.map

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

package/dist/telemetry/query/telemetry-query.errors.d.ts

@@ -0,0 +1,50 @@
+import { HttpException } from '@nestjs/common';
+/**
+ * The `details.reason` of every telemetry error (see the table above).
+ *
+ * @stability stable
+ */
+export declare const TELEMETRY_ERROR_REASONS: {
+    /** 503: no telemetry store is configured. */
+    readonly NOT_CONFIGURED: "TELEMETRY_NOT_CONFIGURED";
+    /** 503: the store did not answer. */
+    readonly UNREACHABLE: "TELEMETRY_UNREACHABLE";
+    /** 409: `telemetry.enabled` is off. */
+    readonly DISABLED: "TELEMETRY_DISABLED";
+    /** 400: the SQL guard refused the statement. */
+    readonly QUERY_REJECTED: "TELEMETRY_QUERY_REJECTED";
+    /** 400: the store refused the statement. */
+    readonly QUERY_FAILED: "TELEMETRY_QUERY_FAILED";
+    /** 504: the statement timed out. */
+    readonly QUERY_TIMEOUT: "TELEMETRY_QUERY_TIMEOUT";
+    /** 409: `telemetry.assistant.enabled` is off. */
+    readonly ASSISTANT_DISABLED: "TELEMETRY_ASSISTANT_DISABLED";
+    /** 409: no assistant provider or model is selected. */
+    readonly ASSISTANT_NOT_CONFIGURED: "TELEMETRY_ASSISTANT_NOT_CONFIGURED";
+    /** 400: a dashboard filter value was not seen in the range. */
+    readonly DASHBOARD_BAD_FILTER: "TELEMETRY_DASHBOARD_BAD_FILTER";
+    /** 400: the events `cursor` is malformed. */
+    readonly DASHBOARD_BAD_CURSOR: "TELEMETRY_DASHBOARD_BAD_CURSOR";
+    /** 500: an app's dashboard panel failed (its cause is in the log, not the answer). */
+    readonly PANEL_FAILED: "TELEMETRY_PANEL_FAILED";
+};
+/**
+ * One of {@link TELEMETRY_ERROR_REASONS}.
+ *
+ * @stability stable
+ */
+export type TelemetryErrorReason = (typeof TELEMETRY_ERROR_REASONS)[keyof typeof TELEMETRY_ERROR_REASONS];
+/**
+ * A telemetry failure with its reason in `details.reason`; the HTTP status
+ * follows from the reason.
+ *
+ * @stability stable
+ */
+export declare class TelemetryHttpError extends HttpException {
+    /** Why it failed. */
+    readonly reason: TelemetryErrorReason;
+    constructor(
+    /** Why it failed. */
+    reason: TelemetryErrorReason, message: string, details?: Record<string, unknown>);
+}
+//# sourceMappingURL=telemetry-query.errors.d.ts.map

package/dist/telemetry/query/telemetry-query.errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-query.errors.d.ts","sourceRoot":"","sources":["../../../src/telemetry/query/telemetry-query.errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAc,MAAM,gBAAgB,CAAC;AAiD3D;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;IAClC,6CAA6C;;IAE7C,qCAAqC;;IAErC,uCAAuC;;IAEvC,gDAAgD;;IAEhD,4CAA4C;;IAE5C,oCAAoC;;IAEpC,iDAAiD;;IAEjD,uDAAuD;;IAEvD,+DAA+D;;IAE/D,6CAA6C;;IAE7C,sFAAsF;;CAE9E,CAAC;AAEX;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,OAAO,uBAAuB,CAAC,CAAC;AAgB1G;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;IAEjD,qBAAqB;IACrB,QAAQ,CAAC,MAAM,EAAE,oBAAoB;;IADrC,qBAAqB;IACZ,MAAM,EAAE,oBAAoB,EACrC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAKxC"}

package/dist/telemetry/query/telemetry-query.errors.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryHttpError = exports.TELEMETRY_ERROR_REASONS = void 0;
+const common_1 = require("@nestjs/common");
+// =============================================================================
+// HTTP failures of the telemetry explorer (issue #535, epic #528)
+// =============================================================================
+//
+// The error envelope derives `code` from the status (docs/API.md), so the
+// machine-readable reason travels in `details.reason`, exactly like
+// `AI_DISABLED`. One status per reason:
+//
+//   TELEMETRY_NOT_CONFIGURED  503  no telemetry store in this deployment (the
+//                                  overlay is not deployed). 503 rather than
+//                                  404: the ROUTE exists, the service behind
+//                                  it does not — and `GET …/status` already
+//                                  reports `configured: false` with a 200.
+//   TELEMETRY_UNREACHABLE     503  configured, but the store did not answer.
+//   TELEMETRY_DISABLED        409  `telemetry.enabled` is off — a state an
+//                                  administrator can change (same status the
+//                                  AI kill switch's admin-facing errors use for
+//                                  "the configuration forbids this now").
+//   TELEMETRY_QUERY_REJECTED  400  the SQL guard refused the statement.
+//   TELEMETRY_QUERY_FAILED    400  GreptimeDB refused or failed the statement
+//                                  (syntax, unknown column, not permitted).
+//                                  The message is the server's own: it is
+//                                  about the caller's SQL and carries no
+//                                  credential.
+//   TELEMETRY_QUERY_TIMEOUT   504  the statement outran
+//                                  `telemetry.query.timeoutSeconds`.
+//
+// The assistant (#536) adds two, both 409 for the same reason as DISABLED
+// (an administrator can change the configuration that forbids this):
+//
+//   TELEMETRY_ASSISTANT_DISABLED        409  `telemetry.assistant.enabled` is off.
+//   TELEMETRY_ASSISTANT_NOT_CONFIGURED  409  no `assistant.provider`/`modelId`.
+//
+// The dashboard (#577) adds two request errors:
+//
+//   TELEMETRY_DASHBOARD_BAD_FILTER  400  `service`/`instance` is not among the
+//                                        values seen in the requested range.
+//   TELEMETRY_DASHBOARD_BAD_CURSOR  400  the events `cursor` is malformed.
+//
+// A dashboard panel an app registered (PP-14.18) adds one:
+//
+//   TELEMETRY_PANEL_FAILED          500  the panel's `data` function threw, ran
+//                                        out of time or returned something that is
+//                                        not bounded JSON. The viewer sees a
+//                                        generic message; the cause is logged.
+// =============================================================================
+/**
+ * The `details.reason` of every telemetry error (see the table above).
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_ERROR_REASONS = {
+    /** 503: no telemetry store is configured. */
+    NOT_CONFIGURED: 'TELEMETRY_NOT_CONFIGURED',
+    /** 503: the store did not answer. */
+    UNREACHABLE: 'TELEMETRY_UNREACHABLE',
+    /** 409: `telemetry.enabled` is off. */
+    DISABLED: 'TELEMETRY_DISABLED',
+    /** 400: the SQL guard refused the statement. */
+    QUERY_REJECTED: 'TELEMETRY_QUERY_REJECTED',
+    /** 400: the store refused the statement. */
+    QUERY_FAILED: 'TELEMETRY_QUERY_FAILED',
+    /** 504: the statement timed out. */
+    QUERY_TIMEOUT: 'TELEMETRY_QUERY_TIMEOUT',
+    /** 409: `telemetry.assistant.enabled` is off. */
+    ASSISTANT_DISABLED: 'TELEMETRY_ASSISTANT_DISABLED',
+    /** 409: no assistant provider or model is selected. */
+    ASSISTANT_NOT_CONFIGURED: 'TELEMETRY_ASSISTANT_NOT_CONFIGURED',
+    /** 400: a dashboard filter value was not seen in the range. */
+    DASHBOARD_BAD_FILTER: 'TELEMETRY_DASHBOARD_BAD_FILTER',
+    /** 400: the events `cursor` is malformed. */
+    DASHBOARD_BAD_CURSOR: 'TELEMETRY_DASHBOARD_BAD_CURSOR',
+    /** 500: an app's dashboard panel failed (its cause is in the log, not the answer). */
+    PANEL_FAILED: 'TELEMETRY_PANEL_FAILED',
+};
+const STATUS = {
+    TELEMETRY_NOT_CONFIGURED: common_1.HttpStatus.SERVICE_UNAVAILABLE,
+    TELEMETRY_UNREACHABLE: common_1.HttpStatus.SERVICE_UNAVAILABLE,
+    TELEMETRY_DISABLED: common_1.HttpStatus.CONFLICT,
+    TELEMETRY_QUERY_REJECTED: common_1.HttpStatus.BAD_REQUEST,
+    TELEMETRY_QUERY_FAILED: common_1.HttpStatus.BAD_REQUEST,
+    TELEMETRY_QUERY_TIMEOUT: common_1.HttpStatus.GATEWAY_TIMEOUT,
+    TELEMETRY_ASSISTANT_DISABLED: common_1.HttpStatus.CONFLICT,
+    TELEMETRY_ASSISTANT_NOT_CONFIGURED: common_1.HttpStatus.CONFLICT,
+    TELEMETRY_DASHBOARD_BAD_FILTER: common_1.HttpStatus.BAD_REQUEST,
+    TELEMETRY_DASHBOARD_BAD_CURSOR: common_1.HttpStatus.BAD_REQUEST,
+    TELEMETRY_PANEL_FAILED: common_1.HttpStatus.INTERNAL_SERVER_ERROR,
+};
+/**
+ * A telemetry failure with its reason in `details.reason`; the HTTP status
+ * follows from the reason.
+ *
+ * @stability stable
+ */
+class TelemetryHttpError extends common_1.HttpException {
+    reason;
+    constructor(
+    /** Why it failed. */
+    reason, message, details = {}) {
+        // `reason` last, so a caller-supplied detail can never contradict it.
+        super({ message, details: { ...details, reason } }, STATUS[reason]);
+        this.reason = reason;
+    }
+}
+exports.TelemetryHttpError = TelemetryHttpError;
+//# sourceMappingURL=telemetry-query.errors.js.map

package/dist/telemetry/query/telemetry-query.errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-query.errors.js","sourceRoot":"","sources":["../../../src/telemetry/query/telemetry-query.errors.ts"],"names":[],"mappings":";;;AAAA,2CAA2D;AAE3D,gFAAgF;AAChF,kEAAkE;AAClE,gFAAgF;AAChF,EAAE;AACF,0EAA0E;AAC1E,oEAAoE;AACpE,wCAAwC;AACxC,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAC7E,6EAA6E;AAC7E,4EAA4E;AAC5E,2EAA2E;AAC3E,6EAA6E;AAC7E,2EAA2E;AAC3E,6EAA6E;AAC7E,gFAAgF;AAChF,0EAA0E;AAC1E,wEAAwE;AACxE,8EAA8E;AAC9E,4EAA4E;AAC5E,0EAA0E;AAC1E,yEAAyE;AACzE,+CAA+C;AAC/C,wDAAwD;AACxD,qEAAqE;AACrE,EAAE;AACF,0EAA0E;AAC1E,qEAAqE;AACrE,EAAE;AACF,mFAAmF;AACnF,gFAAgF;AAChF,EAAE;AACF,gDAAgD;AAChD,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,2EAA2E;AAC3E,EAAE;AACF,2DAA2D;AAC3D,EAAE;AACF,gFAAgF;AAChF,mFAAmF;AACnF,6EAA6E;AAC7E,+EAA+E;AAC/E,gFAAgF;AAEhF;;;;GAIG;AACU,QAAA,uBAAuB,GAAG;IACrC,6CAA6C;IAC7C,cAAc,EAAE,0BAA0B;IAC1C,qCAAqC;IACrC,WAAW,EAAE,uBAAuB;IACpC,uCAAuC;IACvC,QAAQ,EAAE,oBAAoB;IAC9B,gDAAgD;IAChD,cAAc,EAAE,0BAA0B;IAC1C,4CAA4C;IAC5C,YAAY,EAAE,wBAAwB;IACtC,oCAAoC;IACpC,aAAa,EAAE,yBAAyB;IACxC,iDAAiD;IACjD,kBAAkB,EAAE,8BAA8B;IAClD,uDAAuD;IACvD,wBAAwB,EAAE,oCAAoC;IAC9D,+DAA+D;IAC/D,oBAAoB,EAAE,gCAAgC;IACtD,6CAA6C;IAC7C,oBAAoB,EAAE,gCAAgC;IACtD,sFAAsF;IACtF,YAAY,EAAE,wBAAwB;CAC9B,CAAC;AASX,MAAM,MAAM,GAA6C;IACvD,wBAAwB,EAAE,mBAAU,CAAC,mBAAmB;IACxD,qBAAqB,EAAE,mBAAU,CAAC,mBAAmB;IACrD,kBAAkB,EAAE,mBAAU,CAAC,QAAQ;IACvC,wBAAwB,EAAE,mBAAU,CAAC,WAAW;IAChD,sBAAsB,EAAE,mBAAU,CAAC,WAAW;IAC9C,uBAAuB,EAAE,mBAAU,CAAC,eAAe;IACnD,4BAA4B,EAAE,mBAAU,CAAC,QAAQ;IACjD,kCAAkC,EAAE,mBAAU,CAAC,QAAQ;IACvD,8BAA8B,EAAE,mBAAU,CAAC,WAAW;IACtD,8BAA8B,EAAE,mBAAU,CAAC,WAAW;IACtD,sBAAsB,EAAE,mBAAU,CAAC,qBAAqB;CACzD,CAAC;AAEF;;;;;GAKG;AACH,MAAa,kBAAmB,SAAQ,sBAAa;IAGxC;IAFX;IACE,qBAAqB;IACZ,MAA4B,EACrC,OAAe,EACf,UAAmC,EAAE;QAErC,sEAAsE;QACtE,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAL3D,WAAM,GAAN,MAAM,CAAsB;IAMvC,CAAC;CACF;AAVD,gDAUC"}

package/dist/telemetry/query/telemetry-query.service.d.ts

@@ -0,0 +1,57 @@
+import type { TelemetryColumnType, TelemetryQueryRunResult } from '../dto/telemetry-query.dto';
+import { type TelemetryAuditSink } from '../ports';
+import { type TelemetryStore } from '../stores/telemetry-store';
+import { TelemetrySettingsService } from '../telemetry-settings.service';
+/**
+ * Who runs a statement; chooses the audit action.
+ *
+ * @stability experimental
+ */
+export type TelemetryQuerySource = 'explorer' | 'assistant' | 'export' | 'panel';
+/**
+ * How `TelemetryQueryService.run` runs one statement.
+ *
+ * @stability experimental
+ */
+export interface TelemetryQueryRunOptions {
+    /** Row cap for this call; clamped to `telemetry.query.maxRows`, which is also the default. */
+    maxRows?: number;
+    /** Who is asking. Chooses the audit action. Default `explorer`. */
+    source?: TelemetryQuerySource;
+    /** Abandons the statement when aborted (the assistant's client went away, #536). */
+    signal?: AbortSignal;
+}
+/** Audit `action` per source. */
+export declare const TELEMETRY_QUERY_AUDIT_ACTIONS: Record<TelemetryQuerySource, string>;
+/** How much of the SQL text an audit row keeps. */
+export declare const TELEMETRY_AUDIT_SQL_MAX = 4000;
+export declare function columnTypeName(dataTypeID: number): TelemetryColumnType;
+/**
+ * A wire value as something `JSON.stringify` reproduces faithfully:
+ * Buffer → base64, bigint → decimal string, Date → ISO string, non-finite
+ * number → its name (JSON would silently turn it into null), arrays and
+ * plain objects recursively. `int8`/`numeric`/timestamps already arrive as
+ * strings from the store and stay that way.
+ */
+export declare function toJsonSafe(value: unknown): unknown;
+/**
+ * The one entry point for caller-supplied SQL (the explorer, the export and
+ * the assistant): the SQL guard, the row cap, the timeout and an audit row.
+ * Exported by `TelemetryModule`.
+ *
+ * @stability experimental
+ */
+export declare class TelemetryQueryService {
+    private readonly store;
+    private readonly settings;
+    private readonly auditSink;
+    private readonly logger;
+    constructor(store: TelemetryStore, settings: TelemetrySettingsService, auditSink: TelemetryAuditSink);
+    /**
+     * Runs one read-only statement for `userId`. Throws `TelemetryHttpError`
+     * (see `telemetry-query.errors.ts`) for every expected failure.
+     */
+    run(userId: string, sql: string, opts?: TelemetryQueryRunOptions): Promise<TelemetryQueryRunResult>;
+    private audit;
+}
+//# sourceMappingURL=telemetry-query.service.d.ts.map

package/dist/telemetry/query/telemetry-query.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-query.service.d.ts","sourceRoot":"","sources":["../../../src/telemetry/query/telemetry-query.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC/F,OAAO,EAAwB,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAoCzE;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEjF;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,oFAAoF;IACpF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,iCAAiC;AACjC,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAK9E,CAAC;AAEF,mDAAmD;AACnD,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAsB7C,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,mBAAmB,CAEtE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAuBlD;AAED;;;;;;GAMG;AACH,qBACa,qBAAqB;IAIL,OAAO,CAAC,QAAQ,CAAC,KAAK;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACK,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;gBAGrB,KAAK,EAAE,cAAc,EAC9C,QAAQ,EAAE,wBAAwB,EACJ,SAAS,EAAE,kBAAkB;IAG9E;;;OAGG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,wBAA6B,GAAG,OAAO,CAAC,uBAAuB,CAAC;YAwE/F,KAAK;CAmBpB"}

package/dist/telemetry/query/telemetry-query.service.js

@@ -0,0 +1,196 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var TelemetryQueryService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryQueryService = exports.TELEMETRY_AUDIT_SQL_MAX = exports.TELEMETRY_QUERY_AUDIT_ACTIONS = void 0;
+exports.columnTypeName = columnTypeName;
+exports.toJsonSafe = toJsonSafe;
+const common_1 = require("@nestjs/common");
+const ports_1 = require("../ports");
+const telemetry_store_1 = require("../stores/telemetry-store");
+const telemetry_settings_service_1 = require("../telemetry-settings.service");
+const sql_guard_1 = require("./sql-guard");
+const telemetry_availability_1 = require("./telemetry-availability");
+const telemetry_query_errors_1 = require("./telemetry-query.errors");
+/** Audit `action` per source. */
+exports.TELEMETRY_QUERY_AUDIT_ACTIONS = {
+    explorer: 'telemetry:query',
+    export: 'telemetry:export',
+    assistant: 'telemetry:assistant_query',
+    panel: 'telemetry:panel_query',
+};
+/** How much of the SQL text an audit row keeps. */
+exports.TELEMETRY_AUDIT_SQL_MAX = 4_000;
+/** PostgreSQL type OID → the simplified name the explorer shows. */
+const TYPE_NAMES = {
+    16: 'bool',
+    17: 'bytea',
+    20: 'int8',
+    21: 'int2',
+    23: 'int4',
+    25: 'text',
+    114: 'json',
+    700: 'float4',
+    701: 'float8',
+    1043: 'text',
+    1082: 'date',
+    1083: 'time',
+    1114: 'timestamp',
+    1184: 'timestamp',
+    1700: 'numeric',
+    3802: 'json',
+};
+function columnTypeName(dataTypeID) {
+    return TYPE_NAMES[dataTypeID] ?? 'unknown';
+}
+/**
+ * A wire value as something `JSON.stringify` reproduces faithfully:
+ * Buffer → base64, bigint → decimal string, Date → ISO string, non-finite
+ * number → its name (JSON would silently turn it into null), arrays and
+ * plain objects recursively. `int8`/`numeric`/timestamps already arrive as
+ * strings from the store and stay that way.
+ */
+function toJsonSafe(value) {
+    if (value === null || value === undefined)
+        return null;
+    switch (typeof value) {
+        case 'string':
+        case 'boolean':
+            return value;
+        case 'number':
+            return Number.isFinite(value) ? value : String(value);
+        case 'bigint':
+            return value.toString();
+        case 'object':
+            break;
+        default:
+            return String(value);
+    }
+    if (Buffer.isBuffer(value))
+        return value.toString('base64');
+    if (value instanceof Uint8Array)
+        return Buffer.from(value).toString('base64');
+    if (value instanceof Date)
+        return Number.isNaN(value.getTime()) ? null : value.toISOString();
+    if (Array.isArray(value))
+        return value.map(toJsonSafe);
+    return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, toJsonSafe(v)]));
+}
+/**
+ * The one entry point for caller-supplied SQL (the explorer, the export and
+ * the assistant): the SQL guard, the row cap, the timeout and an audit row.
+ * Exported by `TelemetryModule`.
+ *
+ * @stability experimental
+ */
+let TelemetryQueryService = TelemetryQueryService_1 = class TelemetryQueryService {
+    store;
+    settings;
+    auditSink;
+    logger = new common_1.Logger(TelemetryQueryService_1.name);
+    constructor(store, settings, auditSink) {
+        this.store = store;
+        this.settings = settings;
+        this.auditSink = auditSink;
+    }
+    /**
+     * Runs one read-only statement for `userId`. Throws `TelemetryHttpError`
+     * (see `telemetry-query.errors.ts`) for every expected failure.
+     */
+    async run(userId, sql, opts = {}) {
+        const source = opts.source ?? 'explorer';
+        // Preconditions are not audited: nothing was attempted against the store.
+        const policy = await (0, telemetry_availability_1.requireQueryablePolicy)(this.store, this.settings);
+        const maxRows = clampRows(opts.maxRows, policy.query.maxRows);
+        const started = Date.now();
+        let outcome;
+        try {
+            const statement = (0, sql_guard_1.analyzeStatement)(sql);
+            const capped = (0, sql_guard_1.applyRowCap)(statement, maxRows + 1);
+            // 'client-only': the server may return more than maxRows + 1 rows. The
+            // slice below still caps the RESPONSE; the rows are held in memory in
+            // the meantime, bounded only by the policy timeout. Streaming rows off
+            // the socket and hanging up past the cap was considered and not done:
+            // it would replace the store's one-shot query (and its
+            // multi-statement check) for statements that are rare — `LIMIT ALL`,
+            // `LIMIT <expression>`, `FETCH FIRST`, SHOW/DESCRIBE/EXPLAIN.
+            if (capped.strategy === 'client-only' && statement.kind === 'select') {
+                this.logger.debug('Telemetry query has no server-side row cap; capping client-side');
+            }
+            const result = await this.store.query(capped.sql, [], {
+                readOnly: true,
+                timeoutMs: policy.query.timeoutSeconds * 1000,
+                signal: opts.signal,
+            });
+            const elapsedMs = Date.now() - started;
+            const truncated = result.rows.length > maxRows;
+            const rows = (truncated ? result.rows.slice(0, maxRows) : result.rows).map((row) => row.map(toJsonSafe));
+            outcome = {
+                columns: result.fields.map((field) => ({ name: field.name, type: columnTypeName(field.dataTypeID) })),
+                rows,
+                rowCount: rows.length,
+                truncated,
+                elapsedMs,
+            };
+        }
+        catch (error) {
+            const mapped = (0, telemetry_availability_1.toTelemetryHttpError)(error);
+            const elapsedMs = Date.now() - started;
+            await this.audit(userId, source, sql, {
+                rowCount: 0,
+                truncated: false,
+                elapsedMs,
+                error: error instanceof Error ? error.message : String(error),
+                ...(mapped instanceof telemetry_query_errors_1.TelemetryHttpError ? { reason: mapped.reason } : {}),
+            }).catch((auditError) => {
+                // Never let a failed audit write replace the error the caller needs.
+                this.logger.warn(`Could not audit a failed telemetry query: ${auditError instanceof Error ? auditError.message : String(auditError)}`);
+            });
+            throw mapped;
+        }
+        // Outside the try: a failed audit write is a 500, not a "failed query".
+        await this.audit(userId, source, sql, {
+            rowCount: outcome.rowCount,
+            truncated: outcome.truncated,
+            elapsedMs: outcome.elapsedMs,
+        });
+        return outcome;
+    }
+    async audit(userId, source, sql, meta) {
+        await this.auditSink.record({
+            actorUserId: userId,
+            action: exports.TELEMETRY_QUERY_AUDIT_ACTIONS[source],
+            targetType: 'telemetry_store',
+            targetId: this.store.database,
+            meta: {
+                sql: sql.length > exports.TELEMETRY_AUDIT_SQL_MAX ? `${sql.slice(0, exports.TELEMETRY_AUDIT_SQL_MAX)}…` : sql,
+                ...(sql.length > exports.TELEMETRY_AUDIT_SQL_MAX ? { sqlLength: sql.length } : {}),
+                source,
+                ...meta,
+            },
+        });
+    }
+};
+exports.TelemetryQueryService = TelemetryQueryService;
+exports.TelemetryQueryService = TelemetryQueryService = TelemetryQueryService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(telemetry_store_1.TELEMETRY_STORE)),
+    __param(2, (0, common_1.Inject)(ports_1.TELEMETRY_AUDIT_SINK)),
+    __metadata("design:paramtypes", [Object, telemetry_settings_service_1.TelemetrySettingsService, Object])
+], TelemetryQueryService);
+function clampRows(requested, ceiling) {
+    const wanted = requested !== undefined && Number.isFinite(requested) ? Math.floor(requested) : ceiling;
+    return Math.max(1, Math.min(wanted, ceiling));
+}
+//# sourceMappingURL=telemetry-query.service.js.map

package/dist/telemetry/query/telemetry-query.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-query.service.js","sourceRoot":"","sources":["../../../src/telemetry/query/telemetry-query.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AA6FA,wCAEC;AASD,gCAuBC;AA/HD,2CAA4D;AAG5D,oCAAyE;AACzE,+DAAiF;AACjF,8EAAyE;AACzE,2CAA4D;AAC5D,qEAAwF;AACxF,qEAA8D;AAsD9D,iCAAiC;AACpB,QAAA,6BAA6B,GAAyC;IACjF,QAAQ,EAAE,iBAAiB;IAC3B,MAAM,EAAE,kBAAkB;IAC1B,SAAS,EAAE,2BAA2B;IACtC,KAAK,EAAE,uBAAuB;CAC/B,CAAC;AAEF,mDAAmD;AACtC,QAAA,uBAAuB,GAAG,KAAK,CAAC;AAE7C,oEAAoE;AACpE,MAAM,UAAU,GAAwC;IACtD,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,OAAO;IACX,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,MAAM;IACV,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,QAAQ;IACb,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,SAAgB,cAAc,CAAC,UAAkB;IAC/C,OAAO,UAAU,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,UAAU,CAAC,KAAc;IACvC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAEvD,QAAQ,OAAO,KAAK,EAAE,CAAC;QACrB,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxD,KAAK,QAAQ;YACX,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC1B,KAAK,QAAQ;YACX,MAAM;QACR;YACE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5D,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC9E,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IAC7F,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAEvD,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClH,CAAC;AAED;;;;;;GAMG;AAEI,IAAM,qBAAqB,6BAA3B,MAAM,qBAAqB;IAIY;IACzB;IAC8B;IALhC,MAAM,GAAG,IAAI,eAAM,CAAC,uBAAqB,CAAC,IAAI,CAAC,CAAC;IAEjE,YAC4C,KAAqB,EAC9C,QAAkC,EACJ,SAA6B;QAFlC,UAAK,GAAL,KAAK,CAAgB;QAC9C,aAAQ,GAAR,QAAQ,CAA0B;QACJ,cAAS,GAAT,SAAS,CAAoB;IAC3E,CAAC;IAEJ;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,MAAc,EAAE,GAAW,EAAE,OAAiC,EAAE;QACxE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC;QAEzC,0EAA0E;QAC1E,MAAM,MAAM,GAAG,MAAM,IAAA,+CAAsB,EAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAE9D,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,IAAI,OAAgC,CAAC;QAErC,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAA,4BAAgB,EAAC,GAAG,CAAC,CAAC;YACxC,MAAM,MAAM,GAAG,IAAA,uBAAW,EAAC,SAAS,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;YAEnD,uEAAuE;YACvE,sEAAsE;YACtE,uEAAuE;YACvE,sEAAsE;YACtE,uDAAuD;YACvD,qEAAqE;YACrE,8DAA8D;YAC9D,IAAI,MAAM,CAAC,QAAQ,KAAK,aAAa,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;YACvF,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE;gBACpD,QAAQ,EAAE,IAAI;gBACd,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,cAAc,GAAG,IAAI;gBAC7C,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;YAEvC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;YAC/C,MAAM,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;YAEzG,OAAO,GAAG;gBACR,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;gBACrG,IAAI;gBACJ,QAAQ,EAAE,IAAI,CAAC,MAAM;gBACrB,SAAS;gBACT,SAAS;aACV,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,IAAA,6CAAoB,EAAC,KAAK,CAAC,CAAC;YAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;YAEvC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE;gBACpC,QAAQ,EAAE,CAAC;gBACX,SAAS,EAAE,KAAK;gBAChB,SAAS;gBACT,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC7D,GAAG,CAAC,MAAM,YAAY,2CAAkB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC3E,CAAC,CAAC,KAAK,CAAC,CAAC,UAAmB,EAAE,EAAE;gBAC/B,qEAAqE;gBACrE,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,6CAA6C,UAAU,YAAY,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CACrH,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,MAAM,MAAM,CAAC;QACf,CAAC;QAED,wEAAwE;QACxE,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE;YACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,KAAK,CACjB,MAAc,EACd,MAA4B,EAC5B,GAAW,EACX,IAAkG;QAElG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;YAC1B,WAAW,EAAE,MAAM;YACnB,MAAM,EAAE,qCAA6B,CAAC,MAAM,CAAC;YAC7C,UAAU,EAAE,iBAAiB;YAC7B,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ;YAC7B,IAAI,EAAE;gBACJ,GAAG,EAAE,GAAG,CAAC,MAAM,GAAG,+BAAuB,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,+BAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;gBAC7F,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,+BAAuB,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1E,MAAM;gBACN,GAAG,IAAI;aACR;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAxGY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;IAKR,WAAA,IAAA,eAAM,EAAC,iCAAe,CAAC,CAAA;IAEvB,WAAA,IAAA,eAAM,EAAC,4BAAoB,CAAC,CAAA;6CADF,qDAAwB;GAL1C,qBAAqB,CAwGjC;AAED,SAAS,SAAS,CAAC,SAA6B,EAAE,OAAe;IAC/D,MAAM,MAAM,GAAG,SAAS,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAEvG,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/dist/telemetry/query/telemetry-schema.service.d.ts

@@ -0,0 +1,30 @@
+import type { TelemetrySchema, TelemetrySchemaTable } from '../dto/telemetry-query.dto';
+import { type TelemetryStore } from '../stores/telemetry-store';
+import { TelemetrySettingsService } from '../telemetry-settings.service';
+export declare const TELEMETRY_SCHEMA_CACHE_MS = 30000;
+/**
+ * The telemetry store's tables and columns, cached briefly. Exported by
+ * `TelemetryModule`.
+ *
+ * @stability experimental
+ */
+export declare class TelemetrySchemaService {
+    private readonly store;
+    private readonly settings;
+    private cache;
+    private inflight;
+    constructor(store: TelemetryStore, settings: TelemetrySettingsService);
+    /** Every table with its columns, both sorted by name / position. */
+    getSchema(opts?: {
+        fresh?: boolean;
+    }): Promise<TelemetrySchema>;
+    /** Whether `name` is exactly (case-sensitively) a table of the telemetry database. */
+    tableExists(name: string): Promise<boolean>;
+    /** One table's schema, or null when there is no such table. */
+    describeTable(name: string): Promise<TelemetrySchemaTable | null>;
+    /** Drops the cached schema so the next read asks the store. */
+    invalidateCache(): void;
+    private read;
+}
+export { groupSchema } from '../stores/greptime/greptime.schema';
+//# sourceMappingURL=telemetry-schema.service.d.ts.map

package/dist/telemetry/query/telemetry-schema.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-schema.service.d.ts","sourceRoot":"","sources":["../../../src/telemetry/query/telemetry-schema.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACxF,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAuBzE,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD;;;;;GAKG;AACH,qBACa,sBAAsB;IAKN,OAAO,CAAC,QAAQ,CAAC,KAAK;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAL3B,OAAO,CAAC,KAAK,CAA2D;IACxE,OAAO,CAAC,QAAQ,CAAyC;gBAGb,KAAK,EAAE,cAAc,EAC9C,QAAQ,EAAE,wBAAwB;IAGrD,oEAAoE;IAC9D,SAAS,CAAC,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAsBzE,sFAAsF;IAChF,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjD,+DAA+D;IACzD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAMvE,+DAA+D;IAC/D,eAAe,IAAI,IAAI;YAIT,IAAI;CAOnB;AAGD,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC"}