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

package/dist/alerts/kinds/alert-kind.registry.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.alertRuleKindRegistry = void 0;
+exports.registerAlertRuleKind = registerAlertRuleKind;
+exports.parseAlertConfig = parseAlertConfig;
+const index_1 = require("../../core/index");
+const alerts_1 = require("@marinoscar/platform-contract/alerts");
+const alerts_errors_1 = require("../alerts.errors");
+/**
+ * Every registered rule kind. Open: an app adds its own with
+ * {@link registerAlertRuleKind} at import time, before the application
+ * bootstraps (the registry freezes then).
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+exports.alertRuleKindRegistry = (0, index_1.defineRegistry)({
+    name: 'alert-rule-kinds',
+    idOf: (kind) => kind.id,
+    idPattern: alerts_1.ALERT_KIND_PATTERN,
+    validate: (kind) => {
+        if (typeof kind.evaluate !== 'function')
+            throw new Error('an alert rule kind needs an evaluate function');
+        if (!kind.configSchema || typeof kind.configSchema.safeParse !== 'function') {
+            throw new Error('an alert rule kind needs a zod configSchema');
+        }
+    },
+    describeDuplicate: (existing) => `Duplicate alert rule kind "${existing.id}". Kind ids are persisted on rules; pick a new id.`,
+});
+/**
+ * Registers a rule kind. Kind ids are PERMANENT once rules of the kind exist.
+ *
+ * @param kind - the kind.
+ * @throws RegistryError `INVALID_ID`, `INVALID_ENTRY`, `DUPLICATE_ID` or `FROZEN`.
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+function registerAlertRuleKind(kind) {
+    exports.alertRuleKindRegistry.register(kind);
+}
+/**
+ * Validates `config` against the schema of `kind`, returning the parsed (and
+ * defaulted) value.
+ *
+ * @param kind - the kind id.
+ * @param config - the raw config.
+ * @returns the parsed config.
+ * @throws AlertConfigError `ALERT_UNKNOWN_KIND` or `ALERT_INVALID_CONFIG`.
+ *
+ * @stability experimental
+ */
+function parseAlertConfig(kind, config) {
+    const def = exports.alertRuleKindRegistry.get(kind);
+    if (!def)
+        throw new alerts_errors_1.AlertConfigError('ALERT_UNKNOWN_KIND', `There is no alert rule kind "${kind}".`);
+    const parsed = def.configSchema.safeParse(config ?? {});
+    if (!parsed.success) {
+        throw new alerts_errors_1.AlertConfigError('ALERT_INVALID_CONFIG', `The config does not match the "${kind}" kind.`, parsed.error.issues.map((issue) => ({ path: issue.path.join('.'), message: issue.message })));
+    }
+    return parsed.data;
+}
+//# sourceMappingURL=alert-kind.registry.js.map

package/dist/alerts/kinds/alert-kind.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert-kind.registry.js","sourceRoot":"","sources":["../../../src/alerts/kinds/alert-kind.registry.ts"],"names":[],"mappings":";;;AAsCA,sDAEC;AAaD,4CAYC;AA/DD,4CAAkD;AAClD,iEAA0E;AAC1E,oDAAoD;AAGpD;;;;;;;GAOG;AACU,QAAA,qBAAqB,GAAG,IAAA,sBAAc,EAAgB;IACjE,IAAI,EAAE,kBAAkB;IACxB,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE;IACvB,SAAS,EAAE,2BAAkB;IAC7B,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;QACjB,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QAC1G,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,OAAQ,IAAI,CAAC,YAA0B,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;YAC3F,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IACD,iBAAiB,EAAE,CAAC,QAAQ,EAAE,EAAE,CAC9B,8BAA8B,QAAQ,CAAC,EAAE,oDAAoD;CAChG,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,SAAgB,qBAAqB,CAAI,IAAsB;IAC7D,6BAAqB,CAAC,QAAQ,CAAC,IAAqB,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,gBAAgB,CAAC,IAAY,EAAE,MAAe;IAC5D,MAAM,GAAG,GAAG,6BAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,gCAAgB,CAAC,oBAAoB,EAAE,gCAAgC,IAAI,IAAI,CAAC,CAAC;IACrG,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,gCAAgB,CACxB,sBAAsB,EACtB,kCAAkC,IAAI,SAAS,EAC/C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAC7F,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/alerts/kinds/builtin-kinds.d.ts

