fix: App hanging when changing passcode on iOS

- Add 300ms delay between authentication and passcode change modals
- Add try-catch to handle authentication cancellation gracefully
- Prevents iOS UI thread hang when two modals open back-to-back

Fixes #6313

Author: DSingh0304

app/views/ScreenLockConfigView.test.tsx

@@ -0,0 +1,127 @@
+import * as localAuthentication from '../lib/methods/helpers/localAuthentication';
+
+// Mock the localAuthentication module
+jest.mock('../lib/methods/helpers/localAuthentication', () => ({
+	handleLocalAuthentication: jest.fn(),
+	changePasscode: jest.fn(),
+	checkHasPasscode: jest.fn(),
+	supportedBiometryLabel: jest.fn()
+}));
+
+describe('ScreenLockConfigView - Passcode Change with Modal Delay', () => {
+	beforeEach(() => {
+		jest.clearAllMocks();
+		jest.useFakeTimers();
+	});
+
+	afterEach(() => {
+		jest.useRealTimers();
+	});
+
+	it('should add 300ms delay between authentication and passcode change', async () => {
+		const handleLocalAuthenticationMock = localAuthentication.handleLocalAuthentication as jest.Mock;
+		const changePasscodeMock = localAuthentication.changePasscode as jest.Mock;
+
+		handleLocalAuthenticationMock.mockResolvedValue(undefined);
+		changePasscodeMock.mockResolvedValue(undefined);
+
+		// Simulate the flow: authentication -> delay -> passcode change
+		const simulatePasscodeChange = async (autoLock: boolean) => {
+			if (autoLock) {
+				try {
+					await handleLocalAuthenticationMock(true);
+					// Add 300ms delay
+					await new Promise(resolve => setTimeout(resolve, 300));
+				} catch {
+					return;
+				}
+			}
+			await changePasscodeMock({ force: false });
+		};
+
+		const promise = simulatePasscodeChange(true);
+
+		// Verify handleLocalAuthentication was called
+		await Promise.resolve(); // Flush microtasks
+		expect(handleLocalAuthenticationMock).toHaveBeenCalledWith(true);
+
+		// Fast-forward timers to simulate the 300ms delay
+		jest.runAllTimers();
+
+		await promise;
+
+		// Verify changePasscode was called after the delay
+		expect(changePasscodeMock).toHaveBeenCalledWith({ force: false });
+	});
+
+	it('should handle authentication cancellation gracefully', async () => {
+		const handleLocalAuthenticationMock = localAuthentication.handleLocalAuthentication as jest.Mock;
+		const changePasscodeMock = localAuthentication.changePasscode as jest.Mock;
+
+		// Simulate user canceling authentication
+		handleLocalAuthenticationMock.mockRejectedValue(new Error('Authentication cancelled'));
+
+		// Simulate the flow with error handling
+		const simulatePasscodeChange = async (autoLock: boolean) => {
+			if (autoLock) {
+				try {
+					await handleLocalAuthenticationMock(true);
+					await new Promise(resolve => setTimeout(resolve, 300));
+				} catch {
+					// User cancelled - should return early
+					return;
+				}
+			}
+			await changePasscodeMock({ force: false });
+		};
+
+		await simulatePasscodeChange(true);
+
+		// Verify handleLocalAuthentication was called
+		expect(handleLocalAuthenticationMock).toHaveBeenCalledWith(true);
+
+		// Verify that changePasscode was NOT called when authentication fails
+		expect(changePasscodeMock).not.toHaveBeenCalled();
+	});
+
+	it('should proceed directly to passcode change when autoLock is disabled', async () => {
+		const handleLocalAuthenticationMock = localAuthentication.handleLocalAuthentication as jest.Mock;
+		const changePasscodeMock = localAuthentication.changePasscode as jest.Mock;
+
+		changePasscodeMock.mockResolvedValue(undefined);
+
+		// Simulate the flow without authentication
+		const simulatePasscodeChange = async (autoLock: boolean) => {
+			if (autoLock) {
+				try {
+					await handleLocalAuthenticationMock(true);
+					await new Promise(resolve => setTimeout(resolve, 300));
+				} catch {
+					return;
+				}
+			}
+			await changePasscodeMock({ force: false });
+		};
+
+		await simulatePasscodeChange(false);
+
+		// Verify handleLocalAuthentication was NOT called
+		expect(handleLocalAuthenticationMock).not.toHaveBeenCalled();
+
+		// Verify changePasscode was called directly
+		expect(changePasscodeMock).toHaveBeenCalledWith({ force: false });
+	});
+
+	it('should use 300ms as the delay duration', () => {
+		const delay = 300;
+
+		// Create a promise that resolves after the delay
+		const delayPromise = new Promise(resolve => setTimeout(resolve, delay));
+
+		// Advance timers by exactly 300ms
+		jest.advanceTimersByTime(delay);
+
+		// The promise should resolve
+		return expect(delayPromise).resolves.toBeUndefined();
+	});
+});

app/views/ScreenLockConfigView.tsx

@@ -132,7 +132,15 @@ class ScreenLockConfigView extends React.Component<IScreenLockConfigViewProps, I
 	changePasscode = async ({ force }: { force: boolean }) => {
 		const { autoLock } = this.state;
 		if (autoLock) {
-			await handleLocalAuthentication(true);
+			try {
+				await handleLocalAuthentication(true);
+				// Add a small delay to ensure the first modal is fully closed before opening the next one
+				// This prevents the app from hanging on iOS when two modals open back-to-back
+				await new Promise(resolve => setTimeout(resolve, 300));
+			} catch {
+				// User cancelled or authentication failed
+				return;
+			}
 		}
 		logEvent(events.SLC_CHANGE_PASSCODE);
 		await changePasscode({ force });

app/views/SecurityPrivacyView.tsx

@@ -59,7 +59,14 @@ const SecurityPrivacyView = ({ navigation }: ISecurityPrivacyViewProps): JSX.Ele
 
 	const navigateToScreenLockConfigView = async () => {
 		if (server?.autoLock) {
-			await handleLocalAuthentication(true);
+			try {
+				await handleLocalAuthentication(true);
+				// Add a small delay to prevent modal conflicts on iOS
+				await new Promise(resolve => setTimeout(resolve, 300));
+			} catch {
+				// User cancelled or authentication failed
+				return;
+			}
 		}
 		navigateToScreen('ScreenLockConfigView');
 	};