@scalio-cloud/ui 0.18.1 → 0.19.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.19.0
+Settings card "Scalio Beacon" for the apps (Beacon phase 3, scalio-docs `concepts/beacon-suite.md`).
+- `BeaconConnection` with `peersApi(api)`: pair the installation with a Beacon instance (address + one-time code from
+  Beacon), show the pairing (address, version, last contact, queue), test it and disconnect. Routes from
+  scalio-connect 0.8.0 (`scalio_connect.peers.web.admin_router`).
+- Labels `beacon*` in German and English.
+- **Visible change:** none until an app shows the card. No token changes.
+
 ## 0.18.1
 Page actions after Markus' feedback (2026-10-31, UISPEC section 2 "Page actions"). 0.18.0 was released before these
 changes were merged; apps use 0.18.1.
@@ -36,7 +44,7 @@ Same profile page in every app, reference Scalio Nexus (Markus 2026-10-31, scali
 - **Visible change:** none until an app uses the new parts. No token changes.
 
 ## 0.15.0
-New app Scalio Beacon (service desk, scalio-docs ADR 0043).
+New app Scalio Beacon (service desk, scalio-docs ADR 0044).
 - Product switcher: entry "Beacon" (icon `RadioTower`) between Citadel and Pulse, available like the others.
 - `manualUrl("beacon")`: docs.scaliobeacon.com / devdocs.scaliobeacon.com.
 - **Visible change:** every app shows "Beacon" in the switcher after its upgrade (greyed out until the instance

package/README.md

@@ -117,6 +117,10 @@ With `client` the drawer has the tabs "Neue Anfrage" (category, subject, descrip
 axios instance. The settings card `<SupportConnection client={supportApi(api)} lang={lang} />` connects the
 installation with a one-time code (admins). Without `client` the drawer keeps the old single form with `onSubmit`.
 
+The settings card `<BeaconConnection client={peersApi(api)} lang={lang} />` pairs the app with Scalio Beacon
+(address and one-time code from Beacon, Einstellungen -> Verbundene Apps); findings then go to Beacon. Backend:
+scalio-connect 0.8.0 `peers.web.admin_router`.
+
 `link` is the router's `NavLink` (it gets `to`, `end`, a `className` function and `onClick`); without it the
 sidebar renders plain links and marks the item for `activePath`. Item test ids default to `nav-<path>`
 (`nav-overview` for `/`), or set `testId`. Page blocks: `KpiTile` (tone `error` = red number),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scalio-cloud/ui",
-  "version": "0.18.1",
+  "version": "0.19.0",
   "description": "Scalio Control Room design tokens, Tailwind preset, self-hosted fonts, the shared app header, sign-in layout, sidebar and page blocks",
   "license": "SEE LICENSE IN README.md",
   "private": false,

package/react/beacon.js

@@ -0,0 +1,112 @@
+"use strict";
+// Settings card "Scalio Beacon" (Beacon phase 3, scalio-docs concepts/beacon-suite.md): an app (Citadel, Rosetta,
+// Foundry, Nexus) pairs with a Beacon instance using the address and one-time code from Beacon (Einstellungen ->
+// Verbundene Apps); findings then go to Beacon and become tickets. Backend routes from scalio-connect
+// (`scalio_connect.peers.web.admin_router`); peersApi(api) maps them for an axios-like client.
+const React = require("react");
+const h = React.createElement;
+const { labelsFor } = require("./labels");
+
+function errorText(err) {
+  const d = err && err.response && err.response.data && err.response.data.detail;
+  if (typeof d === "string") return d;
+  if (d && typeof d.message === "string") return d.message;
+  return (err && err.message) || String(err);
+}
+
+function fmtDate(value, lang) {
+  if (!value) return "";
+  const d = new Date(value);
+  if (isNaN(d.getTime())) return String(value);
+  return d.toLocaleString(lang === "en" ? "en-GB" : "de-CH", { dateStyle: "medium", timeStyle: "short" });
+}
+
+// api: axios instance with the app's base URL (/api). Every method resolves to the response body.
+function peersApi(api) {
+  const data = (p) => p.then((r) => r.data);
+  const enc = encodeURIComponent;
+  return {
+    list: () => data(api.get("/peers")),
+    connect: (url, code) => data(api.post("/peers", { url, code })),
+    check: (id) => data(api.post(`/peers/${enc(id)}/check`)),
+    remove: (id) => data(api.delete(`/peers/${enc(id)}`)),
+  };
+}
+
+function BeaconConnection({ client, lang, labels, onChange }) {
+  const L = labelsFor(lang, labels);
+  const [st, setSt] = React.useState(null);
+  const [url, setUrl] = React.useState("");
+  const [code, setCode] = React.useState("");
+  const [busy, setBusy] = React.useState(false);
+  const [error, setError] = React.useState("");
+  const [note, setNote] = React.useState("");
+  const load = React.useCallback(() => client.list().then((d) => setSt(d)).catch((err) => (setError(errorText(err)), setSt(false))), [client]);
+  React.useEffect(() => { load(); }, [load]);
+  const run = async (fn, ok) => {
+    setBusy(true);
+    setError("");
+    setNote("");
+    try {
+      const d = await fn();
+      if (d && d.ok === false) throw new Error(L.beaconCheckFailed.replace("{detail}", d.detail || d.status));
+      setCode("");
+      setNote(typeof ok === "function" ? ok(d) : ok);
+      await load();
+      if (onChange) onChange(d);
+    } catch (err) {
+      setError(errorText(err));
+    } finally {
+      setBusy(false);
+    }
+  };
+  if (st === null) return h("div", { className: "scalio-support-meta" }, L.loading);
+  if (st === false) return h("div", { className: "scalio-notice is-error", role: "alert" }, error);
+  const beacons = (st.peers || []).filter((p) => p.app === "beacon");
+  return h(
+    "div",
+    { className: "scalio-support-conn", "data-testid": "beacon-connection" },
+    h("p", { className: "scalio-support-meta" }, beacons.length ? L.beaconHelpConnected : L.beaconHelp),
+    beacons.map((p) => {
+      const q = p.queue || {};
+      return h(
+        "div",
+        { key: p.id, className: "scalio-support-conn", "data-testid": "beacon-peer" },
+        h("div", { className: "scalio-support-conn-head" },
+          h("span", { className: "scalio-badge " + (p.usable ? "is-ok" : "is-error") }, p.usable ? L.beaconConnected : L.beaconKeyLost)),
+        h("dl", { className: "scalio-support-conn-facts" },
+          h("dt", null, L.beaconAddress), h("dd", null, p.url),
+          p.version ? h(React.Fragment, null, h("dt", null, L.version), h("dd", null, p.version)) : null,
+          h("dt", null, L.supportSince), h("dd", null, fmtDate(p.paired_at, lang)),
+          h("dt", null, L.beaconLastContact), h("dd", null, fmtDate(p.last_seen, lang))),
+        q.pending || q.failed
+          ? h("div", { className: "scalio-support-meta", "data-testid": "beacon-queue" },
+              L.supportOutbox.replace("{pending}", q.pending || 0).replace("{failed}", q.failed || 0) + (q.last_error ? ` (${q.last_error})` : ""))
+          : null,
+        h("div", { className: "scalio-support-conn-actions" },
+          h("button", { type: "button", className: "scalio-btn", disabled: busy, "data-testid": "beacon-check",
+            onClick: () => run(() => client.check(p.id), (d) => L.beaconChecked.replace("{version}", (d && d.version) || "")) }, L.supportCheck),
+          h("button", { type: "button", className: "scalio-btn scalio-btn-danger", disabled: busy, "data-testid": "beacon-remove",
+            onClick: () => (typeof window === "undefined" || window.confirm(L.beaconRemoveConfirm)) && run(() => client.remove(p.id), L.supportRemoved) },
+            L.supportRemove))
+      );
+    }),
+    note ? h("div", { className: "scalio-notice is-ok", "data-testid": "beacon-note" }, note) : null,
+    error ? h("div", { className: "scalio-notice is-error", role: "alert", "data-testid": "beacon-error" }, error) : null,
+    beacons.length
+      ? null
+      : h(
+          "form",
+          { className: "scalio-support-form", onSubmit: (e) => { e.preventDefault(); run(() => client.connect(url.trim(), code.trim()), L.beaconPaired); } },
+          h("label", { className: "scalio-field-label", htmlFor: "beacon-url" }, L.beaconAddress),
+          h("input", { id: "beacon-url", className: "scalio-input", placeholder: "https://beacon.example.com", value: url, required: true,
+            onChange: (e) => setUrl(e.target.value), "data-testid": "beacon-url-input" }),
+          h("label", { className: "scalio-field-label", htmlFor: "beacon-code" }, L.beaconCode),
+          h("input", { id: "beacon-code", className: "scalio-input", placeholder: "bpc_…", value: code, required: true,
+            onChange: (e) => setCode(e.target.value), "data-testid": "beacon-code-input" }),
+          h("button", { type: "submit", className: "scalio-btn-primary", disabled: busy, "data-testid": "beacon-connect-btn" }, L.supportConnect)
+        )
+  );
+}
+
+module.exports = { peersApi, BeaconConnection };

package/react/index.js

@@ -378,6 +378,6 @@ module.exports = {
   TEST_IDS,
   initials,
 };
-Object.assign(module.exports, Nav, Blocks, require("./settings"), require("./support"), require("./security"), require("./license"), require("./palette"), require("./unify"), require("./profile"), require("./actions"));
+Object.assign(module.exports, Nav, Blocks, require("./settings"), require("./support"), require("./beacon"), require("./security"), require("./license"), require("./palette"), require("./unify"), require("./profile"), require("./actions"));
 // After the exports above: auth.js uses LanguageToggle and ThemeToggle from this module.
 Object.assign(module.exports, require("./auth"));

package/react/labels.js

@@ -140,6 +140,19 @@ const LABELS = {
     supportRemove: "Trennen",
     supportRemoveConfirm: "Verbindung zum Support trennen? Neue Tickets warten dann, bis wieder verbunden ist.",
     supportRemoved: "Verbindung getrennt.",
+    // Scalio Beacon (connected apps, Beacon phase 3)
+    beaconTitle: "Scalio Beacon",
+    beaconHelp: "Befunde dieser Installation gehen an Scalio Beacon und werden dort Tickets. Adresse und Kopplungscode erhalten Sie in Beacon unter Einstellungen -> Verbundene Apps.",
+    beaconHelpConnected: "Befunde dieser Installation gehen an Scalio Beacon und werden dort Tickets.",
+    beaconAddress: "Beacon-Adresse",
+    beaconCode: "Kopplungscode",
+    beaconConnected: "Verbunden",
+    beaconKeyLost: "Schlüssel nicht lesbar, bitte neu verbinden",
+    beaconLastContact: "Letzter Kontakt",
+    beaconPaired: "Mit Beacon verbunden.",
+    beaconChecked: "Verbindung funktioniert (Beacon {version}).",
+    beaconCheckFailed: "Keine Verbindung: {detail}",
+    beaconRemoveConfirm: "Verbindung zu Beacon trennen? Befunde gehen dann nicht mehr an Beacon; die Tickets dort bleiben.",
     // Two-factor card (SecurityFactors) and license panel (LicensePanel)
     mfa: {
       backupTitle: "Ihre Backup-Codes",
@@ -384,6 +397,19 @@ const LABELS = {
     supportRemove: "Disconnect",
     supportRemoveConfirm: "Disconnect from support? New tickets then wait until the instance is connected again.",
     supportRemoved: "Disconnected.",
+    // Scalio Beacon (connected apps, Beacon phase 3)
+    beaconTitle: "Scalio Beacon",
+    beaconHelp: "Findings of this installation go to Scalio Beacon and become tickets there. You get the address and the pairing code in Beacon under Settings -> Connected apps.",
+    beaconHelpConnected: "Findings of this installation go to Scalio Beacon and become tickets there.",
+    beaconAddress: "Beacon address",
+    beaconCode: "Pairing code",
+    beaconConnected: "Connected",
+    beaconKeyLost: "Key cannot be read, please connect again",
+    beaconLastContact: "Last contact",
+    beaconPaired: "Connected with Beacon.",
+    beaconChecked: "Connection works (Beacon {version}).",
+    beaconCheckFailed: "No connection: {detail}",
+    beaconRemoveConfirm: "Disconnect from Beacon? Findings no longer go to Beacon; the tickets there stay.",
     mfa: {
       backupTitle: "Your backup codes",
       backupHint: "Each code works once, if you do not have your phone. Keep them in a safe place, for example your password manager. They are shown only now.",