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

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

@@ -0,0 +1,10 @@
+export { APP_ACTIVITY_METRIC_TAGS, APP_SAMPLE_METRIC_TAGS, VERIFIED_METRIC_TAGS, appActivityMetricSchema, appSampleMetricSchema, metricCatalogSchema, metricTableSchema, } from './metric-schema.fixture';
+export { COACH_METRIC_GROUP, COACH_METRIC_GROUP_ID } from './coach-metric-group.fixture';
+export { assistantMetricWindow, NODE_FLAGS } from '../assistant/telemetry-assistant.metrics';
+export { buildTelemetryAssistantInstructions } from '../assistant/telemetry-assistant.service';
+export type { MetricGroupWindow } from '../metrics/metric-group';
+export { CONFORMANCE_SECRETS, TELEMETRY_CRON_FILE, bootStubApp, checkBootsWithoutTelemetry, checkCronCoverage, checkDoctorReadOnly, checkMetricGroups, checkMetricGroupsOnEmptySchema, checkNoSecretsInResponses, checkRoutePermissions, discoverDoctorChecks, discoverRoutes, telemetryConformanceSuite, } from './conformance';
+export type { ComputeMetricGroup, ComputedMetricGroup, ConformanceSecrets, CreateConformanceApp, StubAppInput, TelemetryConformanceOptions, TelemetryRoute, } from './conformance';
+export { createStubTelemetryPorts } from './stub-ports';
+export type { StubTelemetryPortsOptions, StubTelemetryPortsState } from './stub-ports';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/telemetry/testing/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAC7F,OAAO,EAAE,mCAAmC,EAAE,MAAM,0CAA0C,CAAC;AAC/F,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAIjE,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,0BAA0B,EAC1B,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,8BAA8B,EAC9B,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,EACZ,2BAA2B,EAC3B,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC"}

package/dist/telemetry/testing/index.js

