refactor: update JsonRpcCallOptions to use maxAttempts and attemptTimeoutMs, implement exponential backoff for retries

ui/src/components/UsbDeviceSetting.tsx

@@ -9,6 +9,7 @@ import { SelectMenuBasic } from "@components/SelectMenuBasic";
 import { SettingsSectionHeader } from "@components/SettingsSectionHeader";
 import Fieldset from "@components/Fieldset";
 import notifications from "@/notifications";
+import { sleep } from "@/utils";
 
 export interface USBConfig {
   vendor_id: string;
@@ -108,7 +109,7 @@ export function UsbDeviceSetting() {
         }
 
         // We need some time to ensure the USB devices are updated
-        await new Promise(resolve => setTimeout(resolve, 2000));
+        await sleep(2000);
         setLoading(false);
         syncUsbDeviceConfig();
         notifications.success(m.usb_device_updated());

ui/src/components/UsbInfoSetting.tsx

@@ -9,6 +9,7 @@ import { SelectMenuBasic } from "@components/SelectMenuBasic";
 import { SettingsItem } from "@components/SettingsItem";
 import notifications from "@/notifications";
 import { m } from "@localizations/messages.js";
+import { sleep } from "@/utils";
 
 const generatedSerialNumber = [generateNumber(1, 9), generateHex(7, 7), 0, 1].join("&");
 
@@ -123,7 +124,7 @@ export function UsbInfoSetting() {
         }
 
         // We need some time to ensure the USB devices are updated
-        await new Promise(resolve => setTimeout(resolve, 2000));
+        await sleep(2000);
         setLoading(false);
         notifications.success(
           m.usb_config_set_success({ manufacturer: usbConfig.manufacturer, product: usbConfig.product }),

ui/src/components/VideoOverlay.tsx

@@ -483,6 +483,7 @@ export function RebootingOverlay({ show, postRebootAction }: RebootingOverlayPro
           const targetUrl = new URL(postRebootAction.redirectTo, window.location.origin);
 
           window.location.href = targetUrl.href;
+          window.location.reload();
         }
       } catch (err) {
         // Ignore errors - they're expected while device is rebooting

ui/src/hooks/useKeyboard.ts

@@ -16,6 +16,7 @@ import {
 import { useHidRpc } from "@/hooks/useHidRpc";
 import { JsonRpcResponse, useJsonRpc } from "@/hooks/useJsonRpc";
 import { hidKeyToModifierMask, keys, modifiers } from "@/keyboardMappings";
+import { sleep } from "@/utils";
 
 const MACRO_RESET_KEYBOARD_STATE = {
   keys: new Array(hidKeyBufferSize).fill(0),
@@ -31,8 +32,6 @@ export interface MacroStep {
 
 export type MacroSteps = MacroStep[];
 
-const sleep = (ms: number): Promise<void> => new Promise(resolve => setTimeout(resolve, ms));
-
 export default function useKeyboard() {
   const { send } = useJsonRpc();
   const { rpcDataChannel } = useRTCStore();
@@ -97,24 +96,23 @@ export default function useKeyboard() {
     [send, setKeysDownState],
   );
 
-  const sendKeystrokeLegacy = useCallback(async (keys: number[], modifier: number, ac?: AbortController) => {
+  const sendKeystrokeLegacy = useCallback(
-    return await new Promise<void>((resolve, reject) => {
+    async (keys: number[], modifier: number, ac?: AbortController) => {
-      const abortListener = () => {
+      return await new Promise<void>((resolve, reject) => {
-        reject(new Error("Keyboard report aborted"));
+        const abortListener = () => {
-      };
+          reject(new Error("Keyboard report aborted"));
+        };
 
-      ac?.signal?.addEventListener("abort", abortListener);
+        ac?.signal?.addEventListener("abort", abortListener);
 
-      send(
+        send("keyboardReport", { keys, modifier }, params => {
-        "keyboardReport",
-        { keys, modifier },
-        params => {
           if ("error" in params) return reject(params.error);
           resolve();
-        },
+        });
-      );
+      });
-    });
+    },
-  }, [send]);
+    [send],
+  );
 
   const KEEPALIVE_INTERVAL = 50;
 
@@ -149,7 +147,6 @@ export default function useKeyboard() {
     }
   }, [rpcHidReady, sendKeyboardEventHidRpc, handleLegacyKeyboardReport, cancelKeepAlive]);
 
-
   // IMPORTANT: See the keyPressReportApiAvailable comment above for the reason this exists
   function simulateDeviceSideKeyHandlingForLegacyDevices(
     state: KeysDownState,
@@ -200,7 +197,9 @@ export default function useKeyboard() {
       // If we reach here it means we didn't find an empty slot or the key in the buffer
       if (overrun) {
         if (press) {
-          console.warn(`keyboard buffer overflow current keys ${keys}, key: ${key} not added`);
+          console.warn(
+            `keyboard buffer overflow current keys ${keys}, key: ${key} not added`,
+          );
           // Fill all key slots with ErrorRollOver (0x01) to indicate overflow
           keys.length = hidKeyBufferSize;
           keys.fill(hidErrorRollOver);
@@ -284,85 +283,92 @@ export default function useKeyboard() {
   // After the delay, the keys and modifiers are released and the next step is executed.
   // If a step has no keys or modifiers, it is treated as a delay-only step.
   // A small pause is added between steps to ensure that the device can process the events.
-  const executeMacroRemote = useCallback(async (
+  const executeMacroRemote = useCallback(
-    steps: MacroSteps,
+    async (steps: MacroSteps) => {
-  ) => {
+      const macro: KeyboardMacroStep[] = [];
-    const macro: KeyboardMacroStep[] = [];
 
-    for (const [_, step] of steps.entries()) {
+      for (const [_, step] of steps.entries()) {
-      const keyValues = (step.keys || []).map(key => keys[key]).filter(Boolean);
+        const keyValues = (step.keys || []).map(key => keys[key]).filter(Boolean);
-      const modifierMask: number = (step.modifiers || [])
+        const modifierMask: number = (step.modifiers || [])
 
-        .map(mod => modifiers[mod])
+          .map(mod => modifiers[mod])
 
-        .reduce((acc, val) => acc + val, 0);
+          .reduce((acc, val) => acc + val, 0);
 
-      // If the step has keys and/or modifiers, press them and hold for the delay
+        // If the step has keys and/or modifiers, press them and hold for the delay
-      if (keyValues.length > 0 || modifierMask > 0) {
+        if (keyValues.length > 0 || modifierMask > 0) {
-        macro.push({ keys: keyValues, modifier: modifierMask, delay: 20 });
+          macro.push({ keys: keyValues, modifier: modifierMask, delay: 20 });
-        macro.push({ ...MACRO_RESET_KEYBOARD_STATE, delay: step.delay || 100 });
+          macro.push({ ...MACRO_RESET_KEYBOARD_STATE, delay: step.delay || 100 });
-      }
-    }
-
-    sendKeyboardMacroEventHidRpc(macro);
-  }, [sendKeyboardMacroEventHidRpc]);
-
-  const executeMacroClientSide = useCallback(async (steps: MacroSteps) => {
-    const promises: (() => Promise<void>)[] = [];
-
-    const ac = new AbortController();
-    setAbortController(ac);
-
-    for (const [_, step] of steps.entries()) {
-      const keyValues = (step.keys || []).map(key => keys[key]).filter(Boolean);
-      const modifierMask: number = (step.modifiers || [])
-        .map(mod => modifiers[mod])
-        .reduce((acc, val) => acc + val, 0);
-
-      // If the step has keys and/or modifiers, press them and hold for the delay
-      if (keyValues.length > 0 || modifierMask > 0) {
-        promises.push(() => sendKeystrokeLegacy(keyValues, modifierMask, ac));
-        promises.push(() => resetKeyboardState());
-        promises.push(() => sleep(step.delay || 100));
-      }
-    }
-
-    const runAll = async () => {
-      for (const promise of promises) {
-        // Check if we've been aborted before executing each promise
-        if (ac.signal.aborted) {
-          throw new Error("Macro execution aborted");
         }
-        await promise();
       }
-    }
 
-    return await new Promise<void>((resolve, reject) => {
+      sendKeyboardMacroEventHidRpc(macro);
-      // Set up abort listener
+    },
-      const abortListener = () => {
+    [sendKeyboardMacroEventHidRpc],
-        reject(new Error("Macro execution aborted"));
+  );
+
+  const executeMacroClientSide = useCallback(
+    async (steps: MacroSteps) => {
+      const promises: (() => Promise<void>)[] = [];
+
+      const ac = new AbortController();
+      setAbortController(ac);
+
+      for (const [_, step] of steps.entries()) {
+        const keyValues = (step.keys || []).map(key => keys[key]).filter(Boolean);
+        const modifierMask: number = (step.modifiers || [])
+          .map(mod => modifiers[mod])
+          .reduce((acc, val) => acc + val, 0);
+
+        // If the step has keys and/or modifiers, press them and hold for the delay
+        if (keyValues.length > 0 || modifierMask > 0) {
+          promises.push(() => sendKeystrokeLegacy(keyValues, modifierMask, ac));
+          promises.push(() => resetKeyboardState());
+          promises.push(() => sleep(step.delay || 100));
+        }
+      }
+
+      const runAll = async () => {
+        for (const promise of promises) {
+          // Check if we've been aborted before executing each promise
+          if (ac.signal.aborted) {
+            throw new Error("Macro execution aborted");
+          }
+          await promise();
+        }
       };
 
-      ac.signal.addEventListener("abort", abortListener);
+      return await new Promise<void>((resolve, reject) => {
+        // Set up abort listener
+        const abortListener = () => {
+          reject(new Error("Macro execution aborted"));
+        };
 
-      runAll()
+        ac.signal.addEventListener("abort", abortListener);
-        .then(() => {
-          ac.signal.removeEventListener("abort", abortListener);
-          resolve();
-        })
-        .catch((error) => {
-          ac.signal.removeEventListener("abort", abortListener);
-          reject(error);
-        });
-    });
-  }, [sendKeystrokeLegacy, resetKeyboardState, setAbortController]);
 
-  const executeMacro = useCallback(async (steps: MacroSteps) => {
+        runAll()
-    if (rpcHidReady) {
+          .then(() => {
-      return executeMacroRemote(steps);
+            ac.signal.removeEventListener("abort", abortListener);
-    }
+            resolve();
-    return executeMacroClientSide(steps);
+          })
-  }, [rpcHidReady, executeMacroRemote, executeMacroClientSide]);
+          .catch(error => {
+            ac.signal.removeEventListener("abort", abortListener);
+            reject(error);
+          });
+      });
+    },
+    [sendKeystrokeLegacy, resetKeyboardState, setAbortController],
+  );
+
+  const executeMacro = useCallback(
+    async (steps: MacroSteps) => {
+      if (rpcHidReady) {
+        return executeMacroRemote(steps);
+      }
+      return executeMacroClientSide(steps);
+    },
+    [rpcHidReady, executeMacroRemote, executeMacroClientSide],
+  );
 
   const cancelExecuteMacro = useCallback(async () => {
     if (abortController.current) {
@@ -375,5 +381,11 @@ export default function useKeyboard() {
     cancelOngoingKeyboardMacroHidRpc();
   }, [rpcHidReady, cancelOngoingKeyboardMacroHidRpc, abortController]);
 
-  return { handleKeyPress, resetKeyboardState, executeMacro, cleanup, cancelExecuteMacro };
+  return {
+    handleKeyPress,
+    resetKeyboardState,
+    executeMacro,
+    cleanup,
+    cancelExecuteMacro,
+  };
 }

ui/src/routes/devices.$id.settings.general.update.tsx

@@ -10,8 +10,8 @@ import Card from "@components/Card";
 import LoadingSpinner from "@components/LoadingSpinner";
 import UpdatingStatusCard, { type UpdatePart } from "@components/UpdatingStatusCard";
 import { m } from "@localizations/messages.js";
-
+import { sleep } from "@/utils";
-import { SystemVersionInfo } from "../utils/jsonrpc";
+import { SystemVersionInfo } from "@/utils/jsonrpc";
 
 export default function SettingsGeneralUpdateRoute() {
   const navigate = useNavigate();
@@ -136,13 +136,14 @@ function LoadingState({
     }, 0);
 
     getVersionInfo()
-      .then(versionInfo => {
+      .then(async versionInfo => {
         // Add a small delay to ensure it's not just flickering
-        return new Promise(resolve => setTimeout(() => resolve(versionInfo), 600));
+        await sleep(600);
+        return versionInfo
       })
       .then(versionInfo => {
         if (!signal.aborted) {
-          onFinished(versionInfo as SystemVersionInfo);
+          onFinished(versionInfo);
         }
       })
       .catch(error => {

ui/src/utils.ts

@@ -1,7 +1,6 @@
 import { KeySequence } from "@hooks/stores";
-import { getLocale } from '@localizations/runtime.js';
+import { getLocale , locales } from "@localizations/runtime.js";
 import { m } from "@localizations/messages.js";
-import { locales } from '@localizations/runtime.js';
 
 export const formatters = {
   date: (date: Date, options?: Intl.DateTimeFormatOptions) =>
@@ -47,14 +46,14 @@ export const formatters = {
       amount: number;
       name: Intl.RelativeTimeFormatUnit;
     }[] = [
-        { amount: 60, name: "seconds" },
+      { amount: 60, name: "seconds" },
-        { amount: 60, name: "minutes" },
+      { amount: 60, name: "minutes" },
-        { amount: 24, name: "hours" },
+      { amount: 24, name: "hours" },
-        { amount: 7, name: "days" },
+      { amount: 7, name: "days" },
-        { amount: 4.34524, name: "weeks" },
+      { amount: 4.34524, name: "weeks" },
-        { amount: 12, name: "months" },
+      { amount: 12, name: "months" },
-        { amount: Number.POSITIVE_INFINITY, name: "years" },
+      { amount: Number.POSITIVE_INFINITY, name: "years" },
-      ];
+    ];
 
     let duration = (date.valueOf() - new Date().valueOf()) / 1000;
 
@@ -255,27 +254,41 @@ export function normalizeSortOrders(macros: KeySequence[]): KeySequence[] {
     ...macro,
     sortOrder: index + 1,
   }));
-};
+}
 
-type LocaleCode = typeof locales[number];
+type LocaleCode = (typeof locales)[number];
 
-export function map_locale_code_to_name(currentLocale: LocaleCode, locale: string): [string, string] {
+export function map_locale_code_to_name(
-    // the first is the name in the current app locale (e.g. Inglese),
+  currentLocale: LocaleCode,
-    // the second is the name in the language of the locale itself (e.g. English)
+  locale: string,
-    switch (locale) {
+): [string, string] {
-      case '': return [m.locale_auto(), ""];
+  // the first is the name in the current app locale (e.g. Inglese),
-      case 'en': return [m.locale_en({}, { locale: currentLocale }), m.locale_en({}, { locale })];
+  // the second is the name in the language of the locale itself (e.g. English)
-      case 'da': return [m.locale_da({}, { locale: currentLocale }), m.locale_da({}, { locale })];
+  switch (locale) {
-      case 'de': return [m.locale_de({}, { locale: currentLocale }), m.locale_de({}, { locale })];
+    case "":
-      case 'es': return [m.locale_es({}, { locale: currentLocale }), m.locale_es({}, { locale })];
+      return [m.locale_auto(), ""];
-      case 'fr': return [m.locale_fr({}, { locale: currentLocale }), m.locale_fr({}, { locale })];
+    case "en":
-      case 'it': return [m.locale_it({}, { locale: currentLocale }), m.locale_it({}, { locale })];
+      return [m.locale_en({}, { locale: currentLocale }), m.locale_en({}, { locale })];
-      case 'nb': return [m.locale_nb({}, { locale: currentLocale }), m.locale_nb({}, { locale })];
+    case "da":
-      case 'sv': return [m.locale_sv({}, { locale: currentLocale }), m.locale_sv({}, { locale })];
+      return [m.locale_da({}, { locale: currentLocale }), m.locale_da({}, { locale })];
-      case 'zh': return [m.locale_zh({}, { locale: currentLocale }), m.locale_zh({}, { locale })];
+    case "de":
-      default: return [locale, ""];
+      return [m.locale_de({}, { locale: currentLocale }), m.locale_de({}, { locale })];
-    }
+    case "es":
+      return [m.locale_es({}, { locale: currentLocale }), m.locale_es({}, { locale })];
+    case "fr":
+      return [m.locale_fr({}, { locale: currentLocale }), m.locale_fr({}, { locale })];
+    case "it":
+      return [m.locale_it({}, { locale: currentLocale }), m.locale_it({}, { locale })];
+    case "nb":
+      return [m.locale_nb({}, { locale: currentLocale }), m.locale_nb({}, { locale })];
+    case "sv":
+      return [m.locale_sv({}, { locale: currentLocale }), m.locale_sv({}, { locale })];
+    case "zh":
+      return [m.locale_zh({}, { locale: currentLocale }), m.locale_zh({}, { locale })];
+    default:
+      return [locale, ""];
   }
+}
 
 export function deleteCookie(name: string, domain?: string, path = "/") {
   const domainPart = domain ? `; domain=${domain}` : "";
@@ -284,3 +297,7 @@ export function deleteCookie(name: string, domain?: string, path = "/") {
   // fallback: set an expires in the past for older agents
   document.cookie = `${name}=; path=${path}; expires=Thu, 01 Jan 1970 00:00:00 GMT${domainPart}`;
 }
+
+export function sleep(ms: number): Promise<void> {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}

ui/src/utils/jsonrpc.ts

@@ -1,12 +1,13 @@
 import { useRTCStore } from "@/hooks/stores";
+import { sleep } from "@/utils";
 
 // JSON-RPC utility for use outside of React components
 
 export interface JsonRpcCallOptions {
   method: string;
   params?: unknown;
-  timeout?: number;
+  attemptTimeoutMs?: number;
-  retriesOnError?: number;
+  maxAttempts?: number;
 }
 
 export interface JsonRpcCallResponse<T = unknown> {
@@ -22,9 +23,6 @@ export interface JsonRpcCallResponse<T = unknown> {
 
 let rpcCallCounter = 0;
 
-// Helper: sleep utility for retry delays
-const sleep = (ms: number) => new Promise(resolve => setTimeout(resolve, ms));
-
 // Helper: wait for RTC data channel to be ready
 async function waitForRtcReady(signal: AbortSignal): Promise<RTCDataChannel> {
   const pollInterval = 100;
@@ -95,13 +93,16 @@ export function callJsonRpc(
 export async function callJsonRpc<T = unknown>(
   options: JsonRpcCallOptions,
 ): Promise<JsonRpcCallResponse<T>> {
-  const maxRetries = options.retriesOnError ?? 0;
+  const maxAttempts = options.maxAttempts ?? 1;
-  const timeout = options.timeout || 5000;
+  const timeout = options.attemptTimeoutMs || 5000;
 
-  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+  for (let attempt = 0; attempt < maxAttempts; attempt++) {
     const abortController = new AbortController();
     const timeoutId = setTimeout(() => abortController.abort(), timeout);
 
+    // Exponential backoff for retries that starts at 500ms up to a maximum of 10 seconds
+    const backoffMs = Math.min(500 * Math.pow(2, attempt), 10000);
+
     try {
       // Wait for RTC readiness
       const rpcDataChannel = await waitForRtcReady(abortController.signal);
@@ -116,8 +117,8 @@ export async function callJsonRpc<T = unknown>(
       clearTimeout(timeoutId);
 
       // Retry on error if attempts remain
-      if (response.error && attempt < maxRetries) {
+      if (response.error && attempt < maxAttempts - 1) {
-        await sleep(1000);
+        await sleep(backoffMs);
         continue;
       }
 
@@ -126,8 +127,8 @@ export async function callJsonRpc<T = unknown>(
       clearTimeout(timeoutId);
 
       // Retry on timeout/error if attempts remain
-      if (attempt < maxRetries) {
+      if (attempt < maxAttempts - 1) {
-        await sleep(1000);
+        await sleep(backoffMs);
         continue;
       }
 
@@ -196,8 +197,7 @@ export async function getUpdateStatus() {
     // This function calls our api server to see if there are any updates available.
     // It can be called on page load right after a restart, so we need to give it time to
     // establish a connection to the api server.
-    timeout: 10000,
+    maxAttempts: 6,
-    retriesOnError: 5,
   });
 
   if (response.error) throw response.error;