Claude/edit person bio view kq js x

app/App.tsx

@@ -19,6 +19,27 @@ import { ErrorBoundary } from './src/components/ErrorBoundary';
 // Keep splash visible while we load
 SplashScreen.preventAutoHideAsync();
 
+/** Deep linking configuration for scripture:// URLs. */
+const linking = {
+ prefixes: ['scripture://'],
+ config: {
+ screens: {
+ HomeTab: {
+ screens: {
+ Chapter: 'book/:bookId/:chapterNum',
+ },
+ },
+ ExploreTab: {
+ screens: {
+ GenealogyTree: 'people/:personId',
+ Map: 'map',
+ Timeline: 'timeline',
+ },
+ },
+ },
+ },
+};
+
 /** Inner app shell — consumes theme context for nav theme + status bar. */
 function AppShell() {
  const { base: themeBase, mode, statusBarStyle } = useTheme();
@@ -40,7 +61,7 @@ function AppShell() {
 
  return (
  <>
- <NavigationContainer theme={navTheme}>
+ <NavigationContainer theme={navTheme} linking={linking}>
  <ErrorBoundary>
  <RootNavigator />
  </ErrorBoundary>

app/__tests__/hooks/useAvailableVoices.test.ts

@@ -0,0 +1,78 @@
+import { renderHook, waitFor } from '@testing-library/react-native';
+
+const mockGetAvailableVoicesAsync = jest.fn();
+
+jest.mock('expo-speech', () => ({
+ getAvailableVoicesAsync: (...args: any[]) => mockGetAvailableVoicesAsync(...args),
+}));
+
+// Must unmock the hook itself since jest.setup.js mocks it globally
+jest.unmock('@/hooks/useAvailableVoices');
+
+import { useAvailableVoices } from '@/hooks/useAvailableVoices';
+
+describe('useAvailableVoices', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ mockGetAvailableVoicesAsync.mockResolvedValue([]);
+ });
+
+ it('starts with an empty array', () => {
+ const { result } = renderHook(() => useAvailableVoices());
+ expect(result.current).toEqual([]);
+ });
+
+ it('loads English voices from device', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'voice-1', name: 'Samantha', language: 'en-US' },
+ { identifier: 'voice-2', name: 'Daniel', language: 'en-GB' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(2);
+ });
+
+ expect(result.current[0].name).toBe('Daniel');
+ expect(result.current[1].name).toBe('Samantha');
+ });
+
+ it('filters out non-English voices', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'voice-1', name: 'Samantha', language: 'en-US' },
+ { identifier: 'voice-2', name: 'Marie', language: 'fr-FR' },
+ { identifier: 'voice-3', name: 'Hans', language: 'de-DE' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(1);
+ });
+
+ expect(result.current[0].name).toBe('Samantha');
+ });
+
+ it('sorts recommended voices first, then alphabetical', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'com.apple.voice.basic.en-US.Zoe', name: 'Zoe', language: 'en-US' },
+ { identifier: 'com.apple.voice.enhanced.en-US.Aaron', name: 'Aaron', language: 'en-US' },
+ { identifier: 'com.apple.voice.basic.en-US.Alex', name: 'Alex', language: 'en-US' },
+ { identifier: 'com.apple.voice.enhanced.en-US.Nathan', name: 'Nathan', language: 'en-US' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(4);
+ });
+
+ // Recommended voices (Aaron, Nathan) should come first
+ expect(result.current[0].name).toBe('Aaron');
+ expect(result.current[1].name).toBe('Nathan');
+ // Then alphabetical
+ expect(result.current[2].name).toBe('Alex');
+ expect(result.current[3].name).toBe('Zoe');
+ });
+});

app/__tests__/hooks/useScreenView.test.ts

@@ -0,0 +1,33 @@
+import { renderHook } from '@testing-library/react-native';
+
+const mockLogEvent = jest.fn();
+
+jest.mock('@/services/analytics', () => ({
+ logEvent: (...args: any[]) => mockLogEvent(...args),
+}));
+
+import { useScreenView } from '@/hooks/useScreenView';
+
+describe('useScreenView', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ });
+
+ it('logs screen_view event on focus with screen name', () => {
+ renderHook(() => useScreenView('HomeScreen'));
+
+ expect(mockLogEvent).toHaveBeenCalledWith('screen_view', { screen: 'HomeScreen' });
+ });
+
+ it('logs different screen names correctly', () => {
+ renderHook(() => useScreenView('ReaderScreen'));
+
+ expect(mockLogEvent).toHaveBeenCalledWith('screen_view', { screen: 'ReaderScreen' });
+ });
+
+ it('calls logEvent exactly once per mount', () => {
+ renderHook(() => useScreenView('Settings'));
+
+ expect(mockLogEvent).toHaveBeenCalledTimes(1);
+ });
+});

app/__tests__/hooks/useStoreReview.test.ts

@@ -0,0 +1,95 @@
+import { renderHook, act } from '@testing-library/react-native';
+
+const mockIsAvailableAsync = jest.fn();
+const mockRequestReview = jest.fn();
+
+jest.mock('expo-store-review', () => ({
+ isAvailableAsync: (...args: any[]) => mockIsAvailableAsync(...args),
+ requestReview: (...args: any[]) => mockRequestReview(...args),
+}));
+
+jest.mock('expo-constants', () => ({
+ expoConfig: { version: '2.0.0' },
+}));
+
+const mockGetPreference = jest.fn();
+const mockSetPreference = jest.fn();
+const mockGetReadingStats = jest.fn();
+
+jest.mock('@/db/user', () => ({
+ getPreference: (...args: any[]) => mockGetPreference(...args),
+ setPreference: (...args: any[]) => mockSetPreference(...args),
+ getReadingStats: (...args: any[]) => mockGetReadingStats(...args),
+}));
+
+import { useStoreReview } from '@/hooks/useStoreReview';
+
+describe('useStoreReview', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ jest.useFakeTimers();
+ mockIsAvailableAsync.mockResolvedValue(true);
+ mockRequestReview.mockResolvedValue(undefined);
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 0 });
+ mockGetPreference.mockResolvedValue(null);
+ });
+
+ afterEach(() => {
+ jest.useRealTimers();
+ });
+
+ it('does not prompt when fewer than 3 chapters read', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 2 });
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ });
+
+ it('does not prompt when already prompted for this version', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 10 });
+ mockGetPreference.mockResolvedValue('2.0.0');
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ jest.advanceTimersByTime(3000);
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ });
+
+ it('prompts for review when conditions are met', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 5 });
+ mockGetPreference.mockResolvedValue(null);
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ await act(async () => {
+ jest.advanceTimersByTime(2000);
+ });
+
+ expect(mockRequestReview).toHaveBeenCalled();
+ expect(mockSetPreference).toHaveBeenCalledWith('store_review_last_version', '2.0.0');
+ });
+
+ it('handles store review unavailable gracefully', async () => {
+ mockIsAvailableAsync.mockResolvedValue(false);
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 10 });
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ jest.advanceTimersByTime(3000);
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ expect(mockGetReadingStats).not.toHaveBeenCalled();
+ });
+});

app/__tests__/hooks/useTTS.test.ts

@@ -22,19 +22,19 @@ describe('useTTS', () => {
  expect(result.current.speed).toBe(1.0);
  });
 