@@ -0,0 +1,41 @@
+"use strict";
+// `@marinoscar/platform-api/telemetry/testing`: test fixtures and seams of the
+// telemetry slice (issue #703), for an app's own tests. Never import it from
+// production code. Documented in ../README.md.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStubTelemetryPorts = exports.telemetryConformanceSuite = exports.discoverRoutes = exports.discoverDoctorChecks = exports.checkRoutePermissions = exports.checkNoSecretsInResponses = exports.checkMetricGroupsOnEmptySchema = exports.checkMetricGroups = exports.checkDoctorReadOnly = exports.checkCronCoverage = exports.checkBootsWithoutTelemetry = exports.bootStubApp = exports.TELEMETRY_CRON_FILE = exports.CONFORMANCE_SECRETS = exports.buildTelemetryAssistantInstructions = exports.NODE_FLAGS = exports.assistantMetricWindow = exports.COACH_METRIC_GROUP_ID = exports.COACH_METRIC_GROUP = exports.metricTableSchema = exports.metricCatalogSchema = exports.appSampleMetricSchema = exports.appActivityMetricSchema = exports.VERIFIED_METRIC_TAGS = exports.APP_SAMPLE_METRIC_TAGS = exports.APP_ACTIVITY_METRIC_TAGS = void 0;
+var metric_schema_fixture_1 = require("./metric-schema.fixture");
+Object.defineProperty(exports, "APP_ACTIVITY_METRIC_TAGS", { enumerable: true, get: function () { return metric_schema_fixture_1.APP_ACTIVITY_METRIC_TAGS; } });
+Object.defineProperty(exports, "APP_SAMPLE_METRIC_TAGS", { enumerable: true, get: function () { return metric_schema_fixture_1.APP_SAMPLE_METRIC_TAGS; } });
+Object.defineProperty(exports, "VERIFIED_METRIC_TAGS", { enumerable: true, get: function () { return metric_schema_fixture_1.VERIFIED_METRIC_TAGS; } });
+Object.defineProperty(exports, "appActivityMetricSchema", { enumerable: true, get: function () { return metric_schema_fixture_1.appActivityMetricSchema; } });
+Object.defineProperty(exports, "appSampleMetricSchema", { enumerable: true, get: function () { return metric_schema_fixture_1.appSampleMetricSchema; } });
+Object.defineProperty(exports, "metricCatalogSchema", { enumerable: true, get: function () { return metric_schema_fixture_1.metricCatalogSchema; } });
+Object.defineProperty(exports, "metricTableSchema", { enumerable: true, get: function () { return metric_schema_fixture_1.metricTableSchema; } });
+var coach_metric_group_fixture_1 = require("./coach-metric-group.fixture");
+Object.defineProperty(exports, "COACH_METRIC_GROUP", { enumerable: true, get: function () { return coach_metric_group_fixture_1.COACH_METRIC_GROUP; } });
+Object.defineProperty(exports, "COACH_METRIC_GROUP_ID", { enumerable: true, get: function () { return coach_metric_group_fixture_1.COACH_METRIC_GROUP_ID; } });
+var telemetry_assistant_metrics_1 = require("../assistant/telemetry-assistant.metrics");
+Object.defineProperty(exports, "assistantMetricWindow", { enumerable: true, get: function () { return telemetry_assistant_metrics_1.assistantMetricWindow; } });
+Object.defineProperty(exports, "NODE_FLAGS", { enumerable: true, get: function () { return telemetry_assistant_metrics_1.NODE_FLAGS; } });
+var telemetry_assistant_service_1 = require("../assistant/telemetry-assistant.service");
+Object.defineProperty(exports, "buildTelemetryAssistantInstructions", { enumerable: true, get: function () { return telemetry_assistant_service_1.buildTelemetryAssistantInstructions; } });
+// The telemetry conformance suite (PP-4.6): importing this entry registers the
+// `telemetry` suite with `runPlatformConformance` (@marinoscar/platform-api/testing).
+var conformance_1 = require("./conformance");
+Object.defineProperty(exports, "CONFORMANCE_SECRETS", { enumerable: true, get: function () { return conformance_1.CONFORMANCE_SECRETS; } });
+Object.defineProperty(exports, "TELEMETRY_CRON_FILE", { enumerable: true, get: function () { return conformance_1.TELEMETRY_CRON_FILE; } });
+Object.defineProperty(exports, "bootStubApp", { enumerable: true, get: function () { return conformance_1.bootStubApp; } });
+Object.defineProperty(exports, "checkBootsWithoutTelemetry", { enumerable: true, get: function () { return conformance_1.checkBootsWithoutTelemetry; } });
+Object.defineProperty(exports, "checkCronCoverage", { enumerable: true, get: function () { return conformance_1.checkCronCoverage; } });
+Object.defineProperty(exports, "checkDoctorReadOnly", { enumerable: true, get: function () { return conformance_1.checkDoctorReadOnly; } });
+Object.defineProperty(exports, "checkMetricGroups", { enumerable: true, get: function () { return conformance_1.checkMetricGroups; } });
+Object.defineProperty(exports, "checkMetricGroupsOnEmptySchema", { enumerable: true, get: function () { return conformance_1.checkMetricGroupsOnEmptySchema; } });
+Object.defineProperty(exports, "checkNoSecretsInResponses", { enumerable: true, get: function () { return conformance_1.checkNoSecretsInResponses; } });
+Object.defineProperty(exports, "checkRoutePermissions", { enumerable: true, get: function () { return conformance_1.checkRoutePermissions; } });
+Object.defineProperty(exports, "discoverDoctorChecks", { enumerable: true, get: function () { return conformance_1.discoverDoctorChecks; } });
+Object.defineProperty(exports, "discoverRoutes", { enumerable: true, get: function () { return conformance_1.discoverRoutes; } });
+Object.defineProperty(exports, "telemetryConformanceSuite", { enumerable: true, get: function () { return conformance_1.telemetryConformanceSuite; } });
+var stub_ports_1 = require("./stub-ports");
+Object.defineProperty(exports, "createStubTelemetryPorts", { enumerable: true, get: function () { return stub_ports_1.createStubTelemetryPorts; } });
+//# sourceMappingURL=index.js.map

