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

package/dist/nodes/dto/node-event.dto.js

@@ -0,0 +1,239 @@
+"use strict";
+// =============================================================================
+// The node event log's wire shapes (issue #1045)
+// =============================================================================
+//
+// The schemas live in `@marinoscar/platform-contract/nodes`; these classes add
+// the Swagger decorators the generated OpenAPI document is made of, and each
+// `implements` its contract type so the two cannot drift.
+// =============================================================================
+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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodePowerDto = exports.NodeHostVitalsDto = exports.AdminNodeEventListDto = exports.AdminNodeEventDto = exports.NodeEventListQueryDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const nodes_1 = require("@marinoscar/platform-contract/nodes");
+const nestjs_zod_1 = require("nestjs-zod");
+/**
+ * The events-list query (`nodeEventListQuerySchema`).
+ *
+ * @stability experimental
+ */
+class NodeEventListQueryDto extends (0, nestjs_zod_1.createZodDto)(nodes_1.nodeEventListQuerySchema) {
+}
+exports.NodeEventListQueryDto = NodeEventListQueryDto;
+/**
+ * One event a node reported about itself.
+ *
+ * @stability experimental
+ */
+class AdminNodeEventDto {
+    /** Event ID (UUID) */
+    id;
+    /** The node that reported it (UUID) */
+    nodeId;
+    /** Dotted event type */
+    type;
+    /** How loud it is */
+    severity;
+    /** The node's scalar attributes, `{}` when none */
+    attrs;
+    /** When it happened (ISO 8601) */
+    occurredAt;
+    /** When the server received it (ISO 8601) */
+    receivedAt;
+}
+exports.AdminNodeEventDto = AdminNodeEventDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Event ID (UUID)' }),
+    __metadata("design:type", String)
+], AdminNodeEventDto.prototype, "id", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'The node that reported it (UUID)' }),
+    __metadata("design:type", String)
+], AdminNodeEventDto.prototype, "nodeId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Dotted event type, e.g. `power.battery_low`' }),
+    __metadata("design:type", String)
+], AdminNodeEventDto.prototype, "type", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'How loud it is', enum: ['info', 'warning', 'critical'] }),
+    __metadata("design:type", String)
+], AdminNodeEventDto.prototype, "severity", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'The node’s scalar attributes, `{}` when none. Self-reported and untrusted.',
+        type: 'object',
+        additionalProperties: { oneOf: [{ type: 'string' }, { type: 'number' }, { type: 'boolean' }] },
+    }),
+    __metadata("design:type", Object)
+], AdminNodeEventDto.prototype, "attrs", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'When it happened (ISO 8601), on the node’s clock. A value more than 24 hours old or more ' +
+            'than 5 minutes ahead of the server is replaced by `receivedAt`.',
+    }),
+    __metadata("design:type", String)
+], AdminNodeEventDto.prototype, "occurredAt", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'When the server received it (ISO 8601)' }),
+    __metadata("design:type", String)
+], AdminNodeEventDto.prototype, "receivedAt", void 0);
+/**
+ * A page of node events, newest first.
+ *
+ * @stability experimental
+ */
+class AdminNodeEventListDto {
+    /** The page's events */
+    items;
+    /** Total events matching the filters */
+    total;
+    /** Current page, from 1 */
+    page;
+    /** Page size */
+    pageSize;
+    /** Total pages (at least 1) */
+    totalPages;
+}
+exports.AdminNodeEventListDto = AdminNodeEventListDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'The page’s events, newest first', type: [AdminNodeEventDto] }),
+    __metadata("design:type", Array)
+], AdminNodeEventListDto.prototype, "items", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Total events matching the filters' }),
+    __metadata("design:type", Number)
+], AdminNodeEventListDto.prototype, "total", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Current page, from 1' }),
+    __metadata("design:type", Number)
+], AdminNodeEventListDto.prototype, "page", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Page size' }),
+    __metadata("design:type", Number)
+], AdminNodeEventListDto.prototype, "pageSize", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Total pages (at least 1)' }),
+    __metadata("design:type", Number)
+], AdminNodeEventListDto.prototype, "totalPages", void 0);
+/**
+ * Machine-level readings a node reported (`vitals.host`).
+ *
+ * @stability experimental
+ */
+class NodeHostVitalsDto {
+    /** System-wide CPU utilisation, 0 to 100 */
+    cpuPercent;
+    /** Logical CPU count */
+    cpuCount;
+    /** 1-minute load average */
+    loadAvg1;
+    /** 5-minute load average */
+    loadAvg5;
+    /** 15-minute load average */
+    loadAvg15;
+    /** Total physical memory, bytes */
+    memTotalBytes;
+    /** Free physical memory, bytes */
+    memFreeBytes;
+    /** Memory available to new work, bytes */
+    memAvailableBytes;
+    /** OS release string */
+    osRelease;
+    /** CPU architecture */
+    arch;
+    /** Seconds since boot */
+    uptimeSeconds;
+}
+exports.NodeHostVitalsDto = NodeHostVitalsDto;
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'System-wide CPU utilisation, 0 to 100', minimum: 0, maximum: 100 }),
+    __metadata("design:type", Number)
+], NodeHostVitalsDto.prototype, "cpuPercent", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Logical CPU count' }),
+    __metadata("design:type", Number)
+], NodeHostVitalsDto.prototype, "cpuCount", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '1-minute load average' }),
+    __metadata("design:type", Number)
+], NodeHostVitalsDto.prototype, "loadAvg1", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '5-minute load average' }),
+    __metadata("design:type", Number)
+], NodeHostVitalsDto.prototype, "loadAvg5", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '15-minute load average' }),
+    __metadata("design:type", Number)
+], NodeHostVitalsDto.prototype, "loadAvg15", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Total physical memory, bytes' }),
+    __metadata("design:type", Number)
+], NodeHostVitalsDto.prototype, "memTotalBytes", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Free physical memory, bytes' }),
+    __metadata("design:type", Number)
+], NodeHostVitalsDto.prototype, "memFreeBytes", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Memory available to new work (reclaimable included), bytes' }),
+    __metadata("design:type", Number)
+], NodeHostVitalsDto.prototype, "memAvailableBytes", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'The OS release string', maxLength: 128 }),
+    __metadata("design:type", String)
+], NodeHostVitalsDto.prototype, "osRelease", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'The CPU architecture (`x64`, `arm64`)', maxLength: 32 }),
+    __metadata("design:type", String)
+], NodeHostVitalsDto.prototype, "arch", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Seconds since the machine booted' }),
+    __metadata("design:type", Number)
+], NodeHostVitalsDto.prototype, "uptimeSeconds", void 0);
+/**
+ * Power state a node reported (`vitals.power`).
+ *
+ * @stability experimental
+ */
+class NodePowerDto {
+    /** Where power comes from */
+    source;
+    /** Battery charge, 0 to 100 */
+    batteryPercent;
+    /** Whether the battery is charging */
+    charging;
+    /** Estimated seconds of battery left */
+    timeRemainingSeconds;
+    /** Whether OS low-power mode is on */
+    lowPowerMode;
+}
+exports.NodePowerDto = NodePowerDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Where power comes from', enum: ['ac', 'battery', 'unknown'] }),
+    __metadata("design:type", String)
+], NodePowerDto.prototype, "source", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Battery charge, 0 to 100', minimum: 0, maximum: 100 }),
+    __metadata("design:type", Number)
+], NodePowerDto.prototype, "batteryPercent", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Whether the battery is charging' }),
+    __metadata("design:type", Boolean)
+], NodePowerDto.prototype, "charging", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Estimated seconds of battery left' }),
+    __metadata("design:type", Number)
+], NodePowerDto.prototype, "timeRemainingSeconds", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Whether the OS low-power / battery-saver mode is on' }),
+    __metadata("design:type", Boolean)
+], NodePowerDto.prototype, "lowPowerMode", void 0);
+//# sourceMappingURL=node-event.dto.js.map