@@ -0,0 +1,18 @@
+import type { AlertRuleKind } from '../alerts.types';
+/**
+ * The five kinds the slice ships, in registration order.
+ *
+ * @stability experimental
+ */
+export declare const BUILTIN_ALERT_KINDS: readonly AlertRuleKind[];
+/**
+ * Registers the built-in kinds. IDEMPOTENT: a kind already registered with the
+ * built-in definition is skipped (`AlertsModule.forRoot` and an app may both
+ * call it).
+ *
+ * @throws RegistryError `FROZEN` when something is left to register after the application bootstrapped.
+ *
+ * @stability experimental
+ */
+export declare function registerBuiltinAlertKinds(): void;
+//# sourceMappingURL=builtin-kinds.d.ts.map

package/dist/alerts/kinds/builtin-kinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-kinds.d.ts","sourceRoot":"","sources":["../../../src/alerts/kinds/builtin-kinds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAQrD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,aAAa,EAAiG,CAAC;AAE1J;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAKhD"}

package/dist/alerts/kinds/builtin-kinds.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUILTIN_ALERT_KINDS = void 0;
+exports.registerBuiltinAlertKinds = registerBuiltinAlertKinds;
+const alert_kind_registry_1 = require("./alert-kind.registry");
+const metric_threshold_kind_1 = require("./metric-threshold.kind");
+const node_event_kind_1 = require("./node-event.kind");
+const node_offline_kind_1 = require("./node-offline.kind");
+const telemetry_unavailable_kind_1 = require("./telemetry-unavailable.kind");
+const verdict_kind_1 = require("./verdict.kind");
+/**
+ * The five kinds the slice ships, in registration order.
+ *
+ * @stability experimental
+ */
+exports.BUILTIN_ALERT_KINDS = [metric_threshold_kind_1.metricThresholdKind, node_event_kind_1.nodeEventKind, verdict_kind_1.verdictKind, node_offline_kind_1.nodeOfflineKind, telemetry_unavailable_kind_1.telemetryUnavailableKind];
+/**
+ * Registers the built-in kinds. IDEMPOTENT: a kind already registered with the
+ * built-in definition is skipped (`AlertsModule.forRoot` and an app may both
+ * call it).
+ *
+ * @throws RegistryError `FROZEN` when something is left to register after the application bootstrapped.
+ *
+ * @stability experimental
+ */
+function registerBuiltinAlertKinds() {
+    for (const kind of exports.BUILTIN_ALERT_KINDS) {
+        if (alert_kind_registry_1.alertRuleKindRegistry.get(kind.id) === kind)
+            continue;
+        (0, alert_kind_registry_1.registerAlertRuleKind)(kind);
+    }
+}
+//# sourceMappingURL=builtin-kinds.js.map

package/dist/alerts/kinds/builtin-kinds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-kinds.js","sourceRoot":"","sources":["../../../src/alerts/kinds/builtin-kinds.ts"],"names":[],"mappings":";;;AAwBA,8DAKC;AA5BD,+DAAqF;AACrF,mEAA8D;AAC9D,uDAAkD;AAClD,2DAAsD;AACtD,6EAAwE;AACxE,iDAA6C;AAE7C;;;;GAIG;AACU,QAAA,mBAAmB,GAA6B,CAAC,2CAAmB,EAAE,+BAAa,EAAE,0BAAW,EAAE,mCAAe,EAAE,qDAAwB,CAAC,CAAC;AAE1J;;;;;;;;GAQG;AACH,SAAgB,yBAAyB;IACvC,KAAK,MAAM,IAAI,IAAI,2BAAmB,EAAE,CAAC;QACvC,IAAI,2CAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI;YAAE,SAAS;QAC1D,IAAA,2CAAqB,EAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/alerts/kinds/metric-threshold.kind.d.ts

