@marinoscar/platform-api 0.1.0-next.18 → 0.1.0-next.20

package/dist/alerts/alerts-admin.controller.js

@@ -0,0 +1,297 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlertsAdminController = void 0;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const zod_1 = require("zod");
+const alerts_1 = require("@marinoscar/platform-contract/alerts");
+const index_1 = require("../core/index");
+const index_2 = require("../identity/index");
+const alerts_evaluation_service_1 = require("./alerts-evaluation.service");
+const alerts_incidents_service_1 = require("./alerts-incidents.service");
+const alerts_rules_service_1 = require("./alerts-rules.service");
+const alerts_dto_1 = require("./dto/alerts.dto");
+const alert_kind_registry_1 = require("./kinds/alert-kind.registry");
+const RULE_ID = { name: 'id', type: String, format: 'uuid', description: 'The rule id.' };
+const INCIDENT_ID = { name: 'id', type: String, format: 'uuid', description: 'The incident id.' };
+const NO_READ = { status: 403, description: 'Missing alerts:read', type: index_1.ErrorDto };
+const NO_WRITE = { status: 403, description: 'Missing alerts:write', type: index_1.ErrorDto };
+const NO_RULE = { status: 404, description: '`ALERT_RULE_NOT_FOUND`', type: index_1.ErrorDto };
+const NO_INCIDENT = { status: 404, description: '`ALERT_INCIDENT_NOT_FOUND`', type: index_1.ErrorDto };
+const BAD_CONFIG = { status: 400, description: '`ALERT_UNKNOWN_KIND` or `ALERT_INVALID_CONFIG`', type: index_1.ErrorDto };
+function configJsonSchema(kind) {
+    try {
+        return zod_1.z.toJSONSchema(kind.configSchema, { io: 'input', unrepresentable: 'any' });
+    }
+    catch {
+        return {};
+    }
+}
+const BUILTIN_IDS = new Set(Object.values(alerts_1.ALERT_KIND_IDS));
+// =============================================================================
+//   GET    /api/admin/alerts/rules                     alerts:read
+//   POST   /api/admin/alerts/rules                     alerts:write
+//   GET    /api/admin/alerts/rules/:id                 alerts:read
+//   PATCH  /api/admin/alerts/rules/:id                 alerts:write
+//   DELETE /api/admin/alerts/rules/:id                 alerts:write
+//   POST   /api/admin/alerts/rules/:id/test            alerts:write
+//   GET    /api/admin/alerts/kinds                     alerts:read
+//   GET    /api/admin/alerts/incidents                 alerts:read
+//   GET    /api/admin/alerts/incidents/:id             alerts:read
+//   POST   /api/admin/alerts/incidents/:id/acknowledge alerts:write
+//   GET    /api/admin/alerts/summary                   alerts:read
+// =============================================================================
+/**
+ * The alerts admin routes: rules, the kind catalog, incidents and the firing
+ * summary.
+ *
+ * @stability experimental
+ */
+let AlertsAdminController = class AlertsAdminController {
+    rules;
+    incidents;
+    evaluation;
+    constructor(rules, incidents, evaluation) {
+        this.rules = rules;
+        this.incidents = incidents;
+        this.evaluation = evaluation;
+    }
+    /** Lists the rules. */
+    listRules(query) {
+        return this.rules.list(query);
+    }
+    /** Creates a rule. */
+    createRule(body, userId) {
+        return this.rules.create(body, userId);
+    }
+    /** One rule. */
+    getRule(id) {
+        return this.rules.get(id);
+    }
+    /** Updates a rule. */
+    updateRule(id, body) {
+        return this.rules.update(id, body);
+    }
+    /** Deletes a rule. */
+    async deleteRule(id) {
+        await this.rules.remove(id);
+    }
+    /** Evaluates a rule now without storing or dispatching anything. */
+    async testRule(id) {
+        const row = await this.rules.row(id);
+        const started = Date.now();
+        const evaluatedAt = new Date();
+        try {
+            const observations = await this.evaluation.observe(row, evaluatedAt);
+            return { ruleId: id, kind: row.kind, evaluatedAt: evaluatedAt.toISOString(), durationMs: Date.now() - started, observations, error: null };
+        }
+        catch (error) {
+            return {
+                ruleId: id,
+                kind: row.kind,
+                evaluatedAt: evaluatedAt.toISOString(),
+                durationMs: Date.now() - started,
+                observations: [],
+                error: (error instanceof Error ? error.message : String(error)).slice(0, 500),
+            };
+        }
+    }
+    /** The registered kinds. */
+    listKinds() {
+        return alert_kind_registry_1.alertRuleKindRegistry.list().map((kind) => ({
+            id: kind.id,
+            label: kind.label,
+            description: kind.description,
+            eventDriven: kind.eventDriven === true,
+            builtin: BUILTIN_IDS.has(kind.id),
+            configSchema: configJsonSchema(kind),
+        }));
+    }
+    /** Lists incidents. */
+    listIncidents(query) {
+        return this.incidents.list(query);
+    }
+    /** One incident. */
+    getIncident(id) {
+        return this.incidents.get(id);
+    }
+    /** Acknowledges an incident. */
+    acknowledge(id, userId) {
+        return this.incidents.acknowledge(id, userId);
+    }
+    /** The firing summary. */
+    summary() {
+        return this.incidents.summary();
+    }
+};
+exports.AlertsAdminController = AlertsAdminController;
+__decorate([
+    (0, common_1.Get)('rules'),
+    (0, index_2.Auth)({ permissions: [alerts_1.ALERT_PERMISSIONS.READ] }),
+    (0, swagger_1.ApiOperation)({ summary: 'List alert rules (Admin)', description: 'Every rule, oldest first, with its open incident count. Filter by `kind`, `severity` or `enabled`.' }),
+    (0, index_1.ApiDataResponse)(alerts_dto_1.AlertRuleDto, { isArray: true, description: 'The rules' }),
+    (0, swagger_1.ApiResponse)(NO_READ),
+    __param(0, (0, common_1.Query)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [alerts_dto_1.AlertRuleListQueryDto]),
+    __metadata("design:returntype", Promise)
+], AlertsAdminController.prototype, "listRules", null);
+__decorate([
+    (0, common_1.Post)('rules'),
+    (0, common_1.HttpCode)(common_1.HttpStatus.CREATED),
+    (0, index_2.Auth)({ permissions: [alerts_1.ALERT_PERMISSIONS.WRITE] }),
+    (0, swagger_1.ApiOperation)({
+        summary: 'Create an alert rule (Admin)',
+        description: 'The `config` is validated against the kind\'s schema (`GET /kinds`). A rule is created disabled unless `enabled` is true.',
+    }),
+    (0, index_1.ApiDataResponse)(alerts_dto_1.AlertRuleDto, { status: 201, description: 'The rule' }),
+    (0, swagger_1.ApiResponse)(BAD_CONFIG),
+    (0, swagger_1.ApiResponse)(NO_WRITE),
+    __param(0, (0, common_1.Body)()),
+    __param(1, (0, index_2.CurrentUser)('id')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [alerts_dto_1.CreateAlertRuleDto, String]),
+    __metadata("design:returntype", Promise)
+], AlertsAdminController.prototype, "createRule", null);
+__decorate([
+    (0, common_1.Get)('rules/:id'),
+    (0, index_2.Auth)({ permissions: [alerts_1.ALERT_PERMISSIONS.READ] }),
+    (0, swagger_1.ApiOperation)({ summary: 'Get an alert rule (Admin)' }),
+    (0, swagger_1.ApiParam)(RULE_ID),
+    (0, index_1.ApiDataResponse)(alerts_dto_1.AlertRuleDto, { description: 'The rule' }),
+    (0, swagger_1.ApiResponse)(NO_READ),
+    (0, swagger_1.ApiResponse)(NO_RULE),
+    __param(0, (0, common_1.Param)('id', common_1.ParseUUIDPipe)),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], AlertsAdminController.prototype, "getRule", null);
+__decorate([
+    (0, common_1.Patch)('rules/:id'),
+    (0, index_2.Auth)({ permissions: [alerts_1.ALERT_PERMISSIONS.WRITE] }),
+    (0, swagger_1.ApiOperation)({
+        summary: 'Update an alert rule (Admin)',
+        description: 'A partial update; the kind cannot change. Disabling a rule closes its open incidents without a notification. A starter rule may be edited and disabled.',
+    }),
+    (0, swagger_1.ApiParam)(RULE_ID),
+    (0, index_1.ApiDataResponse)(alerts_dto_1.AlertRuleDto, { description: 'The rule' }),
+    (0, swagger_1.ApiResponse)(BAD_CONFIG),
+    (0, swagger_1.ApiResponse)(NO_WRITE),
+    (0, swagger_1.ApiResponse)(NO_RULE),
+    __param(0, (0, common_1.Param)('id', common_1.ParseUUIDPipe)),
+    __param(1, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, alerts_dto_1.UpdateAlertRuleDto]),
+    __metadata("design:returntype", Promise)
+], AlertsAdminController.prototype, "updateRule", null);
+__decorate([
+    (0, common_1.Delete)('rules/:id'),
+    (0, common_1.HttpCode)(common_1.HttpStatus.NO_CONTENT),
+    (0, index_2.Auth)({ permissions: [alerts_1.ALERT_PERMISSIONS.WRITE] }),
+    (0, swagger_1.ApiOperation)({ summary: 'Delete an alert rule (Admin)', description: 'Deletes the rule and its incidents. A starter rule is refused with `ALERT_STARTER_RULE_PROTECTED` (409): disable it instead.' }),
+    (0, swagger_1.ApiParam)(RULE_ID),
+    (0, swagger_1.ApiResponse)({ status: 204, description: 'Deleted' }),
+    (0, swagger_1.ApiResponse)(NO_WRITE),
+    (0, swagger_1.ApiResponse)(NO_RULE),
+    (0, swagger_1.ApiResponse)({ status: 409, description: `\`${alerts_1.ALERT_ERROR_CODES.STARTER_RULE_PROTECTED}\``, type: index_1.ErrorDto }),
+    __param(0, (0, common_1.Param)('id', common_1.ParseUUIDPipe)),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], AlertsAdminController.prototype, "deleteRule", null);
+__decorate([
+    (0, common_1.Post)('rules/:id/test'),
+    (0, common_1.HttpCode)(common_1.HttpStatus.OK),
+    (0, index_2.Auth)({ permissions: [alerts_1.ALERT_PERMISSIONS.WRITE] }),
+    (0, swagger_1.ApiOperation)({
+        summary: 'Test an alert rule (Admin)',
+        description: 'Evaluates the rule once, now, and returns what it observed. Nothing is stored (no incident, no `lastEvaluatedAt`) and nothing is dispatched. An evaluation failure is returned in `error`, not as an HTTP error.',
+    }),
+    (0, swagger_1.ApiParam)(RULE_ID),
+    (0, index_1.ApiDataResponse)(alerts_dto_1.AlertRuleTestResponseDto, { description: 'The observations' }),
+    (0, swagger_1.ApiResponse)(NO_WRITE),
+    (0, swagger_1.ApiResponse)(NO_RULE),
+    __param(0, (0, common_1.Param)('id', common_1.ParseUUIDPipe)),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], AlertsAdminController.prototype, "testRule", null);
+__decorate([
+    (0, common_1.Get)('kinds'),
+    (0, index_2.Auth)({ permissions: [alerts_1.ALERT_PERMISSIONS.READ] }),
+    (0, swagger_1.ApiOperation)({ summary: 'List alert rule kinds (Admin)', description: 'Every registered kind with the JSON Schema of its `config`.' }),
+    (0, index_1.ApiDataResponse)(alerts_dto_1.AlertKindDto, { isArray: true, description: 'The kinds' }),
+    (0, swagger_1.ApiResponse)(NO_READ),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Array)
+], AlertsAdminController.prototype, "listKinds", null);
+__decorate([
+    (0, common_1.Get)('incidents'),
+    (0, index_2.Auth)({ permissions: [alerts_1.ALERT_PERMISSIONS.READ] }),
+    (0, swagger_1.ApiOperation)({ summary: 'List alert incidents (Admin)', description: 'Newest first. Filter by `state`, `severity` and `ruleId`; paged (`page`, `pageSize` up to 100).' }),
+    (0, index_1.ApiDataResponse)(alerts_dto_1.AlertIncidentDto, { pagination: 'flat', description: 'Paginated incidents' }),
+    (0, swagger_1.ApiResponse)(NO_READ),
+    __param(0, (0, common_1.Query)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [alerts_dto_1.AlertIncidentListQueryDto]),
+    __metadata("design:returntype", Promise)
+], AlertsAdminController.prototype, "listIncidents", null);
+__decorate([
+    (0, common_1.Get)('incidents/:id'),
+    (0, index_2.Auth)({ permissions: [alerts_1.ALERT_PERMISSIONS.READ] }),
+    (0, swagger_1.ApiOperation)({ summary: 'Get an alert incident (Admin)' }),
+    (0, swagger_1.ApiParam)(INCIDENT_ID),
+    (0, index_1.ApiDataResponse)(alerts_dto_1.AlertIncidentDto, { description: 'The incident' }),
+    (0, swagger_1.ApiResponse)(NO_READ),
+    (0, swagger_1.ApiResponse)(NO_INCIDENT),
+    __param(0, (0, common_1.Param)('id', common_1.ParseUUIDPipe)),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], AlertsAdminController.prototype, "getIncident", null);
+__decorate([
+    (0, common_1.Post)('incidents/:id/acknowledge'),
+    (0, common_1.HttpCode)(common_1.HttpStatus.OK),
+    (0, index_2.Auth)({ permissions: [alerts_1.ALERT_PERMISSIONS.WRITE] }),
+    (0, swagger_1.ApiOperation)({ summary: 'Acknowledge an alert incident (Admin)', description: 'Marks the incident as seen by you. Idempotent: the first acknowledgement is kept. It does not resolve the incident.' }),
+    (0, swagger_1.ApiParam)(INCIDENT_ID),
+    (0, index_1.ApiDataResponse)(alerts_dto_1.AlertIncidentDto, { description: 'The incident' }),
+    (0, swagger_1.ApiResponse)(NO_WRITE),
+    (0, swagger_1.ApiResponse)(NO_INCIDENT),
+    __param(0, (0, common_1.Param)('id', common_1.ParseUUIDPipe)),
+    __param(1, (0, index_2.CurrentUser)('id')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String]),
+    __metadata("design:returntype", Promise)
+], AlertsAdminController.prototype, "acknowledge", null);
+__decorate([
+    (0, common_1.Get)('summary'),
+    (0, index_2.Auth)({ permissions: [alerts_1.ALERT_PERMISSIONS.READ] }),
+    (0, swagger_1.ApiOperation)({ summary: 'Alerts summary (Admin)', description: 'Incidents firing now by severity, and the newest evaluation: what a dashboard banner shows.' }),
+    (0, index_1.ApiDataResponse)(alerts_dto_1.AlertSummaryDto, { description: 'The summary' }),
+    (0, swagger_1.ApiResponse)(NO_READ),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], AlertsAdminController.prototype, "summary", null);
+exports.AlertsAdminController = AlertsAdminController = __decorate([
+    (0, swagger_1.ApiTags)('Alerts'),
+    (0, common_1.Controller)('admin/alerts'),
+    __metadata("design:paramtypes", [alerts_rules_service_1.AlertsRulesService,
+        alerts_incidents_service_1.AlertsIncidentsService,
+        alerts_evaluation_service_1.AlertsEvaluationService])
+], AlertsAdminController);
+//# sourceMappingURL=alerts-admin.controller.js.map

