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

package/dist/telemetry/handlers/telemetry-retention.handler.js

@@ -0,0 +1,123 @@
+"use strict";
+// =============================================================================
+// `telemetry.retention.apply` job handler (issue #534, epic #528)
+// =============================================================================
+//
+// Makes GreptimeDB's database-level TTL match `telemetry.retentionDays`:
+//
+//     ALTER DATABASE <database> SET 'ttl'='<N>d'
+//
+// The database name is deliberately UNQUOTED: GreptimeDB v1.2.1 resolves a
+// double-quoted name in ALTER DATABASE literally (`"public"` fails with
+// "Failed to find schema"), so the name is instead restricted to a plain
+// identifier and refused otherwise.
+//
+// One database TTL covers every telemetry table, including the per-metric and
+// per-attribute tables GreptimeDB creates later (spike #529: tables inherit
+// it). GreptimeDB enforces the TTL itself during compaction — this job only
+// states the policy, it deletes nothing directly.
+//
+// IDEMPOTENT: setting the TTL to the value it already has is a no-op on the
+// server, so a retry, a duplicate run, or the daily re-assertion
+// (`TelemetryRetentionTask`) are all harmless. Enqueued by that cron and by
+// every successful `PUT /api/admin/telemetry/config`.
+//
+// NOT GATED ON `telemetry.enabled`. Retention is a data-hygiene policy: a
+// deployment that switched collection off still wants what it already
+// collected to age out.
+//
+// A DEPLOYMENT WITHOUT GREPTIMEDB (or without its admin credential) completes
+// as a NO-OP with a log line rather than failing: that is a supported
+// configuration, and failing would put a red row in the jobs dashboard every
+// night for a feature the operator never deployed.
+//
+// SERVER-ONLY, PERMANENTLY: no `nodeResultSchema`/`persistNodeResult`. The
+// statement needs the GreptimeDB ADMIN credential — one able to change
+// retention and drop telemetry — and a worker node must never hold it
+// (CLAUDE.md, queue rule 3).
+// =============================================================================
+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 TelemetryRetentionHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryRetentionHandler = exports.TELEMETRY_RETENTION_STATEMENT_TIMEOUT_MS = exports.TELEMETRY_RETENTION_TYPE = void 0;
+exports.retentionStatement = retentionStatement;
+const common_1 = require("@nestjs/common");
+const greptime_client_1 = require("../greptime/greptime.client");
+const ports_1 = require("../ports");
+/**
+ * The job type. PERMANENT once rows of it exist.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_RETENTION_TYPE = 'telemetry.retention.apply';
+/** Client-side ceiling on the ALTER. It is a metadata change; seconds, not minutes. */
+exports.TELEMETRY_RETENTION_STATEMENT_TIMEOUT_MS = 30_000;
+/** A bare SQL identifier; the only database names the statement accepts. */
+const PLAIN_IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/** The one statement this job runs. Exported so its text is pinned by a test. */
+function retentionStatement(database, retentionDays) {
+    // Defence in depth: the value came through `systemTelemetrySchema`
+    // (an integer in 1..3650), and it is interpolated into SQL — GreptimeDB
+    // has no bind parameters — so it is checked again right here.
+    if (!Number.isInteger(retentionDays) || retentionDays < 1 || retentionDays > 3650) {
+        throw new Error(`Refusing to apply an invalid telemetry retention of ${String(retentionDays)} day(s).`);
+    }
+    if (!PLAIN_IDENTIFIER.test(database)) {
+        throw new Error(`Refusing to apply retention to a non-plain database name: ${JSON.stringify(database)}.`);
+    }
+    return `ALTER DATABASE ${database} SET 'ttl'='${retentionDays}d'`;
+}
+let TelemetryRetentionHandler = TelemetryRetentionHandler_1 = class TelemetryRetentionHandler {
+    jobs;
+    systemSettings;
+    greptime;
+    logger = new common_1.Logger(TelemetryRetentionHandler_1.name);
+    type = exports.TELEMETRY_RETENTION_TYPE;
+    /** One metadata statement; a minute is generous. Retried like any housekeeping job. */
+    profile = { maxRuntimeMs: 60_000, maxAttempts: 3 };
+    // Deliberately NO `nodeResultSchema` / `persistNodeResult` — see the header.
+    constructor(jobs, systemSettings, greptime) {
+        this.jobs = jobs;
+        this.systemSettings = systemSettings;
+        this.greptime = greptime;
+    }
+    onModuleInit() {
+        this.jobs.registerHandler(this);
+    }
+    /** Throws to fail (GreptimeDB unreachable or refusing), so the queue's retry applies. */
+    async process(job) {
+        if (!this.greptime.isConfigured()) {
+            this.logger.log(`Telemetry retention skipped: GreptimeDB is not configured (see /admin/settings/telemetry) (job ${job.id})`);
+            return;
+        }
+        if (!this.greptime.isAdminConfigured()) {
+            this.logger.warn('Telemetry retention skipped: the GreptimeDB admin login is not configured ' +
+                '(set it at /admin/settings/telemetry), so the database TTL cannot be changed ' +
+                `(job ${job.id})`);
+            return;
+        }
+        const { retentionDays } = await this.systemSettings.getTelemetryPolicy();
+        const sql = retentionStatement(this.greptime.database, retentionDays);
+        await this.greptime.queryAdmin(sql, { timeoutMs: exports.TELEMETRY_RETENTION_STATEMENT_TIMEOUT_MS });
+        this.logger.log(`Telemetry retention applied: database "${this.greptime.database}" TTL is ${retentionDays} day(s) (job ${job.id})`);
+    }
+};
+exports.TelemetryRetentionHandler = TelemetryRetentionHandler;
+exports.TelemetryRetentionHandler = TelemetryRetentionHandler = TelemetryRetentionHandler_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(ports_1.TELEMETRY_JOBS)),
+    __param(1, (0, common_1.Inject)(ports_1.TELEMETRY_SETTINGS_STORE)),
+    __metadata("design:paramtypes", [Object, Object, greptime_client_1.GreptimeClient])
+], TelemetryRetentionHandler);
+//# sourceMappingURL=telemetry-retention.handler.js.map

