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

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

package/dist/nodes/index.d.ts

@@ -1,5 +1,5 @@
 export { NodesModule } from './nodes.module';
-export { NODES_OPTIONS, resolveNodesModuleOptions } from './nodes.options';
+export { DEFAULT_NODE_EVENTS_RETENTION_DAYS, NODES_OPTIONS, resolveNodesModuleOptions } from './nodes.options';
 export type { NodesModuleOptions, ResolvedNodesModuleOptions } from './nodes.options';
 export { NODES_SYSTEM_SETTINGS, mergeNodesSettings } from './nodes.system-settings';
 export { NodeCredentialModule } from './node-credential.module';
@@ -9,9 +9,14 @@ export { BUILTIN_NODE_SPAN_ATTRIBUTES, DEFAULT_NODE_SPAN_ATTRIBUTE_STRING_LENGTH
 export type { BuiltinNodeSpanAttribute, NodeSpanAttributeDefinition, RelayedAttribute } from './node-span-attribute.registry';
 export type { BuiltinNodeSpanName, NodeSpanName } from './dto/node-telemetry.dto';
 export { NODE_OFFLINE_EVENT, NodeOfflineEvent } from './events/node-offline.event';
+export { NODE_EVENT_REPORTED, NodeEventReportedEvent } from './events/node-event.event';
 export { CREDENTIAL_OWNER_SELECT, NODE_TOKEN_PREFIX, NodeCredentialService } from './node-credential.service';
 export { NodesService } from './nodes.service';
-export { NodeLifecycleService } from './node-lifecycle.service';
+export { NODE_EVENTS_PER_HOUR, NODE_EVENT_MAX_AGE_MS, NODE_EVENT_MAX_FUTURE_MS, NodeEventRateLimiter, NodeEventsService, } from './node-events.service';
+export type { NodeEventIngestOutcome } from './node-events.service';
+export { NODE_EVENTS_PURGE_TYPE, NodeEventsPurgeHandler } from './handlers/node-events-purge.handler';
+export { NodeLifecycleService, deriveNodeHealth } from './node-lifecycle.service';
+export type { NodeHealth, NodeHealthInput } from './node-lifecycle.service';
 export { NODE_OUTPUT_KEY_PREFIX, NodeDataPlaneService } from './node-data-plane.service';
 export { NodeSecretBrokerService, SECRET_CLOCK_SKEW_ALLOWANCE_MS } from './node-secret-broker.service';
 export { NodesAdminService, OWNER_SELECT } from './nodes-admin.service';
@@ -29,9 +34,11 @@ export type { HeartbeatNodeDto, NodeJobFailureDto, RegisterNodeDto, RenewLeaseDt
 export type { NodeDownloadUrlResponseDto, NodeJobTypeDto, NodeJobTypesResponseDto, NodeUploadUrlResponseDto, } from './dto/node-data-plane.dto';
 export type { NodeJobSecretRequestDto, NodeJobSecretResponseDto } from './dto/node-job-secret.dto';
 export type { AdminNodeCredentialDto, AdminNodeDto, NodeJobCountsDto, NodeOwnerDto, NodeVitalsCountersDto, NodeVitalsDto, } from './dto/node-admin.dto';
-export type { ClaimJobsResponseDto, JobSettlementResponseDto, NodeJobAssignmentDto, NodeJobDto, RegisterNodeResponseDto, RenewLeaseResponseDto, WorkerNodeDto, } from './dto/node-response.dto';
+export { NODE_SERVER_FEATURES } from './dto/node-response.dto';
+export type { AdminNodeEventDto, AdminNodeEventListDto, NodeHostVitalsDto, NodePowerDto } from './dto/node-event.dto';
+export type { ClaimJobsResponseDto, HeartbeatNodeResponseDto, JobSettlementResponseDto, NodeJobAssignmentDto, NodeJobDto, RegisterNodeResponseDto, RenewLeaseResponseDto, WorkerNodeDto, } from './dto/node-response.dto';
 export type { NodeCredentialCreatedResponseDto, NodeCredentialListItemDto } from './dto/node-credential-response.dto';
-export { NODES_APP_METRICS, NODE_HEALTH_VALUES, NODE_STATUS_VALUES } from './nodes.metrics';
+export { NODES_APP_METRICS, NODE_EVENT_METRIC_TYPES, NODE_EVENT_SEVERITY_VALUES, NODE_HEALTH_VALUES, NODE_STATUS_VALUES, } from './nodes.metrics';
 export type { NodesAppMetricDef } from './nodes.metrics';
 export { NODES_PERMISSIONS } from './nodes.permissions';
 export type { NodesPermissionDeclaration } from './nodes.permissions';

package/dist/nodes/index.d.ts.map

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

package/dist/nodes/index.js

@@ -5,11 +5,13 @@
 // fleet admin routes, sweeps and gauges. Needs `@marinoscar/platform-api/jobs`.
 // Documented in ./README.md. Explicit named exports only.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NODES_PERMISSIONS = exports.NODE_STATUS_VALUES = exports.NODE_HEALTH_VALUES = exports.NODES_APP_METRICS = exports.NodeUploadUrlDto = exports.NodeDownloadUrlDto = exports.NodeJobResultDto = exports.ClaimJobsDto = exports.NodeFleetSweepHandler = exports.NODE_FLEET_SWEEP_TYPE = exports.NodeFleetPruneHandler = exports.NODE_FLEET_PRUNE_TYPE = exports.OWNER_SELECT = exports.NodesAdminService = exports.SECRET_CLOCK_SKEW_ALLOWANCE_MS = exports.NodeSecretBrokerService = exports.NodeDataPlaneService = exports.NODE_OUTPUT_KEY_PREFIX = exports.NodeLifecycleService = exports.NodesService = exports.NodeCredentialService = exports.NODE_TOKEN_PREFIX = exports.CREDENTIAL_OWNER_SELECT = exports.NodeOfflineEvent = exports.NODE_OFFLINE_EVENT = exports.resolveRelayedAttribute = exports.registerNodeSpanAttribute = exports.nodeSpanAttributeRegistry = exports.NODE_SPAN_ATTRIBUTE_STRING_PATTERN = exports.NODE_SPAN_ATTRIBUTE_KEY_PATTERN = exports.MAX_NODE_SPAN_ATTRIBUTE_STRING_LENGTH = exports.MAX_NODE_SPAN_ATTRIBUTES = exports.DEFAULT_NODE_SPAN_ATTRIBUTE_STRING_LENGTH = exports.BUILTIN_NODE_SPAN_ATTRIBUTES = exports.NodeJobInputError = exports.NODE_OBJECT_STORE = exports.NODE_JOB_INPUTS = exports.NodeCredentialModule = exports.mergeNodesSettings = exports.NODES_SYSTEM_SETTINGS = exports.resolveNodesModuleOptions = exports.NODES_OPTIONS = exports.NodesModule = void 0;
+exports.NodeUploadUrlDto = exports.NodeDownloadUrlDto = exports.NodeJobResultDto = exports.ClaimJobsDto = exports.NodeFleetSweepHandler = exports.NODE_FLEET_SWEEP_TYPE = exports.NodeFleetPruneHandler = exports.NODE_FLEET_PRUNE_TYPE = exports.OWNER_SELECT = exports.NodesAdminService = exports.SECRET_CLOCK_SKEW_ALLOWANCE_MS = exports.NodeSecretBrokerService = exports.NodeDataPlaneService = exports.NODE_OUTPUT_KEY_PREFIX = exports.deriveNodeHealth = exports.NodeLifecycleService = exports.NodeEventsPurgeHandler = exports.NODE_EVENTS_PURGE_TYPE = exports.NodeEventsService = exports.NodeEventRateLimiter = exports.NODE_EVENT_MAX_FUTURE_MS = exports.NODE_EVENT_MAX_AGE_MS = exports.NODE_EVENTS_PER_HOUR = exports.NodesService = exports.NodeCredentialService = exports.NODE_TOKEN_PREFIX = exports.CREDENTIAL_OWNER_SELECT = exports.NodeEventReportedEvent = exports.NODE_EVENT_REPORTED = exports.NodeOfflineEvent = exports.NODE_OFFLINE_EVENT = exports.resolveRelayedAttribute = exports.registerNodeSpanAttribute = exports.nodeSpanAttributeRegistry = exports.NODE_SPAN_ATTRIBUTE_STRING_PATTERN = exports.NODE_SPAN_ATTRIBUTE_KEY_PATTERN = exports.MAX_NODE_SPAN_ATTRIBUTE_STRING_LENGTH = exports.MAX_NODE_SPAN_ATTRIBUTES = exports.DEFAULT_NODE_SPAN_ATTRIBUTE_STRING_LENGTH = exports.BUILTIN_NODE_SPAN_ATTRIBUTES = exports.NodeJobInputError = exports.NODE_OBJECT_STORE = exports.NODE_JOB_INPUTS = exports.NodeCredentialModule = exports.mergeNodesSettings = exports.NODES_SYSTEM_SETTINGS = exports.resolveNodesModuleOptions = exports.NODES_OPTIONS = exports.DEFAULT_NODE_EVENTS_RETENTION_DAYS = exports.NodesModule = void 0;
+exports.NODES_PERMISSIONS = exports.NODE_STATUS_VALUES = exports.NODE_HEALTH_VALUES = exports.NODE_EVENT_SEVERITY_VALUES = exports.NODE_EVENT_METRIC_TYPES = exports.NODES_APP_METRICS = exports.NODE_SERVER_FEATURES = void 0;
 // ---- the modules and options (rung 1) --------------------------------------------------
 var nodes_module_1 = require("./nodes.module");
 Object.defineProperty(exports, "NodesModule", { enumerable: true, get: function () { return nodes_module_1.NodesModule; } });
 var nodes_options_1 = require("./nodes.options");
+Object.defineProperty(exports, "DEFAULT_NODE_EVENTS_RETENTION_DAYS", { enumerable: true, get: function () { return nodes_options_1.DEFAULT_NODE_EVENTS_RETENTION_DAYS; } });
 Object.defineProperty(exports, "NODES_OPTIONS", { enumerable: true, get: function () { return nodes_options_1.NODES_OPTIONS; } });
 Object.defineProperty(exports, "resolveNodesModuleOptions", { enumerable: true, get: function () { return nodes_options_1.resolveNodesModuleOptions; } });
 var nodes_system_settings_1 = require("./nodes.system-settings");
@@ -37,6 +39,9 @@ Object.defineProperty(exports, "resolveRelayedAttribute", { enumerable: true, ge
 var node_offline_event_1 = require("./events/node-offline.event");
 Object.defineProperty(exports, "NODE_OFFLINE_EVENT", { enumerable: true, get: function () { return node_offline_event_1.NODE_OFFLINE_EVENT; } });
 Object.defineProperty(exports, "NodeOfflineEvent", { enumerable: true, get: function () { return node_offline_event_1.NodeOfflineEvent; } });
+var node_event_event_1 = require("./events/node-event.event");
+Object.defineProperty(exports, "NODE_EVENT_REPORTED", { enumerable: true, get: function () { return node_event_event_1.NODE_EVENT_REPORTED; } });
+Object.defineProperty(exports, "NodeEventReportedEvent", { enumerable: true, get: function () { return node_event_event_1.NodeEventReportedEvent; } });
 // ---- services ----------------------------------------------------------------------------------
 var node_credential_service_1 = require("./node-credential.service");
 Object.defineProperty(exports, "CREDENTIAL_OWNER_SELECT", { enumerable: true, get: function () { return node_credential_service_1.CREDENTIAL_OWNER_SELECT; } });
@@ -44,8 +49,18 @@ Object.defineProperty(exports, "NODE_TOKEN_PREFIX", { enumerable: true, get: fun
 Object.defineProperty(exports, "NodeCredentialService", { enumerable: true, get: function () { return node_credential_service_1.NodeCredentialService; } });
 var nodes_service_1 = require("./nodes.service");
 Object.defineProperty(exports, "NodesService", { enumerable: true, get: function () { return nodes_service_1.NodesService; } });
+var node_events_service_1 = require("./node-events.service");
+Object.defineProperty(exports, "NODE_EVENTS_PER_HOUR", { enumerable: true, get: function () { return node_events_service_1.NODE_EVENTS_PER_HOUR; } });
+Object.defineProperty(exports, "NODE_EVENT_MAX_AGE_MS", { enumerable: true, get: function () { return node_events_service_1.NODE_EVENT_MAX_AGE_MS; } });
+Object.defineProperty(exports, "NODE_EVENT_MAX_FUTURE_MS", { enumerable: true, get: function () { return node_events_service_1.NODE_EVENT_MAX_FUTURE_MS; } });
+Object.defineProperty(exports, "NodeEventRateLimiter", { enumerable: true, get: function () { return node_events_service_1.NodeEventRateLimiter; } });
+Object.defineProperty(exports, "NodeEventsService", { enumerable: true, get: function () { return node_events_service_1.NodeEventsService; } });
+var node_events_purge_handler_1 = require("./handlers/node-events-purge.handler");
+Object.defineProperty(exports, "NODE_EVENTS_PURGE_TYPE", { enumerable: true, get: function () { return node_events_purge_handler_1.NODE_EVENTS_PURGE_TYPE; } });
+Object.defineProperty(exports, "NodeEventsPurgeHandler", { enumerable: true, get: function () { return node_events_purge_handler_1.NodeEventsPurgeHandler; } });
 var node_lifecycle_service_1 = require("./node-lifecycle.service");
 Object.defineProperty(exports, "NodeLifecycleService", { enumerable: true, get: function () { return node_lifecycle_service_1.NodeLifecycleService; } });
+Object.defineProperty(exports, "deriveNodeHealth", { enumerable: true, get: function () { return node_lifecycle_service_1.deriveNodeHealth; } });
 var node_data_plane_service_1 = require("./node-data-plane.service");
 Object.defineProperty(exports, "NODE_OUTPUT_KEY_PREFIX", { enumerable: true, get: function () { return node_data_plane_service_1.NODE_OUTPUT_KEY_PREFIX; } });
 Object.defineProperty(exports, "NodeDataPlaneService", { enumerable: true, get: function () { return node_data_plane_service_1.NodeDataPlaneService; } });
@@ -68,9 +83,13 @@ Object.defineProperty(exports, "NodeJobResultDto", { enumerable: true, get: func
 var node_data_plane_dto_1 = require("./dto/node-data-plane.dto");
 Object.defineProperty(exports, "NodeDownloadUrlDto", { enumerable: true, get: function () { return node_data_plane_dto_1.NodeDownloadUrlDto; } });
 Object.defineProperty(exports, "NodeUploadUrlDto", { enumerable: true, get: function () { return node_data_plane_dto_1.NodeUploadUrlDto; } });
+var node_response_dto_1 = require("./dto/node-response.dto");
+Object.defineProperty(exports, "NODE_SERVER_FEATURES", { enumerable: true, get: function () { return node_response_dto_1.NODE_SERVER_FEATURES; } });
 // ---- metrics, permissions ----------------------------------------------------------------------
 var nodes_metrics_1 = require("./nodes.metrics");
 Object.defineProperty(exports, "NODES_APP_METRICS", { enumerable: true, get: function () { return nodes_metrics_1.NODES_APP_METRICS; } });
+Object.defineProperty(exports, "NODE_EVENT_METRIC_TYPES", { enumerable: true, get: function () { return nodes_metrics_1.NODE_EVENT_METRIC_TYPES; } });
+Object.defineProperty(exports, "NODE_EVENT_SEVERITY_VALUES", { enumerable: true, get: function () { return nodes_metrics_1.NODE_EVENT_SEVERITY_VALUES; } });
 Object.defineProperty(exports, "NODE_HEALTH_VALUES", { enumerable: true, get: function () { return nodes_metrics_1.NODE_HEALTH_VALUES; } });
 Object.defineProperty(exports, "NODE_STATUS_VALUES", { enumerable: true, get: function () { return nodes_metrics_1.NODE_STATUS_VALUES; } });
 var nodes_permissions_1 = require("./nodes.permissions");

package/dist/nodes/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nodes/index.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,qEAAqE;AACrE,6EAA6E;AAC7E,gFAAgF;AAChF,0DAA0D;;;AAE1D,2FAA2F;AAC3F,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,iDAA2E;AAAlE,8GAAA,aAAa,OAAA;AAAE,0HAAA,yBAAyB,OAAA;AAEjD,iEAAoF;AAA3E,8HAAA,qBAAqB,OAAA;AAAE,2HAAA,kBAAkB,OAAA;AAClD,mEAAgE;AAAvD,8HAAA,oBAAoB,OAAA;AAE7B,6FAA6F;AAC7F,iCAAgF;AAAvE,wGAAA,eAAe,OAAA;AAAE,0GAAA,iBAAiB,OAAA;AAAE,0GAAA,iBAAiB,OAAA;AAU9D,8FAA8F;AAC9F,+EAUwC;AATtC,4IAAA,4BAA4B,OAAA;AAC5B,yJAAA,yCAAyC,OAAA;AACzC,wIAAA,wBAAwB,OAAA;AACxB,qJAAA,qCAAqC,OAAA;AACrC,+IAAA,+BAA+B,OAAA;AAC/B,kJAAA,kCAAkC,OAAA;AAClC,yIAAA,yBAAyB,OAAA;AACzB,yIAAA,yBAAyB,OAAA;AACzB,uIAAA,uBAAuB,OAAA;AAKzB,iGAAiG;AACjG,kEAAmF;AAA1E,wHAAA,kBAAkB,OAAA;AAAE,sHAAA,gBAAgB,OAAA;AAE7C,mGAAmG;AACnG,qEAA8G;AAArG,kIAAA,uBAAuB,OAAA;AAAE,4HAAA,iBAAiB,OAAA;AAAE,gIAAA,qBAAqB,OAAA;AAC1E,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,mEAAgE;AAAvD,8HAAA,oBAAoB,OAAA;AAC7B,qEAAyF;AAAhF,iIAAA,sBAAsB,OAAA;AAAE,+HAAA,oBAAoB,OAAA;AACrD,2EAAuG;AAA9F,qIAAA,uBAAuB,OAAA;AAAE,4IAAA,8BAA8B,OAAA;AAChE,6DAAwE;AAA/D,wHAAA,iBAAiB,OAAA;AAAE,mHAAA,YAAY,OAAA;AACxC,gFAAmG;AAA1F,iIAAA,qBAAqB,OAAA;AAAE,iIAAA,qBAAqB,OAAA;AACrD,gFAAmG;AAA1F,iIAAA,qBAAqB,OAAA;AAAE,iIAAA,qBAAqB,OAAA;AAErD,oGAAoG;AACpG,uEAA8E;AAArE,sHAAA,YAAY,OAAA;AAAE,0HAAA,gBAAgB,OAAA;AACvC,iEAAiF;AAAxE,yHAAA,kBAAkB,OAAA;AAAE,uHAAA,gBAAgB,OAAA;AAoC7C,mGAAmG;AACnG,iDAA4F;AAAnF,kHAAA,iBAAiB,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AAElE,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nodes/index.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,qEAAqE;AACrE,6EAA6E;AAC7E,gFAAgF;AAChF,0DAA0D;;;;AAE1D,2FAA2F;AAC3F,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,iDAA+G;AAAtG,mIAAA,kCAAkC,OAAA;AAAE,8GAAA,aAAa,OAAA;AAAE,0HAAA,yBAAyB,OAAA;AAErF,iEAAoF;AAA3E,8HAAA,qBAAqB,OAAA;AAAE,2HAAA,kBAAkB,OAAA;AAClD,mEAAgE;AAAvD,8HAAA,oBAAoB,OAAA;AAE7B,6FAA6F;AAC7F,iCAAgF;AAAvE,wGAAA,eAAe,OAAA;AAAE,0GAAA,iBAAiB,OAAA;AAAE,0GAAA,iBAAiB,OAAA;AAU9D,8FAA8F;AAC9F,+EAUwC;AATtC,4IAAA,4BAA4B,OAAA;AAC5B,yJAAA,yCAAyC,OAAA;AACzC,wIAAA,wBAAwB,OAAA;AACxB,qJAAA,qCAAqC,OAAA;AACrC,+IAAA,+BAA+B,OAAA;AAC/B,kJAAA,kCAAkC,OAAA;AAClC,yIAAA,yBAAyB,OAAA;AACzB,yIAAA,yBAAyB,OAAA;AACzB,uIAAA,uBAAuB,OAAA;AAKzB,iGAAiG;AACjG,kEAAmF;AAA1E,wHAAA,kBAAkB,OAAA;AAAE,sHAAA,gBAAgB,OAAA;AAC7C,8DAAwF;AAA/E,uHAAA,mBAAmB,OAAA;AAAE,0HAAA,sBAAsB,OAAA;AAEpD,mGAAmG;AACnG,qEAA8G;AAArG,kIAAA,uBAAuB,OAAA;AAAE,4HAAA,iBAAiB,OAAA;AAAE,gIAAA,qBAAqB,OAAA;AAC1E,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,6DAM+B;AAL7B,2HAAA,oBAAoB,OAAA;AACpB,4HAAA,qBAAqB,OAAA;AACrB,+HAAA,wBAAwB,OAAA;AACxB,2HAAA,oBAAoB,OAAA;AACpB,wHAAA,iBAAiB,OAAA;AAGnB,kFAAsG;AAA7F,mIAAA,sBAAsB,OAAA;AAAE,mIAAA,sBAAsB,OAAA;AACvD,mEAAkF;AAAzE,8HAAA,oBAAoB,OAAA;AAAE,0HAAA,gBAAgB,OAAA;AAE/C,qEAAyF;AAAhF,iIAAA,sBAAsB,OAAA;AAAE,+HAAA,oBAAoB,OAAA;AACrD,2EAAuG;AAA9F,qIAAA,uBAAuB,OAAA;AAAE,4IAAA,8BAA8B,OAAA;AAChE,6DAAwE;AAA/D,wHAAA,iBAAiB,OAAA;AAAE,mHAAA,YAAY,OAAA;AACxC,gFAAmG;AAA1F,iIAAA,qBAAqB,OAAA;AAAE,iIAAA,qBAAqB,OAAA;AACrD,gFAAmG;AAA1F,iIAAA,qBAAqB,OAAA;AAAE,iIAAA,qBAAqB,OAAA;AAErD,oGAAoG;AACpG,uEAA8E;AAArE,sHAAA,YAAY,OAAA;AAAE,0HAAA,gBAAgB,OAAA;AACvC,iEAAiF;AAAxE,yHAAA,kBAAkB,OAAA;AAAE,uHAAA,gBAAgB,OAAA;AAyB7C,6DAA+D;AAAtD,yHAAA,oBAAoB,OAAA;AAc7B,mGAAmG;AACnG,iDAMyB;AALvB,kHAAA,iBAAiB,OAAA;AACjB,wHAAA,uBAAuB,OAAA;AACvB,2HAAA,0BAA0B,OAAA;AAC1B,mHAAA,kBAAkB,OAAA;AAClB,mHAAA,kBAAkB,OAAA;AAGpB,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA"}

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

@@ -0,0 +1,87 @@
+import { EventEmitter2 } from '@nestjs/event-emitter';
+import type { AdminNodeEventList, NodeEvent, NodeEventListQuery } from '@marinoscar/platform-contract/nodes';
+import { type JobsPrisma, type WorkerNode } from '../jobs/index';
+import { MetricsHostService } from '../otel-core/index';
+/**
+ * Accepted events per node per hour; the excess is dropped and counted.
+ *
+ * @stability experimental
+ */
+export declare const NODE_EVENTS_PER_HOUR = 120;
+/**
+ * An `occurredAt` older than this (relative to receipt) is replaced by the receipt time.
+ *
+ * @stability experimental
+ */
+export declare const NODE_EVENT_MAX_AGE_MS: number;
+/**
+ * An `occurredAt` further in the future than this is replaced by the receipt time.
+ *
+ * @stability experimental
+ */
+export declare const NODE_EVENT_MAX_FUTURE_MS: number;
+/** Default page size of the events list. */
+export declare const NODE_EVENTS_DEFAULT_PAGE_SIZE = 20;
+/** Largest page size of the events list. */
+export declare const NODE_EVENTS_MAX_PAGE_SIZE = 100;
+/**
+ * A per-node token bucket: `NODE_EVENTS_PER_HOUR` capacity, refilled evenly
+ * over the hour. In memory and per replica, on purpose (see the header).
+ *
+ * @stability experimental
+ */
+export declare class NodeEventRateLimiter {
+    private readonly buckets;
+    /**
+     * Takes up to `wanted` tokens for `nodeId` and returns how many it granted.
+     *
+     * @param nodeId - the node (proven owned by the caller before this is asked).
+     * @param wanted - how many events the heartbeat carried.
+     * @param nowMs - the clock, injectable for tests.
+     */
+    take(nodeId: string, wanted: number, nowMs?: number): number;
+    /** Forgets full (idle) buckets first; a fresh bucket starts full, so nothing is lost. */
+    private evict;
+}
+/**
+ * What one ingestion did.
+ *
+ * @stability experimental
+ */
+export interface NodeEventIngestOutcome {
+    /** Rows written. */
+    accepted: number;
+    /** Events dropped by the per-node rate cap. */
+    dropped: number;
+}
+/** `occurredAt` after the clamp (see the header). */
+export declare function clampOccurredAt(at: string, receivedAt: Date): Date;
+/**
+ * Records the events a heartbeat carries and serves the per-node event log:
+ * the rate cap, the clamp, the write, then the metric, span, log line and
+ * `nodes.node.event` domain event. `ingest` never throws.
+ *
+ * @stability experimental
+ */
+export declare class NodeEventsService {
+    private readonly prisma;
+    private readonly events?;
+    private readonly logger;
+    private readonly limiter;
+    private readonly metrics;
+    constructor(prisma: JobsPrisma, events?: EventEmitter2 | undefined, metrics?: MetricsHostService);
+    /**
+     * Persists the events a heartbeat carried and announces them. NEVER THROWS.
+     *
+     * @param node - the node row the heartbeat was proven to belong to.
+     * @param events - the validated `events` of the heartbeat body.
+     */
+    ingest(node: Pick<WorkerNode, 'id' | 'name' | 'createdById'>, events: readonly NodeEvent[] | undefined): Promise<NodeEventIngestOutcome>;
+    private announce;
+    /**
+     * One page of a node's events, newest first. The caller has already proven
+     * access to the node; `nodeId` not existing is a 404 here as a backstop.
+     */
+    list(nodeId: string, query: NodeEventListQuery): Promise<AdminNodeEventList>;
+}
+//# sourceMappingURL=node-events.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node-events.service.d.ts","sourceRoot":"","sources":["../../src/nodes/node-events.service.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAkB,kBAAkB,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAG7H,OAAO,EAA2B,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAE,kBAAkB,EAAsB,MAAM,oBAAoB,CAAC;AAI5E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAsB,CAAC;AAEzD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,QAAgB,CAAC;AAEtD,4CAA4C;AAC5C,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD,4CAA4C;AAC5C,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAU7C;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IAErD;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG,MAAM;IAgBxE,yFAAyF;IACzF,OAAO,CAAC,KAAK;CAOd;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,GAAG,IAAI,CAOlE;AAED;;;;;;GAMG;AACH,qBACa,iBAAiB;IAMD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAPtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAGD,MAAM,EAAE,UAAU,EAE/B,MAAM,CAAC,EAAE,aAAa,YAAA,EACvC,OAAO,CAAC,EAAE,kBAAkB;IAK1C;;;;;OAKG;IACG,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,MAAM,GAAG,aAAa,CAAC,EAAE,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAkC9I,OAAO,CAAC,QAAQ;IAiDhB;;;OAGG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAkCnF"}