package/dist/telemetry/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/telemetry/testing/index.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,6EAA6E;AAC7E,+CAA+C;;;AAE/C,iEAQiC;AAP/B,iIAAA,wBAAwB,OAAA;AACxB,+HAAA,sBAAsB,OAAA;AACtB,6HAAA,oBAAoB,OAAA;AACpB,gIAAA,uBAAuB,OAAA;AACvB,8HAAA,qBAAqB,OAAA;AACrB,4HAAA,mBAAmB,OAAA;AACnB,0HAAA,iBAAiB,OAAA;AAEnB,2EAAyF;AAAhF,gIAAA,kBAAkB,OAAA;AAAE,mIAAA,qBAAqB,OAAA;AAClD,wFAA6F;AAApF,oIAAA,qBAAqB,OAAA;AAAE,yHAAA,UAAU,OAAA;AAC1C,wFAA+F;AAAtF,kJAAA,mCAAmC,OAAA;AAG5C,+EAA+E;AAC/E,sFAAsF;AACtF,6CAcuB;AAbrB,kHAAA,mBAAmB,OAAA;AACnB,kHAAA,mBAAmB,OAAA;AACnB,0GAAA,WAAW,OAAA;AACX,yHAAA,0BAA0B,OAAA;AAC1B,gHAAA,iBAAiB,OAAA;AACjB,kHAAA,mBAAmB,OAAA;AACnB,gHAAA,iBAAiB,OAAA;AACjB,6HAAA,8BAA8B,OAAA;AAC9B,wHAAA,yBAAyB,OAAA;AACzB,oHAAA,qBAAqB,OAAA;AACrB,mHAAA,oBAAoB,OAAA;AACpB,6GAAA,cAAc,OAAA;AACd,wHAAA,yBAAyB,OAAA;AAW3B,2CAAwD;AAA/C,sHAAA,wBAAwB,OAAA"}

package/dist/telemetry/testing/metric-schema.fixture.d.ts

@@ -0,0 +1,73 @@
+import type { TelemetrySchema } from '../dto/telemetry-query.dto';
+/**
+ * The tag columns of every metric table the platform catalog reads, as the
+ * collector and the API's OTLP exporter write them (verified against a live
+ * store).
+ *
+ * @stability experimental
+ */
+export declare const VERIFIED_METRIC_TAGS: Record<string, readonly string[]>;
+/**
+ * The schema entry of one verified metric table (semantic types reported, as the store does).
+ *
+ * @param name - the table.
+ * @param tags - its tag columns; default its verified ones.
+ * @returns the table as `TelemetrySchemaService` reports it.
+ *
+ * @stability experimental
+ */
+export declare function metricTableSchema(name: string, tags?: readonly string[]): TelemetrySchema['tables'][number];
+/**
+ * A schema holding every verified metric table (or only `only`).
+ *
+ * @param only - the table names to include; default all of them.
+ * @returns the schema.
+ *
+ * @stability experimental
+ */
+export declare function metricCatalogSchema(only?: readonly string[]): TelemetrySchema;
+/**
+ * Tag columns of the `app_*` metric tables an app emits with its own
+ * `AppMetricsService`, shaped like EvoPath's AI Coach (issue #703, PP-4.6): the
+ * counters and the histogram its `coach` group reads. They are written by the
+ * API's OTLP exporter exactly like the platform's `app_jobs_*` tables
+ * (`app_instance_id`, `host_name`, `job` and `service_name` come with every
+ * table, then one tag per declared attribute) and are named by the table rule of
+ * the telemetry spec. Not part of the platform catalog; the readiness test and
+ * the registry tests register an app group over them.
+ *
+ * @stability experimental
+ */
+export declare const APP_SAMPLE_METRIC_TAGS: Record<string, readonly string[]>;
+/**
+ * A schema holding the app sample tables of {@link APP_SAMPLE_METRIC_TAGS}
+ * (or only `only`).
+ *
+ * @param only - the table names to include; default all of them.
+ * @returns the schema.
+ *
+ * @stability experimental
+ */
+export declare function appSampleMetricSchema(only?: readonly string[]): TelemetrySchema;
+/**
+ * Tag columns of the five `app_*` counter tables the reference app's `activity`
+ * group reads (`app.auth.logins`, `app.auth.refreshes`, `app.ai.requests`,
+ * `app.ai.tokens`, `app.notifications.deliveries`). The tag set is the metric's
+ * declared attributes (`apps/api/src/common/otel/platform-app-metrics.ts`) plus
+ * the four every `app_*` table carries; the names follow the spec's table
+ * naming rule (dots become `_`, `_total` appended).
+ *
+ * @stability experimental
+ */
+export declare const APP_ACTIVITY_METRIC_TAGS: Record<string, readonly string[]>;
+/**
+ * A schema holding the activity tables of {@link APP_ACTIVITY_METRIC_TAGS}
+ * (or only `only`).
+ *
+ * @param only - the table names to include; default all of them.
+ * @returns the schema.
+ *
+ * @stability experimental
+ */
+export declare function appActivityMetricSchema(only?: readonly string[]): TelemetrySchema;
+//# sourceMappingURL=metric-schema.fixture.d.ts.map