package/dist/telemetry/handlers/telemetry-retention.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-retention.handler.js","sourceRoot":"","sources":["../../../src/telemetry/handlers/telemetry-retention.handler.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,kEAAkE;AAClE,gFAAgF;AAChF,EAAE;AACF,yEAAyE;AACzE,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,2EAA2E;AAC3E,wEAAwE;AACxE,yEAAyE;AACzE,oCAAoC;AACpC,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,4EAA4E;AAC5E,kDAAkD;AAClD,EAAE;AACF,4EAA4E;AAC5E,iEAAiE;AACjE,4EAA4E;AAC5E,sDAAsD;AACtD,EAAE;AACF,0EAA0E;AAC1E,sEAAsE;AACtE,wBAAwB;AACxB,EAAE;AACF,8EAA8E;AAC9E,sEAAsE;AACtE,6EAA6E;AAC7E,mDAAmD;AACnD,EAAE;AACF,2EAA2E;AAC3E,uEAAuE;AACvE,sEAAsE;AACtE,6BAA6B;AAC7B,gFAAgF;;;;;;;;;;;;;;;;AA6BhF,gDAaC;AAxCD,2CAA0E;AAE1E,iEAA6D;AAC7D,oCAQkB;AAElB;;;;GAIG;AACU,QAAA,wBAAwB,GAAG,2BAA2B,CAAC;AAEpE,uFAAuF;AAC1E,QAAA,wCAAwC,GAAG,MAAM,CAAC;AAE/D,4EAA4E;AAC5E,MAAM,gBAAgB,GAAG,0BAA0B,CAAC;AAEpD,iFAAiF;AACjF,SAAgB,kBAAkB,CAAC,QAAgB,EAAE,aAAqB;IACxE,mEAAmE;IACnE,wEAAwE;IACxE,8DAA8D;IAC9D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,aAAa,GAAG,CAAC,IAAI,aAAa,GAAG,IAAI,EAAE,CAAC;QAClF,MAAM,IAAI,KAAK,CAAC,uDAAuD,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAC1G,CAAC;IAED,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,6DAA6D,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC5G,CAAC;IAED,OAAO,kBAAkB,QAAQ,eAAe,aAAa,IAAI,CAAC;AACpE,CAAC;AAGM,IAAM,yBAAyB,iCAA/B,MAAM,yBAAyB;IAWO;IACU;IAClC;IAZF,MAAM,GAAG,IAAI,eAAM,CAAC,2BAAyB,CAAC,IAAI,CAAC,CAAC;IAE5D,IAAI,GAAG,gCAAwB,CAAC;IAEzC,uFAAuF;IAC9E,OAAO,GAAiC,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;IAE1F,6EAA6E;IAE7E,YAC2C,IAAuB,EACb,cAAsC,EACxE,QAAwB;QAFA,SAAI,GAAJ,IAAI,CAAmB;QACb,mBAAc,GAAd,cAAc,CAAwB;QACxE,aAAQ,GAAR,QAAQ,CAAgB;IACxC,CAAC;IAEJ,YAAY;QACV,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,yFAAyF;IACzF,KAAK,CAAC,OAAO,CAAC,GAAQ;QACpB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,kGAAkG,GAAG,CAAC,EAAE,GAAG,CAC5G,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,4EAA4E;gBAC1E,+EAA+E;gBAC/E,QAAQ,GAAG,CAAC,EAAE,GAAG,CACpB,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,kBAAkB,EAAE,CAAC;QACzE,MAAM,GAAG,GAAG,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QAEtE,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,gDAAwC,EAAE,CAAC,CAAC;QAE7F,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,0CAA0C,IAAI,CAAC,QAAQ,CAAC,QAAQ,YAAY,aAAa,gBAAgB,GAAG,CAAC,EAAE,GAAG,CACnH,CAAC;IACJ,CAAC;CACF,CAAA;AA/CY,8DAAyB;oCAAzB,yBAAyB;IADrC,IAAA,mBAAU,GAAE;IAYR,WAAA,IAAA,eAAM,EAAC,sBAAc,CAAC,CAAA;IACtB,WAAA,IAAA,eAAM,EAAC,gCAAwB,CAAC,CAAA;qDACN,gCAAc;GAbhC,yBAAyB,CA+CrC"}

package/dist/telemetry/index.d.ts