@@ -0,0 +1,11 @@
+import { type MetricThresholdConfig } from '@marinoscar/platform-contract/alerts';
+import type { AlertRuleKind } from '../alerts.types';
+/**
+ * `metric_threshold`: one aggregate of one telemetry metric over a window,
+ * compared to a threshold, per group. Runs ONE statement through the guarded
+ * telemetry facade; an unreachable store throws `AlertStoreUnavailableError`.
+ *
+ * @stability experimental
+ */
+export declare const metricThresholdKind: AlertRuleKind<MetricThresholdConfig>;
+//# sourceMappingURL=metric-threshold.kind.d.ts.map

package/dist/alerts/kinds/metric-threshold.kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-threshold.kind.d.ts","sourceRoot":"","sources":["../../../src/alerts/kinds/metric-threshold.kind.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsE,KAAK,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAEtJ,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,iBAAiB,CAAC;AAuBpE;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,qBAAqB,CAkCpE,CAAC"}

package/dist/alerts/kinds/metric-threshold.kind.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.metricThresholdKind = void 0;
+const alerts_1 = require("@marinoscar/platform-contract/alerts");
+const metric_threshold_sql_1 = require("./metric-threshold.sql");
+/** Most label sets one evaluation reads. */
+const MAX_GROUPS = 200;
+const SYMBOL = {
+    gt: '>',
+    gte: '>=',
+    lt: '<',
+    lte: '<=',
+    eq: '=',
+    neq: '!=',
+};
+function describeConfig(config) {
+    return `${config.aggregation}(${config.metric}) over ${config.windowSeconds}s ${SYMBOL[config.comparator]} ${config.threshold}`;
+}
+function formatValue(value) {
+    return Number.isInteger(value) ? String(value) : value.toFixed(2);
+}
+/**
+ * `metric_threshold`: one aggregate of one telemetry metric over a window,
+ * compared to a threshold, per group. Runs ONE statement through the guarded
+ * telemetry facade; an unreachable store throws `AlertStoreUnavailableError`.
+ *
+ * @stability experimental
+ */
+exports.metricThresholdKind = {
+    id: alerts_1.ALERT_KIND_IDS.METRIC_THRESHOLD,
+    label: 'Metric threshold',
+    description: 'An aggregate of one telemetry metric over a time window compared to a threshold, per group.',
+    configSchema: alerts_1.metricThresholdConfigSchema,
+    async evaluate(ctx, rule) {
+        const { config } = rule;
+        const telemetry = await ctx.telemetry();
+        const table = (0, metric_threshold_sql_1.resolveMetricTable)(config.metric, telemetry.tables);
+        if (!table)
+            throw new Error(`The telemetry store has no table for the metric "${config.metric}" (yet).`);
+        const sql = (0, metric_threshold_sql_1.buildMetricThresholdSql)(config, table, telemetry.query, ctx.now);
+        const result = await telemetry.query.query(sql, { maxRows: MAX_GROUPS });
+        const groupBy = config.groupBy ?? [];
+        return result.rows.map((row) => {
+            const labels = {};
+            groupBy.forEach((column, index) => {
+                const raw = row[index];
+                labels[column] = raw === null || raw === undefined ? '' : String(raw);
+            });
+            const raw = row[groupBy.length];
+            const value = raw === null || raw === undefined ? Number.NaN : Number(raw);
+            const known = Number.isFinite(value);
+            const where = Object.keys(labels).length > 0 ? ` for ${Object.entries(labels).map(([k, v]) => `${k}=${v}`).join(', ')}` : '';
+            return {
+                labels,
+                value: known ? value : null,
+                breached: known && (0, metric_threshold_sql_1.compareValue)(value, config.comparator, config.threshold),
+                summary: `${rule.name}: ${config.aggregation} of ${config.metric} is ${known ? formatValue(value) : 'unknown'}${where} (${SYMBOL[config.comparator]} ${config.threshold})`.slice(0, 500),
+            };
+        });
+    },
+    describe: (rule) => describeConfig(rule.config),
+};
+//# sourceMappingURL=metric-threshold.kind.js.map

package/dist/alerts/kinds/metric-threshold.kind.js.map

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

package/dist/alerts/kinds/metric-threshold.sql.d.ts

