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

package/dist/alerts/tasks/alerts-evaluate.task.d.ts

@@ -0,0 +1,18 @@
+import { JobsService } from '../../jobs/index';
+/**
+ * Queues `alerts.evaluate` every minute. It DECIDES nothing and DOES nothing
+ * else: the evaluation is the handler's, on a worker slot, observable as a job.
+ * The housekeeping helper keeps one in flight, so a slow evaluation never
+ * stacks a second behind it.
+ *
+ * @stability experimental
+ */
+export declare class AlertsEvaluateTask {
+    private readonly jobs;
+    private readonly prisma;
+    private readonly logger;
+    constructor(jobs: JobsService, prisma: unknown);
+    /** The cron tick. */
+    handleCron(): Promise<void>;
+}
+//# sourceMappingURL=alerts-evaluate.task.d.ts.map

package/dist/alerts/tasks/alerts-evaluate.task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts-evaluate.task.d.ts","sourceRoot":"","sources":["../../../src/alerts/tasks/alerts-evaluate.task.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAA2C,MAAM,kBAAkB,CAAC;AAGxF;;;;;;;GAOG;AACH,qBACa,kBAAkB;IAI3B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACI,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJlD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;gBAG3C,IAAI,EAAE,WAAW,EACQ,MAAM,EAAE,OAAO;IAG3D,qBAAqB;IAEf,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CASlC"}

package/dist/alerts/tasks/alerts-evaluate.task.js

@@ -0,0 +1,61 @@
+"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 AlertsEvaluateTask_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlertsEvaluateTask = void 0;
+const common_1 = require("@nestjs/common");
+const schedule_1 = require("@nestjs/schedule");
+const index_1 = require("../../core/index");
+const index_2 = require("../../jobs/index");
+const alerts_constants_1 = require("../alerts.constants");
+/**
+ * Queues `alerts.evaluate` every minute. It DECIDES nothing and DOES nothing
+ * else: the evaluation is the handler's, on a worker slot, observable as a job.
+ * The housekeeping helper keeps one in flight, so a slow evaluation never
+ * stacks a second behind it.
+ *
+ * @stability experimental
+ */
+let AlertsEvaluateTask = AlertsEvaluateTask_1 = class AlertsEvaluateTask {
+    jobs;
+    prisma;
+    logger = new common_1.Logger(AlertsEvaluateTask_1.name);
+    constructor(jobs, prisma) {
+        this.jobs = jobs;
+        this.prisma = prisma;
+    }
+    /** The cron tick. */
+    async handleCron() {
+        await (0, index_2.enqueueHousekeepingJob)({
+            jobs: this.jobs,
+            prisma: this.prisma,
+            logger: this.logger,
+            type: alerts_constants_1.ALERTS_EVALUATE_TYPE,
+            what: 'alert evaluation',
+        });
+    }
+};
+exports.AlertsEvaluateTask = AlertsEvaluateTask;
+__decorate([
+    (0, schedule_1.Cron)(schedule_1.CronExpression.EVERY_MINUTE),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], AlertsEvaluateTask.prototype, "handleCron", null);
+exports.AlertsEvaluateTask = AlertsEvaluateTask = AlertsEvaluateTask_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, common_1.Inject)(index_1.PLATFORM_PRISMA)),
+    __metadata("design:paramtypes", [index_2.JobsService, Object])
+], AlertsEvaluateTask);
+//# sourceMappingURL=alerts-evaluate.task.js.map

