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

package/dist/alerts/ui/FiringAlertsBanner.d.ts

@@ -0,0 +1,28 @@
+import type { ReactElement } from 'react';
+/**
+ * Props of {@link FiringAlertsBanner}.
+ *
+ * @stability experimental
+ */
+export interface FiringAlertsBannerProps {
+    /** Where "View incidents" goes; default the Alerts page's Incidents tab. */
+    to?: string;
+    /** The poll interval in milliseconds; default 30 000. */
+    intervalMs?: number;
+}
+/**
+ * The number of firing alerts by severity, with a link to the incidents.
+ *
+ * @param props - see {@link FiringAlertsBannerProps}.
+ * @returns the banner, or `null` when nothing is firing.
+ *
+ * @example
+ * ```tsx
+ * <TelemetryDashboardPage slots={{ BeforeContent: () => <FiringAlertsBanner /> }} />
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export declare function FiringAlertsBanner({ to, intervalMs }?: FiringAlertsBannerProps): ReactElement | null;
+//# sourceMappingURL=FiringAlertsBanner.d.ts.map

package/dist/alerts/ui/FiringAlertsBanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FiringAlertsBanner.d.ts","sourceRoot":"","sources":["../../../src/alerts/ui/FiringAlertsBanner.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAU1C;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,4EAA4E;IAC5E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAQD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAA6C,EAAE,UAAU,EAAE,GAAE,uBAA4B,GAAG,YAAY,GAAG,IAAI,CAgCnJ"}

package/dist/alerts/ui/FiringAlertsBanner.js

@@ -0,0 +1,45 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// The firing-alerts banner (issue #1047): how many alerts are firing now, by
+// severity, linking to the Alerts page's incidents. Built for the telemetry
+// dashboard's `BeforeContent` slot (the app passes it; telemetry does not
+// depend on alerts), and usable on any page. Draws nothing while nothing is
+// firing, before the first answer, or for a viewer without `alerts:read`.
+import { Alert, AlertTitle, Button, Stack } from '@mui/material';
+import { Link as RouterLink } from 'react-router-dom';
+import { ALERT_PERMISSIONS, ALERT_SEVERITIES } from '@marinoscar/platform-contract/alerts';
+import { usePlatformViewer } from '../../core/index.js';
+import { ALERT_SEVERITY_LABELS, alertFiringTotal, alertTopSeverity, useAlertSummary } from '../headless/index.js';
+import { ALERTS_PAGE_COPY } from './copy.js';
+import { SeverityChip } from './parts.js';
+const ALERT_SEVERITY_FOR = {
+    critical: 'error',
+    warning: 'warning',
+    info: 'info',
+};
+/**
+ * The number of firing alerts by severity, with a link to the incidents.
+ *
+ * @param props - see {@link FiringAlertsBannerProps}.
+ * @returns the banner, or `null` when nothing is firing.
+ *
+ * @example
+ * ```tsx
+ * <TelemetryDashboardPage slots={{ BeforeContent: () => <FiringAlertsBanner /> }} />
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export function FiringAlertsBanner({ to = `${ALERTS_PAGE_COPY.path}?tab=incidents`, intervalMs } = {}) {
+    const viewer = usePlatformViewer();
+    const allowed = viewer.hasPermission(ALERT_PERMISSIONS.READ);
+    const { summary } = useAlertSummary({ enabled: allowed, ...(intervalMs === undefined ? {} : { intervalMs }) });
+    const total = alertFiringTotal(summary);
+    const top = alertTopSeverity(summary);
+    if (!allowed || !summary || total === 0 || !top)
+        return null;
+    return (_jsxs(Alert, { severity: ALERT_SEVERITY_FOR[top] ?? 'warning', sx: { mb: 2 }, "data-testid": "firing-alerts-banner", action: _jsx(Button, { component: RouterLink, to: to, color: "inherit", size: "small", sx: { minHeight: 44 }, children: "View incidents" }), children: [_jsx(AlertTitle, { children: total === 1 ? '1 alert is firing' : `${total} alerts are firing` }), _jsx(Stack, { direction: "row", spacing: 1, useFlexGap: true, sx: { flexWrap: 'wrap' }, children: ALERT_SEVERITIES.filter((severity) => summary.firing[severity] > 0)
+                    .reverse()
+                    .map((severity) => (_jsx(SeverityChip, { severity: severity, label: `${summary.firing[severity]} ${ALERT_SEVERITY_LABELS[severity].toLowerCase()}` }, severity))) })] }));
+}
+//# sourceMappingURL=FiringAlertsBanner.js.map

package/dist/alerts/ui/FiringAlertsBanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FiringAlertsBanner.js","sourceRoot":"","sources":["../../../src/alerts/ui/FiringAlertsBanner.tsx"],"names":[],"mappings":";AAAA,6EAA6E;AAC7E,4EAA4E;AAC5E,0EAA0E;AAC1E,4EAA4E;AAC5E,0EAA0E;AAE1E,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAE3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAc1C,MAAM,kBAAkB,GAA2D;IACjF,QAAQ,EAAE,OAAO;IACjB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;CACb,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAE,EAAE,GAAG,GAAG,gBAAgB,CAAC,IAAI,gBAAgB,EAAE,UAAU,KAA8B,EAAE;IAC5H,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC7D,MAAM,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;IAC/G,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAC7D,OAAO,CACL,MAAC,KAAK,IACJ,QAAQ,EAAE,kBAAkB,CAAC,GAAG,CAAC,IAAI,SAAS,EAC9C,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,iBACD,sBAAsB,EAClC,MAAM,EACJ,KAAC,MAAM,IAAC,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAC,SAAS,EAAC,IAAI,EAAC,OAAO,EAAC,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,+BAEhF,aAGX,KAAC,UAAU,cAAE,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,KAAK,oBAAoB,GAAc,EAC3F,KAAC,KAAK,IAAC,SAAS,EAAC,KAAK,EAAC,OAAO,EAAE,CAAC,EAAE,UAAU,QAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,YACnE,gBAAgB,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;qBACjE,OAAO,EAAE;qBACT,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CACjB,KAAC,YAAY,IAEX,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,qBAAqB,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,EAAE,IAFhF,QAAQ,CAGb,CACH,CAAC,GACE,IACF,CACT,CAAC;AACJ,CAAC"}

package/dist/alerts/ui/copy.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The title, description and route of the Alerts page: the registry card's
+ * text and the page's heading.
+ *
+ * @stability experimental
+ */
+export declare const ALERTS_PAGE_COPY: Readonly<{
+    /** The card title and the page heading. */
+    readonly title: string;
+    /** The card text and the page lead. */
+    readonly description: string;
+    /** The route of the page. */
+    readonly path: string;
+}>;
+//# sourceMappingURL=copy.d.ts.map

