Skip to content

Privacy-first password manager with built-in email aliasing. Fully encrypted and self-hostable.

Add 426 status detection to mobile app

Leendert de Borstd64a4c65e75e
diff --git a/apps/mobile-app/android/app/src/main/java/net/aliasvault/app/vaultstore/VaultSync.kt b/apps/mobile-app/android/app/src/main/java/net/aliasvault/app/vaultstore/VaultSync.kt
index 6fbd8cc39..4bc051d48 100644
--- a/apps/mobile-app/android/app/src/main/java/net/aliasvault/app/vaultstore/VaultSync.kt
+++ b/apps/mobile-app/android/app/src/main/java/net/aliasvault/app/vaultstore/VaultSync.kt
@@ -411,6 +411,10 @@ class VaultSync(
if (response.statusCode == 413) {
throw AppError.VaultTooLarge()
}
+ // 426: server no longer supports this app version for this account.
+ if (response.statusCode == 426) {
+ throw AppError.ClientVersionNotSupported()
+ }
return VaultUploadResult(
success = false,
status = -1,
@@ -650,6 +654,10 @@ class VaultSync(
if (vaultResponse.statusCode == 401) {
throw AppError.SessionExpired()
}
+ if (vaultResponse.statusCode == 426) {
+ // Server no longer supports this app version for this account
+ throw AppError.ClientVersionNotSupported()
+ }
throw AppError.ServerUnavailable(vaultResponse.statusCode)
}
@@ -678,6 +686,10 @@ class VaultSync(
Log.e(TAG, "Authentication failed (401) - token refresh also failed")
throw AppError.SessionExpired()
}
+ if (statusResponse.statusCode == 426) {
+ // Server no longer supports this app version for this account
+ throw AppError.ClientVersionNotSupported()
+ }
metadata.setOfflineMode(true)
throw AppError.ServerUnavailable(statusResponse.statusCode)
}
@@ -749,6 +761,10 @@ class VaultSync(
if (vaultResponse.statusCode == 401) {
throw VaultOperationException("Session expired")
}
+ if (vaultResponse.statusCode == 426) {
+ // Typed error so the JS layer gets E-301 and shows the "update your app" message.
+ throw AppError.ClientVersionNotSupported()
+ }
throw VaultOperationException("Server unavailable: ${vaultResponse.statusCode}")
}
diff --git a/apps/mobile-app/app/login.tsx b/apps/mobile-app/app/login.tsx
index 9e19e8043..6c1fa840b 100644
--- a/apps/mobile-app/app/login.tsx
+++ b/apps/mobile-app/app/login.tsx
@@ -15,6 +15,7 @@ import type { LoginResponse } from '@/utils/dist/core/models/webapi';
import EncryptionUtility from '@/utils/EncryptionUtility';
import { SrpUtility } from '@/utils/SrpUtility';
import { ApiAuthError } from '@/utils/types/errors/ApiAuthError';
+import { ClientUpgradeRequiredError } from '@/utils/types/errors/ClientUpgradeRequiredError';
import { LocalAuthError } from '@/utils/types/errors/LocalAuthError';
import { useColors } from '@/hooks/useColorScheme';
@@ -422,7 +423,11 @@ export default function LoginScreen() : React.ReactNode {
initiateLoginResponse
);
} catch (err) {
- if (err instanceof ApiAuthError) {
+ if (err instanceof ClientUpgradeRequiredError) {
+ // Server refused this app version; show the notice translated, keyed on its error code.
+ console.error('Client upgrade required:', err);
+ setError(t('vault.errors.versionNotSupported'));
+ } else if (err instanceof ApiAuthError) {
console.error('ApiAuthError error:', err);
setError(t(`apiErrors.${err.message}`));
} else if (err instanceof LocalAuthError) {
@@ -481,7 +486,10 @@ export default function LoginScreen() : React.ReactNode {
);
} catch (err) {
console.error('2FA error:', err);
- if (err instanceof ApiAuthError) {
+ if (err instanceof ClientUpgradeRequiredError) {
+ // Server refused this app version; show the notice translated, keyed on its error code.
+ setError(t('vault.errors.versionNotSupported'));
+ } else if (err instanceof ApiAuthError) {
setError(t(`apiErrors.${err.message}`));
} else if (err instanceof LocalAuthError) {
setError((err as Error).message);
diff --git a/apps/mobile-app/ios/VaultStoreKit/VaultStore+Mutate.swift b/apps/mobile-app/ios/VaultStoreKit/VaultStore+Mutate.swift
index 783049dab..4cc204ee6 100644
--- a/apps/mobile-app/ios/VaultStoreKit/VaultStore+Mutate.swift
+++ b/apps/mobile-app/ios/VaultStoreKit/VaultStore+Mutate.swift
@@ -271,6 +271,10 @@ extension VaultStore {
if response.statusCode == 413 {
throw AppError.vaultTooLarge
}
+ // 426: server no longer supports this app version for this account.
+ if response.statusCode == 426 {
+ throw AppError.clientVersionNotSupported
+ }
return VaultUploadResult(
success: false,
status: -1,
diff --git a/apps/mobile-app/ios/VaultStoreKit/VaultStore+Sync.swift b/apps/mobile-app/ios/VaultStoreKit/VaultStore+Sync.swift
index 2eb732df4..613e9c6f6 100644
--- a/apps/mobile-app/ios/VaultStoreKit/VaultStore+Sync.swift
+++ b/apps/mobile-app/ios/VaultStoreKit/VaultStore+Sync.swift
@@ -152,6 +152,10 @@ extension VaultStore {
if vaultResponse.statusCode == 401 {
throw AppError.sessionExpired
}
+ if vaultResponse.statusCode == 426 {
+ // Server no longer supports this app version for this account
+ throw AppError.clientVersionNotSupported
+ }
throw AppError.serverUnavailable(statusCode: vaultResponse.statusCode)
}
@@ -574,6 +578,11 @@ extension VaultStore {
throw AppError.sessionExpired
}
+ if statusResponse.statusCode == 426 {
+ // Server no longer supports this app version for this account
+ throw AppError.clientVersionNotSupported
+ }
+
// Other error (5xx, network, etc.) - go offline
setOfflineMode(true)
throw AppError.serverUnavailable(statusCode: statusResponse.statusCode)
@@ -644,6 +653,10 @@ extension VaultStore {
if vaultResponse.statusCode == 401 {
throw AppError.sessionExpired
}
+ if vaultResponse.statusCode == 426 {
+ // Server no longer supports this app version for this account
+ throw AppError.clientVersionNotSupported
+ }
throw AppError.serverUnavailable(statusCode: vaultResponse.statusCode)
}
diff --git a/apps/mobile-app/utils/WebApiService.ts b/apps/mobile-app/utils/WebApiService.ts
index 8098fa862..1a3196c50 100644
--- a/apps/mobile-app/utils/WebApiService.ts
+++ b/apps/mobile-app/utils/WebApiService.ts
@@ -5,6 +5,7 @@ import type { StatusResponse, VaultResponse, AuthLogModel, RefreshToken } from '
import i18n from '@/i18n';
+import { ClientUpgradeRequiredError } from './types/errors/ClientUpgradeRequiredError';
import { LocalAuthError } from './types/errors/LocalAuthError';
import { PayloadTooLargeError } from './types/errors/PayloadTooLargeError';
import { logoutEventEmitter } from '@/events/LogoutEventEmitter';
@@ -92,6 +93,11 @@ export class WebApiService {
throw new Error(i18n.t('auth.errors.sessionExpired'));
}
+ // Server refused this client version.
+ if (response.statusCode === 426) {
+ throw new ClientUpgradeRequiredError();
+ }
+
if (response.statusCode === 413 && throwOnError) {
throw new PayloadTooLargeError(`Request rejected with HTTP 413: payload exceeds server limit`);
}
@@ -158,10 +164,20 @@ export class WebApiService {
headers: nativeResponse.headers,
};
+ // Server refused this client version.
+ if (nativeResponse.statusCode === 426) {
+ throw new ClientUpgradeRequiredError();
+ }
+
return new Response(nativeResponse.body, responseInit);
} catch (error) {
console.error('API request failed:', error);
+ // Server refused this client version.
+ if (error instanceof ClientUpgradeRequiredError) {
+ throw error;
+ }
+
// Detect SSL certificate errors
if (error instanceof Error) {
const errorMessage = error.message.toLowerCase();
diff --git a/apps/mobile-app/utils/types/errors/ClientUpgradeRequiredError.ts b/apps/mobile-app/utils/types/errors/ClientUpgradeRequiredError.ts
new file mode 100644
index 000000000..c003f0535
--- /dev/null
+++ b/apps/mobile-app/utils/types/errors/ClientUpgradeRequiredError.ts
@@ -0,0 +1,13 @@
+/**
+ * Thrown when the server rejects the request with HTTP 426 because this app version is too old to
+ * access the account.
+ */
+export class ClientUpgradeRequiredError extends Error {
+ /**
+ * Creates a new instance of ClientUpgradeRequiredError.
+ */
+ public constructor() {
+ super('HTTP 426: client version no longer supported by the server');
+ this.name = 'ClientUpgradeRequiredError';
+ }
+}