package/dist/alerts/tasks/alerts-evaluate.task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts-evaluate.task.js","sourceRoot":"","sources":["../../../src/alerts/tasks/alerts-evaluate.task.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAA4D;AAC5D,+CAAwD;AAExD,4CAAmD;AACnD,4CAAwF;AACxF,0DAA2D;AAE3D;;;;;;;GAOG;AAEI,IAAM,kBAAkB,0BAAxB,MAAM,kBAAkB;IAIV;IACyB;IAJ3B,MAAM,GAAG,IAAI,eAAM,CAAC,oBAAkB,CAAC,IAAI,CAAC,CAAC;IAE9D,YACmB,IAAiB,EACQ,MAAe;QADxC,SAAI,GAAJ,IAAI,CAAa;QACQ,WAAM,GAAN,MAAM,CAAS;IACxD,CAAC;IAEJ,qBAAqB;IAEf,AAAN,KAAK,CAAC,UAAU;QACd,MAAM,IAAA,8BAAsB,EAAC;YAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAoB;YACjC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,uCAAoB;YAC1B,IAAI,EAAE,kBAAkB;SACzB,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAnBY,gDAAkB;AAUvB;IADL,IAAA,eAAI,EAAC,yBAAc,CAAC,YAAY,CAAC;;;;oDASjC;6BAlBU,kBAAkB;IAD9B,IAAA,mBAAU,GAAE;IAMR,WAAA,IAAA,eAAM,EAAC,uBAAe,CAAC,CAAA;qCADD,mBAAW;GAJzB,kBAAkB,CAmB9B"}

package/dist/alerts/tasks/alerts-purge.task.d.ts

@@ -0,0 +1,15 @@
+import { JobsService } from '../../jobs/index';
+/**
+ * Queues `alerts.incidents_purge` daily. Enqueue only.
+ *
+ * @stability experimental
+ */
+export declare class AlertsPurgeTask {
+    private readonly jobs;
+    private readonly prisma;
+    private readonly logger;
+    constructor(jobs: JobsService, prisma: unknown);
+    /** The cron tick (03:17 UTC). */
+    handleCron(): Promise<void>;
+}
+//# sourceMappingURL=alerts-purge.task.d.ts.map

package/dist/alerts/tasks/alerts-purge.task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts-purge.task.d.ts","sourceRoot":"","sources":["../../../src/alerts/tasks/alerts-purge.task.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAA2C,MAAM,kBAAkB,CAAC;AAGxF;;;;GAIG;AACH,qBACa,eAAe;IAIxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACI,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJlD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;gBAGxC,IAAI,EAAE,WAAW,EACQ,MAAM,EAAE,OAAO;IAG3D,iCAAiC;IAE3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CASlC"}

package/dist/alerts/tasks/alerts-purge.task.js

@@ -0,0 +1,58 @@
+"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 AlertsPurgeTask_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlertsPurgeTask = void 0;
+const common_1 = require("@nestjs/common");
+const schedule_1 = require("@nestjs/schedule");
+const index_1 = require("../../core/index");
+const index_2 = require("../../jobs/index");
+const alerts_constants_1 = require("../alerts.constants");
+/**
+ * Queues `alerts.incidents_purge` daily. Enqueue only.
+ *
+ * @stability experimental
+ */
+let AlertsPurgeTask = AlertsPurgeTask_1 = class AlertsPurgeTask {
+    jobs;
+    prisma;
+    logger = new common_1.Logger(AlertsPurgeTask_1.name);
+    constructor(jobs, prisma) {
+        this.jobs = jobs;
+        this.prisma = prisma;
+    }
+    /** The cron tick (03:17 UTC). */
+    async handleCron() {
+        await (0, index_2.enqueueHousekeepingJob)({
+            jobs: this.jobs,
+            prisma: this.prisma,
+            logger: this.logger,
+            type: alerts_constants_1.ALERTS_INCIDENTS_PURGE_TYPE,
+            what: 'alert incident purge',
+        });
+    }
+};
+exports.AlertsPurgeTask = AlertsPurgeTask;
+__decorate([
+    (0, schedule_1.Cron)('17 3 * * *'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], AlertsPurgeTask.prototype, "handleCron", null);
+exports.AlertsPurgeTask = AlertsPurgeTask = AlertsPurgeTask_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, common_1.Inject)(index_1.PLATFORM_PRISMA)),
+    __metadata("design:paramtypes", [index_2.JobsService, Object])
+], AlertsPurgeTask);
+//# sourceMappingURL=alerts-purge.task.js.map

