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

package/dist/telemetry/telemetry.module.js

@@ -0,0 +1,210 @@
+"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 TelemetryModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryModule = void 0;
+const common_1 = require("@nestjs/common");
+const telemetry_ai_enabled_guard_1 = require("./assistant/telemetry-ai-enabled.guard");
+const telemetry_assistant_controller_1 = require("./assistant/telemetry-assistant.controller");
+const telemetry_assistant_service_1 = require("./assistant/telemetry-assistant.service");
+const telemetry_connection_admin_service_1 = require("./connection/telemetry-connection-admin.service");
+const telemetry_connection_test_service_1 = require("./connection/telemetry-connection-test.service");
+const telemetry_connection_controller_1 = require("./connection/telemetry-connection.controller");
+const telemetry_connection_service_1 = require("./connection/telemetry-connection.service");
+const telemetry_dashboard_controller_1 = require("./dashboard/telemetry-dashboard.controller");
+const telemetry_dashboard_service_1 = require("./dashboard/telemetry-dashboard.service");
+const telemetry_export_service_1 = require("./export/telemetry-export.service");
+const greptime_client_1 = require("./greptime/greptime.client");
+const telemetry_retention_handler_1 = require("./handlers/telemetry-retention.handler");
+const telemetry_query_service_1 = require("./query/telemetry-query.service");
+const telemetry_schema_service_1 = require("./query/telemetry-schema.service");
+const stack_agent_client_1 = require("./stack/stack-agent.client");
+const telemetry_stack_deploy_handler_1 = require("./stack/telemetry-stack-deploy.handler");
+const telemetry_stack_controller_1 = require("./stack/telemetry-stack.controller");
+const telemetry_stack_service_1 = require("./stack/telemetry-stack.service");
+const telemetry_retention_task_1 = require("./tasks/telemetry-retention.task");
+const telemetry_admin_controller_1 = require("./telemetry-admin.controller");
+const telemetry_config_controller_1 = require("./telemetry-config.controller");
+const telemetry_explorer_controller_1 = require("./telemetry-explorer.controller");
+const telemetry_settings_service_1 = require("./telemetry-settings.service");
+const telemetry_status_service_1 = require("./telemetry-status.service");
+const telemetry_support_bundle_section_1 = require("./telemetry-support-bundle.section");
+const telemetry_connection_doctor_check_1 = require("./doctor/telemetry-connection.doctor-check");
+const greptimedb_egress_contributor_1 = require("./doctor/egress/greptimedb.egress.contributor");
+const telemetry_export_doctor_check_1 = require("./doctor/telemetry-export.doctor-check");
+const telemetry_freshness_doctor_check_1 = require("./doctor/telemetry-freshness.doctor-check");
+const telemetry_reachable_doctor_check_1 = require("./doctor/telemetry-reachable.doctor-check");
+const telemetry_tables_doctor_check_1 = require("./doctor/telemetry-tables.doctor-check");
+const metric_group_registry_service_1 = require("./metrics/metric-group-registry.service");
+const metric_group_registry_1 = require("./metrics/metric-group.registry");
+const verdict_policy_1 = require("./dashboard/verdict-policy");
+const telemetry_options_1 = require("./telemetry.options");
+// =============================================================================
+// TelemetryModule (issue #534, epic #528; packaged as
+// `@marinoscar/platform-api/telemetry` by #703)
+// =============================================================================
+//
+// The API side of observability: the `telemetry` settings (and the runtime
+// export gate they drive), the GreptimeDB client, the store's status, and the
+// server-only `telemetry.retention.apply` job with its enqueue-only cron.
+//
+// PACKAGED (#703). Nothing here imports the app: every app capability comes
+// through a host port (./ports.ts) the app binds in `forRoot({ imports })`,
+// and every route through the controller-factory recipe with the app's
+// access decorators (`forRoot({ host })`).
+//
+// The explorer (#535): `TelemetryQueryService` (the one entry point for
+// caller-supplied SQL: guard, row cap, timeout, audit), `TelemetrySchemaService`
+// (tables and columns) and `TelemetryExportService` (csv/ndjson/xlsx/parquet),
+// behind `TelemetryExplorerController` on `telemetry:query`.
+//
+// The assistant (#536, #571): `TelemetryAssistantService` runs a
+// troubleshooting agent's tool loop through the `TELEMETRY_AI` port (the
+// app's `AiService.forUser`);
+// every statement its tools run — the model's and the ones it builds itself
+// (`assistant/telemetry-assistant.sql.ts`) — goes through
+// `TelemetryQueryService.run` with `source: 'assistant'`, so it is held to
+// exactly the explorer's guard and bounds; `TelemetrySchemaService` lists and
+// describes tables, and the `TELEMETRY_SETTINGS_STORE` port gives the
+// allowlisted feature flags `get_app_context` reports. Streamed by
+// `TelemetryAssistantController`.
+//
+// The connection (#558): `TelemetryConnectionService` resolves the GreptimeDB
+// connection at runtime — the one saved at /admin/settings/telemetry (a
+// `telemetry_connection` system-settings row plus two passwords in the
+// credential store, the `TELEMETRY_CREDENTIAL_STORE` port), else the `GREPTIME_*`
+// deployment default. `GreptimeClient` builds its pools from it and rebuilds
+// them when it changes. `TelemetryConnectionController` is the admin surface.
+//
+// The services (#567): on a VPS, `StackAgentClient` talks to the
+// `stack-agent` sidecar (STACK_AGENT_URL/TOKEN) to report the telemetry
+// containers' state and to start them through the server-only
+// `telemetry.stack.deploy` job. `TelemetryStackController` is the admin
+// surface, under /api/admin/telemetry/stack.
+//
+// The dashboard (#577): `TelemetryDashboardService` runs the fixed,
+// server-authored statements of `dashboard/telemetry-dashboard.sql.ts` (no
+// caller SQL) on the reader pool, with a 15 s result cache, behind
+// `TelemetryDashboardController` on `telemetry:query`.
+//
+// `GreptimeClient`, `TelemetrySettingsService` and the two query services are
+// exported for it.
+// =============================================================================
+const PROVIDERS = [
+    // Rung 2 (#703): the metric-group registry, injectable; frozen on bootstrap.
+    metric_group_registry_service_1.MetricGroupRegistry,
+    telemetry_connection_service_1.TelemetryConnectionService,
+    telemetry_connection_admin_service_1.TelemetryConnectionAdminService,
+    telemetry_connection_test_service_1.TelemetryConnectionTestService,
+    greptime_client_1.GreptimeClient,
+    telemetry_settings_service_1.TelemetrySettingsService,
+    telemetry_status_service_1.TelemetryStatusService,
+    telemetry_retention_handler_1.TelemetryRetentionHandler,
+    telemetry_retention_task_1.TelemetryRetentionTask,
+    telemetry_query_service_1.TelemetryQueryService,
+    telemetry_schema_service_1.TelemetrySchemaService,
+    telemetry_export_service_1.TelemetryExportService,
+    telemetry_assistant_service_1.TelemetryAssistantService,
+    telemetry_ai_enabled_guard_1.TelemetryAiEnabledGuard,
+    stack_agent_client_1.StackAgentClient,
+    telemetry_stack_service_1.TelemetryStackService,
+    telemetry_stack_deploy_handler_1.TelemetryStackDeployHandler,
+    telemetry_dashboard_service_1.TelemetryDashboardService,
+    // Doctor checks (#634): read-only — never the connection test (it
+    // audits) and never the dashboard service's audited reads. Each registers
+    // itself with the Doctor's DoctorCheckRegistry (`@marinoscar/platform-api/doctor`).
+    telemetry_export_doctor_check_1.TelemetryExportDoctorCheck,
+    telemetry_connection_doctor_check_1.TelemetryConnectionDoctorCheck,
+    telemetry_reachable_doctor_check_1.TelemetryReachableDoctorCheck,
+    telemetry_tables_doctor_check_1.TelemetryTablesDoctorCheck,
+    telemetry_freshness_doctor_check_1.TelemetryFreshnessDoctorCheck,
+    // Egress inventory (#773): the GreptimeDB host.
+    greptimedb_egress_contributor_1.GreptimeDbEgressContributor,
+    // Support-bundle section (#772): telemetry health as aggregates only,
+    // gated on telemetry:query. Registers itself with SupportBundleRegistry.
+    telemetry_support_bundle_section_1.TelemetrySupportBundleSection,
+];
+/**
+ * The telemetry slice: settings and the export gate, the GreptimeDB
+ * connection and client, the explorer, the assistant, the dashboard, the
+ * stack-agent surface, the two server-only job types, five Doctor checks, an
+ * egress contributor and a support-bundle section.
+ *
+ * @stability experimental
+ */
+let TelemetryModule = TelemetryModule_1 = class TelemetryModule {
+    /**
+     * The slice for one app: its routes guarded by `options.host`, its host
+     * ports bound by `options.imports`.
+     *
+     * @param options - the module options.
+     * @returns the dynamic module. It exports `GreptimeClient`,
+     *   `TelemetrySettingsService`, `TelemetryQueryService`, `TelemetrySchemaService`,
+     *   `MetricGroupRegistry`, `DefaultVerdictPolicy`, `VERDICT_POLICY` and
+     *   `TELEMETRY_VERDICT_THRESHOLDS`.
+     * @throws Error when an option is invalid (a bad verdict threshold names the
+     *   field); RegistryError when an extra metric group is refused (a duplicate id
+     *   or family key fails boot here).
+     *
+     * @example
+     * ```ts
+     * TelemetryModule.forRoot({ host: platformHost, imports: [TelemetryHostModule] });
+     * ```
+     *
+     * @extensionPoint option
+     * @stability experimental
+     */
+    static forRoot(options) {
+        const resolved = (0, telemetry_options_1.resolveTelemetryModuleOptions)(options);
+        // Extra groups go in BEFORE the controllers are created, so the dashboard
+        // route's documented `group` enum includes them. Re-registering the very
+        // same definition (a second forRoot in one process) is a no-op.
+        (0, metric_group_registry_1.registerMetricGroups)(resolved.metricGroups.filter((group) => metric_group_registry_1.metricGroupRegistry.get(group.id) !== group));
+        return {
+            module: TelemetryModule_1,
+            imports: [...resolved.imports],
+            controllers: [
+                (0, telemetry_admin_controller_1.createTelemetryAdminController)(resolved),
+                (0, telemetry_config_controller_1.createTelemetryConfigController)(resolved),
+                (0, telemetry_explorer_controller_1.createTelemetryExplorerController)(resolved),
+                (0, telemetry_assistant_controller_1.createTelemetryAssistantController)(resolved),
+                (0, telemetry_connection_controller_1.createTelemetryConnectionController)(resolved),
+                (0, telemetry_stack_controller_1.createTelemetryStackController)(resolved),
+                (0, telemetry_dashboard_controller_1.createTelemetryDashboardController)(resolved),
+            ],
+            providers: [
+                { provide: telemetry_options_1.TELEMETRY_OPTIONS, useValue: resolved },
+                // Rung 1: the resolved, frozen thresholds every reader injects.
+                { provide: telemetry_options_1.TELEMETRY_VERDICT_THRESHOLDS, useValue: resolved.verdictThresholds },
+                // Rung 1: the metric groups' freshness window (`metrics.freshMs`).
+                { provide: telemetry_options_1.TELEMETRY_METRIC_FRESH_MS, useValue: resolved.metricFreshMs },
+                // Rung 3: the verdict policy. The default is always provided, so an
+                // app policy can inject it and delegate.
+                verdict_policy_1.DefaultVerdictPolicy,
+                { provide: verdict_policy_1.VERDICT_POLICY, ...(resolved.verdictPolicy ?? { useExisting: verdict_policy_1.DefaultVerdictPolicy }) },
+                ...PROVIDERS,
+            ],
+            exports: [
+                greptime_client_1.GreptimeClient,
+                telemetry_settings_service_1.TelemetrySettingsService,
+                telemetry_query_service_1.TelemetryQueryService,
+                telemetry_schema_service_1.TelemetrySchemaService,
+                metric_group_registry_service_1.MetricGroupRegistry,
+                verdict_policy_1.DefaultVerdictPolicy,
+                verdict_policy_1.VERDICT_POLICY,
+                telemetry_options_1.TELEMETRY_VERDICT_THRESHOLDS,
+                telemetry_options_1.TELEMETRY_METRIC_FRESH_MS,
+            ],
+        };
+    }
+};
+exports.TelemetryModule = TelemetryModule;
+exports.TelemetryModule = TelemetryModule = TelemetryModule_1 = __decorate([
+    (0, common_1.Module)({})
+], TelemetryModule);
+//# sourceMappingURL=telemetry.module.js.map

