DefGuard · t-aleksander · Mar 18, 2026 · Mar 18, 2026 · Mar 18, 2026
diff --git a/biome.json b/biome.json
@@ -1,5 +1,5 @@
 {
-  "$schema": "https://biomejs.dev/schemas/2.3.13/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.4.4/schema.json",
   "vcs": {
     "enabled": false,
     "clientKind": "git",

diff --git a/src/components/ApplicationUpdateManager/ApplicationUpdateManager.tsx b/src/components/ApplicationUpdateManager/ApplicationUpdateManager.tsx
@@ -6,6 +6,7 @@ import { clientApi } from '../../pages/client/clientAPI/clientApi.ts';
 import { useClientStore } from '../../pages/client/hooks/useClientStore';
 import { TauriEventKey } from '../../pages/client/types';
 import type { NewApplicationVersionInfo } from '../../shared/hooks/api/types';
+import { errorDetail } from '../../shared/utils/errorDetail';
 import {
   type ApplicationUpdateStore,
   useApplicationUpdateStore,
@@ -83,7 +84,8 @@ export const ApplicationUpdateManager = () => {
           dismissed: false,
         });
       } catch (e) {
-        error(`Failed to check latest app version: ${e}`);
+        const detail = errorDetail(e);
+        error(`Failed to check latest app version (current: ${appVersion}): ${detail}`);
       }
     };
 

diff --git a/src/components/AutoProvisioningManager.tsx b/src/components/AutoProvisioningManager.tsx
@@ -6,6 +6,7 @@ import type { ProvisioningConfig } from '../pages/client/clientAPI/types';
 import { clientQueryKeys } from '../pages/client/query';
 import { useToaster } from '../shared/defguard-ui/hooks/toasts/useToaster';
 import useAddInstance from '../shared/hooks/useAddInstance';
+import { errorDetail } from '../shared/utils/errorDetail';
 
 const { getProvisioningConfig } = clientApi;
 