@@ -0,0 +1,37 @@
+export { TelemetryModule } from './telemetry.module';
+export { TELEMETRY_METRIC_FRESH_MS, TELEMETRY_OPTIONS, TELEMETRY_VERDICT_THRESHOLDS, defaultTelemetryActorId, resolveMetricFreshMs, resolveVerdictThresholds, } from './telemetry.options';
+export type { ResolvedTelemetryModuleOptions, TelemetryDashboardOptions, TelemetryMetricsOptions, TelemetryModuleOptions, VerdictThresholdsOverride, } from './telemetry.options';
+export { DefaultVerdictPolicy, VERDICT_POLICY } from './dashboard/verdict-policy';
+export type { VerdictPolicy } from './dashboard/verdict-policy';
+export { DASHBOARD_VERDICT_THRESHOLDS, DEFAULT_VERDICT_THRESHOLDS, VERDICT_LEVELS, computeVerdict, } from './dashboard/telemetry-dashboard.verdict';
+export type { DashboardVerdict, VerdictCollectorThresholds, VerdictErrorLogThresholds, VerdictInput, VerdictLevel, VerdictLevelThresholds, VerdictThresholds, VerdictUnknownRouteThresholds, } from './dashboard/telemetry-dashboard.verdict';
+export { TELEMETRY_AI, TELEMETRY_APP_INFO, TELEMETRY_AUDIT_SINK, TELEMETRY_CREDENTIAL_STORE, TELEMETRY_JOBS, TELEMETRY_SETTINGS_STORE, } from './ports';
+export type { TelemetryAiError, TelemetryAiInputMessage, TelemetryAiPort, TelemetryAiResponse, TelemetryAiSession, TelemetryAiTool, TelemetryAiToolCallRecord, TelemetryAiToolContext, TelemetryAiToolDefinition, TelemetryAiToolLoopRequest, TelemetryAiToolLoopResult, TelemetryAiToolStep, TelemetryAppInfo, TelemetryAuditEvent, TelemetryAuditSink, TelemetryCredentialInfo, TelemetryCredentialStore, TelemetryDeployInfo, TelemetryFeatureFlag, TelemetryJobExecutionProfile, TelemetryJobHandler, TelemetryJobRecord, TelemetryJobsPort, TelemetrySettingsProvenance, TelemetrySettingsRow, TelemetrySettingsStore, } from './ports';
+export { TelemetryAiEnabledGuard } from './assistant/telemetry-ai-enabled.guard';
+export { TELEMETRY_HOST_PERMISSIONS, TELEMETRY_PERMISSIONS, TELEMETRY_PERMISSION_DECLARATIONS, } from './telemetry.permissions';
+export type { TelemetryPermissionDeclaration } from './telemetry.permissions';
+export { TELEMETRY_SETTINGS_DEFAULTS, TELEMETRY_SETTINGS_DESCRIPTION, TELEMETRY_SETTINGS_NAMESPACE, mergeTelemetrySettings, } from './telemetry.settings';
+export type { TelemetrySettingsPatch } from './telemetry.settings';
+export { TELEMETRY_LIMITS, telemetrySettingsSchema } from '@marinoscar/platform-contract/telemetry';
+export type { TelemetrySettings } from '@marinoscar/platform-contract/telemetry';
+export { GreptimeClient } from './greptime/greptime.client';
+export type { GreptimePool, TelemetryField, TelemetryPingResult, TelemetryQueryOptions, TelemetryQueryResult, } from './greptime/greptime.client';
+export type { HostCheckOptions } from './greptime/greptime-host';
+export { TelemetrySettingsService } from './telemetry-settings.service';
+export { TelemetryQueryService } from './query/telemetry-query.service';
+export type { TelemetryQueryRunOptions, TelemetryQuerySource } from './query/telemetry-query.service';
+export { TelemetrySchemaService } from './query/telemetry-schema.service';
+export { TELEMETRY_ASSISTANT_AUDIT_ACTION } from './assistant/telemetry-assistant.service';
+export { TELEMETRY_RETENTION_TYPE } from './handlers/telemetry-retention.handler';
+export { TELEMETRY_STACK_DEPLOY_TYPE } from './stack/telemetry-stack-deploy.handler';
+export { TELEMETRY_ERROR_REASONS, TelemetryHttpError } from './query/telemetry-query.errors';
+export type { TelemetryErrorReason } from './query/telemetry-query.errors';
+export { analyzeStatement } from './query/sql-guard';
+export type { AnalyzedStatement, TelemetryStatementKind } from './query/sql-guard';
+export { METRIC_FILTER_COLUMNS, METRIC_GROUPS, METRIC_GROUP_ID_PATTERN, METRIC_GROUP_LABELS, isMetricGroup, metricGroupIds, metricGroupRegistry, metricGroups, registerMetricGroups, } from './metrics/metric-catalog';
+export { METRIC_FRESH_MS } from './metrics/metric-group';
+export { MetricGroupRegistry, registerMetricGroup } from './metrics/metric-group-registry.service';
+export type { MetricGroupDefinition } from './metrics/metric-group-registry.service';
+export type { BucketAggregate, CounterFamily, GaugeFamily, HistogramFamily, MetricFamily, MetricFilterKey, MetricGroup, MetricGroupDef, MetricGroupIds, MetricPredicate, MetricRatio, MetricRef, MetricTableDerived, MetricTablePart, MetricTableSpec, MetricUnit, MetricVerdictThresholds, SeriesAggregate, TileAggregate, } from './metrics/metric-catalog';
+export { LOGS_TABLE, REQUIRED_LOG_COLUMNS, REQUIRED_TRACE_COLUMNS, TRACES_TABLE } from './dashboard/telemetry-dashboard.sql';
+//# sourceMappingURL=index.d.ts.map

package/dist/telemetry/index.d.ts.map

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

package/dist/telemetry/index.js