package/dist/telemetry/telemetry.module.js.map

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

package/dist/telemetry/telemetry.options.d.ts

@@ -0,0 +1,176 @@
+import { type ModuleMetadata } from '@nestjs/common';
+import { type PlatformHost, type PortBinding } from '../core/index';
+import { type VerdictThresholds } from './dashboard/telemetry-dashboard.verdict';
+import type { VerdictPolicy } from './dashboard/verdict-policy';
+import type { MetricGroupDef } from './metrics/metric-group.registry';
+/**
+ * A partial {@link VerdictThresholds}: any field, at any depth, may be left out
+ * and keeps its default.
+ *
+ * @stability experimental
+ */
+export type VerdictThresholdsOverride = {
+    -readonly [K in keyof VerdictThresholds]?: VerdictThresholds[K] extends object ? {
+        -readonly [L in keyof VerdictThresholds[K]]?: VerdictThresholds[K][L];
+    } : VerdictThresholds[K];
+};
+/**
+ * The dashboard's options.
+ *
+ * @example
+ * ```ts
+ * TelemetryModule.forRoot({ host, imports, dashboard: { verdictThresholds: { noDataMinutes: 10 } } });
+ * ```
+ *
+ * @extensionPoint option
+ * @stability experimental
+ */
+export interface TelemetryDashboardOptions {
+    /** Deep-merged over `DEFAULT_VERDICT_THRESHOLDS`; validated at boot. */
+    verdictThresholds?: VerdictThresholdsOverride;
+    /** What `VERDICT_POLICY` is bound to; default `{ useClass: DefaultVerdictPolicy }`. Its own dependencies come from `imports`. */
+    verdictPolicy?: PortBinding<VerdictPolicy>;
+}
+/**
+ * The dashboard metric groups' options.
+ *
+ * @example
+ * ```ts
+ * TelemetryModule.forRoot({ host, imports, metrics: { freshMs: 300_000 } });
+ * ```
+ *
+ * @extensionPoint option
+ * @stability experimental
+ */
+export interface TelemetryMetricsOptions {
+    /**
+     * The freshness window, in milliseconds: a per-key table cell read as `last`
+     * (and an uptime check) older than its table's newest reading by more than
+     * this is not current. A whole number from 1 000 (1 s) to 86 400 000 (24 h);
+     * default `METRIC_FRESH_MS` (150 000, 150 s). Raise it when the app's
+     * metrics export interval is longer than the default's 60 s.
+     */
+    freshMs?: number;
+}
+/**
+ * Options of `TelemetryModule.forRoot()`.
+ *
+ * @example
+ * ```ts
+ * TelemetryModule.forRoot({ host: platformHost, imports: [TelemetryHostModule] });
+ * ```
+ *
+ * @extensionPoint option
+ * @stability experimental
+ */
+export interface TelemetryModuleOptions {
+    /** The app's access decorators (`definePlatformHost`); required: a platform route is never public. */
+    host: PlatformHost;
+    /** Modules that export the host-port providers (`TELEMETRY_AUDIT_SINK`, `TELEMETRY_SETTINGS_STORE`, ...): the app's adapters. */
+    imports: NonNullable<ModuleMetadata['imports']>;
+    /** Extra metric groups, registered after the six platform groups when `forRoot` runs. */
+    metricGroups?: readonly MetricGroupDef[];
+    /**
+     * Reads the caller's user id off the framework request. Defaults to
+     * `request.requestUser.id`, else `request.user.id`.
+     *
+     * @param request - the framework request.
+     * @returns the user id, or `undefined` for an anonymous request (the access decorators refuse those first).
+     */
+    actorId?: (request: unknown) => string | undefined;
+    /** The dashboard's verdict thresholds and policy. */
+    dashboard?: TelemetryDashboardOptions;
+    /** The dashboard metric groups' freshness window. */
+    metrics?: TelemetryMetricsOptions;
+}
+/**
+ * The options after validation and defaults, as the slice's providers and
+ * controller factories receive them.
+ *
+ * @stability experimental
+ */
+export interface ResolvedTelemetryModuleOptions {
+    /** The validated, frozen host. */
+    readonly host: PlatformHost;
+    /** The host-port modules. */
+    readonly imports: NonNullable<ModuleMetadata['imports']>;
+    /** The extra metric groups (possibly empty). */
+    readonly metricGroups: readonly MetricGroupDef[];
+    /** The caller resolver. */
+    readonly actorId: (request: unknown) => string | undefined;
+    /** A parameter decorator injecting `actorId(request)` into a route handler. */
+    readonly actorIdParam: () => ParameterDecorator;
+    /** The resolved, frozen verdict thresholds (`TELEMETRY_VERDICT_THRESHOLDS`). */
+    readonly verdictThresholds: VerdictThresholds;
+    /** The binding of `VERDICT_POLICY`, or `undefined` for the default policy. */
+    readonly verdictPolicy: PortBinding<VerdictPolicy> | undefined;
+    /** The metric groups' freshness window in milliseconds (`TELEMETRY_METRIC_FRESH_MS`). */
+    readonly metricFreshMs: number;
+}
+/**
+ * Injection token of the {@link ResolvedTelemetryModuleOptions}.
+ *
+ * @stability experimental
+ */
+export declare const TELEMETRY_OPTIONS: unique symbol;
+/**
+ * Injection token of the resolved {@link VerdictThresholds}: the defaults with
+ * the app's `dashboard.verdictThresholds` deep-merged over them, frozen. Every
+ * reader of a threshold injects this.
+ *
+ * @extensionPoint token
+ * @stability experimental
+ */
+export declare const TELEMETRY_VERDICT_THRESHOLDS: unique symbol;
+/**
+ * Injection token of the metric groups' freshness window in milliseconds: the
+ * app's `metrics.freshMs`, else `METRIC_FRESH_MS`. The dashboard's `/metrics`
+ * route reads it and reports it as the response's `freshMs`.
+ *
+ * @extensionPoint token
+ * @stability experimental
+ */
+export declare const TELEMETRY_METRIC_FRESH_MS: unique symbol;
+/**
+ * The freshness window for an override: validated, else the default.
+ *
+ * @param metrics - the app's `metrics`, or `undefined`.
+ * @returns the window in milliseconds.
+ * @throws Error when `metrics` is not an object or `freshMs` is not a whole number from 1 000 to 86 400 000.
+ *
+ * @stability experimental
+ */
+export declare function resolveMetricFreshMs(metrics: TelemetryMetricsOptions | undefined): number;
+/**
+ * The verdict thresholds for an override: validated, deep-merged over
+ * {@link DEFAULT_VERDICT_THRESHOLDS} and frozen.
+ *
+ * @param override - the app's `dashboard.verdictThresholds`, or `undefined`.
+ * @returns the resolved thresholds.
+ * @throws Error naming every invalid field, or a degraded bound beyond its critical one.
+ *
+ * @stability experimental
+ */
+export declare function resolveVerdictThresholds(override: VerdictThresholdsOverride | undefined): VerdictThresholds;
+/**
+ * The default caller resolver: the authenticated user's `id`, from
+ * `request.requestUser` (set by the app's guards) or `request.user` (the JWT
+ * strategy's user).
+ *
+ * @param request - the framework request.
+ * @returns the user id, or `undefined`.
+ *
+ * @stability experimental
+ */
+export declare function defaultTelemetryActorId(request: unknown): string | undefined;
+/**
+ * Validates `options` and applies the defaults.
+ *
+ * @param options - what the app passed to `forRoot`.
+ * @returns the resolved, frozen options.
+ * @throws Error naming the bad option.
+ *
+ * @stability experimental
+ */
+export declare function resolveTelemetryModuleOptions(options: TelemetryModuleOptions): ResolvedTelemetryModuleOptions;
+//# sourceMappingURL=telemetry.options.d.ts.map

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

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