package/dist/telemetry/testing/metric-schema.fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-schema.fixture.d.ts","sourceRoot":"","sources":["../../../src/telemetry/testing/metric-schema.fixture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAoBlE;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CA0OlE,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,oBAA6B,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAUpH;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,CAG7E;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAOpE,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,CAG/E;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAMtE,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,CAGjF"}

package/dist/telemetry/testing/metric-schema.fixture.js

@@ -0,0 +1,362 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APP_ACTIVITY_METRIC_TAGS = exports.APP_SAMPLE_METRIC_TAGS = exports.VERIFIED_METRIC_TAGS = void 0;
+exports.metricTableSchema = metricTableSchema;
+exports.metricCatalogSchema = metricCatalogSchema;
+exports.appSampleMetricSchema = appSampleMetricSchema;
+exports.appActivityMetricSchema = appActivityMetricSchema;
+// =============================================================================
+// Test fixture: the metric tables the catalog reads, as the store reports them
+// (issue #601)
+// =============================================================================
+//
+// Tag columns per table, copied from `information_schema.columns` of a
+// GreptimeDB v1.2.1 fed by collector 0.145.0 (hostmetrics, prometheus/self,
+// postgresql, httpcheck, nginx — the configuration of
+// infra/otel/otel-collector-config.yaml) and by the API's OTLP metric exporter
+// (2026-09-30). `httpcheck_tls_cert_remaining_seconds` is only written for an
+// `https://` target and is taken from docs/specs/telemetry.md §11.3. Every
+// table also has `greptime_timestamp` (TIMESTAMP) and `greptime_value`
+// (FIELD, Float64).
+//
+// Used by the unit tests (as a `TelemetrySchema`) and by the live GreptimeDB
+// tier (to create look-alike tables).
+// =============================================================================
+/**
+ * The tag columns of every metric table the platform catalog reads, as the
+ * collector and the API's OTLP exporter write them (verified against a live
+ * store).
+ *
+ * @stability experimental
+ */
+exports.VERIFIED_METRIC_TAGS = {
+    app_backup_last_success_timestamp_seconds: [
+        'app_instance_id',
+        'host_name',
+        'job',
+        'service_name',
+    ],
+    app_jobs_duration_seconds_bucket: [
+        'app_instance_id',
+        'executor',
+        'host_name',
+        'job',
+        'job_type',
+        'le',
+        'outcome',
+        'service_name',
+    ],
+    app_jobs_oldest_pending_age_seconds: [
+        'app_instance_id',
+        'host_name',
+        'job',
+        'job_type',
+        'service_name',
+    ],
+    app_jobs_queue_depth: [
+        'app_instance_id',
+        'host_name',
+        'job',
+        'job_type',
+        'service_name',
+        'status',
+    ],
+    app_jobs_settled_total: [
+        'app_instance_id',
+        'executor',
+        'host_name',
+        'job',
+        'job_type',
+        'outcome',
+        'service_name',
+    ],
+    app_nodes_count: ['app_instance_id', 'health', 'host_name', 'job', 'service_name', 'status'],
+    app_nodes_cpu_utilization: [
+        'app_instance_id',
+        'host_name',
+        'job',
+        'node_id',
+        'node_name',
+        'service_name',
+    ],
+    app_nodes_heap_limit_bytes: [
+        'app_instance_id',
+        'host_name',
+        'job',
+        'node_id',
+        'node_name',
+        'service_name',
+    ],
+    app_nodes_heap_used_bytes: [
+        'app_instance_id',
+        'host_name',
+        'job',
+        'node_id',
+        'node_name',
+        'service_name',
+    ],
+    app_nodes_memory_rss_bytes: [
+        'app_instance_id',
+        'host_name',
+        'job',
+        'node_id',
+        'node_name',
+        'service_name',
+    ],
+    app_nodes_slots_total: [
+        'app_instance_id',
+        'host_name',
+        'job',
+        'node_id',
+        'node_name',
+        'service_name',
+    ],
+    app_nodes_slots_used: [
+        'app_instance_id',
+        'host_name',
+        'job',
+        'node_id',
+        'node_name',
+        'service_name',
+    ],
+    app_nodes_state_dir_free_bytes: [
+        'app_instance_id',
+        'host_name',
+        'job',
+        'node_id',
+        'node_name',
+        'service_name',
+    ],
+    app_nodes_state_dir_total_bytes: [
+        'app_instance_id',
+        'host_name',
+        'job',
+        'node_id',
+        'node_name',
+        'service_name',
+    ],
+    app_nodes_types_no_eligible_node: [
+        'app_instance_id',
+        'host_name',
+        'job',
+        'job_type',
+        'service_name',
+    ],
+    greptime_mito_write_stalling_count: [
+        'host_name',
+        'instance',
+        'job',
+        'service_instance_id',
+        'service_name',
+        'worker',
+    ],
+    httpcheck_duration_milliseconds: ['host_name', 'http_url'],
+    httpcheck_error: ['error_message', 'host_name', 'http_url'],
+    httpcheck_status: [
+        'host_name',
+        'http_method',
+        'http_status_class',
+        'http_status_code',
+        'http_url',
+    ],
+    httpcheck_tls_cert_remaining_seconds: ['host_name', 'http_tls_cn', 'http_tls_issuer', 'http_url'],
+    nginx_connections_current: ['host_name', 'state'],
+    nginx_requests_total: ['host_name'],
+    otelcol_exporter_queue_capacity: [
+        'data_type',
+        'exporter',
+        'host_name',
+        'instance',
+        'job',
+        'service_instance_id',
+        'service_name',
+        'service_version',
+    ],
+    otelcol_exporter_queue_size: [
+        'data_type',
+        'exporter',
+        'host_name',
+        'instance',
+        'job',
+        'service_instance_id',
+        'service_name',
+        'service_version',
+    ],
+    otelcol_exporter_send_failed_metric_points_total: [
+        'exporter',
+        'host_name',
+        'instance',
+        'job',
+        'service_instance_id',
+        'service_name',
+        'service_version',
+    ],
+    otelcol_exporter_sent_metric_points_total: [
+        'exporter',
+        'host_name',
+        'instance',
+        'job',
+        'service_instance_id',
+        'service_name',
+        'service_version',
+    ],
+    otelcol_receiver_refused_metric_points_total: [
+        'host_name',
+        'instance',
+        'job',
+        'receiver',
+        'service_instance_id',
+        'service_name',
+        'service_version',
+        'transport',
+    ],
+    postgresql_backends: ['host_name', 'instance', 'postgresql_database_name', 'service_instance_id'],
+    postgresql_blks_hit_total: [
+        'host_name',
+        'instance',
+        'postgresql_database_name',
+        'service_instance_id',
+    ],
+    postgresql_blks_read_total: [
+        'host_name',
+        'instance',
+        'postgresql_database_name',
+        'service_instance_id',
+    ],
+    postgresql_commits_total: [
+        'host_name',
+        'instance',
+        'postgresql_database_name',
+        'service_instance_id',
+    ],
+    postgresql_connection_max: ['host_name', 'instance', 'service_instance_id'],
+    postgresql_db_size_bytes: [
+        'host_name',
+        'instance',
+        'postgresql_database_name',
+        'service_instance_id',
+    ],
+    postgresql_deadlocks_total: [
+        'host_name',
+        'instance',
+        'postgresql_database_name',
+        'service_instance_id',
+    ],
+    postgresql_rollbacks_total: [
+        'host_name',
+        'instance',
+        'postgresql_database_name',
+        'service_instance_id',
+    ],
+    postgresql_table_size_bytes: [
+        'host_name',
+        'instance',
+        'postgresql_database_name',
+        'postgresql_table_name',
+        'service_instance_id',
+    ],
+    system_cpu_load_average_1m: ['host_name'],
+    system_cpu_utilization_ratio: ['cpu', 'host_name', 'state'],
+    system_disk_io_bytes_total: ['device', 'direction', 'host_name'],
+    system_filesystem_usage_bytes: ['device', 'host_name', 'mode', 'mountpoint', 'state', 'type'],
+    system_filesystem_utilization_ratio: ['device', 'host_name', 'mode', 'mountpoint', 'type'],
+    system_memory_utilization_ratio: ['host_name', 'state'],
+    system_network_io_bytes_total: ['device', 'direction', 'host_name'],
+    up: ['host_name', 'instance', 'job', 'service_instance_id', 'service_name', 'service_version'],
+};
+/**
+ * The schema entry of one verified metric table (semantic types reported, as the store does).
+ *
+ * @param name - the table.
+ * @param tags - its tag columns; default its verified ones.
+ * @returns the table as `TelemetrySchemaService` reports it.
+ *
+ * @stability experimental
+ */
+function metricTableSchema(name, tags = exports.VERIFIED_METRIC_TAGS[name]) {
+    return {
+        name,
+        rows: null,
+        columns: [
+            { name: 'greptime_timestamp', type: 'timestamp(3)', semanticType: 'TIMESTAMP' },
+            { name: 'greptime_value', type: 'double', semanticType: 'FIELD' },
+            ...tags.map((tag) => ({ name: tag, type: 'string', semanticType: 'TAG' })),
+        ],
+    };
+}
+/**
+ * A schema holding every verified metric table (or only `only`).
+ *
+ * @param only - the table names to include; default all of them.
+ * @returns the schema.
+ *
+ * @stability experimental
+ */
+function metricCatalogSchema(only) {
+    const names = only ?? Object.keys(exports.VERIFIED_METRIC_TAGS);
+    return { tables: names.map((name) => metricTableSchema(name)) };
+}
+/**
+ * Tag columns of the `app_*` metric tables an app emits with its own
+ * `AppMetricsService`, shaped like EvoPath's AI Coach (issue #703, PP-4.6): the
+ * counters and the histogram its `coach` group reads. They are written by the
+ * API's OTLP exporter exactly like the platform's `app_jobs_*` tables
+ * (`app_instance_id`, `host_name`, `job` and `service_name` come with every
+ * table, then one tag per declared attribute) and are named by the table rule of
+ * the telemetry spec. Not part of the platform catalog; the readiness test and
+ * the registry tests register an app group over them.
+ *
+ * @stability experimental
+ */
+exports.APP_SAMPLE_METRIC_TAGS = {
+    app_coach_audio_failed_total: ['app_instance_id', 'host_name', 'job', 'provider', 'reason', 'service_name'],
+    app_coach_audio_generated_total: ['app_instance_id', 'host_name', 'job', 'provider', 'service_name'],
+    app_coach_nudge_opened_total: ['app_instance_id', 'channel', 'host_name', 'job', 'persona', 'service_name'],
+    app_coach_nudge_sent_total: ['app_instance_id', 'channel', 'host_name', 'job', 'persona', 'service_name'],
+    app_coach_nudge_suppressed_total: ['app_instance_id', 'host_name', 'job', 'persona', 'reason', 'service_name'],
+    app_health_summary_duration_seconds_bucket: ['app_instance_id', 'host_name', 'job', 'le', 'outcome', 'service_name'],
+};
+/**
+ * A schema holding the app sample tables of {@link APP_SAMPLE_METRIC_TAGS}
+ * (or only `only`).
+ *
+ * @param only - the table names to include; default all of them.
+ * @returns the schema.
+ *
+ * @stability experimental
+ */
+function appSampleMetricSchema(only) {
+    const names = only ?? Object.keys(exports.APP_SAMPLE_METRIC_TAGS);
+    return { tables: names.map((name) => metricTableSchema(name, exports.APP_SAMPLE_METRIC_TAGS[name])) };
+}
+/**
+ * Tag columns of the five `app_*` counter tables the reference app's `activity`
+ * group reads (`app.auth.logins`, `app.auth.refreshes`, `app.ai.requests`,
+ * `app.ai.tokens`, `app.notifications.deliveries`). The tag set is the metric's
+ * declared attributes (`apps/api/src/common/otel/platform-app-metrics.ts`) plus
+ * the four every `app_*` table carries; the names follow the spec's table
+ * naming rule (dots become `_`, `_total` appended).
+ *
+ * @stability experimental
+ */
+exports.APP_ACTIVITY_METRIC_TAGS = {
+    app_ai_requests_total: ['app_instance_id', 'host_name', 'job', 'key_source', 'model', 'operation', 'provider', 'service_name', 'status'],
+    app_ai_tokens_total: ['app_instance_id', 'host_name', 'job', 'model', 'operation', 'provider', 'service_name', 'token_type'],
+    app_auth_logins_total: ['app_instance_id', 'host_name', 'job', 'outcome', 'provider', 'service_name'],
+    app_auth_refreshes_total: ['app_instance_id', 'host_name', 'job', 'outcome', 'service_name'],
+    app_notifications_deliveries_total: ['app_instance_id', 'channel', 'event', 'host_name', 'job', 'outcome', 'service_name'],
+};
+/**
+ * A schema holding the activity tables of {@link APP_ACTIVITY_METRIC_TAGS}
+ * (or only `only`).
+ *
+ * @param only - the table names to include; default all of them.
+ * @returns the schema.
+ *
+ * @stability experimental
+ */
+function appActivityMetricSchema(only) {
+    const names = only ?? Object.keys(exports.APP_ACTIVITY_METRIC_TAGS);
+    return { tables: names.map((name) => metricTableSchema(name, exports.APP_ACTIVITY_METRIC_TAGS[name])) };
+}
+//# sourceMappingURL=metric-schema.fixture.js.map