@@ -0,0 +1,97 @@
+"use strict";
+// `@marinoscar/platform-api/telemetry`: the telemetry slice (epic #528, packaged
+// by issue #703). Documented in ./README.md. Explicit named exports only.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricGroupRegistry = exports.METRIC_FRESH_MS = exports.registerMetricGroups = exports.metricGroups = exports.metricGroupRegistry = exports.metricGroupIds = exports.isMetricGroup = exports.METRIC_GROUP_LABELS = exports.METRIC_GROUP_ID_PATTERN = exports.METRIC_GROUPS = exports.METRIC_FILTER_COLUMNS = exports.analyzeStatement = exports.TelemetryHttpError = exports.TELEMETRY_ERROR_REASONS = exports.TELEMETRY_STACK_DEPLOY_TYPE = exports.TELEMETRY_RETENTION_TYPE = exports.TELEMETRY_ASSISTANT_AUDIT_ACTION = exports.TelemetrySchemaService = exports.TelemetryQueryService = exports.TelemetrySettingsService = exports.GreptimeClient = exports.telemetrySettingsSchema = exports.TELEMETRY_LIMITS = exports.mergeTelemetrySettings = exports.TELEMETRY_SETTINGS_NAMESPACE = exports.TELEMETRY_SETTINGS_DESCRIPTION = exports.TELEMETRY_SETTINGS_DEFAULTS = exports.TELEMETRY_PERMISSION_DECLARATIONS = exports.TELEMETRY_PERMISSIONS = exports.TELEMETRY_HOST_PERMISSIONS = exports.TelemetryAiEnabledGuard = exports.TELEMETRY_SETTINGS_STORE = exports.TELEMETRY_JOBS = exports.TELEMETRY_CREDENTIAL_STORE = exports.TELEMETRY_AUDIT_SINK = exports.TELEMETRY_APP_INFO = exports.TELEMETRY_AI = exports.computeVerdict = exports.VERDICT_LEVELS = exports.DEFAULT_VERDICT_THRESHOLDS = exports.DASHBOARD_VERDICT_THRESHOLDS = exports.VERDICT_POLICY = exports.DefaultVerdictPolicy = exports.resolveVerdictThresholds = exports.resolveMetricFreshMs = exports.defaultTelemetryActorId = exports.TELEMETRY_VERDICT_THRESHOLDS = exports.TELEMETRY_OPTIONS = exports.TELEMETRY_METRIC_FRESH_MS = exports.TelemetryModule = void 0;
+exports.TRACES_TABLE = exports.REQUIRED_TRACE_COLUMNS = exports.REQUIRED_LOG_COLUMNS = exports.LOGS_TABLE = exports.registerMetricGroup = void 0;
+// ---- the module and its options (rung 1) ------------------------------------------
+var telemetry_module_1 = require("./telemetry.module");
+Object.defineProperty(exports, "TelemetryModule", { enumerable: true, get: function () { return telemetry_module_1.TelemetryModule; } });
+var telemetry_options_1 = require("./telemetry.options");
+Object.defineProperty(exports, "TELEMETRY_METRIC_FRESH_MS", { enumerable: true, get: function () { return telemetry_options_1.TELEMETRY_METRIC_FRESH_MS; } });
+Object.defineProperty(exports, "TELEMETRY_OPTIONS", { enumerable: true, get: function () { return telemetry_options_1.TELEMETRY_OPTIONS; } });
+Object.defineProperty(exports, "TELEMETRY_VERDICT_THRESHOLDS", { enumerable: true, get: function () { return telemetry_options_1.TELEMETRY_VERDICT_THRESHOLDS; } });
+Object.defineProperty(exports, "defaultTelemetryActorId", { enumerable: true, get: function () { return telemetry_options_1.defaultTelemetryActorId; } });
+Object.defineProperty(exports, "resolveMetricFreshMs", { enumerable: true, get: function () { return telemetry_options_1.resolveMetricFreshMs; } });
+Object.defineProperty(exports, "resolveVerdictThresholds", { enumerable: true, get: function () { return telemetry_options_1.resolveVerdictThresholds; } });
+// ---- the dashboard's verdict: thresholds (rung 1) and policy (rung 3) -------------
+var verdict_policy_1 = require("./dashboard/verdict-policy");
+Object.defineProperty(exports, "DefaultVerdictPolicy", { enumerable: true, get: function () { return verdict_policy_1.DefaultVerdictPolicy; } });
+Object.defineProperty(exports, "VERDICT_POLICY", { enumerable: true, get: function () { return verdict_policy_1.VERDICT_POLICY; } });
+var telemetry_dashboard_verdict_1 = require("./dashboard/telemetry-dashboard.verdict");
+Object.defineProperty(exports, "DASHBOARD_VERDICT_THRESHOLDS", { enumerable: true, get: function () { return telemetry_dashboard_verdict_1.DASHBOARD_VERDICT_THRESHOLDS; } });
+Object.defineProperty(exports, "DEFAULT_VERDICT_THRESHOLDS", { enumerable: true, get: function () { return telemetry_dashboard_verdict_1.DEFAULT_VERDICT_THRESHOLDS; } });
+Object.defineProperty(exports, "VERDICT_LEVELS", { enumerable: true, get: function () { return telemetry_dashboard_verdict_1.VERDICT_LEVELS; } });
+Object.defineProperty(exports, "computeVerdict", { enumerable: true, get: function () { return telemetry_dashboard_verdict_1.computeVerdict; } });
+// ---- the host ports: one token per app capability ----------------------------------
+var ports_1 = require("./ports");
+Object.defineProperty(exports, "TELEMETRY_AI", { enumerable: true, get: function () { return ports_1.TELEMETRY_AI; } });
+Object.defineProperty(exports, "TELEMETRY_APP_INFO", { enumerable: true, get: function () { return ports_1.TELEMETRY_APP_INFO; } });
+Object.defineProperty(exports, "TELEMETRY_AUDIT_SINK", { enumerable: true, get: function () { return ports_1.TELEMETRY_AUDIT_SINK; } });
+Object.defineProperty(exports, "TELEMETRY_CREDENTIAL_STORE", { enumerable: true, get: function () { return ports_1.TELEMETRY_CREDENTIAL_STORE; } });
+Object.defineProperty(exports, "TELEMETRY_JOBS", { enumerable: true, get: function () { return ports_1.TELEMETRY_JOBS; } });
+Object.defineProperty(exports, "TELEMETRY_SETTINGS_STORE", { enumerable: true, get: function () { return ports_1.TELEMETRY_SETTINGS_STORE; } });
+var telemetry_ai_enabled_guard_1 = require("./assistant/telemetry-ai-enabled.guard");
+Object.defineProperty(exports, "TelemetryAiEnabledGuard", { enumerable: true, get: function () { return telemetry_ai_enabled_guard_1.TelemetryAiEnabledGuard; } });
+// ---- permissions and the settings namespace, as data for the app's registries -----
+var telemetry_permissions_1 = require("./telemetry.permissions");
+Object.defineProperty(exports, "TELEMETRY_HOST_PERMISSIONS", { enumerable: true, get: function () { return telemetry_permissions_1.TELEMETRY_HOST_PERMISSIONS; } });
+Object.defineProperty(exports, "TELEMETRY_PERMISSIONS", { enumerable: true, get: function () { return telemetry_permissions_1.TELEMETRY_PERMISSIONS; } });
+Object.defineProperty(exports, "TELEMETRY_PERMISSION_DECLARATIONS", { enumerable: true, get: function () { return telemetry_permissions_1.TELEMETRY_PERMISSION_DECLARATIONS; } });
+var telemetry_settings_1 = require("./telemetry.settings");
+Object.defineProperty(exports, "TELEMETRY_SETTINGS_DEFAULTS", { enumerable: true, get: function () { return telemetry_settings_1.TELEMETRY_SETTINGS_DEFAULTS; } });
+Object.defineProperty(exports, "TELEMETRY_SETTINGS_DESCRIPTION", { enumerable: true, get: function () { return telemetry_settings_1.TELEMETRY_SETTINGS_DESCRIPTION; } });
+Object.defineProperty(exports, "TELEMETRY_SETTINGS_NAMESPACE", { enumerable: true, get: function () { return telemetry_settings_1.TELEMETRY_SETTINGS_NAMESPACE; } });
+Object.defineProperty(exports, "mergeTelemetrySettings", { enumerable: true, get: function () { return telemetry_settings_1.mergeTelemetrySettings; } });
+// The namespace's schema is the contract's (#702).
+var telemetry_1 = require("@marinoscar/platform-contract/telemetry");
+Object.defineProperty(exports, "TELEMETRY_LIMITS", { enumerable: true, get: function () { return telemetry_1.TELEMETRY_LIMITS; } });
+Object.defineProperty(exports, "telemetrySettingsSchema", { enumerable: true, get: function () { return telemetry_1.telemetrySettingsSchema; } });
+// ---- the services the module exports (what the app may inject) -------------------
+// Every other provider is internal; an app's test reaches one through the
+// configured module's `providers` (the reference app: `telemetryProviders` in
+// apps/api/src/platform/telemetry/telemetry.config.ts).
+var greptime_client_1 = require("./greptime/greptime.client");
+Object.defineProperty(exports, "GreptimeClient", { enumerable: true, get: function () { return greptime_client_1.GreptimeClient; } });
+var telemetry_settings_service_1 = require("./telemetry-settings.service");
+Object.defineProperty(exports, "TelemetrySettingsService", { enumerable: true, get: function () { return telemetry_settings_service_1.TelemetrySettingsService; } });
+var telemetry_query_service_1 = require("./query/telemetry-query.service");
+Object.defineProperty(exports, "TelemetryQueryService", { enumerable: true, get: function () { return telemetry_query_service_1.TelemetryQueryService; } });
+var telemetry_schema_service_1 = require("./query/telemetry-schema.service");
+Object.defineProperty(exports, "TelemetrySchemaService", { enumerable: true, get: function () { return telemetry_schema_service_1.TelemetrySchemaService; } });
+var telemetry_assistant_service_1 = require("./assistant/telemetry-assistant.service");
+Object.defineProperty(exports, "TELEMETRY_ASSISTANT_AUDIT_ACTION", { enumerable: true, get: function () { return telemetry_assistant_service_1.TELEMETRY_ASSISTANT_AUDIT_ACTION; } });
+// ---- the job types (permanent strings; both server-only) --------------------------
+var telemetry_retention_handler_1 = require("./handlers/telemetry-retention.handler");
+Object.defineProperty(exports, "TELEMETRY_RETENTION_TYPE", { enumerable: true, get: function () { return telemetry_retention_handler_1.TELEMETRY_RETENTION_TYPE; } });
+var telemetry_stack_deploy_handler_1 = require("./stack/telemetry-stack-deploy.handler");
+Object.defineProperty(exports, "TELEMETRY_STACK_DEPLOY_TYPE", { enumerable: true, get: function () { return telemetry_stack_deploy_handler_1.TELEMETRY_STACK_DEPLOY_TYPE; } });
+// ---- errors and the SQL guard -------------------------------------------------------
+var telemetry_query_errors_1 = require("./query/telemetry-query.errors");
+Object.defineProperty(exports, "TELEMETRY_ERROR_REASONS", { enumerable: true, get: function () { return telemetry_query_errors_1.TELEMETRY_ERROR_REASONS; } });
+Object.defineProperty(exports, "TelemetryHttpError", { enumerable: true, get: function () { return telemetry_query_errors_1.TelemetryHttpError; } });
+var sql_guard_1 = require("./query/sql-guard");
+Object.defineProperty(exports, "analyzeStatement", { enumerable: true, get: function () { return sql_guard_1.analyzeStatement; } });
+// ---- the metric catalog and its group registry (rung 2) ---------------------------
+var metric_catalog_1 = require("./metrics/metric-catalog");
+Object.defineProperty(exports, "METRIC_FILTER_COLUMNS", { enumerable: true, get: function () { return metric_catalog_1.METRIC_FILTER_COLUMNS; } });
+Object.defineProperty(exports, "METRIC_GROUPS", { enumerable: true, get: function () { return metric_catalog_1.METRIC_GROUPS; } });
+Object.defineProperty(exports, "METRIC_GROUP_ID_PATTERN", { enumerable: true, get: function () { return metric_catalog_1.METRIC_GROUP_ID_PATTERN; } });
+Object.defineProperty(exports, "METRIC_GROUP_LABELS", { enumerable: true, get: function () { return metric_catalog_1.METRIC_GROUP_LABELS; } });
+Object.defineProperty(exports, "isMetricGroup", { enumerable: true, get: function () { return metric_catalog_1.isMetricGroup; } });
+Object.defineProperty(exports, "metricGroupIds", { enumerable: true, get: function () { return metric_catalog_1.metricGroupIds; } });
+Object.defineProperty(exports, "metricGroupRegistry", { enumerable: true, get: function () { return metric_catalog_1.metricGroupRegistry; } });
+Object.defineProperty(exports, "metricGroups", { enumerable: true, get: function () { return metric_catalog_1.metricGroups; } });
+Object.defineProperty(exports, "registerMetricGroups", { enumerable: true, get: function () { return metric_catalog_1.registerMetricGroups; } });
+var metric_group_1 = require("./metrics/metric-group");
+Object.defineProperty(exports, "METRIC_FRESH_MS", { enumerable: true, get: function () { return metric_group_1.METRIC_FRESH_MS; } });
+var metric_group_registry_service_1 = require("./metrics/metric-group-registry.service");
+Object.defineProperty(exports, "MetricGroupRegistry", { enumerable: true, get: function () { return metric_group_registry_service_1.MetricGroupRegistry; } });
+Object.defineProperty(exports, "registerMetricGroup", { enumerable: true, get: function () { return metric_group_registry_service_1.registerMetricGroup; } });
+// ---- the dashboard ------------------------------------------------------------------
+var telemetry_dashboard_sql_1 = require("./dashboard/telemetry-dashboard.sql");
+Object.defineProperty(exports, "LOGS_TABLE", { enumerable: true, get: function () { return telemetry_dashboard_sql_1.LOGS_TABLE; } });
+Object.defineProperty(exports, "REQUIRED_LOG_COLUMNS", { enumerable: true, get: function () { return telemetry_dashboard_sql_1.REQUIRED_LOG_COLUMNS; } });
+Object.defineProperty(exports, "REQUIRED_TRACE_COLUMNS", { enumerable: true, get: function () { return telemetry_dashboard_sql_1.REQUIRED_TRACE_COLUMNS; } });
+Object.defineProperty(exports, "TRACES_TABLE", { enumerable: true, get: function () { return telemetry_dashboard_sql_1.TRACES_TABLE; } });
+//# sourceMappingURL=index.js.map

