usb/sagas: Retry USB device open on Linux if SecurityError occurs

On slow machines, udev rules may not have finished processing by the time
we try to open the USB device. This causes a SecurityError, so we add a
retry loop to handle this case.

Closes: pybricks/support#2372

Author: dlech

src/usb/sagas.ts

@@ -1,5 +1,5 @@
 // SPDX-License-Identifier: MIT
-// Copyright (c) 2025 The Pybricks Authors
+// Copyright (c) 2025-2026 The Pybricks Authors
 
 import { firmwareVersion } from '@pybricks/firmware';
 import { AnyAction } from 'redux';
@@ -37,6 +37,7 @@ import { pybricksHubCapabilitiesCharacteristicUUID } from '../ble-pybricks-servi
 import { firmwareInstallPybricks } from '../firmware/actions';
 import { RootState } from '../reducers';
 import { assert, defined, ensureError, maybe } from '../utils';
+import { isLinux } from '../utils/os';
 import { pythonVersionToSemver } from '../utils/version';
 import {
     usbConnectPybricks,
@@ -128,6 +129,7 @@ function* handleUsbConnectPybricks(hotPlugDevice?: USBDevice): Generator {
                 return;
             }
 
+            // TODO: show unexpected error message to user here
             console.error('Failed to request USB device:', reqDeviceErr);
             yield* put(usbDidFailToConnectPybricks());
             yield* cleanup();
@@ -140,13 +142,29 @@ function* handleUsbConnectPybricks(hotPlugDevice?: USBDevice): Generator {
         usbDevice = hotPlugDevice;
     }
 
-    const [, openErr] = yield* call(() => maybe(usbDevice.open()));
-    if (openErr) {
-        // TODO: show error message to user here
-        console.error('Failed to open USB device:', openErr);
-        yield* put(usbDidFailToConnectPybricks());
-        yield* cleanup();
-        return;
+    for (let retry = 0; ; retry++) {
+        const [, openErr] = yield* call(() => maybe(usbDevice.open()));
+        if (openErr) {
+            // On Linux, the udev rules could still be processing, try a few
+            // times before giving up.
+            if (isLinux() && openErr.name === 'SecurityError' && retry < 5) {
+                console.debug(
+                    `Retrying USB device open (${
+                        retry + 1
+                    }/5) after SecurityError on Linux`,
+                );
+                yield* delay(100);
+                continue;
+            }
+
+            // TODO: show error message to user here
+            console.error('Failed to open USB device:', openErr);
+            yield* put(usbDidFailToConnectPybricks());
+            yield* cleanup();
+            return;
+        }
+
+        break;
     }
 
     exitStack.push(() => usbDevice.close().catch(console.debug));