@@ -0,0 +1,41 @@
+import type { AlertComparator, MetricThresholdConfig } from '@marinoscar/platform-contract/alerts';
+import type { TelemetryQueryFacade } from '../../telemetry/index';
+import type { AlertMetricTable } from '../alerts.types';
+/** The suffixes the store appends to a metric's table name, by unit or kind. */
+export declare const METRIC_TABLE_SUFFIXES: readonly ["", "_total", "_bytes", "_seconds", "_ratio", "_percent"];
+/**
+ * The table a metric name or table name resolves to: the name with `.` turned
+ * into `_`, as is, or with one of the store's unit suffixes.
+ *
+ * @param metric - a dotted metric name (`app.jobs.settled`) or a table name.
+ * @param tables - the store's metric tables.
+ * @returns the table, or `null` when the store has none.
+ *
+ * @stability experimental
+ */
+export declare function resolveMetricTable(metric: string, tables: ReadonlyMap<string, AlertMetricTable>): AlertMetricTable | null;
+/**
+ * Whether `value` breaches `threshold` under `comparator`.
+ *
+ * @param value - the observed value.
+ * @param comparator - the rule's comparator.
+ * @param threshold - the rule's threshold.
+ * @returns the verdict.
+ *
+ * @stability experimental
+ */
+export declare function compareValue(value: number, comparator: AlertComparator, threshold: number): boolean;
+/**
+ * Builds the statement for one rule over one table. Throws when a named
+ * column is not a column of the table.
+ *
+ * @param config - the rule's parsed config.
+ * @param table - the resolved metric table.
+ * @param query - the facade (its builders quote; its dialect spells the columns).
+ * @param now - the end of the window.
+ * @returns one SELECT. The result columns are the `groupBy` columns (as text), then `value`.
+ *
+ * @stability experimental
+ */
+export declare function buildMetricThresholdSql(config: MetricThresholdConfig, table: AlertMetricTable, query: Pick<TelemetryQueryFacade, 'sql' | 'dialect'>, now: Date): string;
+//# sourceMappingURL=metric-threshold.sql.d.ts.map

package/dist/alerts/kinds/metric-threshold.sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-threshold.sql.d.ts","sourceRoot":"","sources":["../../../src/alerts/kinds/metric-threshold.sql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAEnG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAcxD,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,qEAAsE,CAAC;AAEzG;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC5C,gBAAgB,GAAG,IAAI,CAOzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAenG;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,IAAI,CAAC,oBAAoB,EAAE,KAAK,GAAG,SAAS,CAAC,EACpD,GAAG,EAAE,IAAI,GACR,MAAM,CAwDR"}

