@rxtx4816/cockpit-plugin-base-react 1.0.7 → 1.0.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rxtx4816/cockpit-plugin-base-react",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Shared infrastructure for Cockpit plugins: i18n, dark theme, test setup, config presets, CI/CD workflows, and QEMU VM harness",
   "type": "module",
   "author": "RXTX4816",
@@ -43,6 +43,9 @@
     "./hooks/usePollingFetch": {
       "default": "./src/hooks/usePollingFetch.ts"
     },
+    "./hooks/useAdminMode": {
+      "default": "./src/hooks/useAdminMode.ts"
+    },
     "./components": {
       "default": "./src/components/index.ts"
     },
@@ -61,6 +64,9 @@
     },
     "./vitest.config.base": {
       "default": "./vitest.config.base.js"
+    },
+    "./lib/logParser": {
+      "default": "./src/lib/logParser.tsx"
     }
   },
   "files": [
@@ -91,17 +97,19 @@
     "react-dom": ">=19",
     "react-i18next": ">=17"
   },
+  "dependencies": {
+    "@typescript-eslint/eslint-plugin": "^8.61.1",
+    "@typescript-eslint/parser": "^8.61.1",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^7.1.1"
+  },
   "devDependencies": {
     "@patternfly/react-core": "^6.5.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
-    "@typescript-eslint/eslint-plugin": "^8.61.1",
-    "@typescript-eslint/parser": "^8.61.1",
     "eslint": "^9.39.4",
-    "eslint-plugin-react": "^7.37.5",
-    "eslint-plugin-react-hooks": "^7.1.1",
     "i18next": "^26.3.1",
     "jsdom": "^29.1.1",
     "react": "^19.2.7",

package/src/components/LayoutSelector.tsx

@@ -1,5 +1,6 @@
 import { useState, useRef, useEffect, type ReactNode } from "react";
-import { Button, Tooltip, ToggleGroup, ToggleGroupItem } from "@patternfly/react-core";
+import { Button, ToggleGroup, ToggleGroupItem } from "@patternfly/react-core";
+import { Tooltip } from "./Tooltip";
 import { SlidersHIcon } from "@patternfly/react-icons";
 import "./LayoutSelector.css";
 

package/src/components/Tooltip.tsx

@@ -0,0 +1,5 @@
+import { Tooltip as PFTooltip, type TooltipProps } from "@patternfly/react-core";
+
+export function Tooltip({ exitDelay = 0, ...props }: TooltipProps) {
+  return <PFTooltip exitDelay={exitDelay} {...props} />;
+}

package/src/components/index.ts

@@ -10,3 +10,4 @@ export { PluginFooter } from "./PluginFooter";
 export { CollapsibleSearch } from "./CollapsibleSearch";
 export { LayoutSelector } from "./LayoutSelector";
 export type { LayoutOption } from "./LayoutSelector";
+export { Tooltip } from "./Tooltip";

package/src/hooks/useAdminMode.ts

@@ -0,0 +1,24 @@
+import { useState, useEffect } from "react";
+
+/**
+ * Returns whether the current Cockpit session has administrative (superuser) access.
+ * - `null`  — still determining (show nothing or a neutral state)
+ * - `true`  — admin access granted
+ * - `false` — limited mode; privileged operations will fail
+ */
+export function useAdminMode(): boolean | null {
+  const [allowed, setAllowed] = useState<boolean | null>(null);
+
+  useEffect(() => {
+    const perm = cockpit.permission({ admin: true });
+    setAllowed(perm.allowed);
+    const onChange = () => setAllowed(perm.allowed);
+    perm.addEventListener("changed", onChange);
+    return () => {
+      perm.removeEventListener("changed", onChange);
+      perm.close();
+    };
+  }, []);
+
+  return allowed;
+}

package/src/index.ts

@@ -10,3 +10,4 @@ export type { ConfirmStep, ConfirmActionState } from "./hooks/useConfirmAction";
 export { usePollingFetch } from "./hooks/usePollingFetch";
 export type { PollingFetchResult } from "./hooks/usePollingFetch";
 export { useLayout } from "./hooks/useLayout";
+export { useAdminMode } from "./hooks/useAdminMode";

package/src/systemd/api.ts

@@ -59,3 +59,32 @@ export async function restartService(unit: string): Promise<void> {
 export async function reloadService(unit: string): Promise<void> {
   await cockpit.spawn(["systemctl", "reload", unit], { superuser: "try" });
 }
+
+/**
+ * Reads a file from the host filesystem via Cockpit, requesting superuser escalation.
+ * @param path - Absolute path to the file.
+ */
+export async function readFile(path: string): Promise<string> {
+  return cockpit.file(path, { superuser: "try" }).read();
+}
+
+/**
+ * Writes content to a file on the host filesystem via Cockpit, requesting superuser escalation.
+ * @param path    - Absolute path to the file.
+ * @param content - UTF-8 string content to write.
+ */
+export async function writeFile(path: string, content: string): Promise<void> {
+  await cockpit.file(path, { superuser: "try" }).replace(content);
+}
+
+/**
+ * Fetches recent journal entries for a systemd unit via `journalctl`.
+ * @param unit  - The systemd unit name (e.g. `"caddy.service"`).
+ * @param lines - Number of lines to return (default 300).
+ */
+export async function fetchServiceLogs(unit: string, lines = 300): Promise<string> {
+  return cockpit.spawn(
+    ["journalctl", "-u", unit, "-n", String(lines), "--no-pager", "--output=short-iso"],
+    { superuser: "try" },
+  );
+}

package/src/systemd/index.ts

@@ -1,5 +1,5 @@
 export type { ServiceStatus } from "./types";
-export { getServiceStatus, startService, stopService, restartService, reloadService } from "./api";
+export { getServiceStatus, startService, stopService, restartService, reloadService, readFile, writeFile, fetchServiceLogs } from "./api";
 export { useServiceStatus } from "./useServiceStatus";
 export { ServiceControl } from "./ServiceControl";
 export type { ServiceControlLabels } from "./ServiceControl";