package/dist/alerts/alerts-admin.controller.js.map

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

package/dist/alerts/alerts-context.service.d.ts

@@ -0,0 +1,64 @@
+import { NodeLifecycleService } from '../nodes/index';
+import { TelemetryDashboardService, TelemetryQueryService, TelemetrySchemaService, type TelemetrySqlDialect } from '../telemetry/index';
+import type { AlertEvaluationContext, AlertMetricTable } from './alerts.types';
+import type { AlertsPrisma } from './data/alerts-db';
+/**
+ * Maps a telemetry failure to the evaluator's vocabulary: a store that cannot
+ * be reached is `AlertStoreUnavailableError` (the rule's incidents are left
+ * alone); anything else (a refused or failed statement) is the rule's own bug
+ * and surfaces as itself.
+ *
+ * @param error - what the telemetry slice threw.
+ * @returns the error to throw.
+ *
+ * @stability experimental
+ */
+export declare function toAlertStoreError(error: unknown): unknown;
+/**
+ * Derives the metric tables of a store schema: tables with the dialect's time
+ * and value columns, and their tag columns.
+ *
+ * @param schema - the store's schema.
+ * @param dialect - the store's SQL spelling.
+ * @returns the tables by name.
+ *
+ * @stability experimental
+ */
+export declare function metricTablesOfSchema(schema: {
+    tables: ReadonlyArray<{
+        name: string;
+        columns: ReadonlyArray<{
+            name: string;
+            semanticType: string | null;
+        }>;
+    }>;
+}, dialect: Pick<TelemetrySqlDialect, 'timestampColumn' | 'valueColumn'>): Map<string, AlertMetricTable>;
+/**
+ * Builds the {@link AlertEvaluationContext} of one rule evaluation from the
+ * app's services. The telemetry, nodes and dashboard services are optional: a
+ * kind that needs one that is not installed gets `AlertStoreUnavailableError`.
+ *
+ * @stability experimental
+ */
+export declare class AlertContextService {
+    private readonly prisma;
+    private readonly queries?;
+    private readonly schema?;
+    private readonly dialect?;
+    private readonly dashboard?;
+    private readonly lifecycle?;
+    private readonly logger;
+    constructor(prisma: AlertsPrisma, queries?: TelemetryQueryService | undefined, schema?: TelemetrySchemaService | undefined, dialect?: TelemetrySqlDialect | undefined, dashboard?: TelemetryDashboardService | undefined, lifecycle?: NodeLifecycleService | undefined);
+    /**
+     * The context for one evaluation.
+     *
+     * @param signal - aborted when the rule's time budget is spent.
+     * @param now - the instant the evaluation is for.
+     * @returns the context; its lazy members memoise per context.
+     */
+    create(signal: AbortSignal, now?: Date): AlertEvaluationContext;
+    private openTelemetry;
+    private readVerdict;
+    private readStale;
+}
+//# sourceMappingURL=alerts-context.service.d.ts.map