package/dist/alerts/ui/copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../../src/alerts/ui/copy.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC;IACtC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAKC,CAAC"}

package/dist/alerts/ui/copy.js

@@ -0,0 +1,14 @@
+// The alerts UI's copy (issue #1047), in one place so a fork rewords it once.
+// The card text and the page heading are the same words.
+/**
+ * The title, description and route of the Alerts page: the registry card's
+ * text and the page's heading.
+ *
+ * @stability experimental
+ */
+export const ALERTS_PAGE_COPY = Object.freeze({
+    title: 'Alerts',
+    description: 'Get told when something needs attention: metric thresholds, worker node events, offline nodes and the dashboard verdict, with the incidents they raised.',
+    path: '/admin/settings/alerts',
+});
+//# sourceMappingURL=copy.js.map

package/dist/alerts/ui/copy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.js","sourceRoot":"","sources":["../../../src/alerts/ui/copy.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,yDAAyD;AAEzD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAOxB,MAAM,CAAC,MAAM,CAAC;IACjB,KAAK,EAAE,QAAQ;IACf,WAAW,EACT,0JAA0J;IAC5J,IAAI,EAAE,wBAAwB;CAC/B,CAAC,CAAC"}

package/dist/alerts/ui/index.d.ts

@@ -0,0 +1,14 @@
+export { ALERTS_PAGE_COPY } from './copy.js';
+export { alertsAdminCards } from './settings.js';
+export type { AlertsAdminCard } from './settings.js';
+export { AlertIncidentDrawer } from './AlertIncidentDrawer.js';
+export type { AlertIncidentDrawerProps } from './AlertIncidentDrawer.js';
+export { AlertRuleDialog } from './AlertRuleDialog.js';
+export type { AlertRuleDialogProps } from './AlertRuleDialog.js';
+export { AlertRuleTestResult } from './AlertRuleTestResult.js';
+export type { AlertRuleTestResultProps } from './AlertRuleTestResult.js';
+export { AlertsPage } from './AlertsPage.js';
+export type { AlertsPageProps, AlertsPageSlots } from './AlertsPage.js';
+export { FiringAlertsBanner } from './FiringAlertsBanner.js';
+export type { FiringAlertsBannerProps } from './FiringAlertsBanner.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/alerts/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/alerts/ui/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/alerts/ui/index.js