package/dist/nodes/dto/node-event.dto.js.map

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

package/dist/nodes/dto/node-response.dto.d.ts

@@ -1,4 +1,12 @@
 import { type Job, type WorkerNode } from '../../jobs/index';
+/**
+ * The optional features this server advertises to a node, on the register and
+ * heartbeat responses. A node sends an optional capability (host vitals, power
+ * state, events) only after it sees the feature here.
+ *
+ * @stability experimental
+ */
+export declare const NODE_SERVER_FEATURES: readonly string[];
 /**
  * One worker node, as the fleet sees it.
  *
@@ -38,6 +46,19 @@ export declare class RegisterNodeResponseDto {
     node: WorkerNodeDto;
     /** `true` when an existing row for this `(owner, name)` was refreshed rather than a new one created — the normal outcome for a restarted worker. */
     reattached: boolean;
+    /** Optional server features. */
+    serverFeatures: string[];
+}
+/**
+ * The response to `POST /nodes/:id/heartbeat`: the refreshed node, plus the
+ * features this server supports so an already-registered node (which does not
+ * call register again) learns them.
+ *
+ * @stability experimental
+ */
+export declare class HeartbeatNodeResponseDto extends WorkerNodeDto {
+    /** Optional server features. */
+    serverFeatures: string[];
 }
 /**
  * A claimed job, as the node sees it.

package/dist/nodes/dto/node-response.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-response.dto.d.ts","sourceRoot":"","sources":["../../../src/nodes/dto/node-response.dto.ts"],"names":[],"mappings":"AAqDA,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAI7D;;;;GAIG;AACH,qBAAa,aAAa;IACxB,qBAAqB;IAErB,EAAE,EAAG,MAAM,CAAC;IAEZ,4BAA4B;IAM5B,IAAI,EAAG,MAAM,CAAC;IAEd,8BAA8B;IAE9B,QAAQ,EAAG,MAAM,CAAC;IAElB,mCAAmC;IAEnC,QAAQ,EAAG,MAAM,CAAC;IAElB,gCAAgC;IAEhC,UAAU,EAAG,MAAM,CAAC;IAEpB,mDAAmD;IAMnD,aAAa,EAAG,MAAM,EAAE,CAAC;IAEzB,+CAA+C;IAM/C,WAAW,EAAG,MAAM,CAAC;IAErB,oDAAoD;IAQpD,MAAM,EAAG,MAAM,CAAC;IAEhB,2FAA2F;IAM3F,YAAY,EAAG,OAAO,CAAC;IAEvB,+CAA+C;IAE/C,YAAY,EAAG,MAAM,CAAC;IAEtB,oFAAoF;IAKpF,eAAe,EAAG,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;;;GAIG;AACH,qBAAa,uBAAuB;IAClC,0CAA0C;IAE1C,IAAI,EAAG,aAAa,CAAC;IAErB,oJAAoJ;IAQpJ,UAAU,EAAG,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,UAAU;IACrB,6DAA6D;IAE7D,EAAE,EAAG,MAAM,CAAC;IAEZ,gEAAgE;IAEhE,IAAI,EAAG,MAAM,CAAC;IAEd,qCAAqC;IAErC,WAAW,EAAG,MAAM,GAAG,IAAI,CAAC;IAE5B,mCAAmC;IAEnC,SAAS,EAAG,MAAM,GAAG,IAAI,CAAC;IAE1B,6CAA6C;IAE7C,QAAQ,EAAG,MAAM,CAAC;IAElB,iGAAiG;IAKjG,QAAQ,EAAG,MAAM,CAAC;IAElB,8CAA8C;IAE9C,SAAS,EAAG,MAAM,GAAG,IAAI,CAAC;IAE1B,6BAA6B;IAM7B,cAAc,EAAG,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B,oCAAoC;IAEpC,GAAG,EAAG,UAAU,CAAC;IAEjB,uGAAuG;IAUvG,MAAM,EAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjC,6LAA6L;IAW7L,eAAe,EAAG,MAAM,CAAC;IAEzB,sJAAsJ;IAatJ,UAAU,EAAG,MAAM,GAAG,IAAI,CAAC;IAE3B,yMAAyM;IAazM,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B,4FAA4F;IAO5F,IAAI,EAAG,oBAAoB,EAAE,CAAC;CAC/B;AAED;;;;GAIG;AACH,qBAAa,qBAAqB;IAChC,uCAAuC;IAEvC,KAAK,EAAG,MAAM,CAAC;IAEf,iDAAiD;IAEjD,cAAc,EAAG,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,qBAAa,wBAAwB;IACnC,+BAA+B;IAE/B,KAAK,EAAG,MAAM,CAAC;IAEf,2KAA2K;IAO3K,OAAO,EAAG,MAAM,CAAC;IAEjB,6EAA6E;IAM7E,SAAS,EAAG,OAAO,CAAC;CACrB;AAMD,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa,CAc/D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,GAAG,oBAAoB,CA0C3F"}
+{"version":3,"file":"node-response.dto.d.ts","sourceRoot":"","sources":["../../../src/nodes/dto/node-response.dto.ts"],"names":[],"mappings":"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"}

package/dist/nodes/dto/node-response.dto.js

@@ -60,11 +60,20 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.JobSettlementResponseDto = exports.RenewLeaseResponseDto = exports.ClaimJobsResponseDto = exports.NodeJobAssignmentDto = exports.NodeJobDto = exports.RegisterNodeResponseDto = exports.WorkerNodeDto = void 0;
+exports.JobSettlementResponseDto = exports.RenewLeaseResponseDto = exports.ClaimJobsResponseDto = exports.NodeJobAssignmentDto = exports.NodeJobDto = exports.HeartbeatNodeResponseDto = exports.RegisterNodeResponseDto = exports.WorkerNodeDto = exports.NODE_SERVER_FEATURES = void 0;
 exports.toWorkerNodeDto = toWorkerNodeDto;
 exports.toNodeJobAssignment = toNodeJobAssignment;
 const swagger_1 = require("@nestjs/swagger");
 const index_1 = require("../../jobs/index");
+const nodes_1 = require("@marinoscar/platform-contract/nodes");
+/**
+ * The optional features this server advertises to a node, on the register and
+ * heartbeat responses. A node sends an optional capability (host vitals, power
+ * state, events) only after it sees the feature here.
+ *
+ * @stability experimental
+ */
+exports.NODE_SERVER_FEATURES = Object.freeze([nodes_1.NODE_SERVER_CAPABILITY_HOST_VITALS]);
 /**
  * One worker node, as the fleet sees it.
  *
@@ -170,6 +179,8 @@ class RegisterNodeResponseDto {
     node;
     /** `true` when an existing row for this `(owner, name)` was refreshed rather than a new one created — the normal outcome for a restarted worker. */
     reattached;