package/dist/alerts/kinds/metric-threshold.sql.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.METRIC_TABLE_SUFFIXES = void 0;
+exports.resolveMetricTable = resolveMetricTable;
+exports.compareValue = compareValue;
+exports.buildMetricThresholdSql = buildMetricThresholdSql;
+// =============================================================================
+// The one statement a `metric_threshold` rule runs (issue #1047)
+// =============================================================================
+//
+// EVERY value that reaches the SQL goes through the facade's builders
+// (`sql.ident` for a column, `sql.literal` for a filter value, `sql.timestamp`
+// for the window): nothing from a rule's config is concatenated. The only
+// other interpolated numbers are integers this file computes itself from the
+// validated window. Column names a rule names (`groupBy`, a filter's `attr`)
+// are additionally required to be columns of the resolved table.
+// =============================================================================
+/** The suffixes the store appends to a metric's table name, by unit or kind. */
+exports.METRIC_TABLE_SUFFIXES = ['', '_total', '_bytes', '_seconds', '_ratio', '_percent'];
+/**
+ * The table a metric name or table name resolves to: the name with `.` turned
+ * into `_`, as is, or with one of the store's unit suffixes.
+ *
+ * @param metric - a dotted metric name (`app.jobs.settled`) or a table name.
+ * @param tables - the store's metric tables.
+ * @returns the table, or `null` when the store has none.
+ *
+ * @stability experimental
+ */
+function resolveMetricTable(metric, tables) {
+    const base = metric.replace(/\./g, '_');
+    for (const suffix of exports.METRIC_TABLE_SUFFIXES) {
+        const table = tables.get(`${base}${suffix}`);
+        if (table)
+            return table;
+    }
+    return null;
+}
+/**
+ * Whether `value` breaches `threshold` under `comparator`.
+ *
+ * @param value - the observed value.
+ * @param comparator - the rule's comparator.
+ * @param threshold - the rule's threshold.
+ * @returns the verdict.
+ *
+ * @stability experimental
+ */
+function compareValue(value, comparator, threshold) {
+    switch (comparator) {
+        case 'gt':
+            return value > threshold;
+        case 'gte':
+            return value >= threshold;
+        case 'lt':
+            return value < threshold;
+        case 'lte':
+            return value <= threshold;
+        case 'eq':
+            return value === threshold;
+        case 'neq':
+            return value !== threshold;
+    }
+}
+/**
+ * Builds the statement for one rule over one table. Throws when a named
+ * column is not a column of the table.
+ *
+ * @param config - the rule's parsed config.
+ * @param table - the resolved metric table.
+ * @param query - the facade (its builders quote; its dialect spells the columns).
+ * @param now - the end of the window.
+ * @returns one SELECT. The result columns are the `groupBy` columns (as text), then `value`.
+ *
+ * @stability experimental
+ */
+function buildMetricThresholdSql(config, table, query, now) {
+    const { sql, dialect } = query;
+    const groupBy = config.groupBy ?? [];
+    const filters = config.filters ?? [];
+    for (const column of [...groupBy, ...filters.map((f) => f.attr)]) {
+        if (!table.columns.has(column)) {
+            throw new Error(`The metric table "${table.name}" has no column "${column}".`);
+        }
+    }
+    if (!Number.isInteger(config.windowSeconds) || config.windowSeconds < 1) {
+        throw new RangeError('windowSeconds must be a positive integer');
+    }
+    const from = new Date(now.getTime() - config.windowSeconds * 1000);
+    const ts = dialect.timestampColumn;
+    const value = sql.ident(dialect.valueColumn);
+    const where = [
+        sql.between(ts, from, now),
+        ...filters.map((f) => `${sql.ident(f.attr)} ${f.op === 'eq' ? '=' : '<>'} ${sql.literal(f.value)}`),
+    ].join(' AND ');
+    const groupSelect = groupBy.map((column) => `${dialect.castText(sql.ident(column))} AS ${sql.ident(column)}`);
+    const groupRef = groupBy.map((column) => sql.ident(column));
+    const tail = groupRef.length > 0 ? ` GROUP BY ${groupRef.join(', ')}` : '';
+    if (config.aggregation === 'rate') {
+        // A counter's increase per series (max - min over the window), summed across
+        // the series that share the group, per minute. Resets inside the window are
+        // not corrected for: a reset reads as a smaller increase, never a false one.
+        const seriesColumns = [...new Set([...table.tags, ...groupBy])];
+        const inner = `SELECT ${[...seriesColumns.map((c) => sql.ident(c)), `MAX(${value}) - MIN(${value}) AS ${sql.ident('inc')}`].join(', ')} ` +
+            `FROM ${sql.ident(table.name)} WHERE ${where}` +
+            (seriesColumns.length > 0 ? ` GROUP BY ${seriesColumns.map((c) => sql.ident(c)).join(', ')}` : '');
+        const minutes = config.windowSeconds / 60;
+        const outerSelect = [
+            ...groupBy.map((column) => `${dialect.castText(sql.ident(column))} AS ${sql.ident(column)}`),
+            `SUM(${sql.ident('inc')}) / ${minutes} AS ${sql.ident('value')}`,
+        ];
+        return `SELECT ${outerSelect.join(', ')} FROM (${inner}) AS ${sql.ident('series')}${tail}`;
+    }
+    const aggregate = {
+        avg: `AVG(${value})`,
+        max: `MAX(${value})`,
+        min: `MIN(${value})`,
+        sum: `SUM(${value})`,
+        last: `last_value(${value} ORDER BY ${sql.ident(ts)})`,
+    }[config.aggregation];
+    return (`SELECT ${[...groupSelect, `${aggregate} AS ${sql.ident('value')}`].join(', ')} ` +
+        `FROM ${sql.ident(table.name)} WHERE ${where}${tail}`);
+}
+//# sourceMappingURL=metric-threshold.sql.js.map