@@ -0,0 +1,12 @@
+// `@marinoscar/platform-web/alerts/ui`: the Alerts page (Rules and Incidents
+// tabs), the rule editor, the dry-run result, the incident drawer, the firing
+// banner for the telemetry dashboard and the admin card as data, built on
+// `/alerts/headless` (issue #1047). Documented in ../README.md.
+export { ALERTS_PAGE_COPY } from './copy.js';
+export { alertsAdminCards } from './settings.js';
+export { AlertIncidentDrawer } from './AlertIncidentDrawer.js';
+export { AlertRuleDialog } from './AlertRuleDialog.js';
+export { AlertRuleTestResult } from './AlertRuleTestResult.js';
+export { AlertsPage } from './AlertsPage.js';
+export { FiringAlertsBanner } from './FiringAlertsBanner.js';
+//# sourceMappingURL=index.js.map

package/dist/alerts/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/alerts/ui/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,8EAA8E;AAC9E,0EAA0E;AAC1E,gEAAgE;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/alerts/ui/parts.d.ts

@@ -0,0 +1,26 @@
+import type { ReactElement, ReactNode } from 'react';
+import type { AlertIncidentState, AlertSeverity } from '@marinoscar/platform-contract/alerts';
+/** A severity as a labelled chip (the words carry the meaning, not the colour). */
+export declare function SeverityChip({ severity, label }: {
+    severity: AlertSeverity;
+    label?: string;
+}): ReactElement;
+/** An incident state as a labelled chip. */
+export declare function StateChip({ state }: {
+    state: AlertIncidentState;
+}): ReactElement;
+/** A timestamp in the display zone, or a dash. */
+export declare function when(iso: string | null | undefined): string;
+export interface ConfirmDialogProps {
+    open: boolean;
+    title: string;
+    children: ReactNode;
+    confirmLabel: string;
+    destructive?: boolean;
+    busy?: boolean;
+    onConfirm: () => void;
+    onClose: () => void;
+}
+/** A yes/no dialog whose text says what will happen. */
+export declare function ConfirmDialog({ open, title, children, confirmLabel, destructive, busy, onConfirm, onClose }: ConfirmDialogProps): ReactElement;
+//# sourceMappingURL=parts.d.ts.map

package/dist/alerts/ui/parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts.d.ts","sourceRoot":"","sources":["../../../src/alerts/ui/parts.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAe9F,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CAE3G;AAED,4CAA4C;AAC5C,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,kBAAkB,CAAA;CAAE,GAAG,YAAY,CAGhF;AAED,kDAAkD;AAClD,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAE3D;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,SAAS,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,kBAAkB,GAAG,YAAY,CAiB9I"}

