build: [ANDROAPP-7337] [2/3] Implement usecases for Home screen [skip size]

[Balcan]

Description

Link the JIRA issue.

Please provide a clear definition of the problem and explain your solution.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[andresmr]

can you fix the lint check

[Copilot]

Pull Request Overview

This PR implements domain-layer use cases for the Home screen as part of a multi-part feature (part 2/3). It introduces a clean architecture pattern with use case classes that handle various home screen operations including user authentication, synchronization, account management, and navigation configuration.

Key changes:

• Added 11 new use case classes for home screen operations (user management, sync, navigation, account operations)
• Created HomeRepository interface and HomeRepositoryImpl with 15 methods for data operations
• Introduced domain models (LockAction, DownloadMethod) to represent screen actions

Reviewed Changes

Copilot reviewed 16 out of 16 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
LockAction.kt	Sealed interface defining PIN creation and session blocking actions
DownloadMethod.kt	Sealed interface for app update download methods (URL vs File)
UpdateInitialSyncStatus.kt	Use case to mark initial sync as completed
ScheduleNewVersionAlert.kt	Use case to schedule periodic app version checks using WorkManager
LogOutUser.kt	Use case orchestrating user logout with cleanup operations
LaunchInitialSync.kt	Use case determining whether to skip or perform initial sync
GetUserName.kt	Use case retrieving formatted user display name
GetLockAction.kt	Use case determining PIN creation or session lock action
GetHomeFilters.kt	Use case retrieving home screen filter configuration
DownloadNewVersion.kt (main)	Use case for downloading app updates via file system
DownloadNewVersion.kt (PlayServices)	Flavor-specific variant for downloading via Play Store URL
CheckSingleNavigation.kt	Use case checking if single-item direct navigation is possible
ConfigureHomeNavigationBar.kt	Use case building navigation bar items based on analytics availability
DeleteAccount.kt	Use case orchestrating complete account deletion with cleanup
HomeRepository.kt	Repository interface defining data operations for home screen
HomeRepositoryImpl.kt	Repository implementation using D2 SDK, Charts, and preferences

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Empty catch block silently swallows errors. The catch block on line 41 catches DomainError but then returns success with a default value, silently hiding any actual errors. Consider logging the error or returning a failure result to make debugging easier.

[Copilot]

Missing import statement. toUri() extension function is used but the necessary import is missing. Add import androidx.core.net.toUri at the top of the file.

[Copilot]

Inaccurate error message. The error message "No programs" is misleading since this code path is reached when homeItemCount != 1, which includes cases where there are zero items OR more than one item. Consider a more accurate message like "Expected exactly one home item" or "Single navigation not available".

Suggested change

	Result.failure(Exception("No programs"))
	Result.failure(Exception("Expected exactly one home item"))

[Copilot]

Inconsistent error handling. This catch block catches DomainError but line 17 throws a generic Exception. For consistency, either throw a DomainError on line 17 or catch Exception here instead of DomainError.

Suggested change

	Result.failure(Exception("No programs"))
	Result.failure(DomainError("No programs"))