package/dist/telemetry/testing/metric-schema.fixture.js.map

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

package/dist/telemetry/testing/stub-ports.d.ts

@@ -0,0 +1,46 @@
+import { type Type } from '@nestjs/common';
+import { type TelemetryAuditEvent } from '../ports';
+/**
+ * What the stub ports hold.
+ *
+ * @stability experimental
+ */
+export interface StubTelemetryPortsOptions {
+    /** Passwords the credential store holds, by credential name (`reader`, `admin`), under purpose `telemetry_greptime`. */
+    credentials?: Readonly<Record<string, string>>;
+    /** Keyed system-settings rows the settings store holds, by key (`telemetry_connection`); the value is the row's stored JSON. */
+    rows?: Readonly<Record<string, unknown>>;
+}
+/**
+ * The stub ports' observable state, so a test can look at what the slice did.
+ *
+ * @stability experimental
+ */
+export interface StubTelemetryPortsState {
+    /** Every audit event recorded, in order. */
+    readonly audit: TelemetryAuditEvent[];
+    /** The job types the slice registered handlers for. */
+    readonly handlers: string[];
+}
+/**
+ * A Nest module exporting one in-memory provider per telemetry host port, with
+ * its state. Pass the module in `TelemetryModule.forRoot({ imports: [module] })`.
+ *
+ * @param options - what the credential and settings stores hold.
+ * @returns the module class and the state its stubs write to.
+ *
+ * @example
+ * ```ts
+ * const { module, state } = createStubTelemetryPorts({ credentials: { reader: 'known-password' } });
+ * TelemetryModule.forRoot({ host: createTestPlatformHost(), imports: [module] });
+ * ```
+ *
+ * @stability experimental
+ */
+export declare function createStubTelemetryPorts(options?: StubTelemetryPortsOptions): {
+    /** The module to pass in `imports`. */
+    module: Type<unknown>;
+    /** What the stubs recorded. */
+    state: StubTelemetryPortsState;
+};
+//# sourceMappingURL=stub-ports.d.ts.map

package/dist/telemetry/testing/stub-ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-ports.d.ts","sourceRoot":"","sources":["../../../src/telemetry/testing/stub-ports.ts"],"names":[],"mappings":"AAeA,OAAO,EAAU,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAOL,KAAK,mBAAmB,EAEzB,MAAM,UAAU,CAAC;AAGlB;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,wHAAwH;IACxH,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,gIAAgI;IAChI,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1C;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,mBAAmB,EAAE,CAAC;IACtC,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,yBAA8B,GAAG;IACjF,uCAAuC;IACvC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,+BAA+B;IAC/B,KAAK,EAAE,uBAAuB,CAAC;CAChC,CA0EA"}