package/dist/telemetry/telemetry.options.js

@@ -0,0 +1,246 @@
+"use strict";
+// =============================================================================
+// TelemetryModule.forRoot options (issue #703, PP-4.2; Extension Contract rung 1)
+// =============================================================================
+//
+// What an app configures when it imports the telemetry slice:
+//
+//   host          the app's access decorators (`definePlatformHost`, issue
+//                 #696): every packaged route is guarded by them, so a
+//                 telemetry route authenticates and authorizes exactly as an
+//                 app route does.
+//   imports       the modules exporting the host-port providers (./ports.ts);
+//                 the reference app passes its `TelemetryHostModule`.
+//   metricGroups  extra dashboard metric groups, registered after the six
+//                 platform groups.
+//   actorId       how a route reads the caller's user id off the request
+//                 (default: `request.requestUser.id ?? request.user.id`, the
+//                 reference app's `@CurrentUser('id')`).
+//   dashboard     `verdictThresholds`: deep-merged over
+//                 `DEFAULT_VERDICT_THRESHOLDS` (zod-validated); `verdictPolicy`:
+//                 what `VERDICT_POLICY` is bound to (rung 3; default
+//                 `DefaultVerdictPolicy`).
+//   metrics       `freshMs`: how much older than its table's newest reading a
+//                 `last` cell (and an uptime check) may be and still count as
+//                 current (default `METRIC_FRESH_MS`, 150 s).
+//
+// Validated once, in `forRoot`: a bad option fails boot with a message naming
+// it.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TELEMETRY_METRIC_FRESH_MS = exports.TELEMETRY_VERDICT_THRESHOLDS = exports.TELEMETRY_OPTIONS = void 0;
+exports.resolveMetricFreshMs = resolveMetricFreshMs;
+exports.resolveVerdictThresholds = resolveVerdictThresholds;
+exports.defaultTelemetryActorId = defaultTelemetryActorId;
+exports.resolveTelemetryModuleOptions = resolveTelemetryModuleOptions;
+const common_1 = require("@nestjs/common");
+const zod_1 = require("zod");
+const index_1 = require("../core/index");
+const telemetry_dashboard_verdict_1 = require("./dashboard/telemetry-dashboard.verdict");
+const metric_group_1 = require("./metrics/metric-group");
+/**
+ * Injection token of the {@link ResolvedTelemetryModuleOptions}.
+ *
+ * @stability experimental
+ */
+exports.TELEMETRY_OPTIONS = Symbol.for('@marinoscar/platform/telemetry/OPTIONS');
+/**
+ * Injection token of the resolved {@link VerdictThresholds}: the defaults with
+ * the app's `dashboard.verdictThresholds` deep-merged over them, frozen. Every
+ * reader of a threshold injects this.
+ *
+ * @extensionPoint token
+ * @stability experimental
+ */
+exports.TELEMETRY_VERDICT_THRESHOLDS = Symbol.for('@marinoscar/platform/telemetry/VERDICT_THRESHOLDS');
+/**
+ * Injection token of the metric groups' freshness window in milliseconds: the
+ * app's `metrics.freshMs`, else `METRIC_FRESH_MS`. The dashboard's `/metrics`
+ * route reads it and reports it as the response's `freshMs`.
+ *
+ * @extensionPoint token
+ * @stability experimental
+ */
+exports.TELEMETRY_METRIC_FRESH_MS = Symbol.for('@marinoscar/platform/telemetry/METRIC_FRESH_MS');
+/** The bounds of `metrics.freshMs`: one second to one day. */
+const FRESH_MS_MIN = 1_000;
+const FRESH_MS_MAX = 86_400_000;
+/**
+ * The freshness window for an override: validated, else the default.
+ *
+ * @param metrics - the app's `metrics`, or `undefined`.
+ * @returns the window in milliseconds.
+ * @throws Error when `metrics` is not an object or `freshMs` is not a whole number from 1 000 to 86 400 000.
+ *
+ * @stability experimental
+ */
+function resolveMetricFreshMs(metrics) {
+    if (metrics === undefined)
+        return metric_group_1.METRIC_FRESH_MS;
+    if (metrics === null || typeof metrics !== 'object')
+        fail('`metrics` must be an object');
+    const { freshMs } = metrics;
+    if (freshMs === undefined)
+        return metric_group_1.METRIC_FRESH_MS;
+    if (typeof freshMs !== 'number' || !Number.isInteger(freshMs) || freshMs < FRESH_MS_MIN || freshMs > FRESH_MS_MAX) {
+        fail(`\`metrics.freshMs\` must be a whole number of milliseconds from ${FRESH_MS_MIN} to ${FRESH_MS_MAX} (got ${String(freshMs)})`);
+    }
+    return freshMs;
+}
+const amount = zod_1.z.number().finite().nonnegative();
+const count = zod_1.z.number().int().positive();
+const levels = zod_1.z.object({ degraded: amount, critical: amount }).partial().strict();
+/** What a `dashboard.verdictThresholds` override may contain. */
+const verdictThresholdsOverrideSchema = zod_1.z
+    .object({
+    minRequests: zod_1.z.number().int().nonnegative(),
+    errorRatePct: levels,
+    p95Ms: levels,
+    errorLogs: zod_1.z
+        .object({ minCurrent: zod_1.z.number().int().nonnegative(), degradedRatio: amount, criticalRatio: amount })
+        .partial()
+        .strict(),
+    noDataMinutes: zod_1.z.number().finite().positive(),
+    unknownRoutes: zod_1.z.object({ criticalBearerRequests: count, criticalDistinctRoutes: count }).partial().strict(),
+    diskUtilizationPct: levels,
+    memoryUtilizationPct: levels,
+    dbConnectionsPct: levels,
+    oldestPendingJobMinutes: levels,
+    tlsDaysLeft: levels,
+    uptimeMinChecksForCritical: count,
+    collectorFailedPct: zod_1.z.object({ critical: amount }).partial().strict(),
+    backupAgeHours: levels,
+})
+    .partial()
+    .strict();
+/** The `{ degraded, critical }` pairs whose degraded bound must not exceed the critical one (`>`/`>=` rules). */
+const RISING = [
+    'errorRatePct',
+    'p95Ms',
+    'diskUtilizationPct',
+    'memoryUtilizationPct',
+    'dbConnectionsPct',
+    'oldestPendingJobMinutes',
+    'backupAgeHours',
+];
+function deepFreeze(value) {
+    if (value && typeof value === 'object') {
+        for (const inner of Object.values(value))
+            deepFreeze(inner);
+        Object.freeze(value);
+    }
+    return value;
+}
+/**
+ * The verdict thresholds for an override: validated, deep-merged over
+ * {@link DEFAULT_VERDICT_THRESHOLDS} and frozen.
+ *
+ * @param override - the app's `dashboard.verdictThresholds`, or `undefined`.
+ * @returns the resolved thresholds.
+ * @throws Error naming every invalid field, or a degraded bound beyond its critical one.
+ *
+ * @stability experimental
+ */
+function resolveVerdictThresholds(override) {
+    const parsed = verdictThresholdsOverrideSchema.safeParse(override ?? {});
+    if (!parsed.success) {
+        const problems = parsed.error.issues
+            .map((issue) => `${issue.path.length ? issue.path.join('.') : '(root)'}: ${issue.message}`)
+            .join('; ');
+        fail(`\`dashboard.verdictThresholds\` is invalid (${problems})`);
+    }
+    const merged = structuredClone(telemetry_dashboard_verdict_1.DEFAULT_VERDICT_THRESHOLDS);
+    for (const [key, value] of Object.entries(parsed.data)) {
+        if (value === undefined)
+            continue;
+        merged[key] =
+            value !== null && typeof value === 'object'
+                ? { ...merged[key], ...value }
+                : value;
+    }
+    const resolved = merged;
+    for (const key of RISING) {
+        const pair = resolved[key];
+        if (pair.degraded > pair.critical) {
+            fail(`\`dashboard.verdictThresholds.${key}\`: degraded (${pair.degraded}) must not exceed critical (${pair.critical})`);
+        }
+    }
+    if (resolved.tlsDaysLeft.degraded < resolved.tlsDaysLeft.critical) {
+        fail(`\`dashboard.verdictThresholds.tlsDaysLeft\`: degraded (${resolved.tlsDaysLeft.degraded}) must not be below ` +
+            `critical (${resolved.tlsDaysLeft.critical}); fewer days left is worse`);
+    }
+    if (resolved.errorLogs.degradedRatio > resolved.errorLogs.criticalRatio) {
+        fail(`\`dashboard.verdictThresholds.errorLogs\`: degradedRatio (${resolved.errorLogs.degradedRatio}) must not exceed ` +
+            `criticalRatio (${resolved.errorLogs.criticalRatio})`);
+    }
+    return deepFreeze(resolved);
+}
+/**
+ * The default caller resolver: the authenticated user's `id`, from
+ * `request.requestUser` (set by the app's guards) or `request.user` (the JWT
+ * strategy's user).
+ *
+ * @param request - the framework request.
+ * @returns the user id, or `undefined`.
+ *
+ * @stability experimental
+ */
+function defaultTelemetryActorId(request) {
+    if (request === null || typeof request !== 'object')
+        return undefined;
+    const { requestUser, user } = request;
+    const id = (requestUser || user)?.id;
+    return typeof id === 'string' ? id : undefined;
+}
+function fail(why) {
+    throw new Error(`TelemetryModule.forRoot: ${why}.`);
+}
+/**
+ * Validates `options` and applies the defaults.
+ *
+ * @param options - what the app passed to `forRoot`.
+ * @returns the resolved, frozen options.
+ * @throws Error naming the bad option.
+ *
+ * @stability experimental
+ */
+function resolveTelemetryModuleOptions(options) {
+    if (options === null || typeof options !== 'object')
+        fail('options are required ({ host, imports })');
+    if (!options.host)
+        fail('`host` is required (the app\'s definePlatformHost(...)): a platform route is never public');
+    const host = (0, index_1.definePlatformHost)(options.host);
+    if (!Array.isArray(options.imports)) {
+        fail('`imports` must list the modules that provide the telemetry host ports (the app\'s TelemetryHostModule)');
+    }
+    if (options.metricGroups !== undefined && !Array.isArray(options.metricGroups))
+        fail('`metricGroups` must be an array');
+    if (options.actorId !== undefined && typeof options.actorId !== 'function')
+        fail('`actorId` must be a function');
+    if (options.dashboard !== undefined && (options.dashboard === null || typeof options.dashboard !== 'object')) {
+        fail('`dashboard` must be an object');
+    }
+    const verdictPolicy = options.dashboard?.verdictPolicy;
+    if (verdictPolicy !== undefined) {
+        const kinds = verdictPolicy && typeof verdictPolicy === 'object'
+            ? ['useExisting', 'useClass', 'useFactory'].filter((k) => k in verdictPolicy)
+            : [];
+        if (kinds.length !== 1)
+            fail('`dashboard.verdictPolicy` needs exactly one of useExisting, useClass or useFactory');
+    }
+    const verdictThresholds = resolveVerdictThresholds(options.dashboard?.verdictThresholds);
+    const metricFreshMs = resolveMetricFreshMs(options.metrics);
+    const actorId = options.actorId ?? defaultTelemetryActorId;
+    const param = (0, common_1.createParamDecorator)((_data, ctx) => actorId(ctx.switchToHttp().getRequest()));
+    return Object.freeze({
+        host,
+        imports: [...options.imports],
+        metricGroups: Object.freeze([...(options.metricGroups ?? [])]),
+        actorId,
+        actorIdParam: () => param(),
+        verdictThresholds,
+        verdictPolicy,
+        metricFreshMs,
+    });
+}
+//# sourceMappingURL=telemetry.options.js.map

package/dist/telemetry/telemetry.options.js.map

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