- it('play sets isPlaying to true', () => {
+ it('play sets isPlaying to true', async () => {
  const { result } = renderHook(() => useTTS(mockVerses));
- act(() => {
- result.current.play();
+await act(async () => {
+await result.current.play();
  });
  expect(result.current.isPlaying).toBe(true);
  expect(Speech.speak).toHaveBeenCalled();
  });
 
- it('pause sets isPlaying to false and stops speech', () => {
+ it('pause sets isPlaying to false and stops speech', async () => {
  const { result } = renderHook(() => useTTS(mockVerses));
- act(() => {
- result.current.play();
+await act(async () => {
+await result.current.play();
  });
  act(() => {
  result.current.pause();

app/__tests__/screens/ForgotPasswordScreen.test.tsx

@@ -0,0 +1,61 @@
+import React from 'react';
+import { renderWithProviders } from '../helpers/renderWithProviders';
+import ForgotPasswordScreen from '@/screens/ForgotPasswordScreen';
+
+jest.mock('@/stores', () => ({
+ useSettingsStore: (sel: any) =>
+ sel({ translation: 'kjv', fontSize: 16, ttsVoice: '' }),
+ useAuthStore: (sel: any) =>
+ sel({
+ user: null,
+ isLoading: false,
+ signInWithEmail: jest.fn(),
+ signUpWithEmail: jest.fn(),
+ signInWithGoogle: jest.fn(),
+ signInWithFacebook: jest.fn(),
+ resetPassword: jest.fn(),
+ }),
+}));
+
+const mockNavigate = jest.fn();
+const mockGoBack = jest.fn();
+jest.mock('@react-navigation/native', () => ({
+ ...jest.requireActual('@react-navigation/native'),
+ useNavigation: () => ({ navigate: mockNavigate, goBack: mockGoBack }),
+}));
+
+describe('ForgotPasswordScreen', () => {
+ beforeEach(() => jest.clearAllMocks());
+
+ it('renders without crashing', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Reset Password')).toBeTruthy();
+ });
+
+ it('shows Reset Password heading', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Reset Password')).toBeTruthy();
+ });
+
+ it('shows email input', () => {
+ const { getByPlaceholderText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByPlaceholderText('Email')).toBeTruthy();
+ });
+
+ it('shows Send Reset Link button', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Send Reset Link')).toBeTruthy();
+ });
+
+ it('shows explanatory text', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(
+ getByText(/Enter your email and we'll send you a link to reset your password/),
+ ).toBeTruthy();
+ });
+
+ it('shows Back to Sign In link', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Back to Sign In')).toBeTruthy();
+ });
+});

app/App.tsx

@@ -19,6 +19,27 @@ import { ErrorBoundary } from './src/components/ErrorBoundary';
 // Keep splash visible while we load
 SplashScreen.preventAutoHideAsync();
 
+/** Deep linking configuration for scripture:// URLs. */
+const linking = {
+ prefixes: ['scripture://'],
+ config: {
+ screens: {
+ HomeTab: {
+ screens: {
+ Chapter: 'book/:bookId/:chapterNum',
+ },
+ },
+ ExploreTab: {
+ screens: {
+ GenealogyTree: 'people/:personId',
+ Map: 'map',
+ Timeline: 'timeline',
+ },
+ },
+ },
+ },
+};
+
 /** Inner app shell — consumes theme context for nav theme + status bar. */
 function AppShell() {
  const { base: themeBase, mode, statusBarStyle } = useTheme();
@@ -40,7 +61,7 @@ function AppShell() {
 
  return (
  <>
- <NavigationContainer theme={navTheme}>
+ <NavigationContainer theme={navTheme} linking={linking}>
  <ErrorBoundary>
  <RootNavigator />
  </ErrorBoundary>

app/__tests__/hooks/useAvailableVoices.test.ts

@@ -0,0 +1,78 @@
+import { renderHook, waitFor } from '@testing-library/react-native';
+
+const mockGetAvailableVoicesAsync = jest.fn();
+
+jest.mock('expo-speech', () => ({
+ getAvailableVoicesAsync: (...args: any[]) => mockGetAvailableVoicesAsync(...args),
+}));
+
+// Must unmock the hook itself since jest.setup.js mocks it globally
+jest.unmock('@/hooks/useAvailableVoices');
+
+import { useAvailableVoices } from '@/hooks/useAvailableVoices';
+
+describe('useAvailableVoices', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ mockGetAvailableVoicesAsync.mockResolvedValue([]);
+ });
+
+ it('starts with an empty array', () => {
+ const { result } = renderHook(() => useAvailableVoices());
+ expect(result.current).toEqual([]);
+ });
+
+ it('loads English voices from device', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'voice-1', name: 'Samantha', language: 'en-US' },
+ { identifier: 'voice-2', name: 'Daniel', language: 'en-GB' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(2);
+ });
+
+ expect(result.current[0].name).toBe('Daniel');
+ expect(result.current[1].name).toBe('Samantha');
+ });
+
+ it('filters out non-English voices', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'voice-1', name: 'Samantha', language: 'en-US' },
+ { identifier: 'voice-2', name: 'Marie', language: 'fr-FR' },
+ { identifier: 'voice-3', name: 'Hans', language: 'de-DE' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(1);
+ });
+
+ expect(result.current[0].name).toBe('Samantha');
+ });
+
+ it('sorts recommended voices first, then alphabetical', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'com.apple.voice.basic.en-US.Zoe', name: 'Zoe', language: 'en-US' },
+ { identifier: 'com.apple.voice.enhanced.en-US.Aaron', name: 'Aaron', language: 'en-US' },
+ { identifier: 'com.apple.voice.basic.en-US.Alex', name: 'Alex', language: 'en-US' },
+ { identifier: 'com.apple.voice.enhanced.en-US.Nathan', name: 'Nathan', language: 'en-US' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(4);
+ });
+
+ // Recommended voices (Aaron, Nathan) should come first
+ expect(result.current[0].name).toBe('Aaron');
+ expect(result.current[1].name).toBe('Nathan');
+ // Then alphabetical
+ expect(result.current[2].name).toBe('Alex');
+ expect(result.current[3].name).toBe('Zoe');
+ });
+});

app/__tests__/hooks/useScreenView.test.ts

@@ -0,0 +1,33 @@
+import { renderHook } from '@testing-library/react-native';
+
+const mockLogEvent = jest.fn();
+
+jest.mock('@/services/analytics', () => ({
+ logEvent: (...args: any[]) => mockLogEvent(...args),
+}));
+
+import { useScreenView } from '@/hooks/useScreenView';
+
+describe('useScreenView', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ });
+
+ it('logs screen_view event on focus with screen name', () => {
+ renderHook(() => useScreenView('HomeScreen'));
+
+ expect(mockLogEvent).toHaveBeenCalledWith('screen_view', { screen: 'HomeScreen' });
+ });
+
+ it('logs different screen names correctly', () => {
+ renderHook(() => useScreenView('ReaderScreen'));
+
+ expect(mockLogEvent).toHaveBeenCalledWith('screen_view', { screen: 'ReaderScreen' });
+ });
+
+ it('calls logEvent exactly once per mount', () => {
+ renderHook(() => useScreenView('Settings'));
+
+ expect(mockLogEvent).toHaveBeenCalledTimes(1);
+ });
+});

app/__tests__/hooks/useStoreReview.test.ts

@@ -0,0 +1,95 @@
+import { renderHook, act } from '@testing-library/react-native';
+
+const mockIsAvailableAsync = jest.fn();
+const mockRequestReview = jest.fn();
+
+jest.mock('expo-store-review', () => ({
+ isAvailableAsync: (...args: any[]) => mockIsAvailableAsync(...args),
+ requestReview: (...args: any[]) => mockRequestReview(...args),
+}));
+
+jest.mock('expo-constants', () => ({
+ expoConfig: { version: '2.0.0' },
+}));
+
+const mockGetPreference = jest.fn();
+const mockSetPreference = jest.fn();
+const mockGetReadingStats = jest.fn();
+
+jest.mock('@/db/user', () => ({
+ getPreference: (...args: any[]) => mockGetPreference(...args),
+ setPreference: (...args: any[]) => mockSetPreference(...args),
+ getReadingStats: (...args: any[]) => mockGetReadingStats(...args),
+}));
+
+import { useStoreReview } from '@/hooks/useStoreReview';
+
+describe('useStoreReview', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ jest.useFakeTimers();
+ mockIsAvailableAsync.mockResolvedValue(true);
+ mockRequestReview.mockResolvedValue(undefined);
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 0 });
+ mockGetPreference.mockResolvedValue(null);
+ });
+
+ afterEach(() => {
+ jest.useRealTimers();
+ });
+
+ it('does not prompt when fewer than 3 chapters read', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 2 });
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ });
+
+ it('does not prompt when already prompted for this version', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 10 });
+ mockGetPreference.mockResolvedValue('2.0.0');
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ jest.advanceTimersByTime(3000);
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ });
+
+ it('prompts for review when conditions are met', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 5 });
+ mockGetPreference.mockResolvedValue(null);
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ await act(async () => {
+ jest.advanceTimersByTime(2000);
+ });
+
+ expect(mockRequestReview).toHaveBeenCalled();
+ expect(mockSetPreference).toHaveBeenCalledWith('store_review_last_version', '2.0.0');
+ });
+
+ it('handles store review unavailable gracefully', async () => {
+ mockIsAvailableAsync.mockResolvedValue(false);
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 10 });
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ jest.advanceTimersByTime(3000);
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ expect(mockGetReadingStats).not.toHaveBeenCalled();
+ });
+});

app/__tests__/hooks/useTTS.test.ts

@@ -22,19 +22,19 @@ describe('useTTS', () => {
  expect(result.current.speed).toBe(1.0);
  });
 
