@marinoscar/platform-api 0.1.0-next.19 → 0.1.0-next.21

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @marinoscar/platform-api
 
+## 0.1.0-next.21
+
+### Patch Changes
+
+- 3d4b937: Record the `webhookDeliveryDuration` histogram for a delivery attempt that completes in 0 ms. The handler skipped the measurement when the elapsed time was zero; it now skips only when no attempt ran (the endpoint was gone or disabled before sending).
+  - @marinoscar/platform-contract@0.1.0-next.21
+  - @marinoscar/platform-ai-providers@0.1.0-next.21
+
+## 0.1.0-next.20
+
+### Minor Changes
+
+- 7b5796f: Add the `alerts` slice (#1047). `@marinoscar/platform-contract/alerts` carries the wire shapes (rules, the configs of the built-in kinds, incidents, the dry-run response, the kind catalog, the summary). `@marinoscar/platform-api/alerts` adds `AlertsModule.forRoot`, the open rule-kind registry (`registerAlertRuleKind`) with the `metric_threshold`, `node_event`, `verdict`, `node_offline` and `telemetry_unavailable` kinds, the pending/firing/resolved state machine, the `alerts.evaluate`, `alerts.evaluate_event` and `alerts.incidents_purge` server-only jobs, notifications on a transition with an optional webhook port (`ALERTS_WEBHOOK_EMITTER`), eight disabled starter rules, the `/api/admin/alerts` routes behind the new `alerts:read` and `alerts:write` permissions, and the `alerts` conformance suite (`@marinoscar/platform-api/alerts/testing`). The telemetry slice now exports `TelemetryDashboardService` and `createQueryFacade`, accepts a `null` (system) user and an `alert` query source, and the nodes slice exports `deriveNodeHealth`. `@marinoscar/platform-db` adds migration `0040_add_alerts` (`alert_rules`, `alert_incidents` and the raw-SQL partial unique index `alert_incidents_open_uniq_idx`).
+- 6949b6b: Worker nodes report host vitals, power state and events (#1045). Contract: `vitals.host` and `vitals.power`, heartbeat `events` (at most 50, `nodeEventSchema`, `NODE_EVENT_TYPES`), `serverFeatures` / `NODE_SERVER_CAPABILITY_HOST_VITALS` (`node_host_vitals`), the admin event list schemas and `nodeEventListQuerySchema`; the nodes telemetry presentation gains host CPU, host memory, load, power source and battery columns. API: `POST /api/nodes/register` and `POST /api/nodes/:id/heartbeat` advertise `serverFeatures` (the heartbeat repeats it beside the node fields, so a node that never re-registers learns it); heartbeat `events` are persisted to `worker_node_events` (occurredAt clamped to [now-24h, now+5m], at most 120 events per node per hour, the excess dropped and logged) and announced after the write as the `nodes.node.event` domain event (`NODE_EVENT_REPORTED`, `NodeEventReportedEvent`), an `app.nodes.events` counter, a bounded `node.event` span and a log line; `GET /api/nodes/:id/events` (`nodes:read`, same 404/403 answers as `GET /api/nodes/:id`) and `GET /api/admin/nodes/:id/events` (Admin role, `nodes:read`) list them; new gauges `app.nodes.host.cpu.utilization`, `app.nodes.host.memory.used|total|available`, `app.nodes.host.load1`, `app.nodes.power.on_battery` and `app.nodes.power.battery_percent` (a series is skipped when the node did not report the field); the telemetry `nodes` group shows them per node and a node on battery at 10 % or less degrades the dashboard verdict; the daily `nodes.node_events_purge` job (enqueued by `NodeEventsPurgeTask`, kept for `NodesModule.forRoot({ nodeEventsRetentionDays })`, default 30 days, switch `tasks.nodeEventsPurge`) deletes old events. The jobs slice's `JobsTx` gains the `workerNodeEvent` delegate. DB: migration `0038_add_worker_node_events` (already shipped with the table). CLI: the node samples host CPU, load and memory, probes power per OS, turns transitions into events and sends them only after the server advertises `node_host_vitals`, learned from the register response or from any heartbeat response; an already-registered node no longer re-registers on start.
+- fb02006: Add the `@marinoscar/platform-api/webhooks` slice and its `/testing` entry (issue #1046): signed outbound webhooks for a member, an organization or the deployment (`/api/webhooks`, `/api/org/webhooks`, `/api/admin/webhooks`), an open event registry (`registerWebhookEvent`) with built-in node and job events, `WebhooksService.emit`, an SSRF-safe egress guard with a pinned address, signing secrets in the credentials store, the server-only `webhooks.deliver`, `webhooks.fanout` and `webhooks.deliveries_purge` jobs with retries and a circuit breaker, the `webhook` notification channel and `webhooks.endpoint_disabled` event, the `webhooks:*`, `org_webhooks:*` and `system_webhooks:*` permissions (added to `@marinoscar/platform-api/manifest`), the `webhooks` conformance suite and an in-memory test kit. Core gains `isBlockedAddress` (public-address classification). Needs platform migration `0039_add_webhooks`.
+
+### Patch Changes
+
+- Updated dependencies [7b5796f]
+- Updated dependencies [6949b6b]
+- Updated dependencies [f3b9700]
+  - @marinoscar/platform-contract@0.1.0-next.20
+  - @marinoscar/platform-ai-providers@0.1.0-next.20
+
 ## 0.1.0-next.19
 
 ### Minor Changes

package/README.md

@@ -26,6 +26,7 @@ Status: pre-release (the current channel and how to install it: the [release run
 - `@marinoscar/platform-api/telemetry` and `@marinoscar/platform-api/telemetry/testing`: the API side of observability: the `telemetry` settings and runtime export gate, the runtime GreptimeDB connection, the explorer, the AI assistant, the dashboard with its metric-group registry and health verdict, the stack-agent surface, two server-only job types, five Doctor checks and a support-bundle section; the `telemetry` conformance suite. [README](src/telemetry/README.md).
 - `@marinoscar/platform-api/sharing` and `@marinoscar/platform-api/sharing/testing`: sharing primitives: groups, members and invites inside an organization, the ownership contract, grants (user, group and link), `AccessPolicy`, the "resources I can see" query helpers, link shares and the public-route pattern; the `sharing` conformance suite. [README](src/sharing/README.md).
 - `@marinoscar/platform-api/notifications` and `@marinoscar/platform-api/notifications/testing`: the notification framework: the event, channel and template registries, the dispatcher and its policy (system, then organization), the email, in-app and Web Push channels, runtime Web Push keys, admin broadcasts and the SSE stream; the `notifications` conformance suite. [README](src/notifications/README.md).
+- `@marinoscar/platform-api/alerts` and `@marinoscar/platform-api/alerts/testing`: alert rules over telemetry metrics, node events and fleet health, incidents with a pending/firing/resolved state machine, notifications and an optional webhook on a transition, the admin routes; the conformance suite and in-memory fakes of its `testing` entry. [README](src/alerts/README.md).
 - `@marinoscar/platform-api/android-app` and `@marinoscar/platform-api/android-app/testing`: the server half of the Android companion: trusted apps and the Digital Asset Links route, hosted APK releases, the `android_app` notification channel and the test notification; the conformance suites of its `testing` entry. [README](src/android-app/README.md).
 - `@marinoscar/platform-api/user-data` and `@marinoscar/platform-api/user-data/testing`: the per-user data deletion with scopes, the admin factory reset and organization offboarding, built from the category, scope, keep-or-delete hint, factory-reset step and offboarding-precondition registries; the conformance suites of its `testing` entry. [README](src/user-data/README.md).
 - `@marinoscar/platform-api/manifest`: what every platform slice registers, in registration order (#866): the platform roles and every slice's permission sets in seed order (`PLATFORM_ROLES`, `PLATFORM_PERMISSION_SETS`, `PLATFORM_PERMISSIONS`), `registerPlatformPermissions()` and its pure twin `platformPermissionCatalog()` (both take the app's own roles and permissions and an optional `slices` filter), and the inventory of platform models with a foreign key to `User` (`PLATFORM_USER_OWNED_MODELS`, `registerPlatformUserOwnedModels()`). Data and plain functions, no Nest module. [README](src/manifest/README.md).

package/dist/alerts/alerts-admin.controller.d.ts

@@ -0,0 +1,40 @@
+import { type AlertIncident, type AlertKind, type AlertRule, type AlertRuleTestResponse, type AlertSummary } from '@marinoscar/platform-contract/alerts';
+import { AlertsEvaluationService } from './alerts-evaluation.service';
+import { AlertsIncidentsService, type AlertIncidentPage } from './alerts-incidents.service';
+import { AlertsRulesService } from './alerts-rules.service';
+import { AlertIncidentListQueryDto, AlertRuleListQueryDto, CreateAlertRuleDto, UpdateAlertRuleDto } from './dto/alerts.dto';
+/**
+ * The alerts admin routes: rules, the kind catalog, incidents and the firing
+ * summary.
+ *
+ * @stability experimental
+ */
+export declare class AlertsAdminController {
+    private readonly rules;
+    private readonly incidents;
+    private readonly evaluation;
+    constructor(rules: AlertsRulesService, incidents: AlertsIncidentsService, evaluation: AlertsEvaluationService);
+    /** Lists the rules. */
+    listRules(query: AlertRuleListQueryDto): Promise<AlertRule[]>;
+    /** Creates a rule. */
+    createRule(body: CreateAlertRuleDto, userId: string): Promise<AlertRule>;
+    /** One rule. */
+    getRule(id: string): Promise<AlertRule>;
+    /** Updates a rule. */
+    updateRule(id: string, body: UpdateAlertRuleDto): Promise<AlertRule>;
+    /** Deletes a rule. */
+    deleteRule(id: string): Promise<void>;
+    /** Evaluates a rule now without storing or dispatching anything. */
+    testRule(id: string): Promise<AlertRuleTestResponse>;
+    /** The registered kinds. */
+    listKinds(): AlertKind[];
+    /** Lists incidents. */
+    listIncidents(query: AlertIncidentListQueryDto): Promise<AlertIncidentPage>;
+    /** One incident. */
+    getIncident(id: string): Promise<AlertIncident>;
+    /** Acknowledges an incident. */
+    acknowledge(id: string, userId: string): Promise<AlertIncident>;
+    /** The firing summary. */
+    summary(): Promise<AlertSummary>;
+}
+//# sourceMappingURL=alerts-admin.controller.d.ts.map

package/dist/alerts/alerts-admin.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts-admin.controller.d.ts","sourceRoot":"","sources":["../../src/alerts/alerts-admin.controller.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EAClB,MAAM,sCAAsC,CAAC;AAI9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,KAAK,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC5F,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAEL,yBAAyB,EAGzB,qBAAqB,EAGrB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAmC1B;;;;;GAKG;AACH,qBAEa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAFV,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,sBAAsB,EACjC,UAAU,EAAE,uBAAuB;IAGtD,uBAAuB;IAMvB,SAAS,CAAU,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAItE,sBAAsB;IAWtB,UAAU,CAAS,IAAI,EAAE,kBAAkB,EAAqB,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAInG,gBAAgB;IAQhB,OAAO,CAA6B,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAInE,sBAAsB;IAYtB,UAAU,CAA6B,EAAE,EAAE,MAAM,EAAU,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC;IAIxG,sBAAsB;IAUhB,UAAU,CAA6B,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE,oEAAoE;IAY9D,QAAQ,CAA6B,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAmBtF,4BAA4B;IAM5B,SAAS,IAAI,SAAS,EAAE;IAWxB,uBAAuB;IAMvB,aAAa,CAAU,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIpF,oBAAoB;IAQpB,WAAW,CAA6B,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI3E,gCAAgC;IAShC,WAAW,CAA6B,EAAE,EAAE,MAAM,EAAqB,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI9G,0BAA0B;IAM1B,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;CAGjC"}

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"}