@@ -26,8 +27,9 @@ export default function AutoProvisioningManager({ children }: PropsWithChildren)
         token: config.enrollment_token,
       });
     } catch (e) {
+      const detail = errorDetail(e);
       error(
-        `Failed to handle automatic client provisioning with ${JSON.stringify(config)}.\n Error: ${JSON.stringify(e)}`,
+        `Failed to handle automatic client provisioning (url: ${config.enrollment_url}): ${detail}`,
       );
       toaster.error(
         'Automatic client provisioning failed, please contact your administrator.',

diff --git a/src/main.tsx b/src/main.tsx
@@ -1,7 +1,22 @@
+import { error } from '@tauri-apps/plugin-log';
 import { StrictMode } from 'react';
 import { createRoot } from 'react-dom/client';
 
 import { App } from './components/App/App';
+import { errorDetail } from './shared/utils/errorDetail';
+
+// Forward uncaught JS errors to the Tauri backend log
+window.onerror = (message, source, lineno, colno, err) => {
+  const detail = err?.stack ?? `${message} (${source}:${lineno}:${colno})`;
+  error(`[uncaught error] ${detail}`);
+  // returning false lets the error propagate to the browser DevTools console
+  return false;
+};
+
+// Forward unhandled promise rejections to the Tauri backend log
+window.addEventListener('unhandledrejection', (event) => {
+  error(`[unhandled rejection] ${errorDetail(event.reason)}`);
+});
 
 const rootElement = document.getElementById('root') as HTMLElement;
 

diff --git a/...components/AddInstanceFormCard/components/AddInstanceDeviceForm/AddInstanceDeviceForm.tsx b/...components/AddInstanceFormCard/components/AddInstanceDeviceForm/AddInstanceDeviceForm.tsx
@@ -23,6 +23,7 @@ import type {
   CreateDeviceResponse,
 } from '../../../../../../../../shared/hooks/api/types';
 import { routes } from '../../../../../../../../shared/routes';
+import { errorDetail } from '../../../../../../../../shared/utils/errorDetail';
 import { generateWGKeys } from '../../../../../../../../shared/utils/generateWGKeys';
 import { clientApi } from '../../../../../../clientAPI/clientApi';
 import { useClientStore } from '../../../../../../hooks/useClientStore';
@@ -134,6 +135,8 @@ export const AddInstanceDeviceForm = () => {
             navigate(routes.client.instancePage, { replace: true });
           })
           .catch((e) => {
+            const detail = errorDetail(e);
+            error(`Failed to save device config: ${detail}`);
             toaster.error(
               LL.common.messages.errorWithMessage({
                 message: String(e),
@@ -144,7 +147,8 @@ export const AddInstanceDeviceForm = () => {
       });
     } catch (e) {
       setIsLoading(false);
-      console.error(e);
+      const detail = errorDetail(e);
+      error(`Device form submit failed for proxy ${proxyUrl}: ${detail}`);
 
       if (typeof e === 'string') {
         if (e.includes('Network Error')) {

diff --git a/...age/components/AddInstanceFormCard/components/AddInstanceInitForm/AddInstanceInitForm.tsx b/...age/components/AddInstanceFormCard/components/AddInstanceInitForm/AddInstanceInitForm.tsx
@@ -9,7 +9,6 @@ import { useMemo, useState } from 'react';
 import { type SubmitHandler, useForm } from 'react-hook-form';
 import { useNavigate } from 'react-router-dom';
 import { z } from 'zod';
-
 import { useI18nContext } from '../../../../../../../../i18n/i18n-react';
 import { FormInput } from '../../../../../../../../shared/defguard-ui/components/Form/FormInput/FormInput';
 import { Button } from '../../../../../../../../shared/defguard-ui/components/Layout/Button/Button';
@@ -24,6 +23,7 @@ import type {
   EnrollmentStartResponse,
 } from '../../../../../../../../shared/hooks/api/types';
 import { routes } from '../../../../../../../../shared/routes';
+import { errorDetail } from '../../../../../../../../shared/utils/errorDetail';
 import { useEnrollmentStore } from '../../../../../../../enrollment/hooks/store/useEnrollmentStore';
 import { clientApi } from '../../../../../../clientAPI/clientApi';
 import { useClientStore } from '../../../../../../hooks/useClientStore';
@@ -96,7 +96,9 @@ export const AddInstanceInitForm = () => {
       .then(async (res: Response) => {
         if (!res.ok) {
           setIsLoading(false);
-          error(JSON.stringify(res.status));
+          error(
+            `Enrollment start returned non-OK status ${res.status} for URL: ${endpointUrl}`,
+          );
           const errorMessage = ((await res.json()) as EnrollmentError).error;
 
           switch (errorMessage) {
@@ -120,9 +122,7 @@ export const AddInstanceInitForm = () => {
         if (!authCookie) {
           setIsLoading(false);
           error(
-            LL.common.messages.errorWithMessage({
-              message: LL.common.messages.noCookie(),
-            }),
+            `Enrollment start response for ${endpointUrl} is missing defguard_proxy set-cookie header`,
           );
           throw Error(
             LL.common.messages.errorWithMessage({
@@ -154,34 +154,57 @@ export const AddInstanceInitForm = () => {
             body: JSON.stringify({
               pubkey: instance.pubkey,
             }),
-          }).then(async (res) => {
-            invoke<void>('update_instance', {
-              instanceId: instance.id,
-              response: (await res.json()) as CreateDeviceResponse,
-            })
-              .then(() => {
-                info('Configured device');
-                toaster.success(
-                  LL.pages.enrollment.steps.deviceSetup.desktopSetup.messages.deviceConfigured(),
-                );
-                const _selectedInstance: SelectedInstance = {
-                  id: instance.id,
-                  type: ClientConnectionType.LOCATION,
-                };
-                setClientState({
-                  selectedInstance: _selectedInstance,
-                });
-                navigate(routes.client.base, { replace: true });
-              })
-              .catch((e) => {
-                error(e);
+          })
+            .then(async (res) => {
+              if (!res.ok) {
+                const detail = `network_info returned status ${res.status} for instance ${instance.uuid}`;
+                error(`Failed to fetch network info: ${detail}`);
                 toaster.error(
                   LL.common.messages.errorWithMessage({
-                    message: String(e),
+                    message: detail,
                   }),
                 );
-              });
-          });
+                return;
+              }
+              invoke<void>('update_instance', {
+                instanceId: instance.id,
+                response: (await res.json()) as CreateDeviceResponse,
+              })
+                .then(() => {
+                  info('Configured device');
+                  toaster.success(
+                    LL.pages.enrollment.steps.deviceSetup.desktopSetup.messages.deviceConfigured(),
+                  );
+                  const _selectedInstance: SelectedInstance = {
+                    id: instance.id,
+                    type: ClientConnectionType.LOCATION,
+                  };
+                  setClientState({
+                    selectedInstance: _selectedInstance,
+                  });
+                  navigate(routes.client.base, { replace: true });
+                })
+                .catch((e) => {
+                  const detail = errorDetail(e);
+                  error(`Failed to save config during instance add: ${detail}`);
+                  toaster.error(
+                    LL.common.messages.errorWithMessage({
+                      message: String(e),
+                    }),
+                  );
+                });
+            })
+            .catch((e) => {
+              const detail = errorDetail(e);
+              error(
+                `Failed to reach network_info endpoint for instance ${instance.uuid}: ${detail}`,
+              );
+              toaster.error(
+                LL.common.messages.errorWithMessage({
+                  message: String(e),
+                }),
+              );
+            });
         }
         // register new instance
         // is user in need of full enrollment ?
@@ -220,6 +243,8 @@ export const AddInstanceInitForm = () => {
       })
       .catch((e) => {
         setIsLoading(false);
+        const detail = errorDetail(e);
+        error(`Failed to initialize instance: ${detail}`);
         if (typeof e === 'string') {
           if (e.includes('Network Error')) {
             toaster.error(LL.common.messages.networkError());

diff --git a/src/pages/client/pages/ClientEditTunnelPage/components/EditTunnelFormCard.tsx b/src/pages/client/pages/ClientEditTunnelPage/components/EditTunnelFormCard.tsx
@@ -1,9 +1,9 @@
 import { zodResolver } from '@hookform/resolvers/zod';
+import { error } from '@tauri-apps/plugin-log';
 import { useMemo, useState } from 'react';
 import { type SubmitHandler, useForm } from 'react-hook-form';
 import { useNavigate } from 'react-router-dom';
 import { z } from 'zod';
-
 import { useI18nContext } from '../../../../../i18n/i18n-react';
 import { FormInput } from '../../../../../shared/defguard-ui/components/Form/FormInput/FormInput';
 import { ArrowSingle } from '../../../../../shared/defguard-ui/components/icons/ArrowSingle/ArrowSingle';
@@ -23,6 +23,7 @@ import {
   patternValidWireguardKey,
 } from '../../../../../shared/patterns';
 import { routes } from '../../../../../shared/routes';
+import { errorDetail } from '../../../../../shared/utils/errorDetail';
 import { validateIpOrDomainList } from '../../../../../shared/validators/tunnel';
 import { clientApi } from '../../../clientAPI/clientApi';
 import type { Tunnel } from '../../../types';
@@ -197,9 +198,11 @@ export const EditTunnelFormCard = ({ tunnel, submitRef }: Props) => {
         navigate(routes.client.base, { replace: true });
         toaster.success(LL.pages.client.pages.editTunnelPage.messages.editSuccess());
       })
-      .catch(() =>
-        toaster.error(LL.pages.client.pages.editTunnelPage.messages.editError()),
-      );
+      .catch((e) => {
+        const detail = errorDetail(e);
+        error(`Failed to update tunnel: ${detail}`);
+        toaster.error(LL.pages.client.pages.editTunnelPage.messages.editError());
+      });
   };
 
   const { handleSubmit, control } = useForm<Tunnel>({

diff --git a/src/pages/client/pages/ClientEditTunnelPage/modals/DeleteTunnelModal/DeleteTunnelModal.tsx b/src/pages/client/pages/ClientEditTunnelPage/modals/DeleteTunnelModal/DeleteTunnelModal.tsx
@@ -1,13 +1,14 @@
 import { useMutation, useQueryClient } from '@tanstack/react-query';
+import { error } from '@tauri-apps/plugin-log';
 import { isUndefined } from 'lodash-es';
 import { useNavigate } from 'react-router-dom';
 import { shallow } from 'zustand/shallow';
-
 import { useI18nContext } from '../../../../../../i18n/i18n-react';
 import { ConfirmModal } from '../../../../../../shared/defguard-ui/components/Layout/modals/ConfirmModal/ConfirmModal';
 import { ConfirmModalType } from '../../../../../../shared/defguard-ui/components/Layout/modals/ConfirmModal/types';
 import { useToaster } from '../../../../../../shared/defguard-ui/hooks/toasts/useToaster';
 import { routes } from '../../../../../../shared/routes';
+import { errorDetail } from '../../../../../../shared/utils/errorDetail';
 import { clientApi } from '../../../../clientAPI/clientApi';
 import { useClientStore } from '../../../../hooks/useClientStore';
 import { clientQueryKeys } from '../../../../query';
@@ -59,7 +60,8 @@ export const DeleteTunnelModal = () => {
           message: String(e),
         }),
       );
-      console.error(e);
+      const detail = errorDetail(e);
+      error(`Failed to delete tunnel "${tunnel?.name}" (id: ${tunnel?.id}): ${detail}`);
     },
   });
 

diff --git a/...mponents/LocationsList/components/LocationCardConnectButton/LocationCardConnectButton.tsx b/...mponents/LocationsList/components/LocationCardConnectButton/LocationCardConnectButton.tsx
@@ -3,7 +3,6 @@ import './style.scss';
 import { error } from '@tauri-apps/plugin-log';
 import classNames from 'classnames';
 import { useState } from 'react';
-
 import { useI18nContext } from '../../../../../../../../i18n/i18n-react';
 import SvgIconCheckmarkSmall from '../../../../../../../../shared/components/svg/IconCheckmarkSmall';
 import { Button } from '../../../../../../../../shared/defguard-ui/components/Layout/Button/Button';
@@ -13,6 +12,7 @@ import {
 } from '../../../../../../../../shared/defguard-ui/components/Layout/Button/types';
 import SvgIconX from '../../../../../../../../shared/defguard-ui/components/svg/IconX';
 import { useToaster } from '../../../../../../../../shared/defguard-ui/hooks/toasts/useToaster';
+import { errorDetail } from '../../../../../../../../shared/utils/errorDetail';
 import { clientApi } from '../../../../../../clientAPI/clientApi';
 import { type CommonWireguardFields, LocationMfaType } from '../../../../../../types';
 import { useMFAModal } from '../../modals/MFAModal/useMFAModal';
@@ -66,8 +66,10 @@ export const LocationCardConnectButton = ({ location }: Props) => {
           message: String(e),
         }),
       );
-      error(`Error handling interface: ${e}`);
-      console.error(e);
+      const detail = errorDetail(e);
+      error(
+        `Error handling interface for location ${location?.id} (${location?.active ? 'disconnect' : 'connect'}): ${detail}`,
+      );
     }
   };
 

diff --git a/...tInstancePage/components/LocationsList/components/LocationCardRoute/LocationCardRoute.tsx b/...tInstancePage/components/LocationsList/components/LocationCardRoute/LocationCardRoute.tsx
@@ -5,6 +5,7 @@ import { useMemo } from 'react';
 import { useI18nContext } from '../../../../../../../../i18n/i18n-react';
 import { Toggle } from '../../../../../../../../shared/defguard-ui/components/Layout/Toggle/Toggle';
 import type { ToggleOption } from '../../../../../../../../shared/defguard-ui/components/Layout/Toggle/types';
+import { errorDetail } from '../../../../../../../../shared/utils/errorDetail';
 import { clientApi } from '../../../../../../clientAPI/clientApi';
 import {
   ClientConnectionType,
@@ -30,8 +31,10 @@ export const LocationCardRoute = ({ location, selectedDefguardInstance }: Props)
         });
       }
     } catch (e) {
-      error(`Error handling routing: ${e}`);
-      console.error(e);
+      const detail = errorDetail(e);
+      error(
+        `Failed to update routing for location ${location?.id} (type: ${location?.connection_type}, routeAllTraffic: ${value}): ${detail}`,
+      );
     }
   };