- it('play sets isPlaying to true', () => {
+ it('play sets isPlaying to true', async () => {
  const { result } = renderHook(() => useTTS(mockVerses));
- act(() => {
- result.current.play();
+await act(async () => {
+await result.current.play();
  });
  expect(result.current.isPlaying).toBe(true);
  expect(Speech.speak).toHaveBeenCalled();
  });
 
- it('pause sets isPlaying to false and stops speech', () => {
+ it('pause sets isPlaying to false and stops speech', async () => {
  const { result } = renderHook(() => useTTS(mockVerses));
- act(() => {
- result.current.play();
+await act(async () => {
+await result.current.play();
  });
  act(() => {
  result.current.pause();

app/__tests__/screens/ForgotPasswordScreen.test.tsx

@@ -0,0 +1,61 @@
+import React from 'react';
+import { renderWithProviders } from '../helpers/renderWithProviders';
+import ForgotPasswordScreen from '@/screens/ForgotPasswordScreen';
+
+jest.mock('@/stores', () => ({
+ useSettingsStore: (sel: any) =>
+ sel({ translation: 'kjv', fontSize: 16, ttsVoice: '' }),
+ useAuthStore: (sel: any) =>
+ sel({
+ user: null,
+ isLoading: false,
+ signInWithEmail: jest.fn(),
+ signUpWithEmail: jest.fn(),
+ signInWithGoogle: jest.fn(),
+ signInWithFacebook: jest.fn(),
+ resetPassword: jest.fn(),
+ }),
+}));
+
+const mockNavigate = jest.fn();
+const mockGoBack = jest.fn();
+jest.mock('@react-navigation/native', () => ({
+ ...jest.requireActual('@react-navigation/native'),
+ useNavigation: () => ({ navigate: mockNavigate, goBack: mockGoBack }),
+}));
+
+describe('ForgotPasswordScreen', () => {
+ beforeEach(() => jest.clearAllMocks());
+
+ it('renders without crashing', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Reset Password')).toBeTruthy();
+ });
+
+ it('shows Reset Password heading', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Reset Password')).toBeTruthy();
+ });
+
+ it('shows email input', () => {
+ const { getByPlaceholderText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByPlaceholderText('Email')).toBeTruthy();
+ });
+
+ it('shows Send Reset Link button', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Send Reset Link')).toBeTruthy();
+ });
+
+ it('shows explanatory text', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(
+ getByText(/Enter your email and we'll send you a link to reset your password/),
+ ).toBeTruthy();
+ });
+
+ it('shows Back to Sign In link', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Back to Sign In')).toBeTruthy();
+ });
+});

app/App.tsx

@@ -19,6 +19,27 @@ import { ErrorBoundary } from './src/components/ErrorBoundary';
 // Keep splash visible while we load
 SplashScreen.preventAutoHideAsync();
 
+/** Deep linking configuration for scripture:// URLs. */
+const linking = {
+ prefixes: ['scripture://'],
+ config: {
+ screens: {
+ HomeTab: {
+ screens: {
+ Chapter: 'book/:bookId/:chapterNum',
+ },
+ },
+ ExploreTab: {
+ screens: {
+ GenealogyTree: 'people/:personId',
+ Map: 'map',
+ Timeline: 'timeline',
+ },
+ },
+ },
+ },
+};
+
 /** Inner app shell — consumes theme context for nav theme + status bar. */
 function AppShell() {
  const { base: themeBase, mode, statusBarStyle } = useTheme();
@@ -40,7 +61,7 @@ function AppShell() {
 
  return (
  <>
- <NavigationContainer theme={navTheme}>
+ <NavigationContainer theme={navTheme} linking={linking}>
  <ErrorBoundary>
  <RootNavigator />
  </ErrorBoundary>

app/__tests__/hooks/useAvailableVoices.test.ts

@@ -0,0 +1,78 @@
+import { renderHook, waitFor } from '@testing-library/react-native';
+
+const mockGetAvailableVoicesAsync = jest.fn();
+
+jest.mock('expo-speech', () => ({
+ getAvailableVoicesAsync: (...args: any[]) => mockGetAvailableVoicesAsync(...args),
+}));
+
+// Must unmock the hook itself since jest.setup.js mocks it globally
+jest.unmock('@/hooks/useAvailableVoices');
+
+import { useAvailableVoices } from '@/hooks/useAvailableVoices';
+
+describe('useAvailableVoices', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ mockGetAvailableVoicesAsync.mockResolvedValue([]);
+ });
+
+ it('starts with an empty array', () => {
+ const { result } = renderHook(() => useAvailableVoices());
+ expect(result.current).toEqual([]);
+ });
+
+ it('loads English voices from device', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'voice-1', name: 'Samantha', language: 'en-US' },
+ { identifier: 'voice-2', name: 'Daniel', language: 'en-GB' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(2);
+ });
+
+ expect(result.current[0].name).toBe('Daniel');
+ expect(result.current[1].name).toBe('Samantha');
+ });
+
+ it('filters out non-English voices', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'voice-1', name: 'Samantha', language: 'en-US' },
+ { identifier: 'voice-2', name: 'Marie', language: 'fr-FR' },
+ { identifier: 'voice-3', name: 'Hans', language: 'de-DE' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(1);
+ });
+
+ expect(result.current[0].name).toBe('Samantha');
+ });
+
+ it('sorts recommended voices first, then alphabetical', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'com.apple.voice.basic.en-US.Zoe', name: 'Zoe', language: 'en-US' },
+ { identifier: 'com.apple.voice.enhanced.en-US.Aaron', name: 'Aaron', language: 'en-US' },
+ { identifier: 'com.apple.voice.basic.en-US.Alex', name: 'Alex', language: 'en-US' },
+ { identifier: 'com.apple.voice.enhanced.en-US.Nathan', name: 'Nathan', language: 'en-US' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(4);
+ });
+
+ // Recommended voices (Aaron, Nathan) should come first
+ expect(result.current[0].name).toBe('Aaron');
+ expect(result.current[1].name).toBe('Nathan');
+ // Then alphabetical
+ expect(result.current[2].name).toBe('Alex');
+ expect(result.current[3].name).toBe('Zoe');
+ });
+});

app/__tests__/hooks/useScreenView.test.ts

@@ -0,0 +1,33 @@
+import { renderHook } from '@testing-library/react-native';
+
+const mockLogEvent = jest.fn();
+
+jest.mock('@/services/analytics', () => ({
+ logEvent: (...args: any[]) => mockLogEvent(...args),
+}));
+
+import { useScreenView } from '@/hooks/useScreenView';
+
+describe('useScreenView', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ });
+
+ it('logs screen_view event on focus with screen name', () => {
+ renderHook(() => useScreenView('HomeScreen'));
+
+ expect(mockLogEvent).toHaveBeenCalledWith('screen_view', { screen: 'HomeScreen' });
+ });
+
+ it('logs different screen names correctly', () => {
+ renderHook(() => useScreenView('ReaderScreen'));
+
+ expect(mockLogEvent).toHaveBeenCalledWith('screen_view', { screen: 'ReaderScreen' });
+ });
+
+ it('calls logEvent exactly once per mount', () => {
+ renderHook(() => useScreenView('Settings'));
+
+ expect(mockLogEvent).toHaveBeenCalledTimes(1);
+ });
+});

app/__tests__/hooks/useStoreReview.test.ts

@@ -0,0 +1,95 @@
+import { renderHook, act } from '@testing-library/react-native';
+
+const mockIsAvailableAsync = jest.fn();
+const mockRequestReview = jest.fn();
+
+jest.mock('expo-store-review', () => ({
+ isAvailableAsync: (...args: any[]) => mockIsAvailableAsync(...args),
+ requestReview: (...args: any[]) => mockRequestReview(...args),
+}));
+
+jest.mock('expo-constants', () => ({
+ expoConfig: { version: '2.0.0' },
+}));
+
+const mockGetPreference = jest.fn();
+const mockSetPreference = jest.fn();
+const mockGetReadingStats = jest.fn();
+
+jest.mock('@/db/user', () => ({
+ getPreference: (...args: any[]) => mockGetPreference(...args),
+ setPreference: (...args: any[]) => mockSetPreference(...args),
+ getReadingStats: (...args: any[]) => mockGetReadingStats(...args),
+}));
+
+import { useStoreReview } from '@/hooks/useStoreReview';
+
+describe('useStoreReview', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ jest.useFakeTimers();
+ mockIsAvailableAsync.mockResolvedValue(true);
+ mockRequestReview.mockResolvedValue(undefined);
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 0 });
+ mockGetPreference.mockResolvedValue(null);
+ });
+
+ afterEach(() => {
+ jest.useRealTimers();
+ });
+
+ it('does not prompt when fewer than 3 chapters read', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 2 });
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ });
+
+ it('does not prompt when already prompted for this version', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 10 });
+ mockGetPreference.mockResolvedValue('2.0.0');
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ jest.advanceTimersByTime(3000);
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ });
+
+ it('prompts for review when conditions are met', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 5 });
+ mockGetPreference.mockResolvedValue(null);
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ await act(async () => {
+ jest.advanceTimersByTime(2000);
+ });
+
+ expect(mockRequestReview).toHaveBeenCalled();
+ expect(mockSetPreference).toHaveBeenCalledWith('store_review_last_version', '2.0.0');
+ });
+
+ it('handles store review unavailable gracefully', async () => {
+ mockIsAvailableAsync.mockResolvedValue(false);
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 10 });
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ jest.advanceTimersByTime(3000);
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ expect(mockGetReadingStats).not.toHaveBeenCalled();
+ });
+});

app/__tests__/hooks/useTTS.test.ts

@@ -22,19 +22,19 @@ describe('useTTS', () => {
  expect(result.current.speed).toBe(1.0);
  });
 
