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

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

@@ -0,0 +1,135 @@
+"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 AlertsDispatchService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlertsDispatchService = exports.ALERT_WEBHOOK_EVENT_DEFS = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const alerts_1 = require("@marinoscar/platform-contract/alerts");
+const index_1 = require("../notifications/index");
+const alerts_constants_1 = require("./alerts.constants");
+const alerts_metrics_1 = require("./alerts.metrics");
+/**
+ * The webhook event keys the slice emits, with the labels a webhooks slice
+ * shows in its catalog.
+ *
+ * @stability experimental
+ */
+exports.ALERT_WEBHOOK_EVENT_DEFS = [
+    { key: alerts_1.ALERT_WEBHOOK_EVENTS.FIRED, label: 'Alert fired', description: 'An alert rule started firing.' },
+    { key: alerts_1.ALERT_WEBHOOK_EVENTS.RESOLVED, label: 'Alert resolved', description: 'A firing alert cleared.' },
+];
+function labelsOf(incident) {
+    const raw = incident.labels;
+    return raw && typeof raw === 'object' ? raw : {};
+}
+/**
+ * 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
+ */
+let AlertsDispatchService = AlertsDispatchService_1 = class AlertsDispatchService {
+    metrics;
+    notifications;
+    webhooks;
+    config;
+    logger = new common_1.Logger(AlertsDispatchService_1.name);
+    constructor(metrics, notifications, webhooks, config) {
+        this.metrics = metrics;
+        this.notifications = notifications;
+        this.webhooks = webhooks;
+        this.config = config;
+        try {
+            this.webhooks?.registerEvents?.(exports.ALERT_WEBHOOK_EVENT_DEFS);
+        }
+        catch (error) {
+            this.logger.warn(`The webhook emitter refused the alert events: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * 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.
+     */
+    async dispatch(to, rule, incident, notify) {
+        this.metrics.transition(to, incident.severity);
+        if (notify)
+            this.notify(to, rule, incident);
+        await this.emitWebhook(to, rule, incident);
+    }
+    notify(to, rule, incident) {
+        if (!this.notifications)
+            return;
+        try {
+            const appUrl = this.config?.get('appUrl');
+            const data = {
+                incidentId: incident.id,
+                ruleId: rule.id,
+                ruleName: rule.name,
+                severity: incident.severity,
+                state: to,
+                summary: incident.summary,
+                labels: labelsOf(incident),
+                value: incident.lastValue,
+                firedAt: incident.firedAt,
+                resolvedAt: incident.resolvedAt,
+                ...(appUrl ? { appUrl: appUrl.replace(/\/+$/, '') } : {}),
+            };
+            void this.notifications
+                .notifyPermissionHolders(to === 'fired' ? alerts_constants_1.ALERT_FIRED_NOTIFICATION : alerts_constants_1.ALERT_RESOLVED_NOTIFICATION, alerts_1.ALERT_PERMISSIONS.READ, data, rule.notifyChannels.length > 0 ? { channels: rule.notifyChannels } : undefined)
+                .catch((error) => {
+                this.logger.error(`Dispatching the '${to}' alert notification for incident ${incident.id} rejected: ${error instanceof Error ? error.message : String(error)}`);
+            });
+        }
+        catch (error) {
+            this.logger.error(`Could not raise the '${to}' alert notification for incident ${incident.id}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async emitWebhook(to, rule, incident) {
+        if (!this.webhooks || !rule.webhook)
+            return;
+        try {
+            const data = {
+                incidentId: incident.id,
+                rule: { id: rule.id, key: rule.key, name: rule.name, kind: rule.kind, severity: rule.severity },
+                labels: labelsOf(incident),
+                value: incident.lastValue,
+                summary: incident.summary,
+                firedAt: incident.firedAt ? incident.firedAt.toISOString() : null,
+                resolvedAt: incident.resolvedAt ? incident.resolvedAt.toISOString() : null,
+            };
+            await this.webhooks.emit(to === 'fired' ? alerts_1.ALERT_WEBHOOK_EVENTS.FIRED : alerts_1.ALERT_WEBHOOK_EVENTS.RESOLVED, data, { orgId: null });
+        }
+        catch (error) {
+            this.logger.error(`Could not emit the '${to}' alert webhook for incident ${incident.id}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+};
+exports.AlertsDispatchService = AlertsDispatchService;
+exports.AlertsDispatchService = AlertsDispatchService = AlertsDispatchService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, common_1.Optional)()),
+    __param(2, (0, common_1.Optional)()),
+    __param(2, (0, common_1.Inject)(alerts_constants_1.ALERTS_WEBHOOK_EMITTER)),
+    __param(3, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [alerts_metrics_1.AlertsMetrics,
+        index_1.NotificationsService, Object, config_1.ConfigService])
+], AlertsDispatchService);
+//# sourceMappingURL=alerts-dispatch.service.js.map

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

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

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

@@ -0,0 +1,88 @@
+import type { AlertObservation } from '@marinoscar/platform-contract/alerts';
+import { AlertContextService } from './alerts-context.service';
+import { AlertsDispatchService } from './alerts-dispatch.service';
+import type { ResolvedAlertsModuleOptions } from './alerts.options';
+import type { AlertNodeEventPayload } from './alerts.types';
+import type { AlertRuleRow, AlertsPrisma } from './data/alerts-db';
+/**
+ * What one rule's evaluation did.
+ *
+ * @stability experimental
+ */
+export interface AlertEvaluationOutcome {
+    /** The rule. */
+    readonly ruleId: string;
+    /** `ok`, or `error` (the kind failed, timed out or is not registered; incidents were left alone). */
+    readonly status: 'ok' | 'error';
+    /** The error message when `status` is `error`. */
+    readonly error: string | null;
+    /** Incidents created. */
+    readonly opened: number;
+    /** Incidents that moved to firing (now or on creation). */
+    readonly fired: number;
+    /** Incidents that resolved. */
+    readonly resolved: number;
+}
+/**
+ * Whether `error` is a unique-constraint violation (Prisma `P2002`).
+ *
+ * @param error - what a write threw.
+ * @returns whether it is `P2002`.
+ *
+ * @stability experimental
+ */
+export declare function isUniqueViolation(error: unknown): boolean;
+/**
+ * Runs the enabled rules: evaluates each kind, isolates failures per rule,
+ * then applies the state machine to the observations. Evaluation is
+ * IDEMPOTENT: two passes over the same data leave one incident (the partial
+ * unique index arbitrates a race), and every state change is a conditional
+ * write so a concurrent pass cannot dispatch the same transition twice.
+ *
+ * It never opens a transaction, so a dispatch always follows a committed write.
+ *
+ * @stability experimental
+ */
+export declare class AlertsEvaluationService {
+    private readonly prisma;
+    private readonly contexts;
+    private readonly dispatcher;
+    private readonly options;
+    private readonly logger;
+    constructor(prisma: AlertsPrisma, contexts: AlertContextService, dispatcher: AlertsDispatchService, options: ResolvedAlertsModuleOptions);
+    /**
+     * Evaluates every enabled rule (or only the event-driven ones that `event`
+     * can change).
+     *
+     * @param scope - `{ event }` restricts to rules of event-driven kinds whose kind says the event matters.
+     * @returns one outcome per rule evaluated.
+     */
+    evaluateEnabled(scope?: {
+        event?: AlertNodeEventPayload;
+    }): Promise<AlertEvaluationOutcome[]>;
+    /**
+     * Evaluates one rule and applies its observations. Never throws: a failure
+     * is recorded on the rule (`lastError`) and returned.
+     *
+     * @param rule - the rule row.
+     * @param now - the instant (a test seam).
+     * @returns what happened.
+     */
+    evaluateRule(rule: AlertRuleRow, now?: Date): Promise<AlertEvaluationOutcome>;
+    /**
+     * Evaluates a rule WITHOUT touching state or dispatching: the dry run behind
+     * `POST /rules/:id/test`.
+     *
+     * @param rule - the rule row.
+     * @param now - the instant.
+     * @returns the observations.
+     * @throws whatever the kind throws (the caller reports it).
+     */
+    observe(rule: AlertRuleRow, now?: Date): Promise<AlertObservation[]>;
+    private stamp;
+    private apply;
+    private create;
+    private fired;
+    private previousResolvedAt;
+}
+//# sourceMappingURL=alerts-evaluation.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"alerts-evaluation.service.d.ts","sourceRoot":"","sources":["../../src/alerts/alerts-evaluation.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAG7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAiB,MAAM,gBAAgB,CAAC;AAC3E,OAAO,KAAK,EAAoB,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAIrF;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,gBAAgB;IAChB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qGAAqG;IACrG,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IAChC,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,yBAAyB;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEzD;AAUD;;;;;;;;;;GAUG;AACH,qBACa,uBAAuB;IAIP,OAAO,CAAC,QAAQ,CAAC,MAAM;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO;IANlD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4C;gBAGvB,MAAM,EAAE,YAAY,EAC7C,QAAQ,EAAE,mBAAmB,EAC7B,UAAU,EAAE,qBAAqB,EACT,OAAO,EAAE,2BAA2B;IAG/E;;;;;;OAMG;IACG,eAAe,CAAC,KAAK,GAAE;QAAE,KAAK,CAAC,EAAE,qBAAqB,CAAA;KAAO,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAgBvG;;;;;;;OAOG;IACG,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAyB/F;;;;;;;;OAQG;IACH,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;YA6BlE,KAAK;YAQL,KAAK;YAyFL,MAAM;YA4BN,KAAK;YAKL,kBAAkB;CAQjC"}

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

@@ -0,0 +1,296 @@
+"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 AlertsEvaluationService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlertsEvaluationService = void 0;
+exports.isUniqueViolation = isUniqueViolation;
+const common_1 = require("@nestjs/common");
+const index_1 = require("../core/index");
+const alerts_context_service_1 = require("./alerts-context.service");
+const alerts_dispatch_service_1 = require("./alerts-dispatch.service");
+const alerts_constants_1 = require("./alerts.constants");
+const alerts_errors_1 = require("./alerts.errors");
+const alert_kind_registry_1 = require("./kinds/alert-kind.registry");
+const alert_state_machine_1 = require("./state/alert-state-machine");
+/**
+ * Whether `error` is a unique-constraint violation (Prisma `P2002`).
+ *
+ * @param error - what a write threw.
+ * @returns whether it is `P2002`.
+ *
+ * @stability experimental
+ */
+function isUniqueViolation(error) {
+    return typeof error === 'object' && error !== null && error.code === 'P2002';
+}
+function message(error) {
+    return (error instanceof Error ? error.message : String(error)).slice(0, 500);
+}
+function clampSummary(text) {
+    return text.length > 500 ? `${text.slice(0, 499)}…` : text;
+}
+/**
+ * Runs the enabled rules: evaluates each kind, isolates failures per rule,
+ * then applies the state machine to the observations. Evaluation is
+ * IDEMPOTENT: two passes over the same data leave one incident (the partial
+ * unique index arbitrates a race), and every state change is a conditional
+ * write so a concurrent pass cannot dispatch the same transition twice.
+ *
+ * It never opens a transaction, so a dispatch always follows a committed write.
+ *
+ * @stability experimental
+ */
+let AlertsEvaluationService = AlertsEvaluationService_1 = class AlertsEvaluationService {
+    prisma;
+    contexts;
+    dispatcher;
+    options;
+    logger = new common_1.Logger(AlertsEvaluationService_1.name);
+    constructor(prisma, contexts, dispatcher, options) {
+        this.prisma = prisma;
+        this.contexts = contexts;
+        this.dispatcher = dispatcher;
+        this.options = options;
+    }
+    /**
+     * Evaluates every enabled rule (or only the event-driven ones that `event`
+     * can change).
+     *
+     * @param scope - `{ event }` restricts to rules of event-driven kinds whose kind says the event matters.
+     * @returns one outcome per rule evaluated.
+     */
+    async evaluateEnabled(scope = {}) {
+        const rules = await this.prisma.alertRule.findMany({ where: { enabled: true }, orderBy: { createdAt: 'asc' } });
+        const outcomes = [];
+        for (const rule of rules) {
+            if (scope.event) {
+                const kind = alert_kind_registry_1.alertRuleKindRegistry.get(rule.kind);
+                if (!kind?.eventDriven)
+                    continue;
+                const config = kind.configSchema.safeParse(rule.config);
+                if (!config.success || (kind.matchesEvent && !kind.matchesEvent(config.data, scope.event)))
+                    continue;
+            }
+            outcomes.push(await this.evaluateRule(rule));
+        }
+        return outcomes;
+    }
+    /**
+     * Evaluates one rule and applies its observations. Never throws: a failure
+     * is recorded on the rule (`lastError`) and returned.
+     *
+     * @param rule - the rule row.
+     * @param now - the instant (a test seam).
+     * @returns what happened.
+     */
+    async evaluateRule(rule, now = new Date()) {
+        let observations;
+        try {
+            observations = await this.observe(rule, now);
+        }
+        catch (error) {
+            if (error instanceof alerts_errors_1.AlertStoreUnavailableError) {
+                this.logger.warn(`Alert rule "${rule.name}" (${rule.id}): ${error.message}`);
+            }
+            else {
+                this.logger.error(`Alert rule "${rule.name}" (${rule.id}) failed: ${message(error)}`);
+            }
+            await this.stamp(rule.id, now, message(error));
+            return { ruleId: rule.id, status: 'error', error: message(error), opened: 0, fired: 0, resolved: 0 };
+        }
+        try {
+            const counts = await this.apply(rule, observations, now);
+            await this.stamp(rule.id, now, null);
+            return { ruleId: rule.id, status: 'ok', error: null, ...counts };
+        }
+        catch (error) {
+            this.logger.error(`Alert rule "${rule.name}" (${rule.id}) could not apply its observations: ${message(error)}`);
+            await this.stamp(rule.id, now, message(error));
+            return { ruleId: rule.id, status: 'error', error: message(error), opened: 0, fired: 0, resolved: 0 };
+        }
+    }
+    /**
+     * Evaluates a rule WITHOUT touching state or dispatching: the dry run behind
+     * `POST /rules/:id/test`.
+     *
+     * @param rule - the rule row.
+     * @param now - the instant.
+     * @returns the observations.
+     * @throws whatever the kind throws (the caller reports it).
+     */
+    observe(rule, now = new Date()) {
+        const kind = alert_kind_registry_1.alertRuleKindRegistry.get(rule.kind);
+        if (!kind)
+            return Promise.reject(new Error(`The alert rule kind "${rule.kind}" is not registered.`));
+        const parsed = kind.configSchema.safeParse(rule.config);
+        if (!parsed.success)
+            return Promise.reject(new Error(`The rule's config no longer matches the "${rule.kind}" kind.`));
+        const controller = new AbortController();
+        const view = {
+            id: rule.id,
+            key: rule.key,
+            name: rule.name,
+            severity: rule.severity,
+            kind: rule.kind,
+            config: parsed.data,
+        };
+        const ctx = this.contexts.create(controller.signal, now);
+        let timer;
+        const budget = new Promise((_resolve, reject) => {
+            timer = setTimeout(() => {
+                controller.abort(new Error('time budget spent'));
+                reject(new Error(`Evaluation took longer than ${this.options.evaluationBudgetMs} ms and was abandoned.`));
+            }, this.options.evaluationBudgetMs);
+            timer.unref?.();
+        });
+        return Promise.race([kind.evaluate(ctx, view), budget]).finally(() => clearTimeout(timer));
+    }
+    async stamp(ruleId, now, lastError) {
+        try {
+            await this.prisma.alertRule.updateMany({ where: { id: ruleId }, data: { lastEvaluatedAt: now, lastError } });
+        }
+        catch (error) {
+            this.logger.warn(`Could not record the evaluation of rule ${ruleId}: ${message(error)}`);
+        }
+    }
+    async apply(rule, observations, now) {
+        const byKey = new Map();
+        for (const observation of observations) {
+            const key = (0, alert_state_machine_1.labelsKeyOf)(observation.labels);
+            const existing = byKey.get(key);
+            // One observation per label set; a breached one wins over a clear one.
+            if (!existing || (observation.breached && !existing.breached))
+                byKey.set(key, observation);
+        }
+        const open = await this.prisma.alertIncident.findMany({ where: { ruleId: rule.id, state: { in: ['pending', 'firing'] } } });
+        const openByKey = new Map(open.map((incident) => [incident.labelsKey, incident]));
+        const counts = { opened: 0, fired: 0, resolved: 0 };
+        for (const key of new Set([...byKey.keys(), ...openByKey.keys()])) {
+            const incident = openByKey.get(key) ?? null;
+            const observation = byKey.get(key) ?? null;
+            const transition = (0, alert_state_machine_1.nextTransition)({
+                now,
+                open: incident ? { id: incident.id, state: incident.state, pendingSince: incident.pendingSince } : null,
+                observation,
+                forSeconds: rule.forSeconds,
+            });
+            const touch = {
+                severity: rule.severity,
+                lastValue: observation?.value ?? null,
+                lastSeenAt: now,
+                ...(observation ? { summary: clampSummary(observation.summary) } : {}),
+            };
+            switch (transition.type) {
+                case 'none':
+                    break;
+                case 'touch':
+                    await this.prisma.alertIncident.updateMany({ where: { id: incident.id, state: { in: ['pending', 'firing'] } }, data: touch });
+                    break;
+                case 'discard':
+                    await this.prisma.alertIncident.deleteMany({ where: { id: incident.id, state: 'pending' } });
+                    break;
+                case 'open': {
+                    const created = await this.create(rule, key, observation, transition.state ?? 'pending', now);
+                    if (!created)
+                        break; // a concurrent pass created it; the next pass handles it
+                    counts.opened += 1;
+                    if (transition.state === 'firing') {
+                        counts.fired += 1;
+                        await this.fired(rule, created);
+                    }
+                    break;
+                }
+                case 'promote': {
+                    const promoted = await this.prisma.alertIncident.updateMany({
+                        where: { id: incident.id, state: 'pending' },
+                        data: { ...touch, state: 'firing', firedAt: now },
+                    });
+                    if (promoted.count !== 1)
+                        break;
+                    counts.fired += 1;
+                    const row = await this.prisma.alertIncident.findUnique({ where: { id: incident.id } });
+                    if (row)
+                        await this.fired(rule, row);
+                    break;
+                }
+                case 'resolve': {
+                    const previous = await this.previousResolvedAt(rule.id, key);
+                    const resolved = await this.prisma.alertIncident.updateMany({
+                        where: { id: incident.id, state: 'firing' },
+                        data: {
+                            state: 'resolved',
+                            resolvedAt: now,
+                            severity: rule.severity,
+                            ...(observation ? { summary: clampSummary(observation.summary), lastValue: observation.value } : {}),
+                        },
+                    });
+                    if (resolved.count !== 1)
+                        break;
+                    counts.resolved += 1;
+                    const row = await this.prisma.alertIncident.findUnique({ where: { id: incident.id } });
+                    if (row) {
+                        const notify = (0, alert_state_machine_1.shouldNotify)(row.firedAt ?? now, previous, rule.cooldownSeconds);
+                        await this.dispatcher.dispatch('resolved', rule, row, notify);
+                    }
+                    break;
+                }
+            }
+        }
+        return counts;
+    }
+    async create(rule, labelsKey, observation, state, now) {
+        try {
+            return await this.prisma.alertIncident.create({
+                data: {
+                    ruleId: rule.id,
+                    labelsKey,
+                    labels: observation.labels,
+                    state,
+                    severity: rule.severity,
+                    pendingSince: now,
+                    firedAt: state === 'firing' ? now : null,
+                    lastValue: observation.value,
+                    lastSeenAt: now,
+                    summary: clampSummary(observation.summary),
+                },
+            });
+        }
+        catch (error) {
+            if (isUniqueViolation(error))
+                return null; // alert_incidents_open_uniq_idx: one open incident per rule and labels
+            throw error;
+        }
+    }
+    async fired(rule, incident) {
+        const previous = await this.previousResolvedAt(rule.id, incident.labelsKey);
+        await this.dispatcher.dispatch('fired', rule, incident, (0, alert_state_machine_1.shouldNotify)(incident.firedAt ?? new Date(), previous, rule.cooldownSeconds));
+    }
+    async previousResolvedAt(ruleId, labelsKey) {
+        const row = await this.prisma.alertIncident.findFirst({
+            where: { ruleId, labelsKey, state: 'resolved' },
+            orderBy: { resolvedAt: 'desc' },
+            select: { resolvedAt: true },
+        });
+        return row?.resolvedAt ?? null;
+    }
+};
+exports.AlertsEvaluationService = AlertsEvaluationService;
+exports.AlertsEvaluationService = AlertsEvaluationService = AlertsEvaluationService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(index_1.PLATFORM_PRISMA)),
+    __param(3, (0, common_1.Inject)(alerts_constants_1.ALERTS_OPTIONS)),
+    __metadata("design:paramtypes", [Object, alerts_context_service_1.AlertContextService,
+        alerts_dispatch_service_1.AlertsDispatchService, Object])
+], AlertsEvaluationService);
+//# sourceMappingURL=alerts-evaluation.service.js.map

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

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

package/dist/alerts/alerts-event.listener.d.ts

@@ -0,0 +1,22 @@
+import { JobsService } from '../jobs/index';
+import { type NodeEventReportedEvent } from '../nodes/index';
+/**
+ * Turns a node event into an `alerts.evaluate_event` job. ENQUEUE ONLY: the
+ * body does no I/O of its own and never evaluates a rule inline (the queue's
+ * rule 1; the `on-event-no-io` suite scans it). Every event gets its own job
+ * (`skipDedup`), because the job's payload says which event to look at.
+ *
+ * @stability experimental
+ */
+export declare class AlertsEventListener {
+    private readonly jobs;
+    private readonly logger;
+    constructor(jobs: JobsService);
+    /**
+     * Queues one `alerts.evaluate_event` job for a reported node event.
+     *
+     * @param event - the node event the nodes slice emitted after its write committed.
+     */
+    handleNodeEvent(event: NodeEventReportedEvent): void;
+}
+//# sourceMappingURL=alerts-event.listener.d.ts.map

package/dist/alerts/alerts-event.listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts-event.listener.d.ts","sourceRoot":"","sources":["../../src/alerts/alerts-event.listener.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAuB,KAAK,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAIlF;;;;;;;GAOG;AACH,qBACa,mBAAmB;IAGlB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;gBAElC,IAAI,EAAE,WAAW;IAE9C;;;;OAIG;IAEH,eAAe,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI;CAqBrD"}

package/dist/alerts/alerts-event.listener.js

@@ -0,0 +1,72 @@
+"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 AlertsEventListener_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlertsEventListener = void 0;
+const common_1 = require("@nestjs/common");
+const event_emitter_1 = require("@nestjs/event-emitter");
+const index_1 = require("../jobs/index");
+const index_2 = require("../nodes/index");
+const alerts_constants_1 = require("./alerts.constants");
+const index_3 = require("../jobs/index");
+/**
+ * Turns a node event into an `alerts.evaluate_event` job. ENQUEUE ONLY: the
+ * body does no I/O of its own and never evaluates a rule inline (the queue's
+ * rule 1; the `on-event-no-io` suite scans it). Every event gets its own job
+ * (`skipDedup`), because the job's payload says which event to look at.
+ *
+ * @stability experimental
+ */
+let AlertsEventListener = AlertsEventListener_1 = class AlertsEventListener {
+    jobs;
+    logger = new common_1.Logger(AlertsEventListener_1.name);
+    constructor(jobs) {
+        this.jobs = jobs;
+    }
+    /**
+     * Queues one `alerts.evaluate_event` job for a reported node event.
+     *
+     * @param event - the node event the nodes slice emitted after its write committed.
+     */
+    handleNodeEvent(event) {
+        void this.jobs
+            .enqueue({
+            type: alerts_constants_1.ALERTS_EVALUATE_EVENT_TYPE,
+            reason: 'backfill',
+            orgId: null,
+            priority: Math.min(index_3.HOUSEKEEPING_PRIORITY, 10),
+            skipDedup: true,
+            payload: {
+                nodeId: event.nodeId,
+                nodeName: event.nodeName,
+                type: event.type,
+                severity: event.severity,
+                attrs: { ...event.attrs },
+                occurredAt: event.occurredAt.toISOString(),
+            },
+        })
+            .catch((error) => {
+            this.logger.error(`Could not queue the alert evaluation for node event ${event.type}: ${error instanceof Error ? error.message : String(error)}`);
+        });
+    }
+};
+exports.AlertsEventListener = AlertsEventListener;
+__decorate([
+    (0, event_emitter_1.OnEvent)(index_2.NODE_EVENT_REPORTED),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Function]),
+    __metadata("design:returntype", void 0)
+], AlertsEventListener.prototype, "handleNodeEvent", null);
+exports.AlertsEventListener = AlertsEventListener = AlertsEventListener_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [index_1.JobsService])
+], AlertsEventListener);
+//# sourceMappingURL=alerts-event.listener.js.map