+    /** Optional server features. */
+    serverFeatures;
 }
 exports.RegisterNodeResponseDto = RegisterNodeResponseDto;
 __decorate([
@@ -185,6 +196,36 @@ __decorate([
     }),
     __metadata("design:type", Boolean)
 ], RegisterNodeResponseDto.prototype, "reattached", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Optional features this server supports, e.g. `node_host_vitals` (host vitals, power state ' +
+            'and node events on the heartbeat). A node sends an optional capability only after it ' +
+            'sees it named here; an older server sends no list at all.',
+        type: [String],
+    }),
+    __metadata("design:type", Array)
+], RegisterNodeResponseDto.prototype, "serverFeatures", void 0);
+/**
+ * The response to `POST /nodes/:id/heartbeat`: the refreshed node, plus the
+ * features this server supports so an already-registered node (which does not
+ * call register again) learns them.
+ *
+ * @stability experimental
+ */
+class HeartbeatNodeResponseDto extends WorkerNodeDto {
+    /** Optional server features. */
+    serverFeatures;
+}
+exports.HeartbeatNodeResponseDto = HeartbeatNodeResponseDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Optional features this server supports, e.g. `node_host_vitals`. The same list the ' +
+            'register response carries, repeated here so a node that never re-registers learns it ' +
+            'from its first heartbeat.',
+        type: [String],
+    }),
+    __metadata("design:type", Array)
+], HeartbeatNodeResponseDto.prototype, "serverFeatures", void 0);
 /**
  * A claimed job, as the node sees it.
  *

package/dist/nodes/dto/node-response.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"node-response.dto.js","sourceRoot":"","sources":["../../../src/nodes/dto/node-response.dto.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"node-response.dto.js","sourceRoot":"","sources":["../../../src/nodes/dto/node-response.dto.ts"],"names":[],"mappings":"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"}

package/dist/nodes/events/node-event.event.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The `EventEmitter2` key. Permanent: a listener subscribes by string, so
+ * renaming it silently unsubscribes every listener.
+ *
+ * @stability stable
+ */
+export declare const NODE_EVENT_REPORTED = "nodes.node.event";
+/**
+ * One event a node reported and the server accepted.
+ *
+ * @example
+ * ```ts
+ * @OnEvent(NODE_EVENT_REPORTED)
+ * handle(event: NodeEventReportedEvent): void {
+ *   if (event.severity === 'critical') void this.notifications.notifyUser(event.ownerUserId, 'nodes.node_event', { ...event }).catch(log);
+ * }
+ * ```
+ *
+ * @extensionPoint event
+ * @stability experimental
+ */
+export declare class NodeEventReportedEvent {
+    readonly nodeId: string;
+    readonly nodeName: string;
+    readonly ownerUserId: string | null;
+    readonly type: string;
+    readonly severity: 'info' | 'warning' | 'critical';
+    readonly attrs: Readonly<Record<string, string | number | boolean>>;
+    readonly occurredAt: Date;
+    /**
+     * @param nodeId - the node.
+     * @param nodeName - its operator-facing name.
+     * @param ownerUserId - the user whose credential registered the node, or `null` when unknown.
+     * @param type - the dotted event type, e.g. `power.battery_low`.
+     * @param severity - `info`, `warning` or `critical`.
+     * @param attrs - the node's scalar attributes, `{}` when none.
+     * @param occurredAt - when it happened (the node's clock, clamped to the server's window).
+     */
+    constructor(nodeId: string, nodeName: string, ownerUserId: string | null, type: string, severity: 'info' | 'warning' | 'critical', attrs: Readonly<Record<string, string | number | boolean>>, occurredAt: Date);
+}
+//# sourceMappingURL=node-event.event.d.ts.map