- it('play sets isPlaying to true', () => {
+ it('play sets isPlaying to true', async () => {
  const { result } = renderHook(() => useTTS(mockVerses));
- act(() => {
- result.current.play();
+await act(async () => {
+await result.current.play();
  });
  expect(result.current.isPlaying).toBe(true);
  expect(Speech.speak).toHaveBeenCalled();
  });
 
- it('pause sets isPlaying to false and stops speech', () => {
+ it('pause sets isPlaying to false and stops speech', async () => {
  const { result } = renderHook(() => useTTS(mockVerses));
- act(() => {
- result.current.play();
+await act(async () => {
+await result.current.play();
  });
  act(() => {
  result.current.pause();

app/__tests__/screens/ForgotPasswordScreen.test.tsx

@@ -0,0 +1,61 @@
+import React from 'react';
+import { renderWithProviders } from '../helpers/renderWithProviders';
+import ForgotPasswordScreen from '@/screens/ForgotPasswordScreen';
+
+jest.mock('@/stores', () => ({
+ useSettingsStore: (sel: any) =>
+ sel({ translation: 'kjv', fontSize: 16, ttsVoice: '' }),
+ useAuthStore: (sel: any) =>
+ sel({
+ user: null,
+ isLoading: false,
+ signInWithEmail: jest.fn(),
+ signUpWithEmail: jest.fn(),
+ signInWithGoogle: jest.fn(),
+ signInWithFacebook: jest.fn(),
+ resetPassword: jest.fn(),
+ }),
+}));
+
+const mockNavigate = jest.fn();
+const mockGoBack = jest.fn();
+jest.mock('@react-navigation/native', () => ({
+ ...jest.requireActual('@react-navigation/native'),
+ useNavigation: () => ({ navigate: mockNavigate, goBack: mockGoBack }),
+}));
+
+describe('ForgotPasswordScreen', () => {
+ beforeEach(() => jest.clearAllMocks());
+
+ it('renders without crashing', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Reset Password')).toBeTruthy();
+ });
+
+ it('shows Reset Password heading', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Reset Password')).toBeTruthy();
+ });
+
+ it('shows email input', () => {
+ const { getByPlaceholderText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByPlaceholderText('Email')).toBeTruthy();
+ });
+
+ it('shows Send Reset Link button', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Send Reset Link')).toBeTruthy();
+ });
+
+ it('shows explanatory text', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(
+ getByText(/Enter your email and we'll send you a link to reset your password/),
+ ).toBeTruthy();
+ });
+
+ it('shows Back to Sign In link', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Back to Sign In')).toBeTruthy();
+ });
+});

app/App.tsx

@@ -19,6 +19,27 @@ import { ErrorBoundary } from './src/components/ErrorBoundary';
 // Keep splash visible while we load
 SplashScreen.preventAutoHideAsync();
 
+/** Deep linking configuration for scripture:// URLs. */
+const linking = {
+ prefixes: ['scripture://'],
+ config: {
+ screens: {
+ HomeTab: {
+ screens: {
+ Chapter: 'book/:bookId/:chapterNum',
+ },
+ },
+ ExploreTab: {
+ screens: {
+ GenealogyTree: 'people/:personId',
+ Map: 'map',
+ Timeline: 'timeline',
+ },
+ },
+ },
+ },
+};
+
 /** Inner app shell — consumes theme context for nav theme + status bar. */
 function AppShell() {
  const { base: themeBase, mode, statusBarStyle } = useTheme();
@@ -40,7 +61,7 @@ function AppShell() {
 
  return (
  <>
- <NavigationContainer theme={navTheme}>
+ <NavigationContainer theme={navTheme} linking={linking}>
  <ErrorBoundary>
  <RootNavigator />
  </ErrorBoundary>

app/__tests__/hooks/useAvailableVoices.test.ts

@@ -0,0 +1,78 @@
+import { renderHook, waitFor } from '@testing-library/react-native';
+
+const mockGetAvailableVoicesAsync = jest.fn();
+
+jest.mock('expo-speech', () => ({
+ getAvailableVoicesAsync: (...args: any[]) => mockGetAvailableVoicesAsync(...args),
+}));
+
+// Must unmock the hook itself since jest.setup.js mocks it globally
+jest.unmock('@/hooks/useAvailableVoices');
+
+import { useAvailableVoices } from '@/hooks/useAvailableVoices';
+
+describe('useAvailableVoices', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ mockGetAvailableVoicesAsync.mockResolvedValue([]);
+ });
+
+ it('starts with an empty array', () => {
+ const { result } = renderHook(() => useAvailableVoices());
+ expect(result.current).toEqual([]);
+ });
+
+ it('loads English voices from device', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'voice-1', name: 'Samantha', language: 'en-US' },
+ { identifier: 'voice-2', name: 'Daniel', language: 'en-GB' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(2);
+ });
+
+ expect(result.current[0].name).toBe('Daniel');
+ expect(result.current[1].name).toBe('Samantha');
+ });
+
+ it('filters out non-English voices', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'voice-1', name: 'Samantha', language: 'en-US' },
+ { identifier: 'voice-2', name: 'Marie', language: 'fr-FR' },
+ { identifier: 'voice-3', name: 'Hans', language: 'de-DE' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(1);
+ });
+
+ expect(result.current[0].name).toBe('Samantha');
+ });
+
+ it('sorts recommended voices first, then alphabetical', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'com.apple.voice.basic.en-US.Zoe', name: 'Zoe', language: 'en-US' },
+ { identifier: 'com.apple.voice.enhanced.en-US.Aaron', name: 'Aaron', language: 'en-US' },
+ { identifier: 'com.apple.voice.basic.en-US.Alex', name: 'Alex', language: 'en-US' },
+ { identifier: 'com.apple.voice.enhanced.en-US.Nathan', name: 'Nathan', language: 'en-US' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(4);
+ });
+
+ // Recommended voices (Aaron, Nathan) should come first
+ expect(result.current[0].name).toBe('Aaron');
+ expect(result.current[1].name).toBe('Nathan');
+ // Then alphabetical
+ expect(result.current[2].name).toBe('Alex');
+ expect(result.current[3].name).toBe('Zoe');
+ });
+});

app/__tests__/hooks/useScreenView.test.ts

@@ -0,0 +1,33 @@
+import { renderHook } from '@testing-library/react-native';
+
+const mockLogEvent = jest.fn();
+
+jest.mock('@/services/analytics', () => ({
+ logEvent: (...args: any[]) => mockLogEvent(...args),
+}));
+
+import { useScreenView } from '@/hooks/useScreenView';
+
+describe('useScreenView', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ });
+
+ it('logs screen_view event on focus with screen name', () => {
+ renderHook(() => useScreenView('HomeScreen'));
+
+ expect(mockLogEvent).toHaveBeenCalledWith('screen_view', { screen: 'HomeScreen' });
+ });
+
+ it('logs different screen names correctly', () => {
+ renderHook(() => useScreenView('ReaderScreen'));
+
+ expect(mockLogEvent).toHaveBeenCalledWith('screen_view', { screen: 'ReaderScreen' });
+ });
+
+ it('calls logEvent exactly once per mount', () => {
+ renderHook(() => useScreenView('Settings'));
+
+ expect(mockLogEvent).toHaveBeenCalledTimes(1);
+ });
+});

app/__tests__/hooks/useStoreReview.test.ts

@@ -0,0 +1,95 @@
+import { renderHook, act } from '@testing-library/react-native';
+
+const mockIsAvailableAsync = jest.fn();
+const mockRequestReview = jest.fn();
+
+jest.mock('expo-store-review', () => ({
+ isAvailableAsync: (...args: any[]) => mockIsAvailableAsync(...args),
+ requestReview: (...args: any[]) => mockRequestReview(...args),
+}));
+
+jest.mock('expo-constants', () => ({
+ expoConfig: { version: '2.0.0' },
+}));
+
+const mockGetPreference = jest.fn();
+const mockSetPreference = jest.fn();
+const mockGetReadingStats = jest.fn();
+
+jest.mock('@/db/user', () => ({
+ getPreference: (...args: any[]) => mockGetPreference(...args),
+ setPreference: (...args: any[]) => mockSetPreference(...args),
+ getReadingStats: (...args: any[]) => mockGetReadingStats(...args),
+}));
+
+import { useStoreReview } from '@/hooks/useStoreReview';
+
+describe('useStoreReview', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ jest.useFakeTimers();
+ mockIsAvailableAsync.mockResolvedValue(true);
+ mockRequestReview.mockResolvedValue(undefined);
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 0 });
+ mockGetPreference.mockResolvedValue(null);
+ });
+
+ afterEach(() => {
+ jest.useRealTimers();
+ });
+
+ it('does not prompt when fewer than 3 chapters read', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 2 });
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ });
+
+ it('does not prompt when already prompted for this version', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 10 });
+ mockGetPreference.mockResolvedValue('2.0.0');
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ jest.advanceTimersByTime(3000);
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ });
+
+ it('prompts for review when conditions are met', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 5 });
+ mockGetPreference.mockResolvedValue(null);
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ await act(async () => {
+ jest.advanceTimersByTime(2000);
+ });
+
+ expect(mockRequestReview).toHaveBeenCalled();
+ expect(mockSetPreference).toHaveBeenCalledWith('store_review_last_version', '2.0.0');
+ });
+
+ it('handles store review unavailable gracefully', async () => {
+ mockIsAvailableAsync.mockResolvedValue(false);
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 10 });
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ jest.advanceTimersByTime(3000);
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ expect(mockGetReadingStats).not.toHaveBeenCalled();
+ });
+});

app/__tests__/hooks/useTTS.test.ts

@@ -22,19 +22,19 @@ describe('useTTS', () => {
  expect(result.current.speed).toBe(1.0);
  });
 