package/dist/alerts/kinds/metric-threshold.sql.js.map

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

package/dist/alerts/kinds/node-event.kind.d.ts

@@ -0,0 +1,44 @@
+import { type NodeEventConfig } from '@marinoscar/platform-contract/alerts';
+import type { AlertRuleKind } from '../alerts.types';
+/**
+ * Whether a dotted event type matches one pattern: exact, or `prefix.*`.
+ *
+ * @param pattern - `power.battery_low` or `power.*`.
+ * @param type - the event type.
+ * @returns whether it matches.
+ *
+ * @stability experimental
+ */
+export declare function eventTypeMatches(pattern: string, type: string): boolean;
+/**
+ * How a node event relates to a rule: it triggers it, recovers it, or is unrelated (`null`).
+ *
+ * @stability experimental
+ */
+export type NodeEventClassification = 'trigger' | 'recovery' | null;
+/**
+ * Classifies one event against a rule's config.
+ *
+ * @param config - the rule's parsed config.
+ * @param event - the event (type, severity, attrs, node).
+ * @returns `trigger`, `recovery` or `null`.
+ *
+ * @stability experimental
+ */
+export declare function classifyNodeEvent(config: NodeEventConfig, event: {
+    nodeId: string;
+    type: string;
+    severity: string;
+    attrs: unknown;
+}): NodeEventClassification;
+/**
+ * `node_event`: a worker node reported a matching event. Reads the
+ * `worker_node_events` table (not the telemetry store), so it works with
+ * telemetry off. Per node the NEWEST classified event inside
+ * `resolveAfterSeconds` decides: a trigger breaches, a recovery clears, and a
+ * node with no such event inside the window is absent (clear).
+ *
+ * @stability experimental
+ */
+export declare const nodeEventKind: AlertRuleKind<NodeEventConfig>;
+//# sourceMappingURL=node-event.kind.d.ts.map

package/dist/alerts/kinds/node-event.kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-event.kind.d.ts","sourceRoot":"","sources":["../../../src/alerts/kinds/node-event.kind.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,KAAK,EAAyB,aAAa,EAAiB,MAAM,iBAAiB,CAAC;AAO3F;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvE;AAYD;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,UAAU,GAAG,IAAI,CAAC;AAEpE;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACxE,uBAAuB,CAazB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC,eAAe,CAsDxD,CAAC"}