package/dist/alerts/tasks/alerts-purge.task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts-purge.task.js","sourceRoot":"","sources":["../../../src/alerts/tasks/alerts-purge.task.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAA4D;AAC5D,+CAAwC;AAExC,4CAAmD;AACnD,4CAAwF;AACxF,0DAAkE;AAElE;;;;GAIG;AAEI,IAAM,eAAe,uBAArB,MAAM,eAAe;IAIP;IACyB;IAJ3B,MAAM,GAAG,IAAI,eAAM,CAAC,iBAAe,CAAC,IAAI,CAAC,CAAC;IAE3D,YACmB,IAAiB,EACQ,MAAe;QADxC,SAAI,GAAJ,IAAI,CAAa;QACQ,WAAM,GAAN,MAAM,CAAS;IACxD,CAAC;IAEJ,iCAAiC;IAE3B,AAAN,KAAK,CAAC,UAAU;QACd,MAAM,IAAA,8BAAsB,EAAC;YAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAoB;YACjC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,8CAA2B;YACjC,IAAI,EAAE,sBAAsB;SAC7B,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAnBY,0CAAe;AAUpB;IADL,IAAA,eAAI,EAAC,YAAY,CAAC;;;;iDASlB;0BAlBU,eAAe;IAD3B,IAAA,mBAAU,GAAE;IAMR,WAAA,IAAA,eAAM,EAAC,uBAAe,CAAC,CAAA;qCADD,mBAAW;GAJzB,eAAe,CAmB3B"}

package/dist/alerts/testing/conformance.d.ts