- it('play sets isPlaying to true', () => {
+ it('play sets isPlaying to true', async () => {
  const { result } = renderHook(() => useTTS(mockVerses));
- act(() => {
- result.current.play();
+await act(async () => {
+await result.current.play();
  });
  expect(result.current.isPlaying).toBe(true);
  expect(Speech.speak).toHaveBeenCalled();
  });
 
- it('pause sets isPlaying to false and stops speech', () => {
+ it('pause sets isPlaying to false and stops speech', async () => {
  const { result } = renderHook(() => useTTS(mockVerses));
- act(() => {
- result.current.play();
+await act(async () => {
+await result.current.play();
  });
  act(() => {
  result.current.pause();

app/__tests__/screens/ForgotPasswordScreen.test.tsx

@@ -0,0 +1,61 @@
+import React from 'react';
+import { renderWithProviders } from '../helpers/renderWithProviders';
+import ForgotPasswordScreen from '@/screens/ForgotPasswordScreen';
+
+jest.mock('@/stores', () => ({
+ useSettingsStore: (sel: any) =>
+ sel({ translation: 'kjv', fontSize: 16, ttsVoice: '' }),
+ useAuthStore: (sel: any) =>
+ sel({
+ user: null,
+ isLoading: false,
+ signInWithEmail: jest.fn(),
+ signUpWithEmail: jest.fn(),
+ signInWithGoogle: jest.fn(),
+ signInWithFacebook: jest.fn(),
+ resetPassword: jest.fn(),
+ }),
+}));
+
+const mockNavigate = jest.fn();
+const mockGoBack = jest.fn();
+jest.mock('@react-navigation/native', () => ({
+ ...jest.requireActual('@react-navigation/native'),
+ useNavigation: () => ({ navigate: mockNavigate, goBack: mockGoBack }),
+}));
+
+describe('ForgotPasswordScreen', () => {
+ beforeEach(() => jest.clearAllMocks());
+
+ it('renders without crashing', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Reset Password')).toBeTruthy();
+ });
+
+ it('shows Reset Password heading', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Reset Password')).toBeTruthy();
+ });
+
+ it('shows email input', () => {
+ const { getByPlaceholderText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByPlaceholderText('Email')).toBeTruthy();
+ });
+
+ it('shows Send Reset Link button', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Send Reset Link')).toBeTruthy();
+ });
+
+ it('shows explanatory text', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(
+ getByText(/Enter your email and we'll send you a link to reset your password/),
+ ).toBeTruthy();
+ });
+
+ it('shows Back to Sign In link', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Back to Sign In')).toBeTruthy();
+ });
+});

app/App.tsx

@@ -19,6 +19,27 @@ import { ErrorBoundary } from './src/components/ErrorBoundary';
 // Keep splash visible while we load
 SplashScreen.preventAutoHideAsync();
 
+/** Deep linking configuration for scripture:// URLs. */
+const linking = {
+ prefixes: ['scripture://'],
+ config: {
+ screens: {
+ HomeTab: {
+ screens: {
+ Chapter: 'book/:bookId/:chapterNum',
+ },
+ },
+ ExploreTab: {
+ screens: {
+ GenealogyTree: 'people/:personId',
+ Map: 'map',
+ Timeline: 'timeline',
+ },
+ },
+ },
+ },
+};
+
 /** Inner app shell — consumes theme context for nav theme + status bar. */
 function AppShell() {
  const { base: themeBase, mode, statusBarStyle } = useTheme();
@@ -40,7 +61,7 @@ function AppShell() {
 
  return (
  <>
- <NavigationContainer theme={navTheme}>
+ <NavigationContainer theme={navTheme} linking={linking}>
  <ErrorBoundary>
  <RootNavigator />
  </ErrorBoundary>

app/__tests__/hooks/useAvailableVoices.test.ts

@@ -0,0 +1,78 @@
+import { renderHook, waitFor } from '@testing-library/react-native';
+
+const mockGetAvailableVoicesAsync = jest.fn();
+
+jest.mock('expo-speech', () => ({
+ getAvailableVoicesAsync: (...args: any[]) => mockGetAvailableVoicesAsync(...args),
+}));
+
+// Must unmock the hook itself since jest.setup.js mocks it globally
+jest.unmock('@/hooks/useAvailableVoices');
+
+import { useAvailableVoices } from '@/hooks/useAvailableVoices';
+
+describe('useAvailableVoices', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ mockGetAvailableVoicesAsync.mockResolvedValue([]);
+ });
+
+ it('starts with an empty array', () => {
+ const { result } = renderHook(() => useAvailableVoices());
+ expect(result.current).toEqual([]);
+ });
+
+ it('loads English voices from device', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'voice-1', name: 'Samantha', language: 'en-US' },
+ { identifier: 'voice-2', name: 'Daniel', language: 'en-GB' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(2);
+ });
+
+ expect(result.current[0].name).toBe('Daniel');
+ expect(result.current[1].name).toBe('Samantha');
+ });
+
+ it('filters out non-English voices', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'voice-1', name: 'Samantha', language: 'en-US' },
+ { identifier: 'voice-2', name: 'Marie', language: 'fr-FR' },
+ { identifier: 'voice-3', name: 'Hans', language: 'de-DE' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(1);
+ });
+
+ expect(result.current[0].name).toBe('Samantha');
+ });
+
+ it('sorts recommended voices first, then alphabetical', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'com.apple.voice.basic.en-US.Zoe', name: 'Zoe', language: 'en-US' },
+ { identifier: 'com.apple.voice.enhanced.en-US.Aaron', name: 'Aaron', language: 'en-US' },
+ { identifier: 'com.apple.voice.basic.en-US.Alex', name: 'Alex', language: 'en-US' },
+ { identifier: 'com.apple.voice.enhanced.en-US.Nathan', name: 'Nathan', language: 'en-US' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(4);
+ });
+
+ // Recommended voices (Aaron, Nathan) should come first
+ expect(result.current[0].name).toBe('Aaron');
+ expect(result.current[1].name).toBe('Nathan');
+ // Then alphabetical
+ expect(result.current[2].name).toBe('Alex');
+ expect(result.current[3].name).toBe('Zoe');
+ });
+});

app/__tests__/hooks/useScreenView.test.ts

@@ -0,0 +1,33 @@
+import { renderHook } from '@testing-library/react-native';
+
+const mockLogEvent = jest.fn();
+
+jest.mock('@/services/analytics', () => ({
+ logEvent: (...args: any[]) => mockLogEvent(...args),
+}));
+
+import { useScreenView } from '@/hooks/useScreenView';
+
+describe('useScreenView', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ });
+
+ it('logs screen_view event on focus with screen name', () => {
+ renderHook(() => useScreenView('HomeScreen'));
+
+ expect(mockLogEvent).toHaveBeenCalledWith('screen_view', { screen: 'HomeScreen' });
+ });
+
+ it('logs different screen names correctly', () => {
+ renderHook(() => useScreenView('ReaderScreen'));
+
+ expect(mockLogEvent).toHaveBeenCalledWith('screen_view', { screen: 'ReaderScreen' });
+ });
+
+ it('calls logEvent exactly once per mount', () => {
+ renderHook(() => useScreenView('Settings'));
+
+ expect(mockLogEvent).toHaveBeenCalledTimes(1);
+ });
+});

app/__tests__/hooks/useStoreReview.test.ts

@@ -0,0 +1,95 @@
+import { renderHook, act } from '@testing-library/react-native';
+
+const mockIsAvailableAsync = jest.fn();
+const mockRequestReview = jest.fn();
+
+jest.mock('expo-store-review', () => ({
+ isAvailableAsync: (...args: any[]) => mockIsAvailableAsync(...args),
+ requestReview: (...args: any[]) => mockRequestReview(...args),
+}));
+
+jest.mock('expo-constants', () => ({
+ expoConfig: { version: '2.0.0' },
+}));
+
+const mockGetPreference = jest.fn();
+const mockSetPreference = jest.fn();
+const mockGetReadingStats = jest.fn();
+
+jest.mock('@/db/user', () => ({
+ getPreference: (...args: any[]) => mockGetPreference(...args),
+ setPreference: (...args: any[]) => mockSetPreference(...args),
+ getReadingStats: (...args: any[]) => mockGetReadingStats(...args),
+}));
+
+import { useStoreReview } from '@/hooks/useStoreReview';
+
+describe('useStoreReview', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ jest.useFakeTimers();
+ mockIsAvailableAsync.mockResolvedValue(true);
+ mockRequestReview.mockResolvedValue(undefined);
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 0 });
+ mockGetPreference.mockResolvedValue(null);
+ });
+
+ afterEach(() => {
+ jest.useRealTimers();
+ });
+
+ it('does not prompt when fewer than 3 chapters read', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 2 });
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ });
+
+ it('does not prompt when already prompted for this version', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 10 });
+ mockGetPreference.mockResolvedValue('2.0.0');
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ jest.advanceTimersByTime(3000);
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ });
+
+ it('prompts for review when conditions are met', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 5 });
+ mockGetPreference.mockResolvedValue(null);
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ await act(async () => {
+ jest.advanceTimersByTime(2000);
+ });
+
+ expect(mockRequestReview).toHaveBeenCalled();
+ expect(mockSetPreference).toHaveBeenCalledWith('store_review_last_version', '2.0.0');
+ });
+
+ it('handles store review unavailable gracefully', async () => {
+ mockIsAvailableAsync.mockResolvedValue(false);
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 10 });
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ jest.advanceTimersByTime(3000);
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ expect(mockGetReadingStats).not.toHaveBeenCalled();
+ });
+});

app/__tests__/hooks/useTTS.test.ts

@@ -22,19 +22,19 @@ describe('useTTS', () => {
  expect(result.current.speed).toBe(1.0);
  });
 
