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

package/dist/nodes/headless/api.d.ts

@@ -1,5 +1,5 @@
 import type { PlatformApiClient } from '../../core/index.js';
-import type { CreateNodeCredentialInput, NodeCredential, NodeCredentialCreated, WorkerNode } from './types.js';
+import type { CreateNodeCredentialInput, NodeCredential, NodeCredentialCreated, NodeEventsQuery, WorkerNode, WorkerNodeEventList } from './types.js';
 /**
  * Every call the worker-node page and hooks make. `createNodesApi` builds one
  * over the app's transport; a test or an app with its own client implements it.
@@ -20,6 +20,8 @@ export interface NodesApi {
     createNodeCredential(input: CreateNodeCredentialInput): Promise<NodeCredentialCreated>;
     /** `DELETE /admin/nodes/credentials/:id`: effective on the node's next request; one-way. */
     revokeNodeCredential(id: string): Promise<void>;
+    /** `GET /admin/nodes/:id/events`: a page of the node's events, newest first (`nodes:read`). */
+    listNodeEvents(nodeId: string, query?: NodeEventsQuery): Promise<WorkerNodeEventList>;
 }
 /**
  * The worker-node client over the app's transport.

package/dist/nodes/headless/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/nodes/headless/api.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,yBAAyB,EAAE,cAAc,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE/G;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,8EAA8E;IAC9E,cAAc,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACxC,6DAA6D;IAC7D,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,yGAAyG;IACzG,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,6FAA6F;IAC7F,kBAAkB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAChD,kFAAkF;IAClF,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACvF,4FAA4F;IAC5F,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,QAAQ,CAiBlE"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/nodes/headless/api.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EACV,yBAAyB,EACzB,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,8EAA8E;IAC9E,cAAc,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACxC,6DAA6D;IAC7D,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,yGAAyG;IACzG,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,6FAA6F;IAC7F,kBAAkB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAChD,kFAAkF;IAClF,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACvF,4FAA4F;IAC5F,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,+FAA+F;IAC/F,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACvF;AAgBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,QAAQ,CAmBlE"}

package/dist/nodes/headless/api.js

@@ -16,7 +16,28 @@
 //
 // `GET /admin/nodes` returns the whole fleet as a bare array, not a page: a
 // fleet is tens of machines, and the page tallies its health verdicts.
+//
+// A node's events (#1045) ARE paged (`GET /admin/nodes/:id/events`): a laptop node
+// on battery reports a change every few minutes, and a timeline only ever
+// needs the newest screenful.
 // =============================================================================
+/**
+ * `GET /admin/nodes/:id/events`'s query string: only the members that are set, in a
+ * fixed order (page, pageSize, type, severity), so a request is byte-stable.
+ */
+function nodeEventsQueryString(query) {
+    const params = new URLSearchParams();
+    if (query.page !== undefined)
+        params.set('page', String(query.page));
+    if (query.pageSize !== undefined)
+        params.set('pageSize', String(query.pageSize));
+    if (query.type)
+        params.set('type', query.type);
+    if (query.severity)
+        params.set('severity', query.severity);
+    const text = params.toString();
+    return text ? `?${text}` : '';
+}
 /**
  * The worker-node client over the app's transport.
  *
@@ -48,6 +69,7 @@ export function createNodesApi(client) {
         revokeNodeCredential: async (id) => {
             await client.delete(`/admin/nodes/credentials/${id}`);
         },
+        listNodeEvents: (nodeId, query = {}) => client.get(`/admin/nodes/${encodeURIComponent(nodeId)}/events${nodeEventsQueryString(query)}`),
     };
 }
 //# sourceMappingURL=api.js.map

package/dist/nodes/headless/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/nodes/headless/api.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,4CAA4C;AAC5C,gFAAgF;AAChF,EAAE;AACF,gFAAgF;AAChF,2EAA2E;AAC3E,8EAA8E;AAC9E,wDAAwD;AACxD,EAAE;AACF,+EAA+E;AAC/E,4EAA4E;AAC5E,4EAA4E;AAC5E,iEAAiE;AACjE,6EAA6E;AAC7E,SAAS;AACT,EAAE;AACF,4EAA4E;AAC5E,uEAAuE;AACvE,gFAAgF;AA2BhF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,MAAyB;IACtD,OAAO;QACL,cAAc,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAe,cAAc,CAAC;QAC9D,aAAa,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAa,gBAAgB,EAAE,EAAE,CAAC;QACnE,gBAAgB,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YAC7B,MAAM,MAAM,CAAC,MAAM,CAAO,gBAAgB,EAAE,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,kBAAkB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAmB,0BAA0B,CAAC;QAClF,oBAAoB,EAAE,CAAC,KAAK,EAAE,EAAE;YAC9B,MAAM,IAAI,GAA8B,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7D,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS;gBAAE,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;YAChF,OAAO,MAAM,CAAC,IAAI,CAAwB,mBAAmB,EAAE,IAAI,CAAC,CAAC;QACvE,CAAC;QACD,oBAAoB,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YACjC,MAAM,MAAM,CAAC,MAAM,CAAO,4BAA4B,EAAE,EAAE,CAAC,CAAC;QAC9D,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/nodes/headless/api.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,4CAA4C;AAC5C,gFAAgF;AAChF,EAAE;AACF,gFAAgF;AAChF,2EAA2E;AAC3E,8EAA8E;AAC9E,wDAAwD;AACxD,EAAE;AACF,+EAA+E;AAC/E,4EAA4E;AAC5E,4EAA4E;AAC5E,iEAAiE;AACjE,6EAA6E;AAC7E,SAAS;AACT,EAAE;AACF,4EAA4E;AAC5E,uEAAuE;AACvE,EAAE;AACF,mFAAmF;AACnF,0EAA0E;AAC1E,8BAA8B;AAC9B,gFAAgF;AAoChF;;;GAGG;AACH,SAAS,qBAAqB,CAAC,KAAsB;IACnD,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACrE,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;QAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjF,IAAI,KAAK,CAAC,IAAI;QAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,KAAK,CAAC,QAAQ;QAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC/B,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAChC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,MAAyB;IACtD,OAAO;QACL,cAAc,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAe,cAAc,CAAC;QAC9D,aAAa,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAa,gBAAgB,EAAE,EAAE,CAAC;QACnE,gBAAgB,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YAC7B,MAAM,MAAM,CAAC,MAAM,CAAO,gBAAgB,EAAE,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,kBAAkB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAmB,0BAA0B,CAAC;QAClF,oBAAoB,EAAE,CAAC,KAAK,EAAE,EAAE;YAC9B,MAAM,IAAI,GAA8B,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7D,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS;gBAAE,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;YAChF,OAAO,MAAM,CAAC,IAAI,CAAwB,mBAAmB,EAAE,IAAI,CAAC,CAAC;QACvE,CAAC;QACD,oBAAoB,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YACjC,MAAM,MAAM,CAAC,MAAM,CAAO,4BAA4B,EAAE,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,cAAc,EAAE,CAAC,MAAM,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CACrC,MAAM,CAAC,GAAG,CAAsB,gBAAgB,kBAAkB,CAAC,MAAM,CAAC,UAAU,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;KACtH,CAAC;AACJ,CAAC"}

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

@@ -1,7 +1,12 @@
 export { createNodesApi } from './api.js';
 export type { NodesApi } from './api.js';
-export { MAX_NODE_CREDENTIAL_DAYS, MAX_NODE_CREDENTIAL_NAME_LENGTH, NODE_HEALTHS, NODE_STATUSES, nodeCredentialStatus, } from './types.js';
-export type { CreateNodeCredentialInput, NodeCredential, NodeCredentialCreated, NodeCredentialStatus, NodeHealth, NodeJobCounts, NodeOwner, NodeStatus, NodeVitals, NodeVitalsCounters, WorkerNode, } from './types.js';
+export { MAX_NODE_CREDENTIAL_DAYS, MAX_NODE_CREDENTIAL_NAME_LENGTH, NODE_EVENT_TYPES, NODE_HEALTHS, NODE_STATUSES, nodeCredentialStatus, } from './types.js';
+export type { CreateNodeCredentialInput, NodeCredential, NodeCredentialCreated, NodeCredentialStatus, NodeEventSeverity, NodeEventsQuery, NodeHealth, NodeHostVitals, NodeJobCounts, NodeOwner, NodePower, NodeStatus, NodeVitals, NodeVitalsCounters, WorkerNode, WorkerNodeEvent, WorkerNodeEventList, } from './types.js';
+export { MAX_NODE_EVENT_SUMMARY_ATTRS, humanizeNodeEventType, nodeEventLabel, nodeEventSummary } from './node-events.js';
+export { NODE_BATTERY_CRITICAL_PERCENT, NODE_BATTERY_WARNING_PERCENT, describeNodePower } from './power.js';
+export type { NodePowerDescription } from './power.js';
+export { useNodeEvents } from './use-node-events.js';
+export type { UseNodeEventsResult } from './use-node-events.js';
 export { formatDateTime, formatDuration, shortId } from './format.js';
 export { formatNodeVital, nodeVitalFor, nodeVitalRows, registerNodeVital, registeredNodeVitals } from './node-vitals.js';
 export type { NodeVitalDef, NodeVitalRow, NodeVitalUnit } from './node-vitals.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/nodes/headless/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,wBAAwB,EACxB,+BAA+B,EAC/B,YAAY,EACZ,aAAa,EACb,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,yBAAyB,EACzB,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,UAAU,EACV,aAAa,EACb,SAAS,EACT,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACzH,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7G,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC3F,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACzE,YAAY,EACV,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,6BAA6B,EAC7B,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EACL,6BAA6B,EAC7B,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/nodes/headless/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,wBAAwB,EACxB,+BAA+B,EAC/B,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,yBAAyB,EACzB,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,cAAc,EACd,aAAa,EACb,SAAS,EACT,SAAS,EACT,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzH,OAAO,EAAE,6BAA6B,EAAE,4BAA4B,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC5G,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACzH,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7G,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC3F,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACzE,YAAY,EACV,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,6BAA6B,EAC7B,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EACL,6BAA6B,EAC7B,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC"}

package/dist/nodes/headless/index.js

@@ -4,7 +4,10 @@
 // the data hooks, the visible-tab poll, the adapters and the formatting
 // helpers. Documented in ../README.md. Explicit named exports only.
 export { createNodesApi } from './api.js';
-export { MAX_NODE_CREDENTIAL_DAYS, MAX_NODE_CREDENTIAL_NAME_LENGTH, NODE_HEALTHS, NODE_STATUSES, nodeCredentialStatus, } from './types.js';
+export { MAX_NODE_CREDENTIAL_DAYS, MAX_NODE_CREDENTIAL_NAME_LENGTH, NODE_EVENT_TYPES, NODE_HEALTHS, NODE_STATUSES, nodeCredentialStatus, } from './types.js';
+export { MAX_NODE_EVENT_SUMMARY_ATTRS, humanizeNodeEventType, nodeEventLabel, nodeEventSummary } from './node-events.js';
+export { NODE_BATTERY_CRITICAL_PERCENT, NODE_BATTERY_WARNING_PERCENT, describeNodePower } from './power.js';
+export { useNodeEvents } from './use-node-events.js';
 export { formatDateTime, formatDuration, shortId } from './format.js';
 export { formatNodeVital, nodeVitalFor, nodeVitalRows, registerNodeVital, registeredNodeVitals } from './node-vitals.js';
 export { MAX_CAPABILITY_TEXT_LENGTH, MAX_LISTED_CAPABILITIES, nodeCapabilityItems } from './capabilities.js';

package/dist/nodes/headless/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/nodes/headless/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,4EAA4E;AAC5E,wFAAwF;AACxF,wEAAwE;AACxE,oEAAoE;AAEpE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,OAAO,EACL,wBAAwB,EACxB,+BAA+B,EAC/B,YAAY,EACZ,aAAa,EACb,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAcpB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAEzH,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7G,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAc3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EACL,6BAA6B,EAC7B,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,cAAc,GACf,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/nodes/headless/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,4EAA4E;AAC5E,wFAAwF;AACxF,wEAAwE;AACxE,oEAAoE;AAEpE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,OAAO,EACL,wBAAwB,EACxB,+BAA+B,EAC/B,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAoBpB,OAAO,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzH,OAAO,EAAE,6BAA6B,EAAE,4BAA4B,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE5G,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAEzH,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7G,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAc3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EACL,6BAA6B,EAC7B,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,cAAc,GACf,MAAM,uBAAuB,CAAC"}

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

@@ -0,0 +1,43 @@
+import type { WorkerNodeEvent } from './types.js';
+/**
+ * Most attributes a summary of an unknown event prints.
+ *
+ * @stability experimental
+ */
+export declare const MAX_NODE_EVENT_SUMMARY_ATTRS = 4;
+/**
+ * A dotted event type as words: the last segment is the event, the ones before
+ * it its area (`transcode.queue_full` to "Transcode: queue full").
+ *
+ * @param type - the event's dotted type.
+ * @returns the humanized text; the input itself when it has no segments.
+ *
+ * @stability experimental
+ */
+export declare function humanizeNodeEventType(type: string): string;
+/**
+ * How an event type reads: the platform's label for a `NODE_EVENT_TYPES` name,
+ * else {@link humanizeNodeEventType}.
+ *
+ * @param type - the event's dotted type.
+ * @returns the label.
+ *
+ * @stability experimental
+ */
+export declare function nodeEventLabel(type: string): string;
+/**
+ * One line that says what an event's attributes mean, or `null` when it has
+ * none worth printing.
+ *
+ * Known types read as a sentence fragment ("AC → Battery (64%)", "12% (threshold
+ * 20%)", "Asleep for 2h 03m", "4.5% free (1.2 GB)"); an unknown type, or a known
+ * one missing the attributes its fragment needs, reads as `key: value` pairs, at
+ * most {@link MAX_NODE_EVENT_SUMMARY_ATTRS} of them, sorted by key.
+ *
+ * @param event - the event (its `type` and `attrs`).
+ * @returns the summary, or `null`.
+ *
+ * @stability experimental
+ */
+export declare function nodeEventSummary(event: Pick<WorkerNodeEvent, 'type' | 'attrs'>): string | null;
+//# sourceMappingURL=node-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node-events.d.ts","sourceRoot":"","sources":["../../../src/nodes/headless/node-events.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAYlD;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAU9C;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAyBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CA4C9F"}

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

