feat: add PeaNUT integration and UPS monitoring widget (#5862)

packages/integrations/src/interfaces/ups-summary/ups-summary-integration.ts

@@ -0,0 +1,5 @@
+import type { UpsSummary } from "./ups-summary-types";
+
+export interface IUpsSummaryIntegration {
+  getUpsSummariesAsync(): Promise<UpsSummary[]>;
+}

packages/integrations/src/interfaces/ups-summary/ups-summary-types.ts

@@ -0,0 +1,32 @@
+/**
+ * Normalized UPS status, resolved from the raw NUT status flags by the integration so that
+ * widgets and future UPS integrations share a single, typed vocabulary.
+ */
+export const upsStatuses = ["online", "charging", "onBattery", "lowBattery", "unknown"] as const;
+
+export type UpsStatus = (typeof upsStatuses)[number];
+
+export interface UpsSummary {
+  /** Stable identifier of the UPS device on the NUT server */
+  id: string;
+  /** Human readable name, derived from the manufacturer and model */
+  name: string;
+  manufacturer: string | null;
+  model: string | null;
+  serial: string | null;
+  /** Normalized status, resolved from the raw NUT `ups.status` flags */
+  status: UpsStatus;
+  /** Battery charge in percent */
+  batteryCharge: number | null;
+  /** Estimated remaining runtime on battery, in seconds */
+  batteryRuntime: number | null;
+  batteryVoltage: number | null;
+  /** UPS load in percent */
+  load: number | null;
+  inputVoltage: number | null;
+  outputVoltage: number | null;
+  /** Real power drawn by the load, in watts */
+  power: number | null;
+  /** UPS temperature in degrees celsius */
+  temperature: number | null;
+}