- it('play sets isPlaying to true', () => {
+ it('play sets isPlaying to true', async () => {
  const { result } = renderHook(() => useTTS(mockVerses));
- act(() => {
- result.current.play();
+await act(async () => {
+await result.current.play();
  });
  expect(result.current.isPlaying).toBe(true);
  expect(Speech.speak).toHaveBeenCalled();
  });
 
- it('pause sets isPlaying to false and stops speech', () => {
+ it('pause sets isPlaying to false and stops speech', async () => {
  const { result } = renderHook(() => useTTS(mockVerses));
- act(() => {
- result.current.play();
+await act(async () => {
+await result.current.play();
  });
  act(() => {
  result.current.pause();

app/__tests__/screens/ForgotPasswordScreen.test.tsx

@@ -0,0 +1,61 @@
+import React from 'react';
+import { renderWithProviders } from '../helpers/renderWithProviders';
+import ForgotPasswordScreen from '@/screens/ForgotPasswordScreen';
+
+jest.mock('@/stores', () => ({
+ useSettingsStore: (sel: any) =>
+ sel({ translation: 'kjv', fontSize: 16, ttsVoice: '' }),
+ useAuthStore: (sel: any) =>
+ sel({
+ user: null,
+ isLoading: false,
+ signInWithEmail: jest.fn(),
+ signUpWithEmail: jest.fn(),
+ signInWithGoogle: jest.fn(),
+ signInWithFacebook: jest.fn(),
+ resetPassword: jest.fn(),
+ }),
+}));
+
+const mockNavigate = jest.fn();
+const mockGoBack = jest.fn();
+jest.mock('@react-navigation/native', () => ({
+ ...jest.requireActual('@react-navigation/native'),
+ useNavigation: () => ({ navigate: mockNavigate, goBack: mockGoBack }),
+}));
+
+describe('ForgotPasswordScreen', () => {
+ beforeEach(() => jest.clearAllMocks());
+
+ it('renders without crashing', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Reset Password')).toBeTruthy();
+ });
+
+ it('shows Reset Password heading', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Reset Password')).toBeTruthy();
+ });
+
+ it('shows email input', () => {
+ const { getByPlaceholderText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByPlaceholderText('Email')).toBeTruthy();
+ });
+
+ it('shows Send Reset Link button', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Send Reset Link')).toBeTruthy();
+ });
+
+ it('shows explanatory text', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(
+ getByText(/Enter your email and we'll send you a link to reset your password/),
+ ).toBeTruthy();
+ });
+
+ it('shows Back to Sign In link', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Back to Sign In')).toBeTruthy();
+ });
+});

app/App.tsx

@@ -19,6 +19,27 @@ import { ErrorBoundary } from './src/components/ErrorBoundary';
 // Keep splash visible while we load
 SplashScreen.preventAutoHideAsync();
 
+/** Deep linking configuration for scripture:// URLs. */
+const linking = {
+ prefixes: ['scripture://'],
+ config: {
+ screens: {
+ HomeTab: {
+ screens: {
+ Chapter: 'book/:bookId/:chapterNum',
+ },
+ },
+ ExploreTab: {
+ screens: {
+ GenealogyTree: 'people/:personId',
+ Map: 'map',
+ Timeline: 'timeline',
+ },
+ },
+ },
+ },
+};
+
 /** Inner app shell — consumes theme context for nav theme + status bar. */
 function AppShell() {
  const { base: themeBase, mode, statusBarStyle } = useTheme();
@@ -40,7 +61,7 @@ function AppShell() {
 
  return (
  <>
- <NavigationContainer theme={navTheme}>
+ <NavigationContainer theme={navTheme} linking={linking}>
  <ErrorBoundary>
  <RootNavigator />
  </ErrorBoundary>

app/__tests__/hooks/useAvailableVoices.test.ts

@@ -0,0 +1,78 @@
+import { renderHook, waitFor } from '@testing-library/react-native';
+
+const mockGetAvailableVoicesAsync = jest.fn();
+
+jest.mock('expo-speech', () => ({
+ getAvailableVoicesAsync: (...args: any[]) => mockGetAvailableVoicesAsync(...args),
+}));
+
+// Must unmock the hook itself since jest.setup.js mocks it globally
+jest.unmock('@/hooks/useAvailableVoices');
+
+import { useAvailableVoices } from '@/hooks/useAvailableVoices';
+
+describe('useAvailableVoices', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ mockGetAvailableVoicesAsync.mockResolvedValue([]);
+ });
+
+ it('starts with an empty array', () => {
+ const { result } = renderHook(() => useAvailableVoices());
+ expect(result.current).toEqual([]);
+ });
+
+ it('loads English voices from device', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'voice-1', name: 'Samantha', language: 'en-US' },
+ { identifier: 'voice-2', name: 'Daniel', language: 'en-GB' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(2);
+ });
+
+ expect(result.current[0].name).toBe('Daniel');
+ expect(result.current[1].name).toBe('Samantha');
+ });
+
+ it('filters out non-English voices', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'voice-1', name: 'Samantha', language: 'en-US' },
+ { identifier: 'voice-2', name: 'Marie', language: 'fr-FR' },
+ { identifier: 'voice-3', name: 'Hans', language: 'de-DE' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(1);
+ });
+
+ expect(result.current[0].name).toBe('Samantha');
+ });
+
+ it('sorts recommended voices first, then alphabetical', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'com.apple.voice.basic.en-US.Zoe', name: 'Zoe', language: 'en-US' },
+ { identifier: 'com.apple.voice.enhanced.en-US.Aaron', name: 'Aaron', language: 'en-US' },
+ { identifier: 'com.apple.voice.basic.en-US.Alex', name: 'Alex', language: 'en-US' },
+ { identifier: 'com.apple.voice.enhanced.en-US.Nathan', name: 'Nathan', language: 'en-US' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(4);
+ });
+
+ // Recommended voices (Aaron, Nathan) should come first
+ expect(result.current[0].name).toBe('Aaron');
+ expect(result.current[1].name).toBe('Nathan');
+ // Then alphabetical
+ expect(result.current[2].name).toBe('Alex');
+ expect(result.current[3].name).toBe('Zoe');
+ });
+});

app/__tests__/hooks/useScreenView.test.ts

@@ -0,0 +1,33 @@
+import { renderHook } from '@testing-library/react-native';
+
+const mockLogEvent = jest.fn();
+
+jest.mock('@/services/analytics', () => ({
+ logEvent: (...args: any[]) => mockLogEvent(...args),
+}));
+
+import { useScreenView } from '@/hooks/useScreenView';
+
+describe('useScreenView', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ });
+
+ it('logs screen_view event on focus with screen name', () => {
+ renderHook(() => useScreenView('HomeScreen'));
+
+ expect(mockLogEvent).toHaveBeenCalledWith('screen_view', { screen: 'HomeScreen' });
+ });
+
+ it('logs different screen names correctly', () => {
+ renderHook(() => useScreenView('ReaderScreen'));
+
+ expect(mockLogEvent).toHaveBeenCalledWith('screen_view', { screen: 'ReaderScreen' });
+ });
+
+ it('calls logEvent exactly once per mount', () => {
+ renderHook(() => useScreenView('Settings'));
+
+ expect(mockLogEvent).toHaveBeenCalledTimes(1);
+ });
+});

app/__tests__/hooks/useStoreReview.test.ts

@@ -0,0 +1,95 @@
+import { renderHook, act } from '@testing-library/react-native';
+
+const mockIsAvailableAsync = jest.fn();
+const mockRequestReview = jest.fn();
+
+jest.mock('expo-store-review', () => ({
+ isAvailableAsync: (...args: any[]) => mockIsAvailableAsync(...args),
+ requestReview: (...args: any[]) => mockRequestReview(...args),
+}));
+
+jest.mock('expo-constants', () => ({
+ expoConfig: { version: '2.0.0' },
+}));
+
+const mockGetPreference = jest.fn();
+const mockSetPreference = jest.fn();
+const mockGetReadingStats = jest.fn();
+
+jest.mock('@/db/user', () => ({
+ getPreference: (...args: any[]) => mockGetPreference(...args),
+ setPreference: (...args: any[]) => mockSetPreference(...args),
+ getReadingStats: (...args: any[]) => mockGetReadingStats(...args),
+}));
+
+import { useStoreReview } from '@/hooks/useStoreReview';
+
+describe('useStoreReview', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ jest.useFakeTimers();
+ mockIsAvailableAsync.mockResolvedValue(true);
+ mockRequestReview.mockResolvedValue(undefined);
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 0 });
+ mockGetPreference.mockResolvedValue(null);
+ });
+
+ afterEach(() => {
+ jest.useRealTimers();
+ });
+
+ it('does not prompt when fewer than 3 chapters read', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 2 });
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ });
+
+ it('does not prompt when already prompted for this version', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 10 });
+ mockGetPreference.mockResolvedValue('2.0.0');
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ jest.advanceTimersByTime(3000);
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ });
+
+ it('prompts for review when conditions are met', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 5 });
+ mockGetPreference.mockResolvedValue(null);
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ await act(async () => {
+ jest.advanceTimersByTime(2000);
+ });
+
+ expect(mockRequestReview).toHaveBeenCalled();
+ expect(mockSetPreference).toHaveBeenCalledWith('store_review_last_version', '2.0.0');
+ });
+
+ it('handles store review unavailable gracefully', async () => {
+ mockIsAvailableAsync.mockResolvedValue(false);
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 10 });
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ jest.advanceTimersByTime(3000);
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ expect(mockGetReadingStats).not.toHaveBeenCalled();
+ });
+});

app/__tests__/hooks/useTTS.test.ts

@@ -22,19 +22,19 @@ describe('useTTS', () => {
  expect(result.current.speed).toBe(1.0);
  });
 