package/dist/alerts/ui/parts.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// Small building blocks of the alerts UI (issue #1047): the severity and state
+// chips, the confirm dialog and the date text. Internal to the slice.
+import { Button, Chip, Dialog, DialogActions, DialogContent, DialogContentText, DialogTitle } from '@mui/material';
+import { formatDateTime } from '../../core/index.js';
+import { ALERT_SEVERITY_LABELS, ALERT_SEVERITY_TONES, ALERT_STATE_LABELS, ALERT_STATE_TONES, } from '../headless/index.js';
+function chipColor(tone) {
+    return tone;
+}
+/** A severity as a labelled chip (the words carry the meaning, not the colour). */
+export function SeverityChip({ severity, label }) {
+    return _jsx(Chip, { size: "small", label: label ?? ALERT_SEVERITY_LABELS[severity], color: chipColor(ALERT_SEVERITY_TONES[severity]) });
+}
+/** An incident state as a labelled chip. */
+export function StateChip({ state }) {
+    const tone = ALERT_STATE_TONES[state];
+    return _jsx(Chip, { size: "small", label: ALERT_STATE_LABELS[state], color: chipColor(tone), variant: state === 'resolved' ? 'outlined' : 'filled' });
+}
+/** A timestamp in the display zone, or a dash. */
+export function when(iso) {
+    return iso ? formatDateTime(iso) : '—';
+}
+/** A yes/no dialog whose text says what will happen. */
+export function ConfirmDialog({ open, title, children, confirmLabel, destructive, busy, onConfirm, onClose }) {
+    return (_jsxs(Dialog, { open: open, onClose: onClose, maxWidth: "xs", fullWidth: true, "aria-labelledby": "alerts-confirm-title", children: [_jsx(DialogTitle, { id: "alerts-confirm-title", children: title }), _jsx(DialogContent, { children: _jsx(DialogContentText, { component: "div", children: children }) }), _jsxs(DialogActions, { children: [_jsx(Button, { onClick: onClose, sx: { minHeight: 44 }, children: "Cancel" }), _jsx(Button, { variant: "contained", color: destructive ? 'error' : 'primary', onClick: onConfirm, disabled: busy, sx: { minHeight: 44 }, children: confirmLabel })] })] }));
+}
+//# sourceMappingURL=parts.js.map

package/dist/alerts/ui/parts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts.js","sourceRoot":"","sources":["../../../src/alerts/ui/parts.tsx"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,sEAAsE;AAEtE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAKnH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,GAElB,MAAM,sBAAsB,CAAC;AAE9B,SAAS,SAAS,CAAC,IAAe;IAChC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,YAAY,CAAC,EAAE,QAAQ,EAAE,KAAK,EAA+C;IAC3F,OAAO,KAAC,IAAI,IAAC,IAAI,EAAC,OAAO,EAAC,KAAK,EAAE,KAAK,IAAI,qBAAqB,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,GAAI,CAAC;AAClI,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,SAAS,CAAC,EAAE,KAAK,EAAiC;IAChE,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACtC,OAAO,KAAC,IAAI,IAAC,IAAI,EAAC,OAAO,EAAC,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,GAAI,CAAC;AAChJ,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,IAAI,CAAC,GAA8B;IACjD,OAAO,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACzC,CAAC;AAaD,wDAAwD;AACxD,MAAM,UAAU,aAAa,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAsB;IAC9H,OAAO,CACL,MAAC,MAAM,IAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAC,IAAI,EAAC,SAAS,2BAAiB,sBAAsB,aAClG,KAAC,WAAW,IAAC,EAAE,EAAC,sBAAsB,YAAE,KAAK,GAAe,EAC5D,KAAC,aAAa,cACZ,KAAC,iBAAiB,IAAC,SAAS,EAAC,KAAK,YAAE,QAAQ,GAAqB,GACnD,EAChB,MAAC,aAAa,eACZ,KAAC,MAAM,IAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,uBAEtC,EACT,KAAC,MAAM,IAAC,OAAO,EAAC,WAAW,EAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,YAC5H,YAAY,GACN,IACK,IACT,CACV,CAAC;AACJ,CAAC"}