package/dist/alerts/alerts-context.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts-context.service.d.ts","sourceRoot":"","sources":["../../src/alerts/alerts-context.service.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAGL,yBAAyB,EAEzB,qBAAqB,EACrB,sBAAsB,EAItB,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAsC,MAAM,gBAAgB,CAAC;AACnH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAYrD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMzD;AAUD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE;IAAE,MAAM,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,aAAa,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAA;CAAE,EAC1H,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,iBAAiB,GAAG,aAAa,CAAC,GACpE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAe/B;AAED;;;;;;GAMG;AACH,qBACa,mBAAmB;IAIH,OAAO,CAAC,QAAQ,CAAC,MAAM;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACO,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IACxD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IARzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;gBAGnB,MAAM,EAAE,YAAY,EACjC,OAAO,CAAC,EAAE,qBAAqB,YAAA,EAC/B,MAAM,CAAC,EAAE,sBAAsB,YAAA,EACA,OAAO,CAAC,EAAE,mBAAmB,YAAA,EAC5D,SAAS,CAAC,EAAE,yBAAyB,YAAA,EACrC,SAAS,CAAC,EAAE,oBAAoB,YAAA;IAG/D;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,GAAE,IAAiB,GAAG,sBAAsB;YAe7D,aAAa;YA6Bb,WAAW;YAUX,SAAS;CAOxB"}