package/dist/alerts/kinds/node-event.kind.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nodeEventKind = void 0;
+exports.eventTypeMatches = eventTypeMatches;
+exports.classifyNodeEvent = classifyNodeEvent;
+const alerts_1 = require("@marinoscar/platform-contract/alerts");
+const SEVERITY_RANK = { info: 0, warning: 1, critical: 2 };
+/** Most events one evaluation reads. */
+const MAX_EVENTS = 2_000;
+/**
+ * Whether a dotted event type matches one pattern: exact, or `prefix.*`.
+ *
+ * @param pattern - `power.battery_low` or `power.*`.
+ * @param type - the event type.
+ * @returns whether it matches.
+ *
+ * @stability experimental
+ */
+function eventTypeMatches(pattern, type) {
+    return pattern.endsWith('.*') ? type.startsWith(pattern.slice(0, -1)) : pattern === type;
+}
+function typeIn(patterns, type) {
+    return patterns.some((pattern) => eventTypeMatches(pattern, type));
+}
+function attrsMatch(wanted, attrs) {
+    if (!wanted)
+        return true;
+    const have = (attrs && typeof attrs === 'object' ? attrs : {});
+    return Object.entries(wanted).every(([key, value]) => String(have[key]) === String(value));
+}
+/**
+ * Classifies one event against a rule's config.
+ *
+ * @param config - the rule's parsed config.
+ * @param event - the event (type, severity, attrs, node).
+ * @returns `trigger`, `recovery` or `null`.
+ *
+ * @stability experimental
+ */
+function classifyNodeEvent(config, event) {
+    if (config.nodeIds && config.nodeIds.length > 0 && !config.nodeIds.includes(event.nodeId))
+        return null;
+    if (typeIn(config.eventTypes, event.type) &&
+        (SEVERITY_RANK[event.severity] ?? 0) >= (SEVERITY_RANK[config.minSeverity ?? 'info'] ?? 0) &&
+        attrsMatch(config.attrs, event.attrs)) {
+        return 'trigger';
+    }
+    if (config.recovery && typeIn(config.recovery.eventTypes, event.type) && attrsMatch(config.recovery.attrs, event.attrs)) {
+        return 'recovery';
+    }
+    return null;
+}
+/**
+ * `node_event`: a worker node reported a matching event. Reads the
+ * `worker_node_events` table (not the telemetry store), so it works with
+ * telemetry off. Per node the NEWEST classified event inside
+ * `resolveAfterSeconds` decides: a trigger breaches, a recovery clears, and a
+ * node with no such event inside the window is absent (clear).
+ *
+ * @stability experimental
+ */
+exports.nodeEventKind = {
+    id: alerts_1.ALERT_KIND_IDS.NODE_EVENT,
+    label: 'Node event',
+    description: 'A worker node reported a matching event (for example it switched to battery). Clears on a recovery event or after a set time.',
+    configSchema: alerts_1.nodeEventConfigSchema,
+    eventDriven: true,
+    async evaluate(ctx, rule) {
+        const { config } = rule;
+        const since = new Date(ctx.now.getTime() - config.resolveAfterSeconds * 1000);
+        const patterns = [...config.eventTypes, ...(config.recovery?.eventTypes ?? [])];
+        const exact = patterns.filter((p) => !p.endsWith('.*'));
+        const prefixes = patterns.filter((p) => p.endsWith('.*')).map((p) => p.slice(0, -1));
+        const events = await ctx.db.workerNodeEvent.findMany({
+            where: {
+                receivedAt: { gte: since },
+                OR: [...(exact.length > 0 ? [{ type: { in: exact } }] : []), ...prefixes.map((prefix) => ({ type: { startsWith: prefix } }))],
+            },
+            orderBy: { receivedAt: 'asc' },
+            take: MAX_EVENTS,
+        });
+        const latest = new Map();
+        for (const event of events) {
+            const kind = classifyNodeEvent(config, event);
+            if (kind)
+                latest.set(event.nodeId, { kind, type: event.type });
+        }
+        if (latest.size === 0)
+            return [];
+        const nodes = await ctx.db.workerNode.findMany({ where: { id: { in: [...latest.keys()] } }, select: { id: true, name: true } });
+        const names = new Map(nodes.map((node) => [node.id, node.name]));
+        return [...latest.entries()].map(([nodeId, state]) => {
+            const name = names.get(nodeId) ?? nodeId;
+            return {
+                labels: { 'node.id': nodeId, 'node.name': name },
+                value: null,
+                breached: state.kind === 'trigger',
+                summary: state.kind === 'trigger'
+                    ? `${rule.name}: node ${name} reported ${state.type}`
+                    : `${rule.name}: node ${name} recovered (${state.type})`,
+            };
+        });
+    },
+    matchesEvent(config, event) {
+        return classifyNodeEvent(config, event) !== null;
+    },
+    describe: (rule) => {
+        const { config } = rule;
+        const recovery = config.recovery ? `; clears on ${config.recovery.eventTypes.join(', ')}` : '';
+        return `A node reports ${config.eventTypes.join(', ')}${recovery}; otherwise clears after ${config.resolveAfterSeconds}s`;
+    },
+};
+//# sourceMappingURL=node-event.kind.js.map

package/dist/alerts/kinds/node-event.kind.js.map

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

package/dist/alerts/kinds/node-offline.kind.d.ts