package/dist/telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":";AAAA,iFAAiF;AACjF,0EAA0E;;;;AAE1E,sFAAsF;AACtF,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AACxB,yDAO6B;AAN3B,8HAAA,yBAAyB,OAAA;AACzB,sHAAA,iBAAiB,OAAA;AACjB,iIAAA,4BAA4B,OAAA;AAC5B,4HAAA,uBAAuB,OAAA;AACvB,yHAAA,oBAAoB,OAAA;AACpB,6HAAA,wBAAwB,OAAA;AAU1B,sFAAsF;AACtF,6DAAkF;AAAzE,sHAAA,oBAAoB,OAAA;AAAE,gHAAA,cAAc,OAAA;AAE7C,uFAKiD;AAJ/C,2IAAA,4BAA4B,OAAA;AAC5B,yIAAA,0BAA0B,OAAA;AAC1B,6HAAA,cAAc,OAAA;AACd,6HAAA,cAAc,OAAA;AAahB,uFAAuF;AACvF,iCAOiB;AANf,qGAAA,YAAY,OAAA;AACZ,2GAAA,kBAAkB,OAAA;AAClB,6GAAA,oBAAoB,OAAA;AACpB,mHAAA,0BAA0B,OAAA;AAC1B,uGAAA,cAAc,OAAA;AACd,iHAAA,wBAAwB,OAAA;AA8B1B,qFAAiF;AAAxE,qIAAA,uBAAuB,OAAA;AAEhC,sFAAsF;AACtF,iEAIiC;AAH/B,mIAAA,0BAA0B,OAAA;AAC1B,8HAAA,qBAAqB,OAAA;AACrB,0IAAA,iCAAiC,OAAA;AAGnC,2DAK8B;AAJ5B,iIAAA,2BAA2B,OAAA;AAC3B,oIAAA,8BAA8B,OAAA;AAC9B,kIAAA,4BAA4B,OAAA;AAC5B,4HAAA,sBAAsB,OAAA;AAGxB,mDAAmD;AACnD,qEAAoG;AAA3F,6GAAA,gBAAgB,OAAA;AAAE,oHAAA,uBAAuB,OAAA;AAGlD,qFAAqF;AACrF,0EAA0E;AAC1E,8EAA8E;AAC9E,wDAAwD;AACxD,8DAA4D;AAAnD,iHAAA,cAAc,OAAA;AASvB,2EAAwE;AAA/D,sIAAA,wBAAwB,OAAA;AACjC,2EAAwE;AAA/D,gIAAA,qBAAqB,OAAA;AAE9B,6EAA0E;AAAjE,kIAAA,sBAAsB,OAAA;AAC/B,uFAA2F;AAAlF,+IAAA,gCAAgC,OAAA;AAEzC,sFAAsF;AACtF,sFAAkF;AAAzE,uIAAA,wBAAwB,OAAA;AACjC,yFAAqF;AAA5E,6IAAA,2BAA2B,OAAA;AAEpC,wFAAwF;AACxF,yEAA6F;AAApF,iIAAA,uBAAuB,OAAA;AAAE,4HAAA,kBAAkB,OAAA;AAEpD,+CAAqD;AAA5C,6GAAA,gBAAgB,OAAA;AAGzB,sFAAsF;AACtF,2DAUkC;AAThC,uHAAA,qBAAqB,OAAA;AACrB,+GAAA,aAAa,OAAA;AACb,yHAAA,uBAAuB,OAAA;AACvB,qHAAA,mBAAmB,OAAA;AACnB,+GAAA,aAAa,OAAA;AACb,gHAAA,cAAc,OAAA;AACd,qHAAA,mBAAmB,OAAA;AACnB,8GAAA,YAAY,OAAA;AACZ,sHAAA,oBAAoB,OAAA;AAEtB,uDAAyD;AAAhD,+GAAA,eAAe,OAAA;AACxB,yFAAmG;AAA1F,oIAAA,mBAAmB,OAAA;AAAE,oIAAA,mBAAmB,OAAA;AAwBjD,wFAAwF;AACxF,+EAA6H;AAApH,qHAAA,UAAU,OAAA;AAAE,+HAAA,oBAAoB,OAAA;AAAE,iIAAA,sBAAsB,OAAA;AAAE,uHAAA,YAAY,OAAA"}