package/dist/alerts/alerts-context.service.js

@@ -0,0 +1,190 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var AlertContextService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlertContextService = void 0;
+exports.toAlertStoreError = toAlertStoreError;
+exports.metricTablesOfSchema = metricTablesOfSchema;
+const common_1 = require("@nestjs/common");
+const index_1 = require("../core/index");
+const index_2 = require("../jobs/index");
+const index_3 = require("../nodes/index");
+const index_4 = require("../telemetry/index");
+const alerts_errors_1 = require("./alerts.errors");
+/** Statements one rule evaluation may run. */
+const STATEMENTS_PER_EVALUATION = 5;
+const UNAVAILABLE_REASONS = new Set([
+    index_4.TELEMETRY_ERROR_REASONS.NOT_CONFIGURED,
+    index_4.TELEMETRY_ERROR_REASONS.DISABLED,
+    index_4.TELEMETRY_ERROR_REASONS.UNREACHABLE,
+    index_4.TELEMETRY_ERROR_REASONS.QUERY_TIMEOUT,
+]);
+/**
+ * Maps a telemetry failure to the evaluator's vocabulary: a store that cannot
+ * be reached is `AlertStoreUnavailableError` (the rule's incidents are left
+ * alone); anything else (a refused or failed statement) is the rule's own bug
+ * and surfaces as itself.
+ *
+ * @param error - what the telemetry slice threw.
+ * @returns the error to throw.
+ *
+ * @stability experimental
+ */
+function toAlertStoreError(error) {
+    if (error instanceof alerts_errors_1.AlertStoreUnavailableError)
+        return error;
+    if (error instanceof index_4.TelemetryHttpError && UNAVAILABLE_REASONS.has(error.reason)) {
+        return new alerts_errors_1.AlertStoreUnavailableError(describe(error), error);
+    }
+    return error;
+}
+function describe(error) {
+    if (error instanceof index_4.TelemetryHttpError) {
+        const body = error.getResponse();
+        return body?.message ?? error.message;
+    }
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * Derives the metric tables of a store schema: tables with the dialect's time
+ * and value columns, and their tag columns.
+ *
+ * @param schema - the store's schema.
+ * @param dialect - the store's SQL spelling.
+ * @returns the tables by name.
+ *
+ * @stability experimental
+ */
+function metricTablesOfSchema(schema, dialect) {
+    const tables = new Map();
+    for (const table of schema.tables) {
+        const names = new Set(table.columns.map((c) => c.name));
+        if (!names.has(dialect.timestampColumn) || !names.has(dialect.valueColumn))
+            continue;
+        const reported = table.columns.some((c) => c.semanticType);
+        const tags = table.columns
+            .filter((c) => reported ? String(c.semanticType).toUpperCase() === 'TAG' : c.name !== dialect.timestampColumn && c.name !== dialect.valueColumn)
+            .map((c) => c.name)
+            .sort();
+        tables.set(table.name, { name: table.name, columns: names, tags });
+    }
+    return tables;
+}
+/**
+ * Builds the {@link AlertEvaluationContext} of one rule evaluation from the
+ * app's services. The telemetry, nodes and dashboard services are optional: a
+ * kind that needs one that is not installed gets `AlertStoreUnavailableError`.
+ *
+ * @stability experimental
+ */
+let AlertContextService = AlertContextService_1 = class AlertContextService {
+    prisma;
+    queries;
+    schema;
+    dialect;
+    dashboard;
+    lifecycle;
+    logger = new common_1.Logger(AlertContextService_1.name);
+    constructor(prisma, queries, schema, dialect, dashboard, lifecycle) {
+        this.prisma = prisma;
+        this.queries = queries;
+        this.schema = schema;
+        this.dialect = dialect;
+        this.dashboard = dashboard;
+        this.lifecycle = lifecycle;
+    }
+    /**
+     * The context for one evaluation.
+     *
+     * @param signal - aborted when the rule's time budget is spent.
+     * @param now - the instant the evaluation is for.
+     * @returns the context; its lazy members memoise per context.
+     */
+    create(signal, now = new Date()) {
+        let telemetry = null;
+        let verdict = null;
+        let stale = null;
+        return {
+            now,
+            signal,
+            db: this.prisma,
+            telemetry: () => (telemetry ??= this.openTelemetry(signal)),
+            verdict: () => (verdict ??= this.readVerdict()),
+            staleHeartbeatSeconds: () => (stale ??= this.readStale()),
+        };
+    }
+    async openTelemetry(signal) {
+        if (!this.queries || !this.schema || !this.dialect) {
+            throw new alerts_errors_1.AlertStoreUnavailableError('The telemetry slice is not installed in this application.');
+        }
+        try {
+            const schema = await this.schema.getSchema();
+            const inner = (0, index_4.createQueryFacade)(this.queries, null, {
+                source: 'alert',
+                dialect: this.dialect,
+                signal,
+                maxStatements: STATEMENTS_PER_EVALUATION,
+            });
+            const query = Object.freeze({
+                sql: inner.sql,
+                dialect: inner.dialect,
+                query: async (sql, options) => {
+                    try {
+                        return await inner.query(sql, options);
+                    }
+                    catch (error) {
+                        throw toAlertStoreError(error);
+                    }
+                },
+            });
+            return { query, tables: metricTablesOfSchema(schema, this.dialect) };
+        }
+        catch (error) {
+            throw toAlertStoreError(error);
+        }
+    }
+    async readVerdict() {
+        if (!this.dashboard)
+            throw new alerts_errors_1.AlertStoreUnavailableError('The telemetry slice is not installed in this application.');
+        try {
+            const summary = await this.dashboard.summary(null, {});
+            return { level: summary.verdict.level, reasons: summary.verdict.reasons };
+        }
+        catch (error) {
+            throw toAlertStoreError(error);
+        }
+    }
+    async readStale() {
+        if (!this.lifecycle) {
+            this.logger.debug('NodeLifecycleService is not available; using the shipped stale window.');
+            return index_2.DEFAULT_NODES_POLICY.staleHeartbeatSeconds;
+        }
+        return (await this.lifecycle.getPolicy()).staleHeartbeatSeconds;
+    }
+};
+exports.AlertContextService = AlertContextService;
+exports.AlertContextService = AlertContextService = AlertContextService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(index_1.PLATFORM_PRISMA)),
+    __param(1, (0, common_1.Optional)()),
+    __param(2, (0, common_1.Optional)()),
+    __param(3, (0, common_1.Optional)()),
+    __param(3, (0, common_1.Inject)(index_4.TELEMETRY_SQL_DIALECT)),
+    __param(4, (0, common_1.Optional)()),
+    __param(5, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [Object, index_4.TelemetryQueryService,
+        index_4.TelemetrySchemaService, Object, index_4.TelemetryDashboardService,
+        index_3.NodeLifecycleService])
+], AlertContextService);
+//# sourceMappingURL=alerts-context.service.js.map