@@ -0,0 +1,11 @@
+import type { AlertRuleKind } from '../alerts.types';
+/**
+ * `node_offline`: a worker node is stale or offline, by the same rule the
+ * fleet page uses (`deriveNodeHealth`). A node an operator DISABLED is left
+ * out (disabling is intent, not failure). A node that deregistered gracefully
+ * is `offline` too and alerts until the fleet's offline retention prunes it.
+ *
+ * @stability experimental
+ */
+export declare const nodeOfflineKind: AlertRuleKind<Record<string, never>>;
+//# sourceMappingURL=node-offline.kind.d.ts.map

package/dist/alerts/kinds/node-offline.kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-offline.kind.d.ts","sourceRoot":"","sources":["../../../src/alerts/kinds/node-offline.kind.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CA8BhE,CAAC"}

package/dist/alerts/kinds/node-offline.kind.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nodeOfflineKind = void 0;
+const alerts_1 = require("@marinoscar/platform-contract/alerts");
+const index_1 = require("../../nodes/index");
+/**
+ * `node_offline`: a worker node is stale or offline, by the same rule the
+ * fleet page uses (`deriveNodeHealth`). A node an operator DISABLED is left
+ * out (disabling is intent, not failure). A node that deregistered gracefully
+ * is `offline` too and alerts until the fleet's offline retention prunes it.
+ *
+ * @stability experimental
+ */
+exports.nodeOfflineKind = {
+    id: alerts_1.ALERT_KIND_IDS.NODE_OFFLINE,
+    label: 'Node offline',
+    description: 'A worker node stopped heartbeating (stale) or was marked offline.',
+    configSchema: alerts_1.emptyAlertConfigSchema,
+    async evaluate(ctx, rule) {
+        const staleSeconds = await ctx.staleHeartbeatSeconds();
+        const nodes = await ctx.db.workerNode.findMany({
+            where: { status: { not: 'disabled' } },
+            select: { id: true, name: true, status: true, lastHeartbeatAt: true },
+            take: 1_000,
+        });
+        return nodes.map((node) => {
+            const health = (0, index_1.deriveNodeHealth)({ status: node.status, lastHeartbeatAt: node.lastHeartbeatAt }, staleSeconds, ctx.now);
+            const breached = health !== 'healthy';
+            return {
+                labels: { 'node.id': node.id, 'node.name': node.name },
+                value: breached ? 1 : 0,
+                breached,
+                summary: breached
+                    ? `${rule.name}: node ${node.name} is ${health}${node.lastHeartbeatAt ? ` (last heartbeat ${node.lastHeartbeatAt.toISOString()})` : ' (never sent a heartbeat)'}`
+                    : `${rule.name}: node ${node.name} is healthy`,
+            };
+        });
+    },
+    describe: () => 'A worker node is stale or offline',
+};
+//# sourceMappingURL=node-offline.kind.js.map

package/dist/alerts/kinds/node-offline.kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-offline.kind.js","sourceRoot":"","sources":["../../../src/alerts/kinds/node-offline.kind.ts"],"names":[],"mappings":";;;AAAA,iEAAqH;AAGrH,6CAAqD;AAErD;;;;;;;GAOG;AACU,QAAA,eAAe,GAAyC;IACnE,EAAE,EAAE,uBAAc,CAAC,YAAY;IAC/B,KAAK,EAAE,cAAc;IACrB,WAAW,EAAE,mEAAmE;IAChF,YAAY,EAAE,+BAAyF;IACvG,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI;QACtB,MAAM,YAAY,GAAG,MAAM,GAAG,CAAC,qBAAqB,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC7C,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE;YACtC,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE;YACrE,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QACH,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAoB,EAAE;YAC1C,MAAM,MAAM,GAAG,IAAA,wBAAgB,EAC7B,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,EAC9D,YAAY,EACZ,GAAG,CAAC,GAAG,CACR,CAAC;YACF,MAAM,QAAQ,GAAG,MAAM,KAAK,SAAS,CAAC;YACtC,OAAO;gBACL,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE;gBACtD,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACvB,QAAQ;gBACR,OAAO,EAAE,QAAQ;oBACf,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC,IAAI,OAAO,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,oBAAoB,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,2BAA2B,EAAE;oBACjK,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC,IAAI,aAAa;aACjD,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IACD,QAAQ,EAAE,GAAG,EAAE,CAAC,mCAAmC;CACpD,CAAC"}