@@ -0,0 +1,58 @@
+import type { ConformanceFinding, ConformanceSuite } from '../../testing/index';
+declare module '../../testing/index' {
+    interface PlatformConformanceSuiteOptions {
+        /** The alerts slice's suite: its options, or `false` to opt out. Registered by importing `@marinoscar/platform-api/alerts/testing`. */
+        alerts?: AlertsConformanceOptions | false;
+    }
+}
+/**
+ * What the `alerts` suite takes: the app's data, never its code.
+ *
+ * @stability experimental
+ */
+export interface AlertsConformanceOptions {
+    /** The names of the raw-SQL indexes the app's migrations install, so the suite proves the one-open-incident index is on the list. */
+    readonly rawSqlIndexNames: readonly string[];
+}
+/**
+ * One route of the slice, as the suite sees it.
+ *
+ * @stability experimental
+ */
+export interface AlertsRoute {
+    /** `Controller#handler`. */
+    readonly id: string;
+    /** The HTTP method name. */
+    readonly method: string;
+    /** Whether it is `@Public()`. */
+    readonly isPublic: boolean;
+    /** Whether `@Auth(...)` put a guard on it. */
+    readonly authenticated: boolean;
+    /** The permissions it requires. */
+    readonly permissions: readonly string[];
+}
+/**
+ * The routes of the slice's controller, read from its metadata.
+ *
+ * @returns every handler.
+ *
+ * @stability experimental
+ */
+export declare function discoverAlertsRoutes(): AlertsRoute[];
+/**
+ * The static invariants of the slice, as findings.
+ *
+ * @param options - the suite's options.
+ * @returns one finding per problem.
+ *
+ * @stability experimental
+ */
+export declare function checkAlertsStatic(options: AlertsConformanceOptions): ConformanceFinding[];
+/**
+ * The `alerts` conformance suite.
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare const alertsConformanceSuite: ConformanceSuite<AlertsConformanceOptions>;
+//# sourceMappingURL=conformance.d.ts.map

package/dist/alerts/testing/conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../../../src/alerts/testing/conformance.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAmB,kBAAkB,EAAqB,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAgBpH,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,+BAA+B;QACvC,uIAAuI;QACvI,MAAM,CAAC,EAAE,wBAAwB,GAAG,KAAK,CAAC;KAC3C;CACF;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,qIAAqI;IACrI,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,8CAA8C;IAC9C,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,mCAAmC;IACnC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,WAAW,EAAE,CAmBpD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,kBAAkB,EAAE,CAiCzF;AAmBD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,gBAAgB,CAAC,wBAAwB,CAwE7E,CAAC"}

package/dist/alerts/testing/conformance.js

@@ -0,0 +1,198 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.alertsConformanceSuite = void 0;
+exports.discoverAlertsRoutes = discoverAlertsRoutes;
+exports.checkAlertsStatic = checkAlertsStatic;
+const constants_1 = require("@nestjs/common/constants");
+const common_1 = require("@nestjs/common");
+const alerts_1 = require("@marinoscar/platform-contract/alerts");
+const index_1 = require("../../identity/index");
+const index_2 = require("../../testing/index");
+const alerts_admin_controller_1 = require("../alerts-admin.controller");
+const alerts_context_service_1 = require("../alerts-context.service");
+const alerts_dispatch_service_1 = require("../alerts-dispatch.service");
+const alerts_evaluation_service_1 = require("../alerts-evaluation.service");
+const alerts_seed_service_1 = require("../alerts-seed.service");
+const alerts_constants_1 = require("../alerts.constants");
+const alerts_metrics_1 = require("../alerts.metrics");
+const alerts_options_1 = require("../alerts.options");
+const alert_kind_registry_1 = require("../kinds/alert-kind.registry");
+const builtin_kinds_1 = require("../kinds/builtin-kinds");
+const alerts_event_listener_1 = require("../alerts-event.listener");
+const starter_rules_1 = require("../starter-rules");
+const fakes_1 = require("./fakes");
+/**
+ * The routes of the slice's controller, read from its metadata.
+ *
+ * @returns every handler.
+ *
+ * @stability experimental
+ */
+function discoverAlertsRoutes() {
+    const controller = alerts_admin_controller_1.AlertsAdminController;
+    const prototype = controller.prototype;
+    const routes = [];
+    for (const name of Object.getOwnPropertyNames(prototype)) {
+        const handler = prototype[name];
+        if (name === 'constructor' || typeof handler !== 'function')
+            continue;
+        const method = Reflect.getMetadata(constants_1.METHOD_METADATA, handler);
+        if (method === undefined || Reflect.getMetadata(constants_1.PATH_METADATA, handler) === undefined)
+            continue;
+        const guards = [...(Reflect.getMetadata(constants_1.GUARDS_METADATA, controller) ?? []), ...(Reflect.getMetadata(constants_1.GUARDS_METADATA, handler) ?? [])];
+        routes.push({
+            id: `${controller.name}#${name}`,
+            method: common_1.RequestMethod[method] ?? String(method),
+            isPublic: Reflect.getMetadata(index_1.IS_PUBLIC_KEY, handler) === true || Reflect.getMetadata(index_1.IS_PUBLIC_KEY, controller) === true,
+            authenticated: guards.length > 0,
+            permissions: [...(Reflect.getMetadata(index_1.PERMISSIONS_KEY, handler) ?? [])],
+        });
+    }
+    return routes;
+}
+/**
+ * The static invariants of the slice, as findings.
+ *
+ * @param options - the suite's options.
+ * @returns one finding per problem.
+ *
+ * @stability experimental
+ */
+function checkAlertsStatic(options) {
+    const findings = [];
+    for (const route of discoverAlertsRoutes()) {
+        if (route.isPublic)
+            findings.push({ file: route.id, message: 'no alerts route may be public' });
+        if (!route.authenticated)
+            findings.push({ file: route.id, message: 'declares no @Auth(...)' });
+        const wanted = route.method === 'GET' ? alerts_1.ALERT_PERMISSIONS.READ : alerts_1.ALERT_PERMISSIONS.WRITE;
+        if (route.permissions.length !== 1 || route.permissions[0] !== wanted) {
+            findings.push({ file: route.id, message: `must require exactly ${wanted} (got ${route.permissions.join(', ') || 'none'})` });
+        }
+    }
+    (0, builtin_kinds_1.registerBuiltinAlertKinds)();
+    for (const id of Object.values(alerts_1.ALERT_KIND_IDS)) {
+        if (!alert_kind_registry_1.alertRuleKindRegistry.has(id))
+            findings.push({ file: 'kinds', message: `built-in kind ${id} is not registered` });
+    }
+    const seen = new Set();
+    for (const { key, rule } of starter_rules_1.STARTER_ALERT_RULES) {
+        if (seen.has(key))
+            findings.push({ file: 'starter-rules', message: `duplicate starter key ${key}` });
+        seen.add(key);
+        if ('enabled' in rule && rule.enabled)
+            findings.push({ file: 'starter-rules', message: `${key} must be seeded disabled` });
+        const kind = alert_kind_registry_1.alertRuleKindRegistry.get(rule.kind);
+        if (!kind)
+            findings.push({ file: 'starter-rules', message: `${key} uses unregistered kind ${rule.kind}` });
+        else if (!kind.configSchema.safeParse(rule.config).success)
+            findings.push({ file: 'starter-rules', message: `${key} has a config its kind refuses` });
+    }
+    if (!options.rawSqlIndexNames.includes(alerts_constants_1.ALERT_OPEN_INCIDENT_INDEX)) {
+        findings.push({ file: 'raw-sql-indexes', message: `${alerts_constants_1.ALERT_OPEN_INCIDENT_INDEX} is not on the raw-SQL index list` });
+    }
+    for (const cls of [alerts_evaluation_service_1.AlertsEvaluationService, alerts_dispatch_service_1.AlertsDispatchService]) {
+        if (/\$transaction|runInOrg/.test(cls.toString()))
+            findings.push({ file: cls.name, message: 'must not open a transaction: a dispatch follows a committed write' });
+    }
+    if (/\b(fetch|spawn|exec|readFile|writeFile|\.download\(|\.upload\()\b/.test(alerts_event_listener_1.AlertsEventListener.toString())) {
+        findings.push({ file: 'AlertsEventListener', message: 'a node event listener only enqueues a job; it does no I/O of its own' });
+    }
+    return findings;
+}
+const STALE_NODE = { id: '11111111-1111-4111-8111-111111111111', name: 'node-a', status: 'online', lastHeartbeatAt: new Date(0) };
+function rig() {
+    const prisma = (0, fakes_1.createInMemoryAlertsPrisma)();
+    prisma.nodes.push({ ...STALE_NODE });
+    const metrics = new alerts_metrics_1.AlertsMetrics(prisma);
+    const log = [];
+    const notifications = {
+        notifyPermissionHolders: async (event) => {
+            log.push(`notify:${event}:${prisma.incidents.filter((i) => i.state === 'firing').length}`);
+        },
+    };
+    const dispatcher = new alerts_dispatch_service_1.AlertsDispatchService(metrics, notifications);
+    const evaluation = new alerts_evaluation_service_1.AlertsEvaluationService(prisma, new alerts_context_service_1.AlertContextService(prisma), dispatcher, (0, alerts_options_1.resolveAlertsModuleOptions)());
+    return { prisma, evaluation, log };
+}
+/**
+ * The `alerts` conformance suite.
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+exports.alertsConformanceSuite = {
+    id: 'alerts',
+    title: 'the alerts slice keeps its invariants',
+    description: 'every route requires exactly alerts:read (GET) or alerts:write and none is public, the built-in kinds and valid disabled starter rules exist, the one-open-incident index is on the raw-SQL list, nothing opens a transaction, an evaluation is idempotent, a dispatch follows the committed write, and seeding never overwrites an edit.',
+    check(_context, options) {
+        const routes = discoverAlertsRoutes();
+        return { scanned: { routes: routes.length }, scannedFiles: { routes: routes.map((r) => r.id) }, findings: checkAlertsStatic(options) };
+    },
+    cases() {
+        return [
+            {
+                name: 'routes: authenticated, never public, exactly alerts:read / alerts:write',
+                run: (report, expect) => {
+                    expect(report.findings.filter((f) => f.file.startsWith('AlertsAdminController'))).toEqual([]);
+                },
+            },
+            {
+                name: 'kinds and starter rules: built-ins registered, starter rules valid and disabled',
+                run: (report, expect) => {
+                    expect(report.findings.filter((f) => f.file === 'kinds' || f.file === 'starter-rules')).toEqual([]);
+                },
+            },
+            {
+                name: 'data: the one-open-incident index is on the raw-SQL index list',
+                run: (report, expect) => {
+                    expect(report.findings.filter((f) => f.file === 'raw-sql-indexes')).toEqual([]);
+                },
+            },
+            {
+                name: 'no transaction around a dispatch; the listener only enqueues',
+                run: (report, expect) => {
+                    expect(report.findings.filter((f) => ['AlertsEvaluationService', 'AlertsDispatchService', 'AlertsEventListener'].includes(f.file))).toEqual([]);
+                },
+            },
+            {
+                name: 'evaluation is idempotent: two passes over the same data leave one incident',
+                run: async (_report, expect) => {
+                    (0, builtin_kinds_1.registerBuiltinAlertKinds)();
+                    const { prisma, evaluation } = rig();
+                    const rule = prisma.addRule({ kind: alerts_1.ALERT_KIND_IDS.NODE_OFFLINE, config: {} });
+                    await evaluation.evaluateRule(rule);
+                    await evaluation.evaluateRule(rule);
+                    expect(prisma.incidents.filter((i) => i.state === 'firing').length).toEqual(1);
+                },
+            },
+            {
+                name: 'dispatch follows the committed write: the incident is firing when the notification is raised',
+                run: async (_report, expect) => {
+                    (0, builtin_kinds_1.registerBuiltinAlertKinds)();
+                    const { prisma, evaluation, log } = rig();
+                    const rule = prisma.addRule({ kind: alerts_1.ALERT_KIND_IDS.NODE_OFFLINE, config: {} });
+                    await evaluation.evaluateRule(rule);
+                    expect(log).toEqual(['notify:alerts.alert_fired:1']);
+                },
+            },
+            {
+                name: 'starter rules are seeded disabled and never overwrite an edit',
+                run: async (_report, expect) => {
+                    (0, builtin_kinds_1.registerBuiltinAlertKinds)();
+                    const prisma = (0, fakes_1.createInMemoryAlertsPrisma)();
+                    const seed = new alerts_seed_service_1.AlertsSeedService(prisma, (0, alerts_options_1.resolveAlertsModuleOptions)());
+                    expect(await seed.seed()).toEqual(starter_rules_1.STARTER_ALERT_RULES.length);
+                    expect(prisma.rules.filter((r) => r.enabled).length).toEqual(0);
+                    prisma.rules[0].enabled = true;
+                    prisma.rules[0].name = 'Edited by an administrator';
+                    expect(await seed.seed()).toEqual(0);
+                    expect([prisma.rules[0].enabled, prisma.rules[0].name]).toEqual([true, 'Edited by an administrator']);
+                },
+            },
+        ];
+    },
+};
+if (!index_2.conformanceSuites.has(exports.alertsConformanceSuite.id))
+    index_2.conformanceSuites.register(exports.alertsConformanceSuite);
+//# sourceMappingURL=conformance.js.map

package/dist/alerts/testing/conformance.js.map

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

package/dist/alerts/testing/fakes.d.ts

@@ -0,0 +1,80 @@
+import type { AlertIncidentRow, AlertNodeEventRow, AlertNodeRow, AlertRuleRow, AlertsPrisma } from '../data/alerts-db';
+import type { AlertEvaluationContext, AlertMetricTable, AlertRuleKind, AlertTelemetryAccess, AlertVerdict } from '../alerts.types';
+/**
+ * The in-memory client: the typed {@link AlertsPrisma} plus the backing arrays.
+ *
+ * @stability experimental
+ */
+export interface InMemoryAlertsPrisma extends AlertsPrisma {
+    /** `alert_rules`. */
+    readonly rules: AlertRuleRow[];
+    /** `alert_incidents`. */
+    readonly incidents: AlertIncidentRow[];
+    /** `worker_node_events`. */
+    readonly nodeEvents: AlertNodeEventRow[];
+    /** `worker_nodes`. */
+    readonly nodes: AlertNodeRow[];
+    /** Adds a rule with sensible defaults; returns the stored row. */
+    addRule(partial: Partial<AlertRuleRow> & Pick<AlertRuleRow, 'kind'>): AlertRuleRow;
+}
+/**
+ * Builds the in-memory client.
+ *
+ * @returns an empty client.
+ *
+ * @stability experimental
+ */
+export declare function createInMemoryAlertsPrisma(): InMemoryAlertsPrisma;
+/**
+ * A scripted kind for tests: `evaluate` returns what `script.next` holds, or
+ * throws it when it is an Error.
+ *
+ * @stability experimental
+ */
+export interface FakeKindScript {
+    /** What the next evaluation returns (an Error is thrown). */
+    next: ReadonlyArray<import('../alerts.types').AlertObservation> | Error;
+    /** How many times it ran. */
+    calls: number;
+}
+/**
+ * A scripted kind and its script.
+ *
+ * @stability experimental
+ */
+export interface FakeKind {
+    /** The kind, ready for `registerAlertRuleKind`. */
+    kind: AlertRuleKind;
+    /** What it returns next, and how often it ran. */
+    script: FakeKindScript;
+}
+/**
+ * Builds a scripted rule kind, `eventDriven` when asked.
+ *
+ * @param id - the kind id.
+ * @param configSchema - the config schema (any object by default).
+ * @returns the kind and its script.
+ *
+ * @stability experimental
+ */
+export declare function createFakeKind(id: string, configSchema: AlertRuleKind['configSchema'], options?: {
+    eventDriven?: boolean;
+}): FakeKind;
+/**
+ * An evaluation context over the given database and fakes; every optional
+ * source throws `AlertStoreUnavailableError` unless supplied.
+ *
+ * @param db - the database.
+ * @param parts - what the test supplies.
+ * @returns the context.
+ *
+ * @stability experimental
+ */
+export declare function createFakeContext(db: AlertsPrisma, parts?: {
+    now?: Date;
+    telemetry?: AlertTelemetryAccess;
+    verdict?: AlertVerdict;
+    staleHeartbeatSeconds?: number;
+    tables?: AlertMetricTable[];
+}): AlertEvaluationContext;
+//# sourceMappingURL=fakes.d.ts.map

package/dist/alerts/testing/fakes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fakes.d.ts","sourceRoot":"","sources":["../../../src/alerts/testing/fakes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,YAAY,EACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,aAAa,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAkHnI;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACxD,qBAAqB;IACrB,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC;IAC/B,yBAAyB;IACzB,QAAQ,CAAC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IACvC,4BAA4B;IAC5B,QAAQ,CAAC,UAAU,EAAE,iBAAiB,EAAE,CAAC;IACzC,sBAAsB;IACtB,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC;IAC/B,kEAAkE;IAClE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG,YAAY,CAAC;CACpF;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,IAAI,oBAAoB,CA4DjE;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,IAAI,EAAE,aAAa,CAAC,OAAO,iBAAiB,EAAE,gBAAgB,CAAC,GAAG,KAAK,CAAC;IACxE,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,mDAAmD;IACnD,IAAI,EAAE,aAAa,CAAC;IACpB,kDAAkD;IAClD,MAAM,EAAE,cAAc,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,aAAa,CAAC,cAAc,CAAC,EAC3C,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,QAAQ,CAgBV;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,YAAY,EAChB,KAAK,GAAE;IAAE,GAAG,CAAC,EAAE,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC;IAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAA;CAAO,GAChJ,sBAAsB,CAexB"}