package/dist/telemetry/internal/blank-secret.d.ts

@@ -0,0 +1,3 @@
+/** Whether `secret` counts as "not supplied". */
+export declare function isBlankSecret(secret: string | null | undefined): secret is null | undefined | '';
+//# sourceMappingURL=blank-secret.d.ts.map

package/dist/telemetry/internal/blank-secret.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blank-secret.d.ts","sourceRoot":"","sources":["../../../src/telemetry/internal/blank-secret.ts"],"names":[],"mappings":"AAOA,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,IAAI,IAAI,GAAG,SAAS,GAAG,EAAE,CAEhG"}

package/dist/telemetry/internal/blank-secret.js

@@ -0,0 +1,14 @@
+"use strict";
+// The credential store's meaning of "blank" on write (issue #703): `undefined`,
+// `null` and `""` mean "no value supplied". Copied from the app's
+// `credentials/credential-internals.ts` (`isBlankSecret`) so the telemetry
+// slice does not import the credentials module; the two must agree, which
+// `internal.spec.ts` pins the rule. Internal to the
+// slice: not exported.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isBlankSecret = isBlankSecret;
+/** Whether `secret` counts as "not supplied". */
+function isBlankSecret(secret) {
+    return secret === undefined || secret === null || secret === '';
+}
+//# sourceMappingURL=blank-secret.js.map

package/dist/telemetry/internal/blank-secret.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blank-secret.js","sourceRoot":"","sources":["../../../src/telemetry/internal/blank-secret.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,kEAAkE;AAClE,2EAA2E;AAC3E,0EAA0E;AAC1E,oDAAoD;AACpD,uBAAuB;;AAGvB,sCAEC;AAHD,iDAAiD;AACjD,SAAgB,aAAa,CAAC,MAAiC;IAC7D,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,EAAE,CAAC;AAClE,CAAC"}

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

@@ -0,0 +1,9 @@
+/** The UTF-8 byte order mark, as the one character it encodes. */
+export declare const UTF8_BOM = "\uFEFF";
+/** What a spreadsheet treats as the start of a formula. */
+export declare const FORMULA_TRIGGER: RegExp;
+/** One field, quoted when RFC 4180 requires it. */
+export declare function csvField(text: string): string;
+/** `text` prefixed with `'` when a spreadsheet would read it as a formula. */
+export declare function neutralizeFormula(text: string): string;
+//# sourceMappingURL=csv.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../../../src/telemetry/internal/csv.ts"],"names":[],"mappings":"AAMA,kEAAkE;AAClE,eAAO,MAAM,QAAQ,WAAW,CAAC;AAEjC,2DAA2D;AAC3D,eAAO,MAAM,eAAe,QAAiB,CAAC;AAE9C,mDAAmD;AACnD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/telemetry/internal/csv.js