package/dist/alerts/alerts-context.service.js.map

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

package/dist/alerts/alerts-dispatch.service.d.ts

@@ -0,0 +1,53 @@
+import { ConfigService } from '@nestjs/config';
+import { NotificationsService } from '../notifications/index';
+import { AlertsMetrics } from './alerts.metrics';
+import type { AlertsWebhookEmitter } from './alerts.types';
+import type { AlertIncidentRow, AlertRuleRow } from './data/alerts-db';
+/**
+ * One webhook event the slice emits.
+ *
+ * @stability experimental
+ */
+export interface AlertWebhookEventDef {
+    /** The event key. */
+    readonly key: string;
+    /** The label a webhooks catalog shows. */
+    readonly label: string;
+    /** One sentence on when it is emitted. */
+    readonly description: string;
+}
+/**
+ * The webhook event keys the slice emits, with the labels a webhooks slice
+ * shows in its catalog.
+ *
+ * @stability experimental
+ */
+export declare const ALERT_WEBHOOK_EVENT_DEFS: readonly AlertWebhookEventDef[];
+/**
+ * Sends the two things a fired or resolved incident causes: the notification
+ * to the holders of `alerts:read` and the optional webhook. Called AFTER the
+ * incident write committed (the evaluator never opens a transaction), and it
+ * never throws: a failed dispatch is logged and the incident stands.
+ *
+ * @stability experimental
+ */
+export declare class AlertsDispatchService {
+    private readonly metrics;
+    private readonly notifications?;
+    private readonly webhooks?;
+    private readonly config?;
+    private readonly logger;
+    constructor(metrics: AlertsMetrics, notifications?: NotificationsService | undefined, webhooks?: AlertsWebhookEmitter | undefined, config?: ConfigService | undefined);
+    /**
+     * Dispatches one transition.
+     *
+     * @param to - `fired` or `resolved`.
+     * @param rule - the rule.
+     * @param incident - the incident as just written.
+     * @param notify - whether the notification is sent (false inside a cooldown); the webhook and the metric follow the transition regardless.
+     */
+    dispatch(to: 'fired' | 'resolved', rule: AlertRuleRow, incident: AlertIncidentRow, notify: boolean): Promise<void>;
+    private notify;
+    private emitWebhook;
+}
+//# sourceMappingURL=alerts-dispatch.service.d.ts.map

package/dist/alerts/alerts-dispatch.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts-dispatch.service.d.ts","sourceRoot":"","sources":["../../src/alerts/alerts-dispatch.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAM9D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGvE;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,qBAAqB;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,oBAAoB,EAGnE,CAAC;AAOF;;;;;;;GAOG;AACH,qBACa,qBAAqB;IAI9B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACZ,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IACC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IANtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;gBAG9C,OAAO,EAAE,aAAa,EACV,aAAa,CAAC,EAAE,oBAAoB,YAAA,EACJ,QAAQ,CAAC,EAAE,oBAAoB,YAAA,EAC/D,MAAM,CAAC,EAAE,aAAa,YAAA;IASrD;;;;;;;OAOG;IACG,QAAQ,CAAC,EAAE,EAAE,OAAO,GAAG,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxH,OAAO,CAAC,MAAM;YAgCA,WAAW;CAiB1B"}