package/dist/alerts/alerts-event.listener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts-event.listener.js","sourceRoot":"","sources":["../../src/alerts/alerts-event.listener.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAoD;AACpD,yDAAgD;AAEhD,yCAA4C;AAC5C,0CAAkF;AAClF,yDAAgE;AAChE,yCAAsD;AAEtD;;;;;;;GAOG;AAEI,IAAM,mBAAmB,2BAAzB,MAAM,mBAAmB;IAGD;IAFZ,MAAM,GAAG,IAAI,eAAM,CAAC,qBAAmB,CAAC,IAAI,CAAC,CAAC;IAE/D,YAA6B,IAAiB;QAAjB,SAAI,GAAJ,IAAI,CAAa;IAAG,CAAC;IAElD;;;;OAIG;IAEH,eAAe,CAAC,KAA6B;QAC3C,KAAK,IAAI,CAAC,IAAI;aACX,OAAO,CAAC;YACP,IAAI,EAAE,6CAA0B;YAChC,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,6BAAqB,EAAE,EAAE,CAAC;YAC7C,SAAS,EAAE,IAAI;YACf,OAAO,EAAE;gBACP,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,KAAK,EAAE,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE;gBACzB,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE;aAC3C;SACF,CAAC;aACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uDAAuD,KAAK,CAAC,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpJ,CAAC,CAAC,CAAC;IACP,CAAC;CACF,CAAA;AAhCY,kDAAmB;AAW9B;IADC,IAAA,uBAAO,EAAC,2BAAmB,CAAC;;;;0DAqB5B;8BA/BU,mBAAmB;IAD/B,IAAA,mBAAU,GAAE;qCAIwB,mBAAW;GAHnC,mBAAmB,CAgC/B"}