@@ -0,0 +1,23 @@
+"use strict";
+// CSV helpers of the telemetry export (issue #703). The same rules as the
+// app's `common/export/csv.ts` (#689): RFC 4180 quoting, a UTF-8 BOM, and a
+// leading `'` on a cell a spreadsheet would read as a formula. Copied so the
+// telemetry slice imports no app code; `internal.spec.ts` pins the same
+// values the app's copy has. Internal to the slice: not exported.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FORMULA_TRIGGER = exports.UTF8_BOM = void 0;
+exports.csvField = csvField;
+exports.neutralizeFormula = neutralizeFormula;
+/** The UTF-8 byte order mark, as the one character it encodes. */
+exports.UTF8_BOM = '\uFEFF';
+/** What a spreadsheet treats as the start of a formula. */
+exports.FORMULA_TRIGGER = /^[=+\-@\t\r]/;
+/** One field, quoted when RFC 4180 requires it. */
+function csvField(text) {
+    return /[",\r\n]/.test(text) ? `"${text.replace(/"/g, '""')}"` : text;
+}
+/** `text` prefixed with `'` when a spreadsheet would read it as a formula. */
+function neutralizeFormula(text) {
+    return exports.FORMULA_TRIGGER.test(text) ? `'${text}` : text;
+}
+//# sourceMappingURL=csv.js.map

package/dist/telemetry/internal/csv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.js","sourceRoot":"","sources":["../../../src/telemetry/internal/csv.ts"],"names":[],"mappings":";AAAA,0EAA0E;AAC1E,4EAA4E;AAC5E,6EAA6E;AAC7E,wEAAwE;AACxE,kEAAkE;;;AASlE,4BAEC;AAGD,8CAEC;AAdD,kEAAkE;AACrD,QAAA,QAAQ,GAAG,QAAQ,CAAC;AAEjC,2DAA2D;AAC9C,QAAA,eAAe,GAAG,cAAc,CAAC;AAE9C,mDAAmD;AACnD,SAAgB,QAAQ,CAAC,IAAY;IACnC,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACxE,CAAC;AAED,8EAA8E;AAC9E,SAAgB,iBAAiB,CAAC,IAAY;IAC5C,OAAO,uBAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACxD,CAAC"}

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

@@ -0,0 +1,23 @@
+import type { ServerResponse } from 'node:http';
+/** Interval of the `: ping` keep-alive comment. */
+export declare const AI_SSE_HEARTBEAT_MS = 15000;
+/** The response headers of an event stream. */
+export declare const AI_SSE_HEADERS: {
+    readonly 'Content-Type': "text/event-stream; charset=utf-8";
+    readonly 'Cache-Control': "no-cache, no-transform";
+    readonly Connection: "keep-alive";
+    readonly 'X-Accel-Buffering': "no";
+};
+/** Aborted when the client goes away. */
+export interface DisconnectSignal {
+    readonly signal: AbortSignal;
+    /** Stop listening (the response finished normally). */
+    dispose(): void;
+}
+/**
+ * Aborts when the client goes away before the response finished. Listens on
+ * the RESPONSE's `close`, not the request's: an `IncomingMessage` emits
+ * `close` as soon as its body has been consumed.
+ */
+export declare function abortOnDisconnect(res: ServerResponse): DisconnectSignal;
+//# sourceMappingURL=sse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../src/telemetry/internal/sse.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,mDAAmD;AACnD,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAE1C,+CAA+C;AAC/C,eAAO,MAAM,cAAc;;;;;CAMjB,CAAC;AAEX,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,uDAAuD;IACvD,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,gBAAgB,CAYvE"}

package/dist/telemetry/internal/sse.js

@@ -0,0 +1,43 @@
+"use strict";
+// =============================================================================
+// SSE wire helpers of the telemetry assistant (issue #703)
+// =============================================================================
+//
+// The same headers, heartbeat and disconnect signal as the app's
+// `ai/http/ai-sse.ts`, copied so the telemetry slice does not import the AI
+// module's HTTP layer (the platform's core does not own them yet). The values
+// must stay identical to the app's: the assistant stream is proxied by the
+// same nginx location rules. `internal.spec.ts` pins the same values the
+// app's copy has. Internal to the slice: not exported.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AI_SSE_HEADERS = exports.AI_SSE_HEARTBEAT_MS = void 0;
+exports.abortOnDisconnect = abortOnDisconnect;
+/** Interval of the `: ping` keep-alive comment. */
+exports.AI_SSE_HEARTBEAT_MS = 15_000;
+/** The response headers of an event stream. */
+exports.AI_SSE_HEADERS = {
+    'Content-Type': 'text/event-stream; charset=utf-8',
+    'Cache-Control': 'no-cache, no-transform',
+    Connection: 'keep-alive',
+    // nginx: do not buffer this response (the location block also says so).
+    'X-Accel-Buffering': 'no',
+};
+/**
+ * Aborts when the client goes away before the response finished. Listens on
+ * the RESPONSE's `close`, not the request's: an `IncomingMessage` emits
+ * `close` as soon as its body has been consumed.
+ */
+function abortOnDisconnect(res) {
+    const controller = new AbortController();
+    const onClose = () => {
+        if (!res.writableFinished)
+            controller.abort(new Error('Client disconnected'));
+    };
+    res.on('close', onClose);
+    return {
+        signal: controller.signal,
+        dispose: () => res.off('close', onClose),
+    };
+}
+//# sourceMappingURL=sse.js.map

package/dist/telemetry/internal/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../../src/telemetry/internal/sse.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,2DAA2D;AAC3D,gFAAgF;AAChF,EAAE;AACF,iEAAiE;AACjE,4EAA4E;AAC5E,8EAA8E;AAC9E,2EAA2E;AAC3E,yEAAyE;AACzE,uDAAuD;AACvD,gFAAgF;;;AA4BhF,8CAYC;AApCD,mDAAmD;AACtC,QAAA,mBAAmB,GAAG,MAAM,CAAC;AAE1C,+CAA+C;AAClC,QAAA,cAAc,GAAG;IAC5B,cAAc,EAAE,kCAAkC;IAClD,eAAe,EAAE,wBAAwB;IACzC,UAAU,EAAE,YAAY;IACxB,wEAAwE;IACxE,mBAAmB,EAAE,IAAI;CACjB,CAAC;AASX;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,GAAmB;IACnD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,IAAI,CAAC,GAAG,CAAC,gBAAgB;YAAE,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC;IAEF,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAEzB,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC;KACzC,CAAC;AACJ,CAAC"}

package/dist/telemetry/metrics/groups/database.metric-group.d.ts

@@ -0,0 +1,7 @@
+import type { MetricGroupDef } from '../metric-group.registry';
+/**
+ * The `database` metric group (the postgresql receiver: connections, size, commits, cache hits).
+ * The entries moved verbatim from `metric-catalog.ts` (#680); registered by `../metric-group.manifest.ts`.
+ */
+export declare const DATABASE_METRIC_GROUP: MetricGroupDef;
+//# sourceMappingURL=database.metric-group.d.ts.map

package/dist/telemetry/metrics/groups/database.metric-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.metric-group.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/metrics/groups/database.metric-group.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,cAqJnC,CAAC"}

package/dist/telemetry/metrics/groups/database.metric-group.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DATABASE_METRIC_GROUP = void 0;
+const metric_catalog_helpers_1 = require("../metric-catalog.helpers");
+/**
+ * The `database` metric group (the postgresql receiver: connections, size, commits, cache hits).
+ * The entries moved verbatim from `metric-catalog.ts` (#680); registered by `../metric-group.manifest.ts`.
+ */
+exports.DATABASE_METRIC_GROUP = {
+    id: 'database',
+    label: 'Database',
+    title: 'Database',
+    order: 20,
+    description: 'connections, size, commits, rollbacks, deadlocks, cache hit ratio, largest tables',
+    families: [
+        {
+            key: 'dbConnections',
+            group: 'database',
+            label: 'Connections',
+            table: 'postgresql_backends',
+            kind: 'gauge',
+            unit: 'count',
+            requiredColumns: ['instance'],
+            seriesAggregate: 'sum',
+            bucketAggregate: 'max',
+            filters: metric_catalog_helpers_1.HOST_FILTERS,
+        },
+        {
+            key: 'dbConnectionMax',
+            group: 'database',
+            label: 'Max connections',
+            table: 'postgresql_connection_max',
+            kind: 'gauge',
+            unit: 'count',
+            requiredColumns: ['instance'],
+            seriesAggregate: 'max',
+            bucketAggregate: 'max',
+            filters: metric_catalog_helpers_1.HOST_FILTERS,
+            series: false,
+        },
+        {
+            key: 'dbSize',
+            group: 'database',
+            label: 'Database size',
+            table: 'postgresql_db_size_bytes',
+            kind: 'gauge',
+            unit: 'bytes',
+            groupBy: 'postgresql_database_name',
+            requiredColumns: ['postgresql_database_name'],
+            seriesAggregate: 'max',
+            bucketAggregate: 'max',
+            filters: metric_catalog_helpers_1.HOST_FILTERS,
+        },
+        {
+            key: 'dbCommits',
+            group: 'database',
+            label: 'Commits',
+            table: 'postgresql_commits_total',
+            kind: 'counter',
+            unit: 'per_s',
+            rate: 'per_s',
+            requiredColumns: ['postgresql_database_name'],
+            filters: metric_catalog_helpers_1.HOST_FILTERS,
+        },
+        {
+            key: 'dbRollbacks',
+            group: 'database',
+            label: 'Rollbacks',
+            table: 'postgresql_rollbacks_total',
+            kind: 'counter',
+            unit: 'per_s',
+            rate: 'per_s',
+            requiredColumns: ['postgresql_database_name'],
+            filters: metric_catalog_helpers_1.HOST_FILTERS,
+        },
+        {
+            key: 'dbDeadlocks',
+            group: 'database',
+            label: 'Deadlocks',
+            table: 'postgresql_deadlocks_total',
+            kind: 'counter',
+            unit: 'count',
+            rate: 'count',
+            requiredColumns: ['postgresql_database_name'],
+            filters: metric_catalog_helpers_1.HOST_FILTERS,
+        },
+        {
+            key: 'dbBlocksHit',
+            group: 'database',
+            label: 'Blocks hit',
+            table: 'postgresql_blks_hit_total',
+            kind: 'counter',
+            unit: 'count',
+            rate: 'count',
+            requiredColumns: ['postgresql_database_name'],
+            filters: metric_catalog_helpers_1.HOST_FILTERS,
+            tile: false,
+            series: false,
+        },
+        {
+            key: 'dbBlocksRead',
+            group: 'database',
+            label: 'Blocks read',
+            table: 'postgresql_blks_read_total',
+            kind: 'counter',
+            unit: 'count',
+            rate: 'count',
+            requiredColumns: ['postgresql_database_name'],
+            filters: metric_catalog_helpers_1.HOST_FILTERS,
+            tile: false,
+            series: false,
+        },
+    ],
+    ratios: [
+        {
+            key: 'dbConnectionUtilization',
+            group: 'database',
+            label: 'Connections used',
+            unit: '%',
+            numerator: [{ family: 'dbConnections' }],
+            denominator: [{ family: 'dbConnectionMax' }],
+            scale: 100,
+            verdict: { ...metric_catalog_helpers_1.T.dbConnectionsPct, direction: 'above' },
+        },
+        {
+            key: 'dbCacheHitRatio',
+            group: 'database',
+            label: 'Cache hit ratio',
+            unit: '%',
+            numerator: [{ family: 'dbBlocksHit' }],
+            denominator: [{ family: 'dbBlocksRead' }],
+            addNumerator: true,
+            scale: 100,
+        },
+    ],
+    tables: [
+        {
+            key: 'largestTables',
+            group: 'database',
+            label: 'Largest tables',
+            keyColumn: 'postgresql_table_name',
+            keyLabel: 'Table',
+            filters: metric_catalog_helpers_1.HOST_FILTERS,
+            orderByValue: true,
+            maxRows: metric_catalog_helpers_1.LARGEST_TABLES_MAX_ROWS,
+            parts: [
+                {
+                    column: 'sizeBytes',
+                    label: 'Size',
+                    unit: 'bytes',
+                    table: 'postgresql_table_size_bytes',
+                    seriesAggregate: 'max',
+                    over: 'last',
+                },
+            ],
+        },
+    ],
+};
+//# sourceMappingURL=database.metric-group.js.map

package/dist/telemetry/metrics/groups/database.metric-group.js.map

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