- it('play sets isPlaying to true', () => {
+ it('play sets isPlaying to true', async () => {
  const { result } = renderHook(() => useTTS(mockVerses));
- act(() => {
- result.current.play();
+await act(async () => {
+await result.current.play();
  });
  expect(result.current.isPlaying).toBe(true);
  expect(Speech.speak).toHaveBeenCalled();
  });
 
- it('pause sets isPlaying to false and stops speech', () => {
+ it('pause sets isPlaying to false and stops speech', async () => {
  const { result } = renderHook(() => useTTS(mockVerses));
- act(() => {
- result.current.play();
+await act(async () => {
+await result.current.play();
  });
  act(() => {
  result.current.pause();

app/__tests__/screens/ForgotPasswordScreen.test.tsx

@@ -0,0 +1,61 @@
+import React from 'react';
+import { renderWithProviders } from '../helpers/renderWithProviders';
+import ForgotPasswordScreen from '@/screens/ForgotPasswordScreen';
+
+jest.mock('@/stores', () => ({
+ useSettingsStore: (sel: any) =>
+ sel({ translation: 'kjv', fontSize: 16, ttsVoice: '' }),
+ useAuthStore: (sel: any) =>
+ sel({
+ user: null,
+ isLoading: false,
+ signInWithEmail: jest.fn(),
+ signUpWithEmail: jest.fn(),
+ signInWithGoogle: jest.fn(),
+ signInWithFacebook: jest.fn(),
+ resetPassword: jest.fn(),
+ }),
+}));
+
+const mockNavigate = jest.fn();
+const mockGoBack = jest.fn();
+jest.mock('@react-navigation/native', () => ({
+ ...jest.requireActual('@react-navigation/native'),
+ useNavigation: () => ({ navigate: mockNavigate, goBack: mockGoBack }),
+}));
+
+describe('ForgotPasswordScreen', () => {
+ beforeEach(() => jest.clearAllMocks());
+
+ it('renders without crashing', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Reset Password')).toBeTruthy();
+ });
+
+ it('shows Reset Password heading', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Reset Password')).toBeTruthy();
+ });
+
+ it('shows email input', () => {
+ const { getByPlaceholderText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByPlaceholderText('Email')).toBeTruthy();
+ });
+
+ it('shows Send Reset Link button', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Send Reset Link')).toBeTruthy();
+ });
+
+ it('shows explanatory text', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(
+ getByText(/Enter your email and we'll send you a link to reset your password/),
+ ).toBeTruthy();
+ });
+
+ it('shows Back to Sign In link', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Back to Sign In')).toBeTruthy();
+ });
+});

app/App.tsx

@@ -19,6 +19,27 @@ import { ErrorBoundary } from './src/components/ErrorBoundary';
 // Keep splash visible while we load
 SplashScreen.preventAutoHideAsync();
 
+/** Deep linking configuration for scripture:// URLs. */
+const linking = {
+ prefixes: ['scripture://'],
+ config: {
+ screens: {
+ HomeTab: {
+ screens: {
+ Chapter: 'book/:bookId/:chapterNum',
+ },
+ },
+ ExploreTab: {
+ screens: {
+ GenealogyTree: 'people/:personId',
+ Map: 'map',
+ Timeline: 'timeline',
+ },
+ },
+ },
+ },
+};
+
 /** Inner app shell — consumes theme context for nav theme + status bar. */
 function AppShell() {
  const { base: themeBase, mode, statusBarStyle } = useTheme();
@@ -40,7 +61,7 @@ function AppShell() {
 
  return (
  <>
- <NavigationContainer theme={navTheme}>
+ <NavigationContainer theme={navTheme} linking={linking}>
  <ErrorBoundary>
  <RootNavigator />
  </ErrorBoundary>

app/__tests__/hooks/useAvailableVoices.test.ts

@@ -0,0 +1,78 @@
+import { renderHook, waitFor } from '@testing-library/react-native';
+
+const mockGetAvailableVoicesAsync = jest.fn();
+
+jest.mock('expo-speech', () => ({
+ getAvailableVoicesAsync: (...args: any[]) => mockGetAvailableVoicesAsync(...args),
+}));
+
+// Must unmock the hook itself since jest.setup.js mocks it globally
+jest.unmock('@/hooks/useAvailableVoices');
+
+import { useAvailableVoices } from '@/hooks/useAvailableVoices';
+
+describe('useAvailableVoices', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ mockGetAvailableVoicesAsync.mockResolvedValue([]);
+ });
+
+ it('starts with an empty array', () => {
+ const { result } = renderHook(() => useAvailableVoices());
+ expect(result.current).toEqual([]);
+ });
+
+ it('loads English voices from device', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'voice-1', name: 'Samantha', language: 'en-US' },
+ { identifier: 'voice-2', name: 'Daniel', language: 'en-GB' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(2);
+ });
+
+ expect(result.current[0].name).toBe('Daniel');
+ expect(result.current[1].name).toBe('Samantha');
+ });
+
+ it('filters out non-English voices', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'voice-1', name: 'Samantha', language: 'en-US' },
+ { identifier: 'voice-2', name: 'Marie', language: 'fr-FR' },
+ { identifier: 'voice-3', name: 'Hans', language: 'de-DE' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(1);
+ });
+
+ expect(result.current[0].name).toBe('Samantha');
+ });
+
+ it('sorts recommended voices first, then alphabetical', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'com.apple.voice.basic.en-US.Zoe', name: 'Zoe', language: 'en-US' },
+ { identifier: 'com.apple.voice.enhanced.en-US.Aaron', name: 'Aaron', language: 'en-US' },
+ { identifier: 'com.apple.voice.basic.en-US.Alex', name: 'Alex', language: 'en-US' },
+ { identifier: 'com.apple.voice.enhanced.en-US.Nathan', name: 'Nathan', language: 'en-US' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(4);
+ });
+
+ // Recommended voices (Aaron, Nathan) should come first
+ expect(result.current[0].name).toBe('Aaron');
+ expect(result.current[1].name).toBe('Nathan');
+ // Then alphabetical
+ expect(result.current[2].name).toBe('Alex');
+ expect(result.current[3].name).toBe('Zoe');
+ });
+});

app/__tests__/hooks/useScreenView.test.ts

@@ -0,0 +1,33 @@
+import { renderHook } from '@testing-library/react-native';
+
+const mockLogEvent = jest.fn();
+
+jest.mock('@/services/analytics', () => ({
+ logEvent: (...args: any[]) => mockLogEvent(...args),
+}));
+
+import { useScreenView } from '@/hooks/useScreenView';
+
+describe('useScreenView', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ });
+
+ it('logs screen_view event on focus with screen name', () => {
+ renderHook(() => useScreenView('HomeScreen'));
+
+ expect(mockLogEvent).toHaveBeenCalledWith('screen_view', { screen: 'HomeScreen' });
+ });
+
+ it('logs different screen names correctly', () => {
+ renderHook(() => useScreenView('ReaderScreen'));
+
+ expect(mockLogEvent).toHaveBeenCalledWith('screen_view', { screen: 'ReaderScreen' });
+ });
+
+ it('calls logEvent exactly once per mount', () => {
+ renderHook(() => useScreenView('Settings'));
+
+ expect(mockLogEvent).toHaveBeenCalledTimes(1);
+ });
+});

app/__tests__/hooks/useStoreReview.test.ts

@@ -0,0 +1,95 @@
+import { renderHook, act } from '@testing-library/react-native';
+
+const mockIsAvailableAsync = jest.fn();
+const mockRequestReview = jest.fn();
+
+jest.mock('expo-store-review', () => ({
+ isAvailableAsync: (...args: any[]) => mockIsAvailableAsync(...args),
+ requestReview: (...args: any[]) => mockRequestReview(...args),
+}));
+
+jest.mock('expo-constants', () => ({
+ expoConfig: { version: '2.0.0' },
+}));
+
+const mockGetPreference = jest.fn();
+const mockSetPreference = jest.fn();
+const mockGetReadingStats = jest.fn();
+
+jest.mock('@/db/user', () => ({
+ getPreference: (...args: any[]) => mockGetPreference(...args),
+ setPreference: (...args: any[]) => mockSetPreference(...args),
+ getReadingStats: (...args: any[]) => mockGetReadingStats(...args),
+}));
+
+import { useStoreReview } from '@/hooks/useStoreReview';
+
+describe('useStoreReview', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ jest.useFakeTimers();
+ mockIsAvailableAsync.mockResolvedValue(true);
+ mockRequestReview.mockResolvedValue(undefined);
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 0 });
+ mockGetPreference.mockResolvedValue(null);
+ });
+
+ afterEach(() => {
+ jest.useRealTimers();
+ });
+
+ it('does not prompt when fewer than 3 chapters read', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 2 });
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ });
+
+ it('does not prompt when already prompted for this version', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 10 });
+ mockGetPreference.mockResolvedValue('2.0.0');
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ jest.advanceTimersByTime(3000);
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ });
+
+ it('prompts for review when conditions are met', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 5 });
+ mockGetPreference.mockResolvedValue(null);
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ await act(async () => {
+ jest.advanceTimersByTime(2000);
+ });
+
+ expect(mockRequestReview).toHaveBeenCalled();
+ expect(mockSetPreference).toHaveBeenCalledWith('store_review_last_version', '2.0.0');
+ });
+
+ it('handles store review unavailable gracefully', async () => {
+ mockIsAvailableAsync.mockResolvedValue(false);
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 10 });
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ jest.advanceTimersByTime(3000);
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ expect(mockGetReadingStats).not.toHaveBeenCalled();
+ });
+});

app/__tests__/hooks/useTTS.test.ts

@@ -22,19 +22,19 @@ describe('useTTS', () => {
  expect(result.current.speed).toBe(1.0);
  });
 