package/dist/nodes/events/node-event.event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-event.event.d.ts","sourceRoot":"","sources":["../../../src/nodes/events/node-event.event.ts"],"names":[],"mappings":"AAiBA;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AAEtD;;;;;;;;;;;;;GAaG;AACH,qBAAa,sBAAsB;aAWf,MAAM,EAAE,MAAM;aACd,QAAQ,EAAE,MAAM;aAChB,WAAW,EAAE,MAAM,GAAG,IAAI;aAC1B,IAAI,EAAE,MAAM;aACZ,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU;aACzC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;aAC1D,UAAU,EAAE,IAAI;IAhBlC;;;;;;;;OAQG;gBAEe,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,EACzC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,EAC1D,UAAU,EAAE,IAAI;CAEnC"}

package/dist/nodes/events/node-event.event.js

@@ -0,0 +1,69 @@
+"use strict";
+// =============================================================================
+// `nodes.node.event`: a worker node reported an event about itself (issue #1045)
+// =============================================================================
+//
+// A heartbeat may carry events the node observed (power source changed, battery
+// low, woke from sleep). `NodeEventsService` persists them to
+// `worker_node_events`, then emits this event once per ACCEPTED row, AFTER the
+// write committed and outside any transaction. The slice raises no
+// notification itself: the notifications slice sits above it, so the app
+// listens and dispatches, exactly as it does for `nodes.node.offline`.
+//
+// ⚠ A LISTENER MUST NOT DO I/O IN ITS BODY beyond a fire-and-forget
+// notification dispatch (`on-event-no-io` conformance suite), and must not
+// throw: the heartbeat has already succeeded. The payload is the node's
+// self-report: untrusted, bounded by `nodeEventSchema`, never a credential.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeEventReportedEvent = exports.NODE_EVENT_REPORTED = void 0;
+/**
+ * The `EventEmitter2` key. Permanent: a listener subscribes by string, so
+ * renaming it silently unsubscribes every listener.
+ *
+ * @stability stable
+ */
+exports.NODE_EVENT_REPORTED = 'nodes.node.event';
+/**
+ * One event a node reported and the server accepted.
+ *
+ * @example
+ * ```ts
+ * @OnEvent(NODE_EVENT_REPORTED)
+ * handle(event: NodeEventReportedEvent): void {
+ *   if (event.severity === 'critical') void this.notifications.notifyUser(event.ownerUserId, 'nodes.node_event', { ...event }).catch(log);
+ * }
+ * ```
+ *
+ * @extensionPoint event
+ * @stability experimental
+ */
+class NodeEventReportedEvent {
+    nodeId;
+    nodeName;
+    ownerUserId;
+    type;
+    severity;
+    attrs;
+    occurredAt;
+    /**
+     * @param nodeId - the node.
+     * @param nodeName - its operator-facing name.
+     * @param ownerUserId - the user whose credential registered the node, or `null` when unknown.
+     * @param type - the dotted event type, e.g. `power.battery_low`.
+     * @param severity - `info`, `warning` or `critical`.
+     * @param attrs - the node's scalar attributes, `{}` when none.
+     * @param occurredAt - when it happened (the node's clock, clamped to the server's window).
+     */
+    constructor(nodeId, nodeName, ownerUserId, type, severity, attrs, occurredAt) {
+        this.nodeId = nodeId;
+        this.nodeName = nodeName;
+        this.ownerUserId = ownerUserId;
+        this.type = type;
+        this.severity = severity;
+        this.attrs = attrs;
+        this.occurredAt = occurredAt;
+    }
+}
+exports.NodeEventReportedEvent = NodeEventReportedEvent;
+//# sourceMappingURL=node-event.event.js.map