@@ -0,0 +1,150 @@
+// =============================================================================
+// Node events: how the Worker Nodes page words one (issue #1045)
+// =============================================================================
+//
+// A node reports what it observed about itself on its heartbeat (a power
+// change, a low battery, a wake from sleep, a low disk); the API stores each one
+// and serves them at `GET /api/admin/nodes/:id/events`. These helpers turn one into
+// text: a label for its type and a one-line summary of its attributes.
+//
+// The type is an OPEN dotted string: an app's node may report its own. A known
+// type (`NODE_EVENT_TYPES`) reads by its label; an unknown one is still shown,
+// humanized from its dotted name (`transcode.queue_full` -> "Transcode: queue
+// full"), never hidden. Attributes are self-reported scalars; they are printed
+// as plain text, bounded, and never turned into a verdict.
+//
+// Pure functions, no markup, so they live in the headless entry.
+// =============================================================================
+import { NODE_EVENT_TYPES } from '@marinoscar/platform-contract/nodes';
+import { formatBytes } from '../internal/format-bytes.js';
+import { formatDuration } from './format.js';
+/** The platform's own event types, as an operator reads them. */
+const NODE_EVENT_LABELS = Object.freeze({
+    [NODE_EVENT_TYPES.POWER_SOURCE_CHANGED]: 'Power source changed',
+    [NODE_EVENT_TYPES.BATTERY_LOW]: 'Battery low',
+    [NODE_EVENT_TYPES.BATTERY_CRITICAL]: 'Battery critical',
+    [NODE_EVENT_TYPES.BATTERY_RECOVERED]: 'Battery recovered',
+    [NODE_EVENT_TYPES.SLEEP_RESUMED]: 'Resumed from sleep',
+    [NODE_EVENT_TYPES.DISK_LOW]: 'Disk space low',
+});
+/**
+ * Most attributes a summary of an unknown event prints.
+ *
+ * @stability experimental
+ */
+export const MAX_NODE_EVENT_SUMMARY_ATTRS = 4;
+/** Longest attribute value a summary prints before an ellipsis. */
+const MAX_ATTR_TEXT = 64;
+function sentenceCase(text) {
+    const spaced = text.replace(/_/g, ' ').trim();
+    return spaced.charAt(0).toUpperCase() + spaced.slice(1);
+}
+/**
+ * A dotted event type as words: the last segment is the event, the ones before
+ * it its area (`transcode.queue_full` to "Transcode: queue full").
+ *
+ * @param type - the event's dotted type.
+ * @returns the humanized text; the input itself when it has no segments.
+ *
+ * @stability experimental
+ */
+export function humanizeNodeEventType(type) {
+    const segments = type.split('.').filter((segment) => segment !== '');
+    if (segments.length === 0)
+        return type;
+    if (segments.length === 1)
+        return sentenceCase(segments[0]);
+    const last = segments[segments.length - 1];
+    const area = segments.slice(0, -1).map(sentenceCase).join(' ');
+    return `${area}: ${last.replace(/_/g, ' ')}`;
+}
+/**
+ * How an event type reads: the platform's label for a `NODE_EVENT_TYPES` name,
+ * else {@link humanizeNodeEventType}.
+ *
+ * @param type - the event's dotted type.
+ * @returns the label.
+ *
+ * @stability experimental
+ */
+export function nodeEventLabel(type) {
+    return NODE_EVENT_LABELS[type] ?? humanizeNodeEventType(type);
+}
+function attrNumber(attrs, key) {
+    const value = attrs[key];
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function percent(value) {
+    return `${Math.round(value * 10) / 10}%`;
+}
+const POWER_SOURCE_WORDS = Object.freeze({ ac: 'AC', battery: 'Battery', unknown: 'Unknown' });
+function powerSourceWord(value) {
+    if (typeof value !== 'string' || value === '')
+        return '?';
+    return POWER_SOURCE_WORDS[value] ?? value;
+}
+function plainAttr(value) {
+    const text = typeof value === 'number' ? value.toLocaleString(undefined, { maximumFractionDigits: 2 }) : String(value);
+    return text.length > MAX_ATTR_TEXT ? `${text.slice(0, MAX_ATTR_TEXT - 1)}…` : text;
+}
+/**
+ * One line that says what an event's attributes mean, or `null` when it has
+ * none worth printing.
+ *
+ * Known types read as a sentence fragment ("AC → Battery (64%)", "12% (threshold
+ * 20%)", "Asleep for 2h 03m", "4.5% free (1.2 GB)"); an unknown type, or a known
+ * one missing the attributes its fragment needs, reads as `key: value` pairs, at
+ * most {@link MAX_NODE_EVENT_SUMMARY_ATTRS} of them, sorted by key.
+ *
+ * @param event - the event (its `type` and `attrs`).
+ * @returns the summary, or `null`.
+ *
+ * @stability experimental
+ */
+export function nodeEventSummary(event) {
+    const attrs = event.attrs && typeof event.attrs === 'object' ? event.attrs : {};
+    const battery = attrNumber(attrs, 'batteryPercent');
+    const threshold = attrNumber(attrs, 'threshold');
+    switch (event.type) {
+        case NODE_EVENT_TYPES.POWER_SOURCE_CHANGED:
+            if (attrs.from !== undefined || attrs.to !== undefined) {
+                const change = `${powerSourceWord(attrs.from)} → ${powerSourceWord(attrs.to)}`;
+                return battery !== undefined ? `${change} (${percent(battery)})` : change;
+            }
+            break;
+        case NODE_EVENT_TYPES.BATTERY_LOW:
+        case NODE_EVENT_TYPES.BATTERY_CRITICAL:
+        case NODE_EVENT_TYPES.BATTERY_RECOVERED:
+            if (battery !== undefined) {
+                return threshold !== undefined ? `${percent(battery)} (threshold ${percent(threshold)})` : percent(battery);
+            }
+            break;
+        case NODE_EVENT_TYPES.SLEEP_RESUMED: {
+            const gap = attrNumber(attrs, 'gapSeconds');
+            if (gap !== undefined)
+                return `Asleep for ${formatDuration(gap * 1000)}`;
+            break;
+        }
+        case NODE_EVENT_TYPES.DISK_LOW: {
+            const freePercent = attrNumber(attrs, 'freePercent');
+            const freeBytes = attrNumber(attrs, 'freeBytes');
+            if (freePercent !== undefined) {
+                return freeBytes !== undefined ? `${percent(freePercent)} free (${formatBytes(freeBytes)})` : `${percent(freePercent)} free`;
+            }
+            if (freeBytes !== undefined)
+                return `${formatBytes(freeBytes)} free`;
+            break;
+        }
+        default:
+            break;
+    }
+    const entries = Object.entries(attrs)
+        .filter(([, value]) => typeof value === 'string' || typeof value === 'boolean' || (typeof value === 'number' && Number.isFinite(value)))
+        .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+    if (entries.length === 0)
+        return null;
+    const shown = entries.slice(0, MAX_NODE_EVENT_SUMMARY_ATTRS).map(([key, value]) => `${key}: ${plainAttr(value)}`);
+    const rest = entries.length - shown.length;
+    return rest > 0 ? `${shown.join(', ')} (+${rest} more)` : shown.join(', ');
+}
+//# sourceMappingURL=node-events.js.map

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

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

package/dist/nodes/headless/power.d.ts

@@ -0,0 +1,43 @@
+import type { NodePower } from './types.js';
+/**
+ * At or under this battery charge the badge reads in the warning colour.
+ *
+ * @stability experimental
+ */
+export declare const NODE_BATTERY_WARNING_PERCENT = 20;
+/**
+ * At or under this battery charge the badge reads in the error colour.
+ *
+ * @stability experimental
+ */
+export declare const NODE_BATTERY_CRITICAL_PERCENT = 10;
+/**
+ * A node's power state, ready to draw.
+ *
+ * @stability experimental
+ */
+export interface NodePowerDescription {
+    /** Where power comes from (`unknown` is never described). */
+    source: 'ac' | 'battery';
+    /** Battery charge, rounded to a whole percent, or `null` when not reported. */
+    percent: number | null;
+    /** Whether the battery is charging, or `null` when not reported. */
+    charging: boolean | null;
+    /** `warning` at or under 20%, `error` at or under 10%, on battery only. */
+    level: 'normal' | 'warning' | 'error';
+    /** The short visible text: `42%`, `AC`. */
+    text: string;
+    /** The full sentence, the accessible label: "On battery, 42%, discharging". */
+    label: string;
+}
+/**
+ * The badge's words and level for a node's reported power, or `null` when
+ * there is nothing to draw (no report, or source `unknown`).
+ *
+ * @param power - `lastVitals.power`, if any.
+ * @returns the description, or `null`.
+ *
+ * @stability experimental
+ */
+export declare function describeNodePower(power: NodePower | null | undefined): NodePowerDescription | null;
+//# sourceMappingURL=power.d.ts.map

package/dist/nodes/headless/power.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"power.d.ts","sourceRoot":"","sources":["../../../src/nodes/headless/power.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,6DAA6D;IAC7D,MAAM,EAAE,IAAI,GAAG,SAAS,CAAC;IACzB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oEAAoE;IACpE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,2EAA2E;IAC3E,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IACtC,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,oBAAoB,GAAG,IAAI,CAkClG"}

package/dist/nodes/headless/power.js

@@ -0,0 +1,74 @@
+// =============================================================================
+// A node's power state, as the Worker Nodes page words it (issue #1045)
+// =============================================================================
+//
+// A node on a laptop reports `vitals.power` (source, battery charge, charging);
+// the fleet table shows a badge for it. This module is the badge's words and
+// level, without markup: the UI draws the icon and the colour from the level,
+// and the SAME sentence is its accessible label, so nothing rests on colour.
+//
+// Display only: a node on battery is not "unhealthy", and nothing here turns
+// the reading into a health verdict (health is the API's, from the heartbeat).
+// An `unknown` or absent source draws nothing: a desktop that cannot tell is not
+// worth a badge on every row.
+// =============================================================================
+/**
+ * At or under this battery charge the badge reads in the warning colour.
+ *
+ * @stability experimental
+ */
+export const NODE_BATTERY_WARNING_PERCENT = 20;
+/**
+ * At or under this battery charge the badge reads in the error colour.
+ *
+ * @stability experimental
+ */
+export const NODE_BATTERY_CRITICAL_PERCENT = 10;
+/**
+ * The badge's words and level for a node's reported power, or `null` when
+ * there is nothing to draw (no report, or source `unknown`).
+ *
+ * @param power - `lastVitals.power`, if any.
+ * @returns the description, or `null`.
+ *
+ * @stability experimental
+ */
+export function describeNodePower(power) {
+    if (!power || typeof power !== 'object')
+        return null;
+    const percent = typeof power.batteryPercent === 'number' && Number.isFinite(power.batteryPercent)
+        ? Math.round(Math.min(100, Math.max(0, power.batteryPercent)))
+        : null;
+    const charging = typeof power.charging === 'boolean' ? power.charging : null;
+    if (power.source === 'ac') {
+        const parts = ['On AC power'];
+        if (percent !== null)
+            parts.push(`battery ${percent}%`);
+        if (charging === true)
+            parts.push('charging');
+        return { source: 'ac', percent, charging, level: 'normal', text: 'AC', label: parts.join(', ') };
+    }
+    if (power.source !== 'battery')
+        return null;
+    const level = percent !== null && percent <= NODE_BATTERY_CRITICAL_PERCENT
+        ? 'error'
+        : percent !== null && percent <= NODE_BATTERY_WARNING_PERCENT
+            ? 'warning'
+            : 'normal';
+    const parts = ['On battery'];
+    if (percent !== null)
+        parts.push(`${percent}%`);
+    if (charging !== null)
+        parts.push(charging ? 'charging' : 'discharging');
+    if (power.lowPowerMode === true)
+        parts.push('low power mode');
+    return {
+        source: 'battery',
+        percent,
+        charging,
+        level,
+        text: percent !== null ? `${percent}%` : 'Battery',
+        label: parts.join(', '),
+    };
+}
+//# sourceMappingURL=power.js.map

package/dist/nodes/headless/power.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"power.js","sourceRoot":"","sources":["../../../src/nodes/headless/power.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wEAAwE;AACxE,gFAAgF;AAChF,EAAE;AACF,gFAAgF;AAChF,6EAA6E;AAC7E,8EAA8E;AAC9E,6EAA6E;AAC7E,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,iFAAiF;AACjF,8BAA8B;AAC9B,gFAAgF;AAIhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAE/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,CAAC;AAsBhD;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAmC;IACnE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrD,MAAM,OAAO,GACX,OAAO,KAAK,CAAC,cAAc,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC;QAC/E,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;QAC9D,CAAC,CAAC,IAAI,CAAC;IACX,MAAM,QAAQ,GAAG,OAAO,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IAE7E,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,CAAC,aAAa,CAAC,CAAC;QAC9B,IAAI,OAAO,KAAK,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,GAAG,CAAC,CAAC;QACxD,IAAI,QAAQ,KAAK,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACnG,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5C,MAAM,KAAK,GACT,OAAO,KAAK,IAAI,IAAI,OAAO,IAAI,6BAA6B;QAC1D,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,IAAI,4BAA4B;YAC3D,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,QAAQ,CAAC;IACjB,MAAM,KAAK,GAAG,CAAC,YAAY,CAAC,CAAC;IAC7B,IAAI,OAAO,KAAK,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC;IAChD,IAAI,QAAQ,KAAK,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IACzE,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC9D,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,OAAO;QACP,QAAQ;QACR,KAAK;QACL,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,SAAS;QAClD,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;KACxB,CAAC;AACJ,CAAC"}

package/dist/nodes/headless/types.d.ts

@@ -1,7 +1,7 @@
 import type { z } from 'zod';
-import type { AdminNode, AdminNodeCredential, NodeCredentialCreated, NodeHealth, NodeJobCounts, NodeOwner, NodeStatus, NodeVitals, NodeVitalsCounters, createNodeCredentialSchema } from '@marinoscar/platform-contract/nodes';
-export { MAX_NODE_CREDENTIAL_DAYS, MAX_NODE_CREDENTIAL_NAME_LENGTH, NODE_HEALTHS, NODE_STATUSES, } from '@marinoscar/platform-contract/nodes';
-export type { NodeCredentialCreated, NodeHealth, NodeJobCounts, NodeOwner, NodeStatus, NodeVitals, NodeVitalsCounters, };
+import type { AdminNode, AdminNodeCredential, AdminNodeEvent, AdminNodeEventList, NodeCredentialCreated, NodeHealth, NodeHostVitals, NodeJobCounts, NodeOwner, NodePower, NodeStatus, NodeVitals, NodeVitalsCounters, createNodeCredentialSchema } from '@marinoscar/platform-contract/nodes';
+export { MAX_NODE_CREDENTIAL_DAYS, MAX_NODE_CREDENTIAL_NAME_LENGTH, NODE_EVENT_TYPES, NODE_HEALTHS, NODE_STATUSES, } from '@marinoscar/platform-contract/nodes';
+export type { NodeCredentialCreated, NodeHealth, NodeHostVitals, NodeJobCounts, NodeOwner, NodePower, NodeStatus, NodeVitals, NodeVitalsCounters, };
 /**
  * One node as `GET /api/admin/nodes` returns it (`AdminNodeDto`,
  * `adminNodeSchema`).
@@ -9,6 +9,43 @@ export type { NodeCredentialCreated, NodeHealth, NodeJobCounts, NodeOwner, NodeS
  * @stability experimental
  */
 export type WorkerNode = AdminNode;
+/**
+ * One stored node event as `GET /api/admin/nodes/:id/events` returns it
+ * (`adminNodeEventSchema`, #1045): a power change, a low battery, a wake from
+ * sleep, a low disk. `type` is an OPEN dotted string (`NODE_EVENT_TYPES` names
+ * the platform's own); `occurredAt` is the node's clock, `receivedAt` the server's.
+ *
+ * @stability experimental
+ */
+export type WorkerNodeEvent = AdminNodeEvent;
+/**
+ * A page of node events (`adminNodeEventListSchema`), newest first.
+ *
+ * @stability experimental
+ */
+export type WorkerNodeEventList = AdminNodeEventList;
+/**
+ * How loud a node event is: `info`, `warning` or `critical`.
+ *
+ * @stability experimental
+ */
+export type NodeEventSeverity = AdminNodeEvent['severity'];
+/**
+ * The query `GET /api/admin/nodes/:id/events` takes. Every member optional; an absent
+ * one is left out of the query string (the API's defaults apply).
+ *
+ * @stability experimental
+ */
+export interface NodeEventsQuery {
+    /** 1-based page. */
+    page?: number;
+    /** Events per page. */
+    pageSize?: number;
+    /** Only events of this exact type (`power.battery_low`). */
+    type?: string;
+    /** Only events of this severity. */
+    severity?: NodeEventSeverity;
+}
 /**
  * One credential as `GET /api/admin/nodes/credentials` returns it
  * (`AdminNodeCredentialDto`, `adminNodeCredentialSchema`). No `token`, no hash;

package/dist/nodes/headless/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/nodes/headless/types.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EACV,SAAS,EACT,mBAAmB,EACnB,qBAAqB,EACrB,UAAU,EACV,aAAa,EACb,SAAS,EACT,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,0BAA0B,EAC3B,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACL,wBAAwB,EACxB,+BAA+B,EAC/B,YAAY,EACZ,aAAa,GACd,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EACV,qBAAqB,EACrB,UAAU,EACV,aAAa,EACb,SAAS,EACT,UAAU,EACV,UAAU,EACV,kBAAkB,GACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC;AAEnC;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEnF;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAEpE;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,WAAW,CAAC,EAC3D,GAAG,GAAE,IAAiB,GACrB,oBAAoB,CAStB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/nodes/headless/types.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EACV,SAAS,EACT,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,UAAU,EACV,cAAc,EACd,aAAa,EACb,SAAS,EACT,SAAS,EACT,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,0BAA0B,EAC3B,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACL,wBAAwB,EACxB,+BAA+B,EAC/B,gBAAgB,EAChB,YAAY,EACZ,aAAa,GACd,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EACV,qBAAqB,EACrB,UAAU,EACV,cAAc,EACd,aAAa,EACb,SAAS,EACT,SAAS,EACT,UAAU,EACV,UAAU,EACV,kBAAkB,GACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC;AAEnC;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,cAAc,CAAC;AAE7C;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AAErD;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEnF;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAEpE;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,WAAW,CAAC,EAC3D,GAAG,GAAE,IAAiB,GACrB,oBAAoB,CAStB"}

package/dist/nodes/headless/types.js

@@ -19,7 +19,7 @@
 // heartbeat against the `nodes.staleHeartbeatSeconds` system setting, which
 // the browser does not read), so nothing in this slice recomputes it.
 // =============================================================================
-export { MAX_NODE_CREDENTIAL_DAYS, MAX_NODE_CREDENTIAL_NAME_LENGTH, NODE_HEALTHS, NODE_STATUSES, } from '@marinoscar/platform-contract/nodes';
+export { MAX_NODE_CREDENTIAL_DAYS, MAX_NODE_CREDENTIAL_NAME_LENGTH, NODE_EVENT_TYPES, NODE_HEALTHS, NODE_STATUSES, } from '@marinoscar/platform-contract/nodes';
 /**
  * Whether a credential can still authenticate a node right now.
  *

package/dist/nodes/headless/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/nodes/headless/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,sEAAsE;AACtE,gFAAgF;AAChF,EAAE;AACF,wFAAwF;AACxF,gFAAgF;AAChF,8EAA8E;AAC9E,+EAA+E;AAC/E,eAAe;AACf,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,6EAA6E;AAC7E,qEAAqE;AACrE,2EAA2E;AAC3E,mCAAmC;AACnC,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,sEAAsE;AACtE,gFAAgF;AAgBhF,OAAO,EACL,wBAAwB,EACxB,+BAA+B,EAC/B,YAAY,EACZ,aAAa,GACd,MAAM,qCAAqC,CAAC;AA2C7C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAA2D,EAC3D,MAAY,IAAI,IAAI,EAAE;IAEtB,IAAI,UAAU,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,0EAA0E;IAC1E,yEAAyE;IACzE,gDAAgD;IAChD,IAAI,UAAU,CAAC,SAAS,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;QACtF,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/nodes/headless/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,sEAAsE;AACtE,gFAAgF;AAChF,EAAE;AACF,wFAAwF;AACxF,gFAAgF;AAChF,8EAA8E;AAC9E,+EAA+E;AAC/E,eAAe;AACf,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,6EAA6E;AAC7E,qEAAqE;AACrE,2EAA2E;AAC3E,mCAAmC;AACnC,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,sEAAsE;AACtE,gFAAgF;AAoBhF,OAAO,EACL,wBAAwB,EACxB,+BAA+B,EAC/B,gBAAgB,EAChB,YAAY,EACZ,aAAa,GACd,MAAM,qCAAqC,CAAC;AAsF7C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAA2D,EAC3D,MAAY,IAAI,IAAI,EAAE;IAEtB,IAAI,UAAU,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,0EAA0E;IAC1E,yEAAyE;IACzE,gDAAgD;IAChD,IAAI,UAAU,CAAC,SAAS,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;QACtF,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/nodes/headless/use-node-events.d.ts

@@ -0,0 +1,59 @@
+/**
+ * One node's recent events (issue #1045): `GET /api/admin/nodes/:id/events`, newest
+ * first, with "load more".
+ *
+ * The same contract as the fleet hooks (`use-worker-nodes.ts`): every function
+ * resolves rather than throws, and a failure is a STRING the caller renders.
+ *
+ * The first page is asked for when the node or the filters change; `loadMore`
+ * appends the next page; `refresh` re-reads from the first page WITHOUT raising
+ * the loading flag (the list stays on screen). An event that arrives between a
+ * first page and a "load more" shifts the pages by one, so an appended page is
+ * de-duplicated by id rather than trusted to start where the last one ended.
+ *
+ * The query is read member by member (`page`, `pageSize`, `type`, `severity`),
+ * so an inline object literal does not re-fetch on every render.
+ */
+import type { NodesApi } from './api.js';
+import type { NodeEventsQuery, WorkerNodeEvent } from './types.js';
+/**
+ * What {@link useNodeEvents} returns.
+ *
+ * @stability experimental
+ */
+export interface UseNodeEventsResult {
+    /** The events read so far, newest first; emptied on an error or with no node. */
+    events: WorkerNodeEvent[];
+    /** How many events the node has in total (for the filters), `0` before an answer. */
+    total: number;
+    /** Whether a further page exists. */
+    hasMore: boolean;
+    /** The first page is in flight. */
+    isLoading: boolean;
+    /** A `loadMore` page is in flight. */
+    isLoadingMore: boolean;
+    /** The last failure as a sentence, or `null`. */
+    error: string | null;
+    /** Re-read from the first page without raising the loading flag. */
+    refresh: () => Promise<void>;
+    /** Append the next page. A no-op while one is in flight or when there is none. */
+    loadMore: () => Promise<void>;
+}
+/**
+ * `GET /api/admin/nodes/:id/events`: a node's events, newest first, page by page.
+ *
+ * @param nodeId - the node id, or `null` to ask for nothing.
+ * @param query - the first page, its size and the filters (every member optional).
+ * @param api - a client to use instead of the adapters' or the host's.
+ * @returns the events and their state.
+ *
+ * @example
+ * ```tsx
+ * const { events, hasMore, loadMore } = useNodeEvents(node.id, { pageSize: 20, severity: 'critical' });
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export declare function useNodeEvents(nodeId: string | null, query?: NodeEventsQuery, api?: NodesApi): UseNodeEventsResult;
+//# sourceMappingURL=use-node-events.d.ts.map

package/dist/nodes/headless/use-node-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-node-events.d.ts","sourceRoot":"","sources":["../../../src/nodes/headless/use-node-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAuB,MAAM,YAAY,CAAC;AAExF;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,aAAa,EAAE,OAAO,CAAC;IACvB,iDAAiD;IACjD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oEAAoE;IACpE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,kFAAkF;IAClF,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AA2BD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,GAAE,eAAoB,EAAE,GAAG,CAAC,EAAE,QAAQ,GAAG,mBAAmB,CAqGrH"}