package/dist/alerts/ui/settings.d.ts

@@ -0,0 +1,27 @@
+import type { PlatformSettingsPage } from '../../core/index.js';
+/**
+ * One alerts registry card: the `PlatformSettingsPage` card shape plus its
+ * icon, structurally a `SettingsCardDef` of the reference app.
+ *
+ * @stability experimental
+ */
+export type AlertsAdminCard = PlatformSettingsPage<never>['card'] & {
+    /** The card and rail icon (an MUI SvgIcon). */
+    Icon: PlatformSettingsPage['Icon'];
+};
+/**
+ * The Observability card of the alerts slice: `Alerts`
+ * (`/admin/settings/alerts`, `alerts:read`, no `feature`). Route it to
+ * `<AlertsPage />`.
+ *
+ * @example
+ * ```tsx
+ * // apps/web/src/config/adminSections.tsx, the Observability section
+ * cards: [...telemetryAdminCards, doctorCard, ...alertsAdminCards],
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export declare const alertsAdminCards: readonly AlertsAdminCard[];
+//# sourceMappingURL=settings.d.ts.map

package/dist/alerts/ui/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../../src/alerts/ui/settings.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGhE;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG;IAClE,+CAA+C;IAC/C,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;CACpC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,eAAe,EAQrD,CAAC"}

package/dist/alerts/ui/settings.js

@@ -0,0 +1,37 @@
+// The alerts slice's admin registry card (issue #1047). DATA, not a new
+// registry: the app declares every card in its own `ADMIN_SECTIONS` and
+// spreads this one where it belongs (the Observability section). No page
+// component is referenced here, so importing the card never pulls the page
+// into the app's main chunk.
+//
+// `alerts:read` is the exact string every read route of the packaged
+// `/api/admin/alerts` controller enforces (`ALERT_PERMISSIONS.READ` of
+// `@marinoscar/platform-contract/alerts`); writes (`alerts:write`) are gated
+// inside the page. NO `feature`: node rules work with telemetry switched off.
+import NotificationImportantOutlinedIcon from '@mui/icons-material/NotificationImportantOutlined';
+import { ALERT_PERMISSIONS } from '@marinoscar/platform-contract/alerts';
+import { ALERTS_PAGE_COPY } from './copy.js';
+/**
+ * The Observability card of the alerts slice: `Alerts`
+ * (`/admin/settings/alerts`, `alerts:read`, no `feature`). Route it to
+ * `<AlertsPage />`.
+ *
+ * @example
+ * ```tsx
+ * // apps/web/src/config/adminSections.tsx, the Observability section
+ * cards: [...telemetryAdminCards, doctorCard, ...alertsAdminCards],
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export const alertsAdminCards = Object.freeze([
+    {
+        title: ALERTS_PAGE_COPY.title,
+        description: ALERTS_PAGE_COPY.description,
+        path: ALERTS_PAGE_COPY.path,
+        Icon: NotificationImportantOutlinedIcon,
+        permission: ALERT_PERMISSIONS.READ,
+    },
+]);
+//# sourceMappingURL=settings.js.map

package/dist/alerts/ui/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../../src/alerts/ui/settings.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,wEAAwE;AACxE,yEAAyE;AACzE,2EAA2E;AAC3E,6BAA6B;AAC7B,EAAE;AACF,qEAAqE;AACrE,uEAAuE;AACvE,6EAA6E;AAC7E,8EAA8E;AAE9E,OAAO,iCAAiC,MAAM,mDAAmD,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAGzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAa7C;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA+B,MAAM,CAAC,MAAM,CAAC;IACxE;QACE,KAAK,EAAE,gBAAgB,CAAC,KAAK;QAC7B,WAAW,EAAE,gBAAgB,CAAC,WAAW;QACzC,IAAI,EAAE,gBAAgB,CAAC,IAAI;QAC3B,IAAI,EAAE,iCAAiC;QACvC,UAAU,EAAE,iBAAiB,CAAC,IAAI;KACnC;CACF,CAAC,CAAC"}

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