- it('play sets isPlaying to true', () => {
+ it('play sets isPlaying to true', async () => {
  const { result } = renderHook(() => useTTS(mockVerses));
- act(() => {
- result.current.play();
+await act(async () => {
+await result.current.play();
  });
  expect(result.current.isPlaying).toBe(true);
  expect(Speech.speak).toHaveBeenCalled();
  });
 
- it('pause sets isPlaying to false and stops speech', () => {
+ it('pause sets isPlaying to false and stops speech', async () => {
  const { result } = renderHook(() => useTTS(mockVerses));
- act(() => {
- result.current.play();
+await act(async () => {
+await result.current.play();
  });
  act(() => {
  result.current.pause();

app/__tests__/screens/ForgotPasswordScreen.test.tsx

@@ -0,0 +1,61 @@
+import React from 'react';
+import { renderWithProviders } from '../helpers/renderWithProviders';
+import ForgotPasswordScreen from '@/screens/ForgotPasswordScreen';
+
+jest.mock('@/stores', () => ({
+ useSettingsStore: (sel: any) =>
+ sel({ translation: 'kjv', fontSize: 16, ttsVoice: '' }),
+ useAuthStore: (sel: any) =>
+ sel({
+ user: null,
+ isLoading: false,
+ signInWithEmail: jest.fn(),
+ signUpWithEmail: jest.fn(),
+ signInWithGoogle: jest.fn(),
+ signInWithFacebook: jest.fn(),
+ resetPassword: jest.fn(),
+ }),
+}));
+
+const mockNavigate = jest.fn();
+const mockGoBack = jest.fn();
+jest.mock('@react-navigation/native', () => ({
+ ...jest.requireActual('@react-navigation/native'),
+ useNavigation: () => ({ navigate: mockNavigate, goBack: mockGoBack }),
+}));
+
+describe('ForgotPasswordScreen', () => {
+ beforeEach(() => jest.clearAllMocks());
+
+ it('renders without crashing', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Reset Password')).toBeTruthy();
+ });
+
+ it('shows Reset Password heading', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Reset Password')).toBeTruthy();
+ });
+
+ it('shows email input', () => {
+ const { getByPlaceholderText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByPlaceholderText('Email')).toBeTruthy();
+ });
+
+ it('shows Send Reset Link button', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Send Reset Link')).toBeTruthy();
+ });
+
+ it('shows explanatory text', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(
+ getByText(/Enter your email and we'll send you a link to reset your password/),
+ ).toBeTruthy();
+ });
+
+ it('shows Back to Sign In link', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Back to Sign In')).toBeTruthy();
+ });
+});

app/App.tsx

@@ -19,6 +19,27 @@ import { ErrorBoundary } from './src/components/ErrorBoundary';
 // Keep splash visible while we load
 SplashScreen.preventAutoHideAsync();
 
+/** Deep linking configuration for scripture:// URLs. */
+const linking = {
+ prefixes: ['scripture://'],
+ config: {
+ screens: {
+ HomeTab: {
+ screens: {
+ Chapter: 'book/:bookId/:chapterNum',
+ },
+ },
+ ExploreTab: {
+ screens: {
+ GenealogyTree: 'people/:personId',
+ Map: 'map',
+ Timeline: 'timeline',
+ },
+ },
+ },
+ },
+};
+
 /** Inner app shell — consumes theme context for nav theme + status bar. */
 function AppShell() {
  const { base: themeBase, mode, statusBarStyle } = useTheme();
@@ -40,7 +61,7 @@ function AppShell() {
 
  return (
  <>
- <NavigationContainer theme={navTheme}>
+ <NavigationContainer theme={navTheme} linking={linking}>
  <ErrorBoundary>
  <RootNavigator />
  </ErrorBoundary>

app/__tests__/hooks/useAvailableVoices.test.ts

@@ -0,0 +1,78 @@
+import { renderHook, waitFor } from '@testing-library/react-native';
+
+const mockGetAvailableVoicesAsync = jest.fn();
+
+jest.mock('expo-speech', () => ({
+ getAvailableVoicesAsync: (...args: any[]) => mockGetAvailableVoicesAsync(...args),
+}));
+
+// Must unmock the hook itself since jest.setup.js mocks it globally
+jest.unmock('@/hooks/useAvailableVoices');
+
+import { useAvailableVoices } from '@/hooks/useAvailableVoices';
+
+describe('useAvailableVoices', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ mockGetAvailableVoicesAsync.mockResolvedValue([]);
+ });
+
+ it('starts with an empty array', () => {
+ const { result } = renderHook(() => useAvailableVoices());
+ expect(result.current).toEqual([]);
+ });
+
+ it('loads English voices from device', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'voice-1', name: 'Samantha', language: 'en-US' },
+ { identifier: 'voice-2', name: 'Daniel', language: 'en-GB' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(2);
+ });
+
+ expect(result.current[0].name).toBe('Daniel');
+ expect(result.current[1].name).toBe('Samantha');
+ });
+
+ it('filters out non-English voices', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'voice-1', name: 'Samantha', language: 'en-US' },
+ { identifier: 'voice-2', name: 'Marie', language: 'fr-FR' },
+ { identifier: 'voice-3', name: 'Hans', language: 'de-DE' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(1);
+ });
+
+ expect(result.current[0].name).toBe('Samantha');
+ });
+
+ it('sorts recommended voices first, then alphabetical', async () => {
+ mockGetAvailableVoicesAsync.mockResolvedValue([
+ { identifier: 'com.apple.voice.basic.en-US.Zoe', name: 'Zoe', language: 'en-US' },
+ { identifier: 'com.apple.voice.enhanced.en-US.Aaron', name: 'Aaron', language: 'en-US' },
+ { identifier: 'com.apple.voice.basic.en-US.Alex', name: 'Alex', language: 'en-US' },
+ { identifier: 'com.apple.voice.enhanced.en-US.Nathan', name: 'Nathan', language: 'en-US' },
+ ]);
+
+ const { result } = renderHook(() => useAvailableVoices());
+
+ await waitFor(() => {
+ expect(result.current).toHaveLength(4);
+ });
+
+ // Recommended voices (Aaron, Nathan) should come first
+ expect(result.current[0].name).toBe('Aaron');
+ expect(result.current[1].name).toBe('Nathan');
+ // Then alphabetical
+ expect(result.current[2].name).toBe('Alex');
+ expect(result.current[3].name).toBe('Zoe');
+ });
+});

app/__tests__/hooks/useScreenView.test.ts

@@ -0,0 +1,33 @@
+import { renderHook } from '@testing-library/react-native';
+
+const mockLogEvent = jest.fn();
+
+jest.mock('@/services/analytics', () => ({
+ logEvent: (...args: any[]) => mockLogEvent(...args),
+}));
+
+import { useScreenView } from '@/hooks/useScreenView';
+
+describe('useScreenView', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ });
+
+ it('logs screen_view event on focus with screen name', () => {
+ renderHook(() => useScreenView('HomeScreen'));
+
+ expect(mockLogEvent).toHaveBeenCalledWith('screen_view', { screen: 'HomeScreen' });
+ });
+
+ it('logs different screen names correctly', () => {
+ renderHook(() => useScreenView('ReaderScreen'));
+
+ expect(mockLogEvent).toHaveBeenCalledWith('screen_view', { screen: 'ReaderScreen' });
+ });
+
+ it('calls logEvent exactly once per mount', () => {
+ renderHook(() => useScreenView('Settings'));
+
+ expect(mockLogEvent).toHaveBeenCalledTimes(1);
+ });
+});

app/__tests__/hooks/useStoreReview.test.ts

@@ -0,0 +1,95 @@
+import { renderHook, act } from '@testing-library/react-native';
+
+const mockIsAvailableAsync = jest.fn();
+const mockRequestReview = jest.fn();
+
+jest.mock('expo-store-review', () => ({
+ isAvailableAsync: (...args: any[]) => mockIsAvailableAsync(...args),
+ requestReview: (...args: any[]) => mockRequestReview(...args),
+}));
+
+jest.mock('expo-constants', () => ({
+ expoConfig: { version: '2.0.0' },
+}));
+
+const mockGetPreference = jest.fn();
+const mockSetPreference = jest.fn();
+const mockGetReadingStats = jest.fn();
+
+jest.mock('@/db/user', () => ({
+ getPreference: (...args: any[]) => mockGetPreference(...args),
+ setPreference: (...args: any[]) => mockSetPreference(...args),
+ getReadingStats: (...args: any[]) => mockGetReadingStats(...args),
+}));
+
+import { useStoreReview } from '@/hooks/useStoreReview';
+
+describe('useStoreReview', () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ jest.useFakeTimers();
+ mockIsAvailableAsync.mockResolvedValue(true);
+ mockRequestReview.mockResolvedValue(undefined);
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 0 });
+ mockGetPreference.mockResolvedValue(null);
+ });
+
+ afterEach(() => {
+ jest.useRealTimers();
+ });
+
+ it('does not prompt when fewer than 3 chapters read', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 2 });
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ });
+
+ it('does not prompt when already prompted for this version', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 10 });
+ mockGetPreference.mockResolvedValue('2.0.0');
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ jest.advanceTimersByTime(3000);
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ });
+
+ it('prompts for review when conditions are met', async () => {
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 5 });
+ mockGetPreference.mockResolvedValue(null);
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ await act(async () => {
+ jest.advanceTimersByTime(2000);
+ });
+
+ expect(mockRequestReview).toHaveBeenCalled();
+ expect(mockSetPreference).toHaveBeenCalledWith('store_review_last_version', '2.0.0');
+ });
+
+ it('handles store review unavailable gracefully', async () => {
+ mockIsAvailableAsync.mockResolvedValue(false);
+ mockGetReadingStats.mockResolvedValue({ totalChapters: 10 });
+
+ const { result } = renderHook(() => useStoreReview());
+ await act(async () => {
+ await result.current.checkAndPrompt();
+ });
+
+ jest.advanceTimersByTime(3000);
+ expect(mockRequestReview).not.toHaveBeenCalled();
+ expect(mockGetReadingStats).not.toHaveBeenCalled();
+ });
+});

app/__tests__/hooks/useTTS.test.ts

@@ -22,19 +22,19 @@ describe('useTTS', () => {
  expect(result.current.speed).toBe(1.0);
  });
 
- it('play sets isPlaying to true', () => {
+ it('play sets isPlaying to true', async () => {
  const { result } = renderHook(() => useTTS(mockVerses));
- act(() => {
- result.current.play();
+await act(async () => {
+await result.current.play();
  });
  expect(result.current.isPlaying).toBe(true);
  expect(Speech.speak).toHaveBeenCalled();
  });
 
- it('pause sets isPlaying to false and stops speech', () => {
+ it('pause sets isPlaying to false and stops speech', async () => {
  const { result } = renderHook(() => useTTS(mockVerses));
- act(() => {
- result.current.play();
+await act(async () => {
+await result.current.play();
  });
  act(() => {
  result.current.pause();

app/__tests__/screens/ForgotPasswordScreen.test.tsx

@@ -0,0 +1,61 @@
+import React from 'react';
+import { renderWithProviders } from '../helpers/renderWithProviders';
+import ForgotPasswordScreen from '@/screens/ForgotPasswordScreen';
+
+jest.mock('@/stores', () => ({
+ useSettingsStore: (sel: any) =>
+ sel({ translation: 'kjv', fontSize: 16, ttsVoice: '' }),
+ useAuthStore: (sel: any) =>
+ sel({
+ user: null,
+ isLoading: false,
+ signInWithEmail: jest.fn(),
+ signUpWithEmail: jest.fn(),
+ signInWithGoogle: jest.fn(),
+ signInWithFacebook: jest.fn(),
+ resetPassword: jest.fn(),
+ }),
+}));
+
+const mockNavigate = jest.fn();
+const mockGoBack = jest.fn();
+jest.mock('@react-navigation/native', () => ({
+ ...jest.requireActual('@react-navigation/native'),
+ useNavigation: () => ({ navigate: mockNavigate, goBack: mockGoBack }),
+}));
+
+describe('ForgotPasswordScreen', () => {
+ beforeEach(() => jest.clearAllMocks());
+
+ it('renders without crashing', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Reset Password')).toBeTruthy();
+ });
+
+ it('shows Reset Password heading', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Reset Password')).toBeTruthy();
+ });
+
+ it('shows email input', () => {
+ const { getByPlaceholderText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByPlaceholderText('Email')).toBeTruthy();
+ });
+
+ it('shows Send Reset Link button', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Send Reset Link')).toBeTruthy();
+ });
+
+ it('shows explanatory text', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(
+ getByText(/Enter your email and we'll send you a link to reset your password/),
+ ).toBeTruthy();
+ });
+
+ it('shows Back to Sign In link', () => {
+ const { getByText } = renderWithProviders(<ForgotPasswordScreen />);
+ expect(getByText('Back to Sign In')).toBeTruthy();
+ });
+});