package/dist/nodes/events/node-event.event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-event.event.js","sourceRoot":"","sources":["../../../src/nodes/events/node-event.event.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,iFAAiF;AACjF,gFAAgF;AAChF,EAAE;AACF,gFAAgF;AAChF,8DAA8D;AAC9D,+EAA+E;AAC/E,mEAAmE;AACnE,yEAAyE;AACzE,uEAAuE;AACvE,EAAE;AACF,oEAAoE;AACpE,2EAA2E;AAC3E,wEAAwE;AACxE,4EAA4E;AAC5E,gFAAgF;;;AAEhF;;;;;GAKG;AACU,QAAA,mBAAmB,GAAG,kBAAkB,CAAC;AAEtD;;;;;;;;;;;;;GAaG;AACH,MAAa,sBAAsB;IAWf;IACA;IACA;IACA;IACA;IACA;IACA;IAhBlB;;;;;;;;OAQG;IACH,YACkB,MAAc,EACd,QAAgB,EAChB,WAA0B,EAC1B,IAAY,EACZ,QAAyC,EACzC,KAA0D,EAC1D,UAAgB;QANhB,WAAM,GAAN,MAAM,CAAQ;QACd,aAAQ,GAAR,QAAQ,CAAQ;QAChB,gBAAW,GAAX,WAAW,CAAe;QAC1B,SAAI,GAAJ,IAAI,CAAQ;QACZ,aAAQ,GAAR,QAAQ,CAAiC;QACzC,UAAK,GAAL,KAAK,CAAqD;QAC1D,eAAU,GAAV,UAAU,CAAM;IAC/B,CAAC;CACL;AAnBD,wDAmBC"}

package/dist/nodes/handlers/node-events-purge.handler.d.ts

@@ -0,0 +1,31 @@
+import { OnModuleInit } from '@nestjs/common';
+import { type Job, JobHandler, JobHandlerRegistry, type JobsPrisma } from '../../jobs/index';
+import { type ResolvedNodesModuleOptions } from '../nodes.options';
+/**
+ * The handler key, and therefore the `Job.type` every purge row carries.
+ * PERMANENT: rows outlive handlers.
+ *
+ * @stability experimental
+ */
+export declare const NODE_EVENTS_PURGE_TYPE = "nodes.node_events_purge";
+/**
+ * The `nodes.node_events_purge` handler: deletes node events older than the retention. Server-only.
+ *
+ * @stability experimental
+ */
+export declare class NodeEventsPurgeHandler implements JobHandler, OnModuleInit {
+    private readonly registry;
+    private readonly prisma;
+    private readonly options?;
+    private readonly logger;
+    readonly type = "nodes.node_events_purge";
+    readonly label = "Node events purge";
+    constructor(registry: JobHandlerRegistry, prisma: JobsPrisma, options?: ResolvedNodesModuleOptions | undefined);
+    /** Self-registration, the only wiring a handler needs. */
+    onModuleInit(): void;
+    /** Runs the purge. THROWS TO FAIL, like every handler. */
+    process(job: Job): Promise<void>;
+    /** Deletes every event received before the retention cutoff; returns the count. */
+    purge(now?: Date): Promise<number>;
+}
+//# sourceMappingURL=node-events-purge.handler.d.ts.map

package/dist/nodes/handlers/node-events-purge.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-events-purge.handler.d.ts","sourceRoot":"","sources":["../../../src/nodes/handlers/node-events-purge.handler.ts"],"names":[],"mappings":"AAiBA,OAAO,EAA8B,YAAY,EAAY,MAAM,gBAAgB,CAAC;AAGpF,OAAO,EAAE,KAAK,GAAG,EAAE,UAAU,EAAE,kBAAkB,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC7F,OAAO,EAAqD,KAAK,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAEtH;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAEhE;;;;GAIG;AACH,qBACa,sBAAuB,YAAW,UAAU,EAAE,YAAY;IAQnE,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACA,OAAO,CAAC,QAAQ,CAAC,MAAM;IACb,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAT9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;IAElE,QAAQ,CAAC,IAAI,6BAA0B;IAEvC,QAAQ,CAAC,KAAK,uBAAuB;gBAGlB,QAAQ,EAAE,kBAAkB,EACH,MAAM,EAAE,UAAU,EACR,OAAO,CAAC,EAAE,0BAA0B,YAAA;IAG1F,0DAA0D;IAC1D,YAAY,IAAI,IAAI;IAIpB,0DAA0D;IACpD,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAUtC,mFAAmF;IAC7E,KAAK,CAAC,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;CAQrD"}

package/dist/nodes/handlers/node-events-purge.handler.js

@@ -0,0 +1,91 @@
+"use strict";
+// =============================================================================
+// `nodes.node_events_purge`: the node event log's retention as a queue job (issue #1045)
+// =============================================================================
+//
+// `worker_node_events` grows by at most 120 rows per node per hour (the
+// ingestion cap), but a log nobody trims is a table that only grows. A daily
+// cron (`NodeEventsPurgeTask`) enqueues this job; a worker slot deletes every
+// row whose `receivedAt` is older than the retention (default 30 days,
+// `NodesModule.forRoot({ nodeEventsRetentionDays })`).
+//
+// IDEMPOTENT, SO NO OVERLAP GUARD AND NO PROFILE: one `deleteMany` on an
+// indexed column; two workers racing produce one delete and one no-op.
+//
+// SERVER-ONLY BY DERIVATION: neither `nodeResultSchema` nor `persistNodeResult`.
+// A node must never be able to delete the log that describes it.
+// =============================================================================
+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 NodeEventsPurgeHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeEventsPurgeHandler = exports.NODE_EVENTS_PURGE_TYPE = void 0;
+const common_1 = require("@nestjs/common");
+const index_1 = require("../../core/index");
+const index_2 = require("../../jobs/index");
+const nodes_options_1 = require("../nodes.options");
+/**
+ * The handler key, and therefore the `Job.type` every purge row carries.
+ * PERMANENT: rows outlive handlers.
+ *
+ * @stability experimental
+ */
+exports.NODE_EVENTS_PURGE_TYPE = 'nodes.node_events_purge';
+/**
+ * The `nodes.node_events_purge` handler: deletes node events older than the retention. Server-only.
+ *
+ * @stability experimental
+ */
+let NodeEventsPurgeHandler = NodeEventsPurgeHandler_1 = class NodeEventsPurgeHandler {
+    registry;
+    prisma;
+    options;
+    logger = new common_1.Logger(NodeEventsPurgeHandler_1.name);
+    type = exports.NODE_EVENTS_PURGE_TYPE;
+    label = 'Node events purge';
+    constructor(registry, prisma, options) {
+        this.registry = registry;
+        this.prisma = prisma;
+        this.options = options;
+    }
+    /** Self-registration, the only wiring a handler needs. */
+    onModuleInit() {
+        this.registry.register(this);
+    }
+    /** Runs the purge. THROWS TO FAIL, like every handler. */
+    async process(job) {
+        const deleted = await this.purge();
+        if (deleted > 0) {
+            this.logger.log(`Node events purge ${job.id}: ${deleted} event(s) past retention deleted`);
+        }
+        else {
+            this.logger.debug(`Node events purge ${job.id}: nothing past retention`);
+        }
+    }
+    /** Deletes every event received before the retention cutoff; returns the count. */
+    async purge(now = new Date()) {
+        const days = this.options?.nodeEventsRetentionDays ?? nodes_options_1.DEFAULT_NODE_EVENTS_RETENTION_DAYS;
+        const cutoff = new Date(now.getTime() - days * 24 * 60 * 60 * 1000);
+        const { count } = await this.prisma.workerNodeEvent.deleteMany({ where: { receivedAt: { lt: cutoff } } });
+        return count;
+    }
+};
+exports.NodeEventsPurgeHandler = NodeEventsPurgeHandler;
+exports.NodeEventsPurgeHandler = NodeEventsPurgeHandler = NodeEventsPurgeHandler_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, common_1.Inject)(index_1.PLATFORM_PRISMA)),
+    __param(2, (0, common_1.Optional)()),
+    __param(2, (0, common_1.Inject)(nodes_options_1.NODES_OPTIONS)),
+    __metadata("design:paramtypes", [index_2.JobHandlerRegistry, Object, Object])
+], NodeEventsPurgeHandler);
+//# sourceMappingURL=node-events-purge.handler.js.map

package/dist/nodes/handlers/node-events-purge.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-events-purge.handler.js","sourceRoot":"","sources":["../../../src/nodes/handlers/node-events-purge.handler.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yFAAyF;AACzF,gFAAgF;AAChF,EAAE;AACF,wEAAwE;AACxE,6EAA6E;AAC7E,8EAA8E;AAC9E,uEAAuE;AACvE,uDAAuD;AACvD,EAAE;AACF,yEAAyE;AACzE,uEAAuE;AACvE,EAAE;AACF,iFAAiF;AACjF,iEAAiE;AACjE,gFAAgF;;;;;;;;;;;;;;;;AAEhF,2CAAoF;AAEpF,4CAAmD;AACnD,4CAA6F;AAC7F,oDAAsH;AAEtH;;;;;GAKG;AACU,QAAA,sBAAsB,GAAG,yBAAyB,CAAC;AAEhE;;;;GAIG;AAEI,IAAM,sBAAsB,8BAA5B,MAAM,sBAAsB;IAQd;IACyB;IACU;IATrC,MAAM,GAAG,IAAI,eAAM,CAAC,wBAAsB,CAAC,IAAI,CAAC,CAAC;IAEzD,IAAI,GAAG,8BAAsB,CAAC;IAE9B,KAAK,GAAG,mBAAmB,CAAC;IAErC,YACmB,QAA4B,EACH,MAAkB,EACR,OAAoC;QAFvE,aAAQ,GAAR,QAAQ,CAAoB;QACH,WAAM,GAAN,MAAM,CAAY;QACR,YAAO,GAAP,OAAO,CAA6B;IACvF,CAAC;IAEJ,0DAA0D;IAC1D,YAAY;QACV,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,OAAO,CAAC,GAAQ;QACpB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QAEnC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,qBAAqB,GAAG,CAAC,EAAE,KAAK,OAAO,kCAAkC,CAAC,CAAC;QAC7F,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,GAAG,CAAC,EAAE,0BAA0B,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,mFAAmF;IACnF,KAAK,CAAC,KAAK,CAAC,MAAY,IAAI,IAAI,EAAE;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,uBAAuB,IAAI,kDAAkC,CAAC;QACzF,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAEpE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QAE1G,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAA;AAtCY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;IAUR,WAAA,IAAA,eAAM,EAAC,uBAAe,CAAC,CAAA;IACvB,WAAA,IAAA,iBAAQ,GAAE,CAAA;IAAE,WAAA,IAAA,eAAM,EAAC,6BAAa,CAAC,CAAA;qCAFP,0BAAkB;GARpC,sBAAsB,CAsClC"}