From 4942e38e84e8ef5f186ce71838a0aa94645d6ce2 Mon Sep 17 00:00:00 2001 From: ShiftHackZ Date: Thu, 19 Nov 2026 13:06:28 +0200 Subject: [PATCH 1/3] Add selective application backup and restore --- .../src/androidMain/res/values-de/strings.xml | 35 ++ .../src/androidMain/res/values-ru/strings.xml | 35 ++ .../src/androidMain/res/values-tr/strings.xml | 35 ++ .../src/androidMain/res/values-uk/strings.xml | 35 ++ .../src/androidMain/res/values-zh/strings.xml | 35 ++ .../src/androidMain/res/values/strings.xml | 35 ++ .../core/navigation/RootAppRouterTest.kt | 13 + .../aisdv1/core/navigation/AppRoute.kt | 14 +- .../aisdv1/core/navigation/HomeTabRoutes.kt | 2 + .../core/navigation/NavigationDestination.kt | 2 + .../aisdv1/core/navigation/RootAppRouter.kt | 44 +- .../core/navigation/router/BackupRouter.kt | 31 + .../navigation/router/NoOpBackupRouter.kt | 12 + .../navigation/router/NoOpOnBoardingRouter.kt | 14 +- .../navigation/router/NoOpSettingsRouter.kt | 2 + .../navigation/router/NoOpSplashRouter.kt | 4 + .../navigation/router/OnBoardingRouter.kt | 16 +- .../core/navigation/router/SettingsRouter.kt | 6 + .../core/navigation/router/SplashRouter.kt | 15 + .../PlatformBackupImageDecoder.android.kt | 43 ++ .../AndroidKeyValueStore.android.kt | 56 +- .../image/BackupImageValidatorImplTest.kt | 69 +++ .../image/PlatformBackupImageDecoderTest.kt | 58 ++ .../preference/PreferenceManagerImplTest.kt | 14 + .../backup/BackupExportStateStoreImplTest.kt | 69 +++ .../BackupPreferencesGatewayImplTest.kt | 261 ++++++++ .../aisdv1/data/di/DataCoreModule.kt | 16 + .../aisdv1/data/di/PreferenceDataModule.kt | 15 +- .../aisdv1/data/image/BackupImageDecoder.kt | 22 + .../data/image/BackupImageValidatorImpl.kt | 25 + .../data/image/PlatformBackupImageDecoder.kt | 7 + .../preference/ConfigurationMemoryMask.kt | 16 +- .../aisdv1/data/preference/KeyValueStore.kt | 23 + .../backup/BackupExportStateStoreImpl.kt | 62 ++ .../backup/BackupPreferencesGatewayImpl.kt | 223 +++++++ .../backup/PortablePreferenceField.kt | 9 + .../backup/PortablePreferenceSchema.kt | 174 ++++++ .../backup/PortablePreferenceType.kt | 7 + .../image/PlatformBackupImageDecoder.ios.kt | 202 +++++++ .../data/preference/AppleKeyValueStore.ios.kt | 55 +- .../mocks/ImmediateGenerationRestoreGate.kt | 9 + .../generation/ImageToImageUseCaseImplTest.kt | 262 +++++--- .../generation/MnnTextToImageUseCaseTest.kt | 2 + .../generation/TextToImageUseCaseImplTest.kt | 329 ++++++---- .../SetServerConfigurationUseCaseImplTest.kt | 41 +- .../splash/SplashNavigationUseCaseImplTest.kt | 210 ++++--- .../aisdv1/domain/di/DomainCoreModule.kt | 12 +- .../domain/entity/backup/BackupCategory.kt | 11 + .../domain/entity/backup/BackupEntry.kt | 15 + .../domain/entity/backup/BackupExport.kt | 11 + .../entity/backup/BackupExportCompletion.kt | 33 + .../entity/backup/BackupExportIntent.kt | 17 + .../entity/backup/BackupExportOperation.kt | 13 + .../entity/backup/BackupExportStatus.kt | 8 + .../domain/entity/backup/BackupImageBudget.kt | 21 + .../domain/entity/backup/BackupInspection.kt | 25 + .../domain/entity/backup/BackupPreferences.kt | 13 + .../domain/entity/backup/BackupProgress.kt | 11 + .../domain/entity/backup/BackupRecovery.kt | 10 + .../entity/backup/BackupRestoreNotice.kt | 15 + .../entity/backup/BackupRestoreRequest.kt | 19 + .../entity/backup/BackupRestoreResult.kt | 34 ++ .../domain/entity/backup/BackupSelection.kt | 13 + .../entity/backup/BackupStartupStage.kt | 8 + .../domain/entity/backup/BackupValue.kt | 35 ++ .../domain/gateway/GenerationRestoreGate.kt | 21 + .../gateway/backup/BackupChangesGateway.kt | 16 + .../gateway/backup/BackupExportStateStore.kt | 34 ++ .../gateway/backup/BackupImageValidator.kt | 14 + .../backup/BackupPreferencesGateway.kt | 65 ++ .../backup/CancelBackupExportUseCase.kt | 14 + .../backup/CompleteBackupExportUseCase.kt | 16 + .../usecase/backup/CreateBackupUseCase.kt | 22 + .../usecase/backup/DiscardBackupUseCase.kt | 15 + .../backup/DismissBackupExportUseCase.kt | 14 + .../usecase/backup/ExportBackupUseCase.kt | 16 + .../backup/GetBackupStartupStageUseCase.kt | 15 + .../backup/GetPendingBackupExportUseCase.kt | 14 + .../usecase/backup/InspectBackupUseCase.kt | 21 + .../backup/LoadBackupInventoryUseCase.kt | 15 + .../backup/LoadPendingBackupUseCase.kt | 15 + .../backup/ObserveBackupExportUseCase.kt | 16 + .../usecase/backup/RestoreBackupUseCase.kt | 22 + .../backup/SetBackupStartupStageUseCase.kt | 16 + .../ObserveSeverConnectivityUseCase.kt | 20 +- .../debug/DebugInsertBadBase64UseCaseImpl.kt | 28 +- .../donate/FetchSupportersUseCaseImpl.kt | 13 +- .../gallery/GetMediaStoreInfoUseCaseImpl.kt | 13 +- .../generation/GetRandomImageUseCaseImpl.kt | 13 +- .../generation/ImageToImageUseCaseImpl.kt | 13 +- .../generation/TextToImageUseCaseImpl.kt | 15 +- .../FetchHuggingFaceModelsUseCaseImpl.kt | 21 +- .../usecase/report/SendReportUseCaseImpl.kt | 19 +- .../FetchAndGetEmbeddingsUseCaseImpl.kt | 13 +- .../sdlora/FetchAndGetLorasUseCaseImpl.kt | 13 +- .../GetStableDiffusionModelsUseCaseImpl.kt | 27 +- .../GetStableDiffusionSamplersUseCaseImpl.kt | 2 +- ...efaultSetServerConfigurationUseCaseImpl.kt | 7 + .../usecase/settings/NetworkUsageUseCases.kt | 4 +- .../usecase/splash/SplashNavigationUseCase.kt | 53 +- .../splash/SplashNavigationUseCaseImpl.kt | 38 ++ .../FetchStabilityAiEnginesUseCase.kt | 25 +- .../ObserveStabilityAiCreditsUseCaseImpl.kt | 13 +- .../swarmmodel/FetchSwarmUiModelsUseCase.kt | 33 +- feature/backup/build.gradle.kts | 24 + .../backup/di/BackupPlatformModule.android.kt | 14 + .../backup/io/BackupFileStore.android.kt | 53 ++ .../DefaultBackupStagingCleanerTest.kt | 216 +++++++ .../codec/BackupPreferencesCodecTest.kt | 34 ++ .../codec/BinaryBackupArchiveCodecTest.kt | 158 +++++ .../backup/codec/GalleryBackupCodecTest.kt | 180 ++++++ .../DefaultBackupExportCoordinatorTest.kt | 229 +++++++ .../DefaultBackupProviderPlannerTest.kt | 181 ++++++ .../DefaultGenerationRestoreGateTest.kt | 86 +++ .../restore/RoomBackupRestoreWriterTest.kt | 96 +++ .../usecase/DiscardBackupUseCaseImplTest.kt | 121 ++++ .../LoadPendingBackupUseCaseImplTest.kt | 138 +++++ .../usecase/RestoreBackupUseCaseImplTest.kt | 383 ++++++++++++ .../SetBackupStartupStageUseCaseImplTest.kt | 34 ++ .../backup/archive/BackupArchiveStore.kt | 79 +++ .../backup/archive/BackupStagingCleaner.kt | 17 + .../archive/DefaultBackupArchiveStore.kt | 411 +++++++++++++ .../archive/DefaultBackupStagingCleaner.kt | 74 +++ .../feature/backup/archive/StagedBackup.kt | 13 + .../backup/codec/BackupArchiveCodec.kt | 60 ++ .../feature/backup/codec/BackupManifest.kt | 23 + .../backup/codec/BackupPreferencesCodec.kt | 37 ++ .../feature/backup/codec/BackupSection.kt | 27 + .../backup/codec/BinaryBackupArchiveCodec.kt | 141 +++++ .../backup/codec/BoundedBackupSource.kt | 26 + .../codec/DefaultBackupPreferencesCodec.kt | 52 ++ .../backup/codec/DefaultGalleryBackupCodec.kt | 160 +++++ .../backup/codec/GalleryBackupCodec.kt | 27 + .../backup/codec/GalleryBackupRecord.kt | 46 ++ .../aisdv1/feature/backup/di/BackupModule.kt | 177 ++++++ .../backup/export/BackupExportCoordinator.kt | 56 ++ .../export/DefaultBackupExportCoordinator.kt | 216 +++++++ .../feature/backup/io/BackupFileStore.kt | 60 ++ .../backup/restore/BackupProviderPlan.kt | 23 + .../backup/restore/BackupProviderPlanner.kt | 26 + .../backup/restore/BackupRestoreGuard.kt | 14 + .../backup/restore/BackupRestoreWriter.kt | 31 + .../backup/restore/BackupSessionCodec.kt | 23 + .../restore/DefaultBackupProviderPlanner.kt | 90 +++ .../restore/DefaultBackupRestoreGuard.kt | 13 + .../restore/DefaultBackupSessionCodec.kt | 26 + .../restore/DefaultGenerationRestoreGate.kt | 49 ++ .../backup/restore/RoomBackupRestoreWriter.kt | 108 ++++ .../usecase/CancelBackupExportUseCaseImpl.kt | 15 + .../CompleteBackupExportUseCaseImpl.kt | 15 + .../backup/usecase/CreateBackupUseCaseImpl.kt | 25 + .../usecase/DiscardBackupUseCaseImpl.kt | 72 +++ .../usecase/DismissBackupExportUseCaseImpl.kt | 14 + .../backup/usecase/ExportBackupUseCaseImpl.kt | 21 + .../GetBackupStartupStageUseCaseImpl.kt | 15 + .../GetPendingBackupExportUseCaseImpl.kt | 22 + .../usecase/InspectBackupUseCaseImpl.kt | 24 + .../usecase/LoadBackupInventoryUseCaseImpl.kt | 21 + .../usecase/LoadPendingBackupUseCaseImpl.kt | 86 +++ .../usecase/ObserveBackupExportUseCaseImpl.kt | 16 + .../usecase/RestoreBackupUseCaseImpl.kt | 246 ++++++++ .../SetBackupStartupStageUseCaseImpl.kt | 18 + .../backup/di/BackupPlatformModule.ios.kt | 13 + .../feature/backup/io/BackupFileStore.ios.kt | 49 ++ gradle/libs.versions.toml | 2 + presentation/app/build.gradle.kts | 4 + .../presentation/app/BackupRouterSaverTest.kt | 49 ++ .../aisdv1/presentation/app/AiSdApp.kt | 3 +- .../aisdv1/presentation/app/AiSdAppRoutes.kt | 51 ++ .../presentation/app/BackupRouterSaver.kt | 29 + .../presentation/app/di/AppCoreModule.kt | 3 + .../presentation/app/di/KoinBootstrap.kt | 20 +- .../app/di/PresentationCoreModule.kt | 2 + presentation/backup/build.gradle.kts | 51 ++ .../platform/BackupDateFormatter.android.kt | 12 + .../BackupDocumentLauncher.android.kt | 50 ++ .../backup/BackupViewModelTest.kt | 386 ++++++++++++ .../presentation/backup/BackupEffect.kt | 20 + .../presentation/backup/BackupIntent.kt | 105 ++++ .../presentation/backup/BackupPageState.kt | 17 + .../presentation/backup/BackupScreen.kt | 199 ++++++ .../presentation/backup/BackupScreenMode.kt | 7 + .../aisdv1/presentation/backup/BackupState.kt | 42 ++ .../presentation/backup/BackupViewModel.kt | 391 ++++++++++++ .../backup/component/BackupSelectionList.kt | 150 +++++ .../backup/create/CreateBackupScreen.kt | 41 ++ .../backup/di/BackupViewModelModule.kt | 36 ++ .../backup/platform/BackupDateFormatter.kt | 8 + .../backup/platform/BackupDocumentLauncher.kt | 35 ++ .../backup/restore/RestoreBackupScreen.kt | 73 +++ .../service/BackupChangesGatewayImpl.kt | 24 + .../backup/welcome/RestoreWelcomeScreen.kt | 85 +++ .../platform/BackupDateFormatter.ios.kt | 16 + .../platform/BackupDocumentLauncher.ios.kt | 130 ++++ .../OnBoardingViewModelSplashSourceTest.kt | 113 ++-- .../onboarding/OnBoardingViewModel.kt | 24 +- .../di/OnboardingViewModelModule.kt | 2 +- .../navigation/OnBoardingNavigation.kt | 20 - .../settings/SettingsViewModelTest.kt | 2 + .../settings/SettingsContentTypes.kt | 1 + .../presentation/settings/SettingsIntent.kt | 4 + .../presentation/settings/SettingsListItem.kt | 1 + .../settings/SettingsListItems.kt | 1 + .../settings/SettingsViewModel.kt | 2 + .../settings/content/SettingsContent.kt | 1 + .../settings/section/SettingsServerSection.kt | 11 + .../splash/navigation/SplashNavigation.kt | 3 + settings.gradle.kts | 2 + .../14.json | 551 +++++++++++++++++ .../15.json | 565 ++++++++++++++++++ .../db/persistent/PersistentDatabase.kt | 49 +- .../db/persistent/dao/GenerationResultDao.kt | 95 +-- .../db/persistent/dao/RestoreSessionDao.kt | 78 +++ .../persistent/entity/RestoreSectionEntity.kt | 22 + .../persistent/entity/RestoreSessionEntity.kt | 23 + .../storage/di/PersistentDatabaseModule.kt | 3 + .../aisdv1/storage/gateway/BackupStorage.kt | 43 ++ .../storage/gateway/RoomBackupStorage.kt | 24 + 218 files changed, 11434 insertions(+), 723 deletions(-) create mode 100644 core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/BackupRouter.kt create mode 100644 core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/NoOpBackupRouter.kt create mode 100644 data/src/androidMain/kotlin/com/shifthackz/aisdv1/data/image/PlatformBackupImageDecoder.android.kt create mode 100644 data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/image/BackupImageValidatorImplTest.kt create mode 100644 data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/image/PlatformBackupImageDecoderTest.kt create mode 100644 data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupExportStateStoreImplTest.kt create mode 100644 data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupPreferencesGatewayImplTest.kt create mode 100644 data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/image/BackupImageDecoder.kt create mode 100644 data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/image/BackupImageValidatorImpl.kt create mode 100644 data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/image/PlatformBackupImageDecoder.kt create mode 100644 data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupExportStateStoreImpl.kt create mode 100644 data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupPreferencesGatewayImpl.kt create mode 100644 data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/backup/PortablePreferenceField.kt create mode 100644 data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/backup/PortablePreferenceSchema.kt create mode 100644 data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/backup/PortablePreferenceType.kt create mode 100644 data/src/iosMain/kotlin/com/shifthackz/aisdv1/data/image/PlatformBackupImageDecoder.ios.kt create mode 100644 domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/mocks/ImmediateGenerationRestoreGate.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupCategory.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupEntry.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupExport.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupExportCompletion.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupExportIntent.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupExportOperation.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupExportStatus.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupImageBudget.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupInspection.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupPreferences.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupProgress.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupRecovery.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupRestoreNotice.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupRestoreRequest.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupRestoreResult.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupSelection.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupStartupStage.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupValue.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/gateway/GenerationRestoreGate.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/gateway/backup/BackupChangesGateway.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/gateway/backup/BackupExportStateStore.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/gateway/backup/BackupImageValidator.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/gateway/backup/BackupPreferencesGateway.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/CancelBackupExportUseCase.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/CompleteBackupExportUseCase.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/CreateBackupUseCase.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/DiscardBackupUseCase.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/DismissBackupExportUseCase.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/ExportBackupUseCase.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/GetBackupStartupStageUseCase.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/GetPendingBackupExportUseCase.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/InspectBackupUseCase.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/LoadBackupInventoryUseCase.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/LoadPendingBackupUseCase.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/ObserveBackupExportUseCase.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/RestoreBackupUseCase.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/SetBackupStartupStageUseCase.kt create mode 100644 domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/splash/SplashNavigationUseCaseImpl.kt create mode 100644 feature/backup/build.gradle.kts create mode 100644 feature/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/feature/backup/di/BackupPlatformModule.android.kt create mode 100644 feature/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.android.kt create mode 100644 feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupStagingCleanerTest.kt create mode 100644 feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BackupPreferencesCodecTest.kt create mode 100644 feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BinaryBackupArchiveCodecTest.kt create mode 100644 feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/codec/GalleryBackupCodecTest.kt create mode 100644 feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/export/DefaultBackupExportCoordinatorTest.kt create mode 100644 feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupProviderPlannerTest.kt create mode 100644 feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultGenerationRestoreGateTest.kt create mode 100644 feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriterTest.kt create mode 100644 feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/DiscardBackupUseCaseImplTest.kt create mode 100644 feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/LoadPendingBackupUseCaseImplTest.kt create mode 100644 feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/RestoreBackupUseCaseImplTest.kt create mode 100644 feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/SetBackupStartupStageUseCaseImplTest.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupArchiveStore.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupStagingCleaner.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupArchiveStore.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupStagingCleaner.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/StagedBackup.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BackupArchiveCodec.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BackupManifest.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BackupPreferencesCodec.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BackupSection.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BinaryBackupArchiveCodec.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BoundedBackupSource.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/DefaultBackupPreferencesCodec.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/DefaultGalleryBackupCodec.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/GalleryBackupCodec.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/GalleryBackupRecord.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/di/BackupModule.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/export/BackupExportCoordinator.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/export/DefaultBackupExportCoordinator.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupProviderPlan.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupProviderPlanner.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupRestoreGuard.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupRestoreWriter.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupSessionCodec.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupProviderPlanner.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupRestoreGuard.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupSessionCodec.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultGenerationRestoreGate.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriter.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CancelBackupExportUseCaseImpl.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CompleteBackupExportUseCaseImpl.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CreateBackupUseCaseImpl.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/DiscardBackupUseCaseImpl.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/DismissBackupExportUseCaseImpl.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/ExportBackupUseCaseImpl.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/GetBackupStartupStageUseCaseImpl.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/GetPendingBackupExportUseCaseImpl.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/InspectBackupUseCaseImpl.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/LoadBackupInventoryUseCaseImpl.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/LoadPendingBackupUseCaseImpl.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/ObserveBackupExportUseCaseImpl.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/RestoreBackupUseCaseImpl.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/SetBackupStartupStageUseCaseImpl.kt create mode 100644 feature/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/feature/backup/di/BackupPlatformModule.ios.kt create mode 100644 feature/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.ios.kt create mode 100644 presentation/app/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/app/BackupRouterSaverTest.kt create mode 100644 presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/BackupRouterSaver.kt create mode 100644 presentation/backup/build.gradle.kts create mode 100644 presentation/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDateFormatter.android.kt create mode 100644 presentation/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDocumentLauncher.android.kt create mode 100644 presentation/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupViewModelTest.kt create mode 100644 presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupEffect.kt create mode 100644 presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupIntent.kt create mode 100644 presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupPageState.kt create mode 100644 presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupScreen.kt create mode 100644 presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupScreenMode.kt create mode 100644 presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupState.kt create mode 100644 presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupViewModel.kt create mode 100644 presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/component/BackupSelectionList.kt create mode 100644 presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/create/CreateBackupScreen.kt create mode 100644 presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/di/BackupViewModelModule.kt create mode 100644 presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDateFormatter.kt create mode 100644 presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDocumentLauncher.kt create mode 100644 presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/restore/RestoreBackupScreen.kt create mode 100644 presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/service/BackupChangesGatewayImpl.kt create mode 100644 presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/welcome/RestoreWelcomeScreen.kt create mode 100644 presentation/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDateFormatter.ios.kt create mode 100644 presentation/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDocumentLauncher.ios.kt delete mode 100644 presentation/onboarding/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/onboarding/navigation/OnBoardingNavigation.kt create mode 100644 storage/schemas/com.shifthackz.aisdv1.storage.db.persistent.PersistentDatabase/14.json create mode 100644 storage/schemas/com.shifthackz.aisdv1.storage.db.persistent.PersistentDatabase/15.json create mode 100644 storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/dao/RestoreSessionDao.kt create mode 100644 storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/entity/RestoreSectionEntity.kt create mode 100644 storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/entity/RestoreSessionEntity.kt create mode 100644 storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/gateway/BackupStorage.kt create mode 100644 storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/gateway/RoomBackupStorage.kt diff --git a/core/localization/src/androidMain/res/values-de/strings.xml b/core/localization/src/androidMain/res/values-de/strings.xml index 4fb9e3dfd..307566af5 100644 --- a/core/localization/src/androidMain/res/values-de/strings.xml +++ b/core/localization/src/androidMain/res/values-de/strings.xml @@ -741,4 +741,39 @@ Laden Download abgeschlossen 🤩 Download fehlgeschlagen 😞 + Sichern und wiederherstellen + Anbieterkonfiguration + Galerie und Verlauf + Netzwerkstatistik + App-Einstellungen + %1$s Einträge + Leer oder von dieser Version nicht unterstützt + Anbieterauswahl + Wähle die zu sichernden Daten. Modelldateien sind nicht enthalten. + Anbietersicherungen enthalten API-Schlüssel und Passwörter. Die Datei ist nicht verschlüsselt. Bewahre sie sicher auf. + Wähle eine Sicherung und die gewünschten Daten. Galerie- und Netzwerkdaten werden hinzugefügt; gewählte App-Einstellungen werden ersetzt. + Sicherungsdatei wählen + SDAI %1$s · %2$s + Erstellt: %1$s + Übersprungen oder nicht unterstützt: %1$s + Nimm deine SDAI-Daten mit + Hast du eine Sicherung? Stelle Anbieter, Galerie und Einstellungen vor der Anbieterauswahl wieder her. Du kannst auch neu beginnen. + Aus Sicherung wiederherstellen + Weiter + Sicherung wird verarbeitet… + Fertig + Gewählte Daten wiederherstellen + Sicherung erstellen + Erstellen + Wiederherstellen + Vorgang fehlgeschlagen. Prüfe die Datei und den freien Speicher und versuche es erneut. + Abgebrochen. Bereits wiederhergestellte Bereiche bleiben erhalten. + Sicherung gespeichert + Wiederherstellung angehalten. Fertige Bereiche bleiben erhalten; ein erneuter Versuch setzt die übrigen fort. + Gewählte Daten wiederhergestellt + Anbietereinstellungen ersetzen? + Die Wiederherstellung ersetzt gespeicherte Einstellungen für: %1$s. Der aktuelle Anbieter bleibt ausgewählt. + Anbietereinstellungen ersetzen + Abbrechen + Gemeinsame Zugangsdaten bleiben für nicht ausgewählte Anbieter erhalten: %1$s. diff --git a/core/localization/src/androidMain/res/values-ru/strings.xml b/core/localization/src/androidMain/res/values-ru/strings.xml index 1874dd494..a773bf5f9 100644 --- a/core/localization/src/androidMain/res/values-ru/strings.xml +++ b/core/localization/src/androidMain/res/values-ru/strings.xml @@ -704,4 +704,39 @@ Загрузка Загрузка завершена 🤩 Не удалось загрузить 😞 + Резервное копирование + Настройки провайдеров + Галерея и история + Статистика сети + Настройки приложения + Элементов: %1$s + Нет данных или не поддерживается этой версией + Выбор провайдеров + Выберите данные для сохранения. Файлы моделей не включаются. + Копии провайдеров содержат API-ключи и пароли. Файл не зашифрован. Храните его в безопасном месте. + Выберите копию, затем данные для восстановления. Галерея и статистика добавляются; выбранные настройки заменяются. + Выбрать файл копии + SDAI %1$s · %2$s + Создано: %1$s + Пропущено или не поддерживается: %1$s + Перенесите свои данные SDAI + Есть резервная копия? Восстановите провайдеров, галерею и настройки перед выбором провайдера. Или начните с нуля. + Восстановить из копии + Продолжить + Обработка резервной копии… + Готово + Восстановить выбранные данные + Создать копию + Создать + Восстановить + Не удалось завершить. Проверьте файл и свободное место и повторите попытку. + Отменено. Уже восстановленные разделы сохранены. + Копия сохранена + Восстановление остановлено. Готовые разделы сохранены; повторная попытка продолжит остальные. + Выбранные данные восстановлены + Заменить настройки провайдеров? + Восстановление заменит сохранённые настройки: %1$s. Текущий провайдер останется выбранным. + Заменить настройки + Отмена + Общие учётные данные сохранены для невыбранных провайдеров: %1$s. diff --git a/core/localization/src/androidMain/res/values-tr/strings.xml b/core/localization/src/androidMain/res/values-tr/strings.xml index 1f0ac45b9..a85534a54 100644 --- a/core/localization/src/androidMain/res/values-tr/strings.xml +++ b/core/localization/src/androidMain/res/values-tr/strings.xml @@ -704,4 +704,39 @@ Yükleniyor İndirme tamamlandı 🤩 İndirme başarısız 😞 + Yedekleme ve geri yükleme + Sağlayıcı yapılandırması + Galeri ve geçmiş + Ağ istatistikleri + Uygulama ayarları + %1$s öğe + Boş veya bu sürümde desteklenmiyor + Sağlayıcı seçenekleri + Yanınıza alacağınız verileri seçin. Model dosyaları dahil değildir. + Sağlayıcı yedekleri API anahtarları ve parolalar içerir. Dosya şifrelenmez. Güvenli bir yerde saklayın. + Bir yedek ve geri yüklenecek verileri seçin. Galeri ve ağ verileri eklenir; seçili uygulama ayarları değiştirilir. + Yedek dosyası seç + SDAI %1$s · %2$s + Oluşturulma: %1$s + Atlanan veya desteklenmeyen: %1$s + SDAI verilerinizi yanınıza alın + Yedeğiniz var mı? Sağlayıcı seçmeden önce sağlayıcılarınızı, galerinizi ve tercihlerinizi geri yükleyin. Sıfırdan da başlayabilirsiniz. + Yedekten geri yükle + Devam et + Yedek işleniyor… + Bitti + Seçili verileri geri yükle + Yedek oluştur + Oluştur + Geri yükle + Tamamlanamadı. Dosyayı ve boş alanı kontrol edip tekrar deneyin. + İptal edildi. Tamamlanan geri yükleme bölümleri korunur. + Yedek kaydedildi + Geri yükleme durdu. Tamamlanan bölümler korunur; tekrar denemek kalan bölümlerden devam eder. + Seçili veriler geri yüklendi + Sağlayıcı ayarları değiştirilsin mi? + Geri yükleme şu sağlayıcıların kayıtlı ayarlarını değiştirir: %1$s. Geçerli sağlayıcınız seçili kalır. + Sağlayıcı ayarlarını değiştir + İptal + Seçilmeyen sağlayıcıları korumak için ortak kimlik bilgileri tutuldu: %1$s. diff --git a/core/localization/src/androidMain/res/values-uk/strings.xml b/core/localization/src/androidMain/res/values-uk/strings.xml index 432e2d8c7..f05edb7a2 100644 --- a/core/localization/src/androidMain/res/values-uk/strings.xml +++ b/core/localization/src/androidMain/res/values-uk/strings.xml @@ -704,4 +704,39 @@ Завантаження Завантаження завершено 🤩 Не вдалося завантажити 😞 + Резервне копіювання + Налаштування провайдерів + Галерея та історія + Статистика мережі + Налаштування застосунку + Елементів: %1$s + Немає даних або не підтримується цією версією + Вибір провайдерів + Виберіть дані для збереження. Файли моделей не включаються. + Копії провайдерів містять API-ключі та паролі. Файл не зашифровано. Зберігайте його в безпечному місці. + Виберіть копію, а потім дані для відновлення. Галерея та статистика додаються; вибрані налаштування замінюються. + Вибрати файл копії + SDAI %1$s · %2$s + Створено: %1$s + Пропущено або не підтримується: %1$s + Перенесіть свої дані SDAI + Маєте резервну копію? Відновіть провайдерів, галерею та налаштування перед вибором провайдера. Або почніть з нуля. + Відновити з копії + Продовжити + Обробка резервної копії… + Готово + Відновити вибрані дані + Створити копію + Створити + Відновити + Не вдалося завершити. Перевірте файл і вільне місце та спробуйте ще раз. + Скасовано. Уже відновлені розділи збережено. + Копію збережено + Відновлення зупинено. Завершені розділи збережено; повторна спроба продовжить решту. + Вибрані дані відновлено + Замінити налаштування провайдерів? + Відновлення замінить збережені налаштування: %1$s. Поточний провайдер залишиться вибраним. + Замінити налаштування + Скасувати + Спільні облікові дані збережено для невибраних провайдерів: %1$s. diff --git a/core/localization/src/androidMain/res/values-zh/strings.xml b/core/localization/src/androidMain/res/values-zh/strings.xml index 38ac75353..d90f86b61 100644 --- a/core/localization/src/androidMain/res/values-zh/strings.xml +++ b/core/localization/src/androidMain/res/values-zh/strings.xml @@ -756,4 +756,39 @@ 加载中 下载完成 🤩 下载失败 😞 + 备份与恢复 + 提供商配置 + 图库与历史记录 + 网络统计 + 应用设置 + %1$s 项 + 为空或此版本不支持 + 提供商选项 + 选择要备份的数据。不包含模型文件。 + 提供商备份包含 API 密钥和密码。此文件未加密,请妥善保管。 + 选择备份后选择要恢复的内容。图库和网络数据会累加,所选应用设置会被替换。 + 选择备份文件 + SDAI %1$s · %2$s + 创建时间:%1$s + 已跳过或不支持:%1$s + 带上您的 SDAI 数据 + 有备份吗?选择提供商前恢复提供商配置、图库和偏好设置。您也可以全新开始。 + 从备份恢复 + 继续 + 正在处理备份… + 完成 + 恢复所选数据 + 创建备份 + 创建 + 恢复 + 无法完成。请检查文件及可用存储空间后重试。 + 已取消。已完成恢复的部分将保留。 + 备份已保存 + 恢复已停止。已完成的部分将保留,重试将继续恢复其余部分。 + 所选数据已恢复 + 替换提供商设置? + 恢复将替换以下提供商的已保存设置:%1$s。当前提供商的选择将保持不变。 + 替换提供商设置 + 取消 + 为保留未选提供商的设置,共用凭据未更改:%1$s。 diff --git a/core/localization/src/androidMain/res/values/strings.xml b/core/localization/src/androidMain/res/values/strings.xml index e69b7980f..9ab4fec8a 100755 --- a/core/localization/src/androidMain/res/values/strings.xml +++ b/core/localization/src/androidMain/res/values/strings.xml @@ -741,4 +741,39 @@ Loading Download complete 🤩 Download failed 😞 + Backup and restore + Provider configuration + Gallery and history + Network statistics + App settings + %1$s items + Empty or unsupported by this version + Provider choices + Choose the data to take with you. Model files are not included. + Provider backups include API keys and passwords. This file is not encrypted. Store it somewhere safe. + Choose a backup, then select what to restore. Gallery and network data are added; selected app settings are replaced. + Choose backup file + SDAI %1$s · %2$s + Created: %1$s + Skipped or unsupported: %1$s + Bring your SDAI data with you + Have a backup? Restore your providers, gallery and preferences before choosing a provider. You can also start fresh. + Restore from backup + Continue + Working on your backup… + Done + Restore selected data + Create backup + Create + Restore + Could not finish. Check the file and available storage, then try again. + Canceled. Any completed restore sections are kept. + Backup saved + Restore stopped. Completed sections are kept; retry resumes the remaining sections. + Selected data restored + Replace provider settings? + Restoring will replace saved settings for: %1$s. Your current provider will stay selected. + Replace provider settings + Cancel + Shared sign-in credentials were kept to preserve unselected providers: %1$s. diff --git a/core/navigation/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/core/navigation/RootAppRouterTest.kt b/core/navigation/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/core/navigation/RootAppRouterTest.kt index 8b183fe67..cc4645c05 100644 --- a/core/navigation/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/core/navigation/RootAppRouterTest.kt +++ b/core/navigation/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/core/navigation/RootAppRouterTest.kt @@ -65,4 +65,17 @@ class RootAppRouterTest { assertEquals(AppRoute.Gallery, router.route.value) } + + @Test + fun `given cold start pending backup, startup opens recovery and user returns, expected Settings context restored`() { + // Given + val router = RootAppRouter() + // When + router.navigateToBackupRestore() + // Then + assertEquals(AppRoute.Backup(LaunchSource.SETTINGS), router.route.value) + router.navigateBack() + assertEquals(AppRoute.Settings, router.route.value) + } + } diff --git a/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/AppRoute.kt b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/AppRoute.kt index 43159bed2..34a00abb2 100644 --- a/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/AppRoute.kt +++ b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/AppRoute.kt @@ -14,10 +14,20 @@ sealed interface AppRoute { val destination: NavigationDestination /** - * Initial launch gate before onboarding, setup or configuration loading. - * + * Reusable backup route carrying settings or first-launch completion behavior. + * @param source Caller context; SPLASH requires configuration on exit. * @author Dmitriy Moroz */ + data class Backup(val source: LaunchSource = LaunchSource.SETTINGS) : AppRoute { + override val destination = NavigationDestination.BACKUP + } + + /** First-launch restore invitation, which cannot return to completed onboarding. @author Dmitriy Moroz */ + data object BackupWelcome : AppRoute { + override val destination = NavigationDestination.BACKUP_WELCOME + } + + /** Initial launch gate before onboarding, setup or configuration loading. @author Dmitriy Moroz */ data object Splash : AppRoute { override val destination = NavigationDestination.SPLASH } diff --git a/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/HomeTabRoutes.kt b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/HomeTabRoutes.kt index b212177e0..1cce7ce2c 100644 --- a/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/HomeTabRoutes.kt +++ b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/HomeTabRoutes.kt @@ -18,6 +18,8 @@ fun AppRoute.asHomeTabRoute(): AppRoute? = when (this) { AppRoute.Benchmark, AppRoute.StorageUsage, AppRoute.NetworkUsage, + AppRoute.BackupWelcome, + is AppRoute.Backup, AppRoute.Splash, is AppRoute.OnBoarding, is AppRoute.Setup, diff --git a/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/NavigationDestination.kt b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/NavigationDestination.kt index 1f8dfc187..d5258a22e 100644 --- a/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/NavigationDestination.kt +++ b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/NavigationDestination.kt @@ -7,6 +7,8 @@ package com.shifthackz.aisdv1.core.navigation */ enum class NavigationDestination { SPLASH, + BACKUP, + BACKUP_WELCOME, ON_BOARDING, SERVER_SETUP, CONFIGURATION_LOADER, diff --git a/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/RootAppRouter.kt b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/RootAppRouter.kt index df74a9801..c28239256 100644 --- a/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/RootAppRouter.kt +++ b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/RootAppRouter.kt @@ -1,5 +1,6 @@ package com.shifthackz.aisdv1.core.navigation +import com.shifthackz.aisdv1.core.navigation.router.BackupRouter import com.shifthackz.aisdv1.core.navigation.router.BenchmarkRouter import com.shifthackz.aisdv1.core.navigation.router.ConfigurationLoaderRouter import com.shifthackz.aisdv1.core.navigation.router.DebugMenuRouter @@ -31,6 +32,7 @@ import kotlinx.coroutines.flow.asStateFlow class RootAppRouter( initialRoute: AppRoute = AppRoute.Splash, ) : ServerSetupRouter, + BackupRouter, ConfigurationLoaderRouter, SplashRouter, DonateRouter, @@ -50,6 +52,28 @@ class RootAppRouter( WebUiRouter, OnBoardingRouter { + /** Opens reusable backup tabs from Settings. @author Dmitriy Moroz */ + override fun navigateToBackup() = navigateTo(AppRoute.Backup(LaunchSource.SETTINGS)) + + /** Consumes onboarding so Back cannot reopen it. @author Dmitriy Moroz */ + override fun navigateToBackupWelcome() = replaceRoute(AppRoute.BackupWelcome) + + /** + * Rebuilds Settings as the return destination before opening a cold-start pending backup operation. + * @author Dmitriy Moroz + */ + override fun navigateToBackupRestore() { + replaceRoute(AppRoute.Settings) + navigateTo(AppRoute.Backup(LaunchSource.SETTINGS)) + } + + /** Opens restore-only content during first launch. @author Dmitriy Moroz */ + override fun navigateToInitialRestore() = replaceRoute(AppRoute.Backup(LaunchSource.SPLASH)) + + /** Consumes first-launch backup before mandatory provider setup. @author Dmitriy Moroz */ + override fun navigateToInitialConfiguration() = + replaceRoute(AppRoute.Setup(LaunchSource.SPLASH)) + private val routeState = MutableStateFlow(initialRoute) /** @@ -162,14 +186,6 @@ class RootAppRouter( navigateTo(AppRoute.Setup(source)) } - /** - * Replaces completed onboarding with initial-launch server setup. - * - * @author Dmitriy Moroz - */ - override fun navigateToServerSetupAfterOnBoarding() { - replaceRoute(AppRoute.Setup(LaunchSource.SPLASH)) - } /** * Selects text-to-image, replacing the active home tab or consumed gallery-detail route. @@ -298,14 +314,6 @@ class RootAppRouter( navigateTo(AppRoute.OnBoarding(source)) } - /** - * Replaces completed onboarding with configuration loading. - * - * @author Dmitriy Moroz - */ - override fun navigateToPostOnBoardingConfigLoader() { - replaceRoute(AppRoute.ConfigurationLoader) - } /** * Opens the gallery result identified by its persisted item ID. @@ -403,6 +411,8 @@ fun AppRoute.isHomeRoute(): Boolean = when (this) { AppRoute.Settings, -> true + AppRoute.BackupWelcome, + is AppRoute.Backup, AppRoute.Splash, is AppRoute.OnBoarding, is AppRoute.Setup, @@ -427,6 +437,7 @@ fun AppRoute.isHomeRoute(): Boolean = when (this) { * @author Dmitriy Moroz */ private fun AppRoute.canFallBackToTextToImage(): Boolean = when (this) { + is AppRoute.Backup -> source == LaunchSource.SETTINGS AppRoute.ImageToImage, AppRoute.ImageInPaint, AppRoute.Gallery, @@ -445,6 +456,7 @@ private fun AppRoute.canFallBackToTextToImage(): Boolean = when (this) { AppRoute.Home, AppRoute.TextToImage, + AppRoute.BackupWelcome, AppRoute.Splash, is AppRoute.OnBoarding, is AppRoute.Setup, diff --git a/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/BackupRouter.kt b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/BackupRouter.kt new file mode 100644 index 000000000..719955b8f --- /dev/null +++ b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/BackupRouter.kt @@ -0,0 +1,31 @@ +package com.shifthackz.aisdv1.core.navigation.router + +/** + * Navigation out of reusable backup screens without exposing application assembly. + * @author Dmitriy Moroz + */ +interface BackupRouter { + /** + * Returns to the preceding Settings route after normal-flow backup. + * @author Dmitriy Moroz + */ + fun navigateBack() + + /** + * Consumes a reconstructed recovery route after provider setup has already completed. + * @author Dmitriy Moroz + */ + fun navigateToHomeScreen() + + /** + * Replaces the invitation with the restore-only first-launch screen. + * @author Dmitriy Moroz + */ + fun navigateToInitialRestore() + + /** + * Consumes first-launch recovery and opens provider selection/configuration. + * @author Dmitriy Moroz + */ + fun navigateToInitialConfiguration() +} diff --git a/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/NoOpBackupRouter.kt b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/NoOpBackupRouter.kt new file mode 100644 index 000000000..3975991fb --- /dev/null +++ b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/NoOpBackupRouter.kt @@ -0,0 +1,12 @@ +package com.shifthackz.aisdv1.core.navigation.router + +/** + * Inert backup navigation for previews and unbound composition roots. + * @author Dmitriy Moroz + */ +object NoOpBackupRouter : BackupRouter { + override fun navigateToHomeScreen() = Unit + override fun navigateBack() = Unit + override fun navigateToInitialRestore() = Unit + override fun navigateToInitialConfiguration() = Unit +} diff --git a/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/NoOpOnBoardingRouter.kt b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/NoOpOnBoardingRouter.kt index 57f2b4957..174fe19b1 100644 --- a/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/NoOpOnBoardingRouter.kt +++ b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/NoOpOnBoardingRouter.kt @@ -7,6 +7,8 @@ package com.shifthackz.aisdv1.core.navigation.router * @author Dmitriy Moroz */ object NoOpOnBoardingRouter : OnBoardingRouter { + override fun navigateToBackupWelcome() = Unit + /** * Ignores this action because no navigation host is attached. * @@ -14,17 +16,5 @@ object NoOpOnBoardingRouter : OnBoardingRouter { */ override fun navigateBack() = Unit - /** - * Ignores this action because no navigation host is attached. - * - * @author Dmitriy Moroz - */ - override fun navigateToServerSetupAfterOnBoarding() = Unit - /** - * Ignores this action because no navigation host is attached. - * - * @author Dmitriy Moroz - */ - override fun navigateToPostOnBoardingConfigLoader() = Unit } diff --git a/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/NoOpSettingsRouter.kt b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/NoOpSettingsRouter.kt index 5f588a5ab..a5cef2c07 100644 --- a/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/NoOpSettingsRouter.kt +++ b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/NoOpSettingsRouter.kt @@ -8,6 +8,8 @@ import com.shifthackz.aisdv1.core.navigation.LaunchSource * @author Dmitriy Moroz */ object NoOpSettingsRouter : SettingsRouter { + override fun navigateToBackup() = Unit + /** * Ignores this action because no navigation host is attached. * diff --git a/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/NoOpSplashRouter.kt b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/NoOpSplashRouter.kt index 317ad27ee..12828b27f 100644 --- a/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/NoOpSplashRouter.kt +++ b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/NoOpSplashRouter.kt @@ -6,6 +6,10 @@ package com.shifthackz.aisdv1.core.navigation.router * @author Dmitriy Moroz */ object NoOpSplashRouter : SplashRouter { + override fun navigateToInitialRestore() = Unit + override fun navigateToBackupWelcome() = Unit + override fun navigateToBackupRestore() = Unit + /** * Ignores this action because no navigation host is attached. * diff --git a/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/OnBoardingRouter.kt b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/OnBoardingRouter.kt index 81debf3f3..d249c3284 100644 --- a/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/OnBoardingRouter.kt +++ b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/OnBoardingRouter.kt @@ -8,23 +8,17 @@ package com.shifthackz.aisdv1.core.navigation.router */ interface OnBoardingRouter { /** - * Closes the drawer first, otherwise returns to the previous route or the generation-home fallback. - * + * Replaces completed onboarding with the first-launch recovery invitation. * @author Dmitriy Moroz */ - fun navigateBack() + fun navigateToBackupWelcome() /** - * Replaces completed onboarding with initial-launch server setup. + * Closes the drawer first, otherwise returns to the previous route or the generation-home fallback. * * @author Dmitriy Moroz */ - fun navigateToServerSetupAfterOnBoarding() + fun navigateBack() + - /** - * Replaces completed onboarding with configuration loading. - * - * @author Dmitriy Moroz - */ - fun navigateToPostOnBoardingConfigLoader() } diff --git a/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/SettingsRouter.kt b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/SettingsRouter.kt index bcc1f0254..c7d814b6c 100644 --- a/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/SettingsRouter.kt +++ b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/SettingsRouter.kt @@ -8,6 +8,12 @@ import com.shifthackz.aisdv1.core.navigation.LaunchSource * @author Dmitriy Moroz */ interface SettingsRouter { + /** + * Opens the standalone Create/Restore backup tabs. + * @author Dmitriy Moroz + */ + fun navigateToBackup() + /** * Opens the application drawer without changing the active route. * diff --git a/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/SplashRouter.kt b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/SplashRouter.kt index df1f5b4df..af530d411 100644 --- a/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/SplashRouter.kt +++ b/core/navigation/src/commonMain/kotlin/com/shifthackz/aisdv1/core/navigation/router/SplashRouter.kt @@ -7,6 +7,21 @@ package com.shifthackz.aisdv1.core.navigation.router * @author Dmitriy Moroz */ interface SplashRouter { + /** Resumes first-launch restore-only content before mandatory setup. @author Dmitriy Moroz */ + fun navigateToInitialRestore() + + /** + * Resumes pending restore work before normal configuration publication. + * @author Dmitriy Moroz + */ + fun navigateToBackupRestore() + + /** + * Resumes the first-launch restore invitation. + * @author Dmitriy Moroz + */ + fun navigateToBackupWelcome() + /** * Replaces splash with onboarding using the initial-launch source. * diff --git a/data/src/androidMain/kotlin/com/shifthackz/aisdv1/data/image/PlatformBackupImageDecoder.android.kt b/data/src/androidMain/kotlin/com/shifthackz/aisdv1/data/image/PlatformBackupImageDecoder.android.kt new file mode 100644 index 000000000..108bcef69 --- /dev/null +++ b/data/src/androidMain/kotlin/com/shifthackz/aisdv1/data/image/PlatformBackupImageDecoder.android.kt @@ -0,0 +1,43 @@ +package com.shifthackz.aisdv1.data.image + +import android.graphics.Bitmap +import android.graphics.BitmapFactory + +/** + * Uses bounds-only Android probing followed by power-of-two sampling; original pixels are never decoded. + * @author Dmitriy Moroz + */ +internal actual class PlatformBackupImageDecoder actual constructor() : BackupImageDecoder { + override fun dimensions(bytes: ByteArray): Pair { + val bounds = BitmapFactory.Options().apply { inJustDecodeBounds = true } + BitmapFactory.decodeByteArray(bytes, 0, bytes.size, bounds) + require(bounds.outWidth > 0 && bounds.outHeight > 0) { "Invalid backup image dimensions" } + return bounds.outWidth.toLong() to bounds.outHeight.toLong() + } + + override fun validateSample(bytes: ByteArray, maxEdge: Int) { + val (width, height) = dimensions(bytes) + var sample = 1L + while ((width - 1) / sample + 1 > maxEdge || (height - 1) / sample + 1 > maxEdge) sample *= 2 + require(sample <= Int.MAX_VALUE) { "Invalid backup sample size" } + val options = BitmapFactory.Options().apply { + inSampleSize = sample.toInt() + inPreferredConfig = Bitmap.Config.ARGB_8888 + inScaled = false + } + val image = requireNotNull( + BitmapFactory.decodeByteArray( + bytes, + 0, + bytes.size, + options + ) + ) { "Invalid backup image content" } + try { + require(image.width in 1..maxEdge && image.height in 1..maxEdge) { "Backup sample exceeds bounds" } + require(image.allocationByteCount.toLong() <= maxEdge.toLong() * maxEdge * 4) { "Backup sample exceeds byte budget" } + } finally { + image.recycle() + } + } +} diff --git a/data/src/androidMain/kotlin/com/shifthackz/aisdv1/data/preference/AndroidKeyValueStore.android.kt b/data/src/androidMain/kotlin/com/shifthackz/aisdv1/data/preference/AndroidKeyValueStore.android.kt index ae69b85ae..ba406286a 100644 --- a/data/src/androidMain/kotlin/com/shifthackz/aisdv1/data/preference/AndroidKeyValueStore.android.kt +++ b/data/src/androidMain/kotlin/com/shifthackz/aisdv1/data/preference/AndroidKeyValueStore.android.kt @@ -26,6 +26,28 @@ private class AndroidPreferencesKeyValueStore( */ private fun withMemoryLock(block: () -> T): T = synchronized(memoryLock, block) + /** + * Reports trusted persisted presence, including explicitly saved default values. + * @param key Existing preference key. + * @author Dmitriy Moroz + */ + override fun contains(key: String): Boolean = withMemoryLock { + val mask = configurationMask + when { + mask?.strings?.containsKey(key) == true -> mask.strings[key] != null + mask?.booleans?.containsKey(key) == true -> mask.booleans[key] != null + mask?.integers?.containsKey(key) == true -> mask.integers[key] != null + else -> preferences.contains(key) + } + } + + /** Finishes the exact quarantined write before a restore session may be abandoned. @author Dmitriy Moroz */ + override fun retryPendingWrite(): Boolean { + val batch = withMemoryLock { configurationMask } ?: return false + putSettingsDurably(batch.candidateStrings, batch.candidateBooleans, batch.candidateIntegers) + return true + } + private var configurationMask: ConfigurationMemoryMask? = null private var isBatchInFlight = false @@ -76,11 +98,29 @@ private class AndroidPreferencesKeyValueStore( override fun putConfigurationDurably( strings: Map, booleans: Map + ) = putSettingsDurably(strings, booleans, emptyMap()) + + /** + * Persists a complete typed backup settings batch with the same quarantine as configuration. + * @param strings String replacements. + * @param booleans Boolean replacements. + * @param integers Integer replacements. + * @author Dmitriy Moroz + */ + override fun putSettingsDurably( + strings: Map, + booleans: Map, + integers: Map, ) { val batch = withMemoryLock { if (isBatchInFlight) persistenceFailure() val current = configurationMask - if (current != null && !current.matches(strings, booleans)) persistenceFailure() + if (current != null && !current.matches( + strings, + booleans, + integers + ) + ) persistenceFailure() if (current == null) configurationMask = ConfigurationMemoryMask( strings.keys.associateWith { key -> preferences.getString(key, null) }, booleans.keys.associateWith { key -> @@ -91,6 +131,13 @@ private class AndroidPreferencesKeyValueStore( }, strings.toMap(), booleans.toMap(), + integers.keys.associateWith { key -> + if (preferences.contains(key)) preferences.getInt( + key, + 0 + ) else null + }, + integers.toMap(), ) isBatchInFlight = true checkNotNull(configurationMask) @@ -100,6 +147,7 @@ private class AndroidPreferencesKeyValueStore( check(preferences.edit().apply { batch.candidateStrings.forEach { (key, value) -> putString(key, value) } batch.candidateBooleans.forEach { (key, value) -> putBoolean(key, value) } + batch.candidateIntegers.forEach { (key, value) -> putInt(key, value) } }.commit()) { "Configuration persistence failed" } hasPersisted = true } finally { @@ -143,7 +191,11 @@ private class AndroidPreferencesKeyValueStore( * @author Dmitriy Moroz */ override fun getInt(key: String, default: Int): Int = - withMemoryLock { preferences.getInt(key, default) } + withMemoryLock { + val mask = configurationMask + if (mask?.integers?.containsKey(key) == true) mask.integers[key] ?: default + else preferences.getInt(key, default) + } /** * Writes an ordinary integer, rejecting accidental overlap with pending configuration keys. diff --git a/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/image/BackupImageValidatorImplTest.kt b/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/image/BackupImageValidatorImplTest.kt new file mode 100644 index 000000000..77627d5fc --- /dev/null +++ b/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/image/BackupImageValidatorImplTest.kt @@ -0,0 +1,69 @@ +package com.shifthackz.aisdv1.data.image + +import com.shifthackz.aisdv1.domain.entity.backup.BackupImageBudget +import io.mockk.every +import io.mockk.mockk +import io.mockk.verify +import org.junit.Assert.assertEquals +import org.junit.Assert.assertThrows +import org.junit.Test + +class BackupImageValidatorImplTest { + private val decoder = mockk(relaxed = true) + private val budget = BackupImageBudget(1024, 16_777_216, 128L * 1024 * 1024, 256) + private val validator = BackupImageValidatorImpl(decoder, budget) + private val encoded = byteArrayOf(1) + + @Test + fun `given compact image with enormous dimensions, native probe reports dimensions, expected pixel rejection before content allocation`() { + // Given + every { decoder.dimensions(encoded) } returns (16_384L to 16_384L) + // When + val failure = assertThrows(IllegalArgumentException::class.java) { validator(encoded) } + // Then + assertEquals("Backup image exceeds pixel budget", failure.message) + verify(exactly = 0) { decoder.validateSample(any(), any()) } + } + + @Test + fun `given image metadata beyond integral multiplication range, native probe reports dimensions, expected rejection without overflow or sample allocation`() { + // Given + every { decoder.dimensions(encoded) } returns (Long.MAX_VALUE to Long.MAX_VALUE) + // When + assertThrows(IllegalArgumentException::class.java) { validator(encoded) } + // Then + verify(exactly = 0) { decoder.validateSample(any(), any()) } + } + + @Test + fun `given pixel count admitted but decoded bytes over budget, validation begins, expected byte admission before sample allocation`() { + // Given + val constrained = BackupImageValidatorImpl(decoder, budget.copy(maxDecodedBytes = 7)) + every { decoder.dimensions(encoded) } returns (1L to 1L) + // When + val failure = assertThrows(IllegalArgumentException::class.java) { constrained(encoded) } + // Then + assertEquals("Backup image exceeds decoded byte budget", failure.message) + verify(exactly = 0) { decoder.validateSample(any(), any()) } + } + + @Test + fun `given encoded image exceeds admission, validation starts, expected native decoder never called`() { + // Given + val oversized = ByteArray(1025) + // When + assertThrows(IllegalArgumentException::class.java) { validator(oversized) } + // Then + verify(exactly = 0) { decoder.dimensions(any()); decoder.validateSample(any(), any()) } + } + + @Test + fun `given admitted dimensions, image validation runs, expected bounded native sample without original bitmap`() { + // Given + every { decoder.dimensions(encoded) } returns (4096L to 4096L) + // When + validator(encoded) + // Then + verify(exactly = 1) { decoder.validateSample(encoded, 256) } + } +} diff --git a/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/image/PlatformBackupImageDecoderTest.kt b/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/image/PlatformBackupImageDecoderTest.kt new file mode 100644 index 000000000..81f2da9e1 --- /dev/null +++ b/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/image/PlatformBackupImageDecoderTest.kt @@ -0,0 +1,58 @@ +package com.shifthackz.aisdv1.data.image + +import com.shifthackz.aisdv1.data.export.MediaStoreImageFixture +import com.shifthackz.aisdv1.domain.entity.backup.BackupImageBudget +import org.junit.Assert.assertEquals +import org.junit.Assert.assertThrows +import org.junit.Test +import org.junit.runner.RunWith +import org.robolectric.RobolectricTestRunner +import org.robolectric.annotation.Config +import org.robolectric.annotation.GraphicsMode +import java.nio.ByteBuffer +import java.util.zip.CRC32 + +@RunWith(RobolectricTestRunner::class) +@Config(sdk = [28]) +@GraphicsMode(GraphicsMode.Mode.NATIVE) +class PlatformBackupImageDecoderTest { + private val decoder = PlatformBackupImageDecoder() + private val validator = BackupImageValidatorImpl( + decoder, + BackupImageBudget(24 * 1024 * 1024, 16_777_216, 128L * 1024 * 1024, 256) + ) + + @Test + fun `given valid application image formats, bounded native validation runs, expected standard PNG JPEG WebP admitted`() { + // Given + val images = MediaStoreImageFixture.entries.map { it.bytes() } + // When + images.forEach(validator::invoke) + // Then + images.forEach { assertEquals(1L to 1L, decoder.dimensions(it)) } + } + + @Test + fun `given compact PNG with enormous header dimensions, native bounds probe runs, expected rejection before raster allocation`() { + // Given + val encoded = MediaStoreImageFixture.PNG.bytes() + ByteBuffer.wrap(encoded).apply { putInt(16, 16384); putInt(20, 16384) } + val crc = CRC32().apply { update(encoded, 12, 17) }.value.toInt() + ByteBuffer.wrap(encoded).putInt(29, crc) + // When + val failure = assertThrows(IllegalArgumentException::class.java) { validator(encoded) } + // Then + assertEquals(16384L to 16384L, decoder.dimensions(encoded)) + assertEquals("Backup image exceeds pixel budget", failure.message) + } + + @Test + fun `given corrupted encoded image, native validation runs, expected rejection without bitmap retention`() { + // Given + val encoded = MediaStoreImageFixture.PNG.bytes().copyOf(20) + // When + assertThrows(IllegalArgumentException::class.java) { validator(encoded) } + // Then + assertThrows(IllegalArgumentException::class.java) { validator("corrupted image".toByteArray()) } + } +} diff --git a/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/preference/PreferenceManagerImplTest.kt b/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/preference/PreferenceManagerImplTest.kt index ad3e6c2ea..ab7dadf6e 100644 --- a/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/preference/PreferenceManagerImplTest.kt +++ b/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/preference/PreferenceManagerImplTest.kt @@ -249,6 +249,20 @@ class PreferenceManagerImplTest { } private class InMemoryKeyValueStore : KeyValueStore { + override fun retryPendingWrite(): Boolean = false + override fun contains(key: String): Boolean = + key in strings || key in booleans || key in ints + + override fun putSettingsDurably( + strings: Map, + booleans: Map, + integers: Map + ) { + this.strings.putAll(strings) + this.booleans.putAll(booleans) + this.ints.putAll(integers) + } + override fun putConfigurationDurably( strings: Map, booleans: Map diff --git a/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupExportStateStoreImplTest.kt b/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupExportStateStoreImplTest.kt new file mode 100644 index 000000000..68a269bb6 --- /dev/null +++ b/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupExportStateStoreImplTest.kt @@ -0,0 +1,69 @@ +package com.shifthackz.aisdv1.data.preference.backup + +import com.shifthackz.aisdv1.data.preference.KeyValueStore +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportIntent +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportStatus +import io.mockk.every +import io.mockk.mockk +import io.mockk.verify +import org.junit.Assert.assertEquals +import org.junit.Assert.assertNull +import org.junit.Assert.assertThrows +import org.junit.Test + +class BackupExportStateStoreImplTest { + private var raw = "" + private val store = mockk(relaxed = true) { + every { getString(any(), any()) } answers { raw } + every { putStringDurably(any(), any()) } answers { raw = secondArg() } + } + private val records = BackupExportStateStoreImpl(store) + + @Test + fun `given pending destination copy, checked operation record round trips, expected source and destination association preserved`() { + // Given + val intent = BackupExportIntent( + "handle", + "backup.sdaibackup", + BackupExportStatus.COPYING, + "content://destination" + ) + // When + records.write(intent) + val restored = records.read() + // Then + assertEquals(intent, restored) + verify(exactly = 1) { store.putStringDurably("pending_export", any()) } + verify(exactly = 0) { store.putConfigurationDurably(any(), any()) } + } + + @Test + fun `given native export acknowledged, checked clear completes, expected no recoverable pending source`() { + // Given + records.write(BackupExportIntent("handle", "backup")) + // When + records.clear() + // Then + assertNull(records.read()) + } + + @Test + fun `given quarantined operation record, startup recovers exact write, expected dedicated preference owner retried`() { + // Given + every { store.retryPendingWrite() } returns true + // When + records.recoverPendingWrite() + // Then + verify(exactly = 1) { store.retryPendingWrite() } + } + + @Test + fun `given invalid operation record, startup reads unknown schema, expected failure without silent pending export loss`() { + // Given + raw = """{"version":2}""" + // When + val error = assertThrows(IllegalStateException::class.java) { records.read() } + // Then + assertEquals("Unsupported pending export state", error.message) + } +} diff --git a/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupPreferencesGatewayImplTest.kt b/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupPreferencesGatewayImplTest.kt new file mode 100644 index 000000000..d29e582dd --- /dev/null +++ b/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupPreferencesGatewayImplTest.kt @@ -0,0 +1,261 @@ +package com.shifthackz.aisdv1.data.preference.backup + +import com.shifthackz.aisdv1.data.preference.KeyValueStore +import com.shifthackz.aisdv1.data.preference.KeyValueConfigurationStore +import com.shifthackz.aisdv1.data.preference.PreferenceManagerImpl +import com.shifthackz.aisdv1.domain.entity.Grid +import com.shifthackz.aisdv1.domain.entity.ServerSource +import com.shifthackz.aisdv1.domain.feature.auth.AuthorizationCredentials +import com.shifthackz.aisdv1.domain.entity.NetworkTimeout +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory +import com.shifthackz.aisdv1.domain.entity.backup.BackupPreferences +import com.shifthackz.aisdv1.domain.entity.backup.BackupStartupStage +import com.shifthackz.aisdv1.domain.entity.backup.BackupValue +import com.shifthackz.aisdv1.domain.preference.PreferenceManager +import io.mockk.every +import io.mockk.mockk +import io.mockk.verify +import org.junit.Assert.assertEquals +import org.junit.Assert.assertFalse +import org.junit.Assert.assertThrows +import org.junit.Assert.assertTrue +import org.junit.Before +import org.junit.Test + +class BackupPreferencesGatewayImplTest { + private val strings = mutableMapOf() + private val flags = mutableMapOf() + private val integers = mutableMapOf() + private val store = mockk(relaxed = true) + private val preferences = mockk(relaxed = true) + private val gateway = BackupPreferencesGatewayImpl(store, preferences) + + @Before + fun setup() { + every { store.contains(any()) } answers { firstArg() in strings || firstArg() in flags || firstArg() in integers } + every { store.getString(any(), any()) } answers { strings[firstArg()] ?: secondArg() } + every { store.getBoolean(any(), any()) } answers { flags[firstArg()] ?: secondArg() } + every { store.getInt(any(), any()) } answers { integers[firstArg()] ?: secondArg() } + every { + store.putConfigurationDurably( + any(), + any() + ) + } answers { strings.putAll(firstArg()); flags.putAll(secondArg()); Unit } + every { preferences.galleryGrid } returns Grid.Fixed2 + every { preferences.connectionTimeout } returns NetworkTimeout.TWO_MINUTES + every { preferences.generationRequestTimeout } returns NetworkTimeout.TWO_MINUTES + every { preferences.designColorToken } returns "default" + every { preferences.designDarkThemeToken } returns "FRAPPE" + every { preferences.languageCode } returns "" + every { preferences.textToImageCfgScale } returns 7f + every { preferences.imageToImageCfgScale } returns 7f + every { preferences.textToImageSamplingSteps } returns 20 + every { preferences.imageToImageSamplingSteps } returns 20 + } + + @Test + fun `given fresh default settings, backup inventory reads effective preferences, expected settings remain selectable`() { + // Given + every { preferences.autoSaveAiResults } returns true + // When + val snapshot = gateway.read() + // Then + assertEquals(BackupValue.Flag(true), snapshot.settings["autoSave"]) + assertEquals(BackupValue.Integer(20), snapshot.settings["textToImageSteps"]) + assertTrue(snapshot.providers.isEmpty()) + } + + @Test + fun `given configured provider with explicit saved default, snapshot is read, expected default presence preserved`() { + // Given + flags["key_demo_mode"] = false + strings["key_server_url"] = "https://configured" + // When + val snapshot = gateway.read() + // Then + assertEquals(BackupValue.Flag(false), snapshot.providers["custom"]?.get("demoMode")) + assertFalse(snapshot.providers.getValue("custom").containsKey("model")) + } + + @Test + fun `given existing installation, recovery stage is absent, expected completed stage without invitation`() { + // Given + flags["key_on_boarding_complete"] = true + // When + val stage = gateway.readStartupStage() + // Then + assertEquals(BackupStartupStage.COMPLETE, stage) + } + + @Test + fun `given onboarding completion, invitation is persisted, expected atomic completed flag and stage batch`() { + // Given + flags["key_on_boarding_complete"] = false + // When + gateway.writeStartupStage(BackupStartupStage.INVITATION) + // Then + verify { + store.putConfigurationDurably( + mapOf("key_backup_startup_stage" to "INVITATION"), + mapOf("key_on_boarding_complete" to true) + ) + } + verify(exactly = 0) { store.putBoolean(any(), any()) } + assertEquals(true, flags["key_on_boarding_complete"]) + assertEquals(BackupStartupStage.INVITATION, gateway.readStartupStage()) + } + + @Test + fun `given inactive provider restore, selected provider is OpenAI, expected selection and revision untouched`() { + // Given + strings["key_provider_selection_state"] = "open_ai|41" + // When + gateway.writeProviders( + mapOf("custom" to mapOf("serverUrl" to BackupValue.Text("https://imported"))), + null + ) + // Then + assertEquals("open_ai|41", strings["key_provider_selection_state"]) + assertEquals("https://imported", strings["key_server_url"]) + } + + @Test + fun `given selected provider restore, connection changes, expected same source with advanced revision`() { + // Given + strings["key_provider_selection_state"] = "easy_diffusion|41" + strings["key_easy_diffusion_url"] = "https://old" + // When + gateway.writeProviders( + mapOf("easy_diffusion" to mapOf("serverUrl" to BackupValue.Text("https://imported"))), + null + ) + // Then + assertEquals("easy_diffusion|42", strings["key_provider_selection_state"]) + } + + @Test + fun `given future provider and removed field, compatibility filtering runs, expected only known fields retained`() { + // Given + val incoming = BackupPreferences( + mapOf( + "future_provider" to mapOf("secret" to BackupValue.Text("ignored")), + "custom" to mapOf( + "serverUrl" to BackupValue.Text("keep"), + "removed" to BackupValue.Text("ignored") + ) + ), mapOf("future_setting" to BackupValue.Flag(true)) + ) + // When + val supported = gateway.filterSupported(incoming) + // Then + assertEquals( + mapOf("custom" to mapOf("serverUrl" to BackupValue.Text("keep"))), + supported.providers + ) + assertTrue(supported.settings.isEmpty()) + } + + @Test + fun `given known provider field, malformed scalar type is imported, expected validation failure`() { + // Given + val incoming = BackupPreferences( + mapOf("custom" to mapOf("serverUrl" to BackupValue.Integer(1))), + emptyMap() + ) + // When + val failure = + assertThrows(IllegalArgumentException::class.java) { gateway.filterSupported(incoming) } + // Then + assertEquals("Invalid portable preference type", failure.message) + } + + @Test + fun `given removed MNN backend and future timeout option, compatibility filtering runs, expected unsupported values skipped`() { + // Given + val incoming = BackupPreferences( + mapOf("local_mnn" to mapOf("backend" to BackupValue.Text("removed_backend"))), + mapOf("generationTimeout" to BackupValue.Integer(999)) + ) + // When + val supported = gateway.filterSupported(incoming) + // Then + assertTrue(supported.providers.getValue("local_mnn").isEmpty()) + assertTrue(supported.settings.isEmpty()) + } + + @Test + fun `given quarantined authorization association only, checked replay commits, expected provider invalidation without ordinary field changes`() { + // Given + strings["key_authorization_commit_id"] = "old" + every { store.retryPendingWrite() } answers { + strings["key_authorization_commit_id"] = "new"; true + } + // When + val recovered = gateway.recoverPendingWrite() + // Then + assertEquals(setOf(BackupCategory.PROVIDERS), recovered) + } + + @Test + fun `given quarantined language setting, checked replay commits, expected settings invalidation for locale refresh`() { + // Given + every { preferences.languageCode } answers { strings["key_language"].orEmpty() } + every { store.retryPendingWrite() } answers { strings["key_language"] = "de"; true } + // When + val recovered = gateway.recoverPendingWrite() + // Then + assertEquals(setOf(BackupCategory.SETTINGS), recovered) + } + + @Test + fun `given normal Horde configuration commit, full default provider snapshot persists, expected only meaningful provider group in backup`() { + // Given + val configuration = KeyValueConfigurationStore(store) + val candidate = configuration.getConfiguration(AuthorizationCredentials.None) + .copy(source = ServerSource.HORDE, hordeApiKey = "horde-key") + configuration.commitConfiguration(candidate, "association") + val actualPreferences = PreferenceManagerImpl(store) + val actualGateway = BackupPreferencesGatewayImpl(store, actualPreferences) + // When + val snapshot = actualGateway.read() + // Then + assertTrue(strings.containsKey("key_swarm_server_url")) + assertTrue(flags.containsKey("key_demo_mode")) + assertEquals(setOf("horde"), snapshot.providers.keys) + assertFalse(snapshot.providers.containsKey("custom")) + assertFalse(snapshot.providers.containsKey("swarm_ui")) + } + + @Test + fun `given normal configured A1111 commit with explicit false default, backup reads existing provider, expected saved default retained for conflict checks`() { + // Given + val configuration = KeyValueConfigurationStore(store) + val candidate = configuration.getConfiguration(AuthorizationCredentials.None) + .copy(serverUrl = "https://configured", demoMode = false) + configuration.commitConfiguration(candidate, "association") + val actualGateway = BackupPreferencesGatewayImpl(store, PreferenceManagerImpl(store)) + // When + val snapshot = actualGateway.read() + // Then + assertEquals( + BackupValue.Flag(false), + snapshot.providers.getValue("custom").getValue("demoMode") + ) + assertFalse(snapshot.providers.containsKey("swarm_ui")) + } + + @Test + fun `given legacy partial provider with missing mandatory fields, backup reads nondefault model choice, expected partial configuration retained without setup validation`() { + // Given + strings["key_open_ai_compatible_model"] = "user-model" + // When + val snapshot = gateway.read() + // Then + assertEquals( + BackupValue.Text("user-model"), + snapshot.providers.getValue("open_ai_compatible").getValue("model") + ) + } + +} diff --git a/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/di/DataCoreModule.kt b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/di/DataCoreModule.kt index a5a6050fd..0652144a4 100644 --- a/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/di/DataCoreModule.kt +++ b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/di/DataCoreModule.kt @@ -1,5 +1,11 @@ package com.shifthackz.aisdv1.data.di +import com.shifthackz.aisdv1.data.image.BackupImageValidatorImpl +import com.shifthackz.aisdv1.data.image.BackupImageDecoder +import com.shifthackz.aisdv1.data.image.PlatformBackupImageDecoder +import com.shifthackz.aisdv1.domain.entity.backup.BackupImageBudget +import com.shifthackz.aisdv1.domain.gateway.backup.BackupImageValidator + import com.shifthackz.aisdv1.domain.datasource.EasyDiffusionRemoteDataSource import com.shifthackz.aisdv1.data.remote.KtorEasyDiffusionRemoteDataSource @@ -181,6 +187,16 @@ import org.koin.dsl.module * @author Dmitriy Moroz */ val coreDataModule = module { + single { + BackupImageBudget( + maxEncodedBytes = 24 * 1024 * 1024, + maxPixels = 16_777_216L, + maxDecodedBytes = 128L * 1024 * 1024, + validationEdge = 256 + ) + } + single { PlatformBackupImageDecoder() } + single { BackupImageValidatorImpl(get(), get()) } single { GalleryReadGatewayImpl(get()) } single { AuthenticatedConnectionProviderImpl( diff --git a/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/di/PreferenceDataModule.kt b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/di/PreferenceDataModule.kt index 297070cb9..da75fb1bc 100644 --- a/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/di/PreferenceDataModule.kt +++ b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/di/PreferenceDataModule.kt @@ -11,14 +11,25 @@ import com.shifthackz.aisdv1.domain.preference.SessionPreference import com.shifthackz.aisdv1.network.client.ConnectionTimeoutProvider import com.shifthackz.aisdv1.network.client.GenerationTimeoutProvider import org.koin.core.qualifier.named +import com.shifthackz.aisdv1.data.preference.backup.BackupPreferencesGatewayImpl +import com.shifthackz.aisdv1.domain.gateway.backup.BackupPreferencesGateway +import com.shifthackz.aisdv1.domain.gateway.backup.BackupExportStateStore +import com.shifthackz.aisdv1.data.preference.backup.BackupExportStateStoreImpl import org.koin.dsl.module /** - * Exposes the `preferenceDataModule` value used by the SDAI data layer. + * Shares one checked preference owner across provider settings, portable backup adapters and live timeout readers. * * @author Dmitriy Moroz */ val preferenceDataModule = module { + single { BackupExportStateStoreImpl(createKeyValueStore("aisdv1_backup_operations")) } + single { + BackupPreferencesGatewayImpl( + get(named(KEY_PREFERENCE_MANAGER)), + get() + ) + } single(named(KEY_PREFERENCE_MANAGER)) { createKeyValueStore( KEY_PREFERENCE_MANAGER @@ -48,7 +59,7 @@ val preferenceDataModule = module { } /** - * Exposes the `KEY_PREFERENCE_MANAGER` value used by the SDAI data layer. + * Installed preference-suite name; preserving it retains settings across app updates. * * @author Dmitriy Moroz */ diff --git a/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/image/BackupImageDecoder.kt b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/image/BackupImageDecoder.kt new file mode 100644 index 000000000..75a94bbf4 --- /dev/null +++ b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/image/BackupImageDecoder.kt @@ -0,0 +1,22 @@ +package com.shifthackz.aisdv1.data.image + +/** + * Backup-specific native probing and bounded content decoding; never materializes the original bitmap. + * @author Dmitriy Moroz + */ +internal interface BackupImageDecoder { + /** + * Reads original pixel dimensions through metadata-only platform APIs before pixel allocation. + * @param bytes Encoded image already admitted by the shared byte budget. + * @author Dmitriy Moroz + */ + fun dimensions(bytes: ByteArray): Pair + + /** + * Rejects undecodable content by creating and immediately releasing a bounded native sample. + * @param bytes Encoded image whose original dimensions passed admission. + * @param maxEdge Maximum sample width and height in pixels. + * @author Dmitriy Moroz + */ + fun validateSample(bytes: ByteArray, maxEdge: Int) +} diff --git a/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/image/BackupImageValidatorImpl.kt b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/image/BackupImageValidatorImpl.kt new file mode 100644 index 000000000..6c55fd709 --- /dev/null +++ b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/image/BackupImageValidatorImpl.kt @@ -0,0 +1,25 @@ +package com.shifthackz.aisdv1.data.image + +import com.shifthackz.aisdv1.domain.entity.backup.BackupImageBudget +import com.shifthackz.aisdv1.domain.gateway.backup.BackupImageValidator + +/** + * Admits native header dimensions before any content bitmap is allocated, then validates a small sample. + * @param decoder Backup-specific metadata probe and bounded platform content decoder. + * @param budget Shared encoded, original-pixel and sampled-allocation admission limits. + * @author Dmitriy Moroz + */ +internal class BackupImageValidatorImpl( + private val decoder: BackupImageDecoder, + private val budget: BackupImageBudget, +) : BackupImageValidator { + override fun invoke(bytes: ByteArray) { + require(bytes.isNotEmpty() && bytes.size <= budget.maxEncodedBytes) { "Backup image exceeds encoded budget" } + val (width, height) = decoder.dimensions(bytes) + require(width > 0 && height > 0 && width <= budget.maxPixels / height) { "Backup image exceeds pixel budget" } + val pixels = width * height + // PNG may carry 16-bit RGBA; use eight bytes per pixel without overflowing a multiplication. + require(pixels <= budget.maxDecodedBytes / 8) { "Backup image exceeds decoded byte budget" } + decoder.validateSample(bytes, budget.validationEdge) + } +} diff --git a/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/image/PlatformBackupImageDecoder.kt b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/image/PlatformBackupImageDecoder.kt new file mode 100644 index 000000000..6b36fcc4d --- /dev/null +++ b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/image/PlatformBackupImageDecoder.kt @@ -0,0 +1,7 @@ +package com.shifthackz.aisdv1.data.image + +/** + * Supplies native metadata-only probing and sampled validation on each supported platform. + * @author Dmitriy Moroz + */ +internal expect class PlatformBackupImageDecoder() : BackupImageDecoder diff --git a/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/ConfigurationMemoryMask.kt b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/ConfigurationMemoryMask.kt index 88971cab9..5b1084b74 100644 --- a/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/ConfigurationMemoryMask.kt +++ b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/ConfigurationMemoryMask.kt @@ -8,6 +8,8 @@ package com.shifthackz.aisdv1.data.preference * @param booleans Trusted boolean entries immediately before replacement. * @param candidateStrings Exact string batch admitted for checked retry. * @param candidateBooleans Exact boolean batch admitted for checked retry. + * @param integers Trusted integer values before a checked settings batch. + * @param candidateIntegers Exact integer replacements retained for retry. * @author Dmitriy Moroz */ internal class ConfigurationMemoryMask( @@ -15,6 +17,8 @@ internal class ConfigurationMemoryMask( val booleans: Map, val candidateStrings: Map, val candidateBooleans: Map, + val integers: Map = emptyMap(), + val candidateIntegers: Map = emptyMap(), ) { /** * Identifies entries owned by the pending transaction, excluding unrelated settings. @@ -22,15 +26,21 @@ internal class ConfigurationMemoryMask( * @param key Preference key being accessed. * @author Dmitriy Moroz */ - fun contains(key: String): Boolean = strings.containsKey(key) || booleans.containsKey(key) + fun contains(key: String): Boolean = + strings.containsKey(key) || booleans.containsKey(key) || integers.containsKey(key) /** * Allows only a identical complete key/value batch to retry while reads are masked. * * @param strings Proposed string replacements. * @param booleans Proposed boolean replacements. + * @param integers Proposed integer replacements. * @author Dmitriy Moroz */ - fun matches(strings: Map, booleans: Map): Boolean = - candidateStrings == strings && candidateBooleans == booleans + fun matches( + strings: Map, + booleans: Map, + integers: Map = emptyMap() + ): Boolean = + candidateStrings == strings && candidateBooleans == booleans && candidateIntegers == integers } diff --git a/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/KeyValueStore.kt b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/KeyValueStore.kt index f3e461680..02884e0fb 100644 --- a/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/KeyValueStore.kt +++ b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/KeyValueStore.kt @@ -7,6 +7,29 @@ package com.shifthackz.aisdv1.data.preference * @author Dmitriy Moroz */ internal interface KeyValueStore { + /** Retries only an existing quarantined typed batch; false means no write was pending. @author Dmitriy Moroz */ + fun retryPendingWrite(): Boolean + + /** + * Distinguishes explicitly saved defaults from missing portable fields. + * @param key Existing preference key. + * @author Dmitriy Moroz + */ + fun contains(key: String): Boolean + + /** + * Checks one atomic typed settings batch before acknowledging restore. + * @param strings String replacements. + * @param booleans Boolean replacements. + * @param integers Integer replacements. + * @author Dmitriy Moroz + */ + fun putSettingsDurably( + strings: Map, + booleans: Map, + integers: Map + ) + /** * Reads a trusted string, using the caller fallback when its prior entry was absent. * diff --git a/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupExportStateStoreImpl.kt b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupExportStateStoreImpl.kt new file mode 100644 index 000000000..054d3e1af --- /dev/null +++ b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupExportStateStoreImpl.kt @@ -0,0 +1,62 @@ +package com.shifthackz.aisdv1.data.preference.backup + +import com.shifthackz.aisdv1.data.preference.KeyValueStore +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportIntent +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportStatus +import com.shifthackz.aisdv1.domain.gateway.backup.BackupExportStateStore +import kotlinx.serialization.json.Json +import kotlinx.serialization.json.JsonPrimitive +import kotlinx.serialization.json.buildJsonObject +import kotlinx.serialization.json.jsonObject +import kotlinx.serialization.json.jsonPrimitive + +/** + * Stores only export handles and result association in a separate checked preference suite. + * @param store Dedicated backup-operation preference owner; never the provider/settings suite. + * @author Dmitriy Moroz + */ +internal class BackupExportStateStoreImpl(private val store: KeyValueStore) : + BackupExportStateStore { + override fun recoverPendingWrite() { + store.retryPendingWrite() + } + + override fun read(): BackupExportIntent? { + val raw = store.getString(KEY) + if (raw.isEmpty()) return null + val fields = Json.parseToJsonElement(raw).jsonObject + check(fields.getValue("version").jsonPrimitive.content == "1") { "Unsupported pending export state" } + return validated( + BackupExportIntent( + fields.getValue("handle").jsonPrimitive.content, + fields.getValue("filename").jsonPrimitive.content, + BackupExportStatus.valueOf(fields.getValue("status").jsonPrimitive.content), + fields["destination"]?.jsonPrimitive?.content, + ) + ) + } + + override fun write(intent: BackupExportIntent) { + validated(intent) + store.putStringDurably(KEY, buildJsonObject { + put("version", JsonPrimitive(1)) + put("handle", JsonPrimitive(intent.handle)) + put("filename", JsonPrimitive(intent.filename)) + put("status", JsonPrimitive(intent.status.name)) + intent.destination?.let { put("destination", JsonPrimitive(it)) } + }.toString()) + } + + private fun validated(intent: BackupExportIntent): BackupExportIntent { + check(intent.handle.isNotBlank() && intent.filename.isNotBlank()) { "Missing pending export identity" } + check(intent.status != BackupExportStatus.NONE && intent.status != BackupExportStatus.PROCESSING) { "Invalid durable export stage" } + check(intent.status != BackupExportStatus.COPYING || !intent.destination.isNullOrBlank()) { "Missing pending export destination" } + return intent + } + + override fun clear() = store.putStringDurably(KEY, "") + + private companion object { + const val KEY = "pending_export" + } +} diff --git a/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupPreferencesGatewayImpl.kt b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupPreferencesGatewayImpl.kt new file mode 100644 index 000000000..7ef06ca93 --- /dev/null +++ b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupPreferencesGatewayImpl.kt @@ -0,0 +1,223 @@ +package com.shifthackz.aisdv1.data.preference.backup + +import com.shifthackz.aisdv1.data.preference.KeyValueStore +import com.shifthackz.aisdv1.data.preference.readProviderSelection +import com.shifthackz.aisdv1.domain.preference.PreferenceManager +import com.shifthackz.aisdv1.domain.entity.Grid +import com.shifthackz.aisdv1.domain.entity.ColorToken +import com.shifthackz.aisdv1.domain.entity.DarkThemeToken +import com.shifthackz.aisdv1.domain.entity.NetworkTimeout +import com.shifthackz.aisdv1.domain.entity.MnnBackend +import com.shifthackz.aisdv1.domain.entity.Configuration +import com.shifthackz.aisdv1.domain.entity.HuggingFaceModel +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory +import com.shifthackz.aisdv1.domain.entity.backup.BackupPreferences +import com.shifthackz.aisdv1.domain.entity.backup.BackupValue +import com.shifthackz.aisdv1.domain.entity.backup.BackupStartupStage +import com.shifthackz.aisdv1.domain.gateway.backup.BackupPreferencesGateway + +/** + * Reads and checks portable preference batches without publishing partial or untrusted writes. + * @param store Shared typed preference owner, also used by normal settings/configuration. + * @param preferences Effective user settings, including defaults that have never been explicitly saved. + * @author Dmitriy Moroz + */ +internal class BackupPreferencesGatewayImpl( + private val store: KeyValueStore, + private val preferences: PreferenceManager +) : BackupPreferencesGateway { + override fun recoverPendingWrite(): Set { + val previous = read() + val authorizationCommit = store.getString("key_authorization_commit_id") + val selection = store.getString("key_provider_selection_state") + if (!store.retryPendingWrite()) return emptySet() + val current = read() + return buildSet { + if (previous.providers != current.providers || authorizationCommit != store.getString("key_authorization_commit_id") || selection != store.getString( + "key_provider_selection_state" + ) + ) add(BackupCategory.PROVIDERS) + if (previous.settings != current.settings) add(BackupCategory.SETTINGS) + } + } + + override fun filterSupported(preferences: BackupPreferences) = BackupPreferences( + providers = preferences.providers.mapNotNull { (provider, values) -> + val schema = PortablePreferenceSchema.providers[provider] ?: return@mapNotNull null + provider to filterFields(values, schema) + }.toMap(), + settings = filterFields(preferences.settings, PortablePreferenceSchema.settings), + ) + + private fun filterFields( + values: Map, + schema: Map + ): Map = values.filter { (id, value) -> + val field = schema[id] ?: return@filter false + val hasCorrectType = when (field.type) { + PortablePreferenceType.TEXT -> value is BackupValue.Text + PortablePreferenceType.FLAG -> value is BackupValue.Flag + PortablePreferenceType.INTEGER -> value is BackupValue.Integer + } + require(hasCorrectType) { "Invalid portable preference type" } + when (id) { + "backend" -> (value as BackupValue.Text).value in MnnBackend.entries.map { it.key } + "colorToken" -> (value as BackupValue.Text).value in ColorToken.entries.map { it.name } + "darkToken" -> (value as BackupValue.Text).value in DarkThemeToken.entries.map { it.name } + "galleryGrid" -> (value as BackupValue.Integer).value in Grid.entries.indices + "connectionTimeout", "generationTimeout" -> (value as BackupValue.Integer).value in NetworkTimeout.entries.map { it.seconds } + "textToImageSteps", "imageToImageSteps" -> (value as BackupValue.Integer).value > 0 + "textToImageCfg", "imageToImageCfg" -> (value as BackupValue.Text).value.toFloatOrNull() + ?.let { it.isFinite() && it >= 0 } == true + + "language" -> (value as BackupValue.Text).value in setOf( + "", + "en", + "de", + "ru", + "tr", + "uk", + "zh" + ) + + else -> true + } + } + + override fun read() = BackupPreferences( + providers = PortablePreferenceSchema.providers.mapValues { (_, fields) -> readFields(fields) } + .filter { (provider, fields) -> hasProviderConfiguration(provider, fields) }, + settings = mapOf( + "dynamicColors" to BackupValue.Flag(preferences.designUseSystemColorPalette), + "systemDarkTheme" to BackupValue.Flag(preferences.designUseSystemDarkTheme), + "darkTheme" to BackupValue.Flag(preferences.designDarkTheme), + "colorToken" to BackupValue.Text(preferences.designColorToken), + "darkToken" to BackupValue.Text(preferences.designDarkThemeToken), + "language" to BackupValue.Text(preferences.languageCode), + "galleryGrid" to BackupValue.Integer(preferences.galleryGrid.ordinal), + "autoSave" to BackupValue.Flag(preferences.autoSaveAiResults), + "saveToMediaStore" to BackupValue.Flag(preferences.saveToMediaStore), + "advancedOptions" to BackupValue.Flag(preferences.formAdvancedOptionsAlwaysShow), + "taggedInput" to BackupValue.Flag(preferences.formPromptTaggedInput), + "connectionTimeout" to BackupValue.Integer(preferences.connectionTimeout.seconds), + "generationTimeout" to BackupValue.Integer(preferences.generationRequestTimeout.seconds), + "backgroundGeneration" to BackupValue.Flag(preferences.backgroundGeneration), + "monitorConnection" to BackupValue.Flag(preferences.monitorConnectivity), + "textToImageSteps" to BackupValue.Integer(preferences.textToImageSamplingSteps), + "textToImageCfg" to BackupValue.Text(preferences.textToImageCfgScale.toString()), + "imageToImageSteps" to BackupValue.Integer(preferences.imageToImageSamplingSteps), + "imageToImageCfg" to BackupValue.Text(preferences.imageToImageCfgScale.toString()), + ), + ) + + override fun writeProviders( + providers: Map>, + authorizationCommitId: String? + ) { + val fields = providers.flatMap { (provider, values) -> + val schema = PortablePreferenceSchema.providers[provider].orEmpty() + values.mapNotNull { (id, value) -> schema[id]?.let { it to value } } + }.toMap() + val strings = mutableMapOf() + val flags = mutableMapOf() + collect(fields, strings, flags, mutableMapOf()) + authorizationCommitId?.let { strings["key_authorization_commit_id"] = it } + val selection = store.readProviderSelection() + val source = selection.first.key + if (providers.containsKey(source) && (authorizationCommitId != null || fields.any { (field, value) -> + readField( + field + ) != value + })) { + val revision = selection.second + check(revision < Long.MAX_VALUE) { "Provider revision exhausted" } + strings["key_provider_selection_state"] = "$source|${revision + 1}" + } + store.putConfigurationDurably(strings, flags) + } + + override fun writeSettings(settings: Map) { + val fields = + settings.mapNotNull { (id, value) -> PortablePreferenceSchema.settings[id]?.let { it to value } } + .toMap() + val strings = mutableMapOf() + val flags = mutableMapOf() + val integers = mutableMapOf() + collect(fields, strings, flags, integers) + store.putSettingsDurably(strings, flags, integers) + } + + override fun readStartupStage(): BackupStartupStage = + BackupStartupStage.entries.firstOrNull { it.name == store.getString("key_backup_startup_stage") } + ?: if (store.getBoolean("key_on_boarding_complete")) BackupStartupStage.COMPLETE else BackupStartupStage.INVITATION + + override fun writeStartupStage(stage: BackupStartupStage) { + if (stage == BackupStartupStage.INVITATION) { + store.putConfigurationDurably( + mapOf("key_backup_startup_stage" to stage.name), + mapOf("key_on_boarding_complete" to true) + ) + } else store.putStringDurably("key_backup_startup_stage", stage.name) + } + + /** + * Distinguishes legacy complete-snapshot defaults from saved provider or partial setup data. + * Normal configuration commits materialize every provider's empty/default fields; those alone + * cannot make a provider configured or consume the shared Basic Auth association. + * @param provider Stable provider wire identifier. + * @param fields Persisted portable values, retaining explicit defaults for an existing configuration. + * @author Dmitriy Moroz + */ + private fun hasProviderConfiguration( + provider: String, + fields: Map + ): Boolean = + fields.any { (id, value) -> + when (value) { + is BackupValue.Flag -> value.isTrue + is BackupValue.Integer -> value.value != 0 + is BackupValue.Text -> { + val implicitDefault = when { + provider == "open_ai_compatible" && id == "model" -> Configuration().openAiCompatibleModel + provider == "hugging_face" && id == "model" -> HuggingFaceModel.default.alias + provider == "local_mnn" && id == "backend" -> MnnBackend.CPU.key + else -> "" + } + value.value.isNotBlank() && value.value != implicitDefault + } + + BackupValue.Unsupported -> false + } + } + + private fun readFields(fields: Map): Map = + fields.filterValues { store.contains(it.key) }.mapValues { (_, field) -> readField(field) } + + private fun readField(field: PortablePreferenceField): BackupValue = when (field.type) { + PortablePreferenceType.TEXT -> BackupValue.Text(store.getString(field.key)) + PortablePreferenceType.FLAG -> BackupValue.Flag(store.getBoolean(field.key)) + PortablePreferenceType.INTEGER -> BackupValue.Integer(store.getInt(field.key)) + } + + private fun collect( + fields: Map, + strings: MutableMap, + flags: MutableMap, + integers: MutableMap + ) { + fields.forEach { (field, value) -> + when { + field.type == PortablePreferenceType.TEXT && value is BackupValue.Text -> strings[field.key] = + value.value + + field.type == PortablePreferenceType.FLAG && value is BackupValue.Flag -> flags[field.key] = + value.isTrue + + field.type == PortablePreferenceType.INTEGER && value is BackupValue.Integer -> integers[field.key] = + value.value + + else -> error("Invalid portable preference type") + } + } + } +} diff --git a/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/backup/PortablePreferenceField.kt b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/backup/PortablePreferenceField.kt new file mode 100644 index 000000000..1b67f1412 --- /dev/null +++ b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/backup/PortablePreferenceField.kt @@ -0,0 +1,9 @@ +package com.shifthackz.aisdv1.data.preference.backup + +/** + * Storage binding for one stable portable field. + * @param key Existing platform preference key. + * @param type Expected persisted value type. + * @author Dmitriy Moroz + */ +internal data class PortablePreferenceField(val key: String, val type: PortablePreferenceType) diff --git a/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/backup/PortablePreferenceSchema.kt b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/backup/PortablePreferenceSchema.kt new file mode 100644 index 000000000..fcaf12d17 --- /dev/null +++ b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/backup/PortablePreferenceSchema.kt @@ -0,0 +1,174 @@ +package com.shifthackz.aisdv1.data.preference.backup + +/** + * Wire-to-storage allowlist. Keys outside these maps can never be imported from a backup. + * @author Dmitriy Moroz + */ +internal object PortablePreferenceSchema { + val providers = mapOf( + "custom" to mapOf( + "serverUrl" to PortablePreferenceField("key_server_url", PortablePreferenceType.TEXT), + "demoMode" to PortablePreferenceField("key_demo_mode", PortablePreferenceType.FLAG), + "model" to PortablePreferenceField("key_sd_model", PortablePreferenceType.TEXT) + ), + "swarm_ui" to mapOf( + "serverUrl" to PortablePreferenceField( + "key_swarm_server_url", + PortablePreferenceType.TEXT + ), + "model" to PortablePreferenceField("key_swarm_model", PortablePreferenceType.TEXT) + ), + "easy_diffusion" to mapOf( + "serverUrl" to PortablePreferenceField( + "key_easy_diffusion_url", + PortablePreferenceType.TEXT + ), + "model" to PortablePreferenceField( + "key_easy_diffusion_model", + PortablePreferenceType.TEXT + ) + ), + "open_ai_compatible" to mapOf( + "serverUrl" to PortablePreferenceField( + "key_open_ai_compatible_url", + PortablePreferenceType.TEXT + ), + "model" to PortablePreferenceField( + "key_open_ai_compatible_model", + PortablePreferenceType.TEXT + ), + "apiKey" to PortablePreferenceField( + "key_open_ai_compatible_api_key", + PortablePreferenceType.TEXT + ) + ), + "open_ai" to mapOf( + "apiKey" to PortablePreferenceField("key_open_ai_api_key", PortablePreferenceType.TEXT) + ), + "horde" to mapOf( + "apiKey" to PortablePreferenceField("key_horde_api_key", PortablePreferenceType.TEXT) + ), + "hugging_face" to mapOf( + "apiKey" to PortablePreferenceField( + "key_hugging_face_api_key", + PortablePreferenceType.TEXT + ), + "model" to PortablePreferenceField( + "key_hugging_face_model_key", + PortablePreferenceType.TEXT + ) + ), + "stability_ai" to mapOf( + "apiKey" to PortablePreferenceField( + "key_stability_ai_api_key", + PortablePreferenceType.TEXT + ), + "model" to PortablePreferenceField( + "key_stability_ai_engine_id_key", + PortablePreferenceType.TEXT + ) + ), + "fal_ai" to mapOf( + "apiKey" to PortablePreferenceField("key_fal_ai_api_key", PortablePreferenceType.TEXT) + ), + "arli_ai" to mapOf( + "apiKey" to PortablePreferenceField("key_arli_ai_api_key", PortablePreferenceType.TEXT), + "model" to PortablePreferenceField("key_arli_ai_model_key", PortablePreferenceType.TEXT) + ), + "local" to mapOf( + "model" to PortablePreferenceField("key_local_model_id", PortablePreferenceType.TEXT), + "useNnapi" to PortablePreferenceField("key_local_nn_api", PortablePreferenceType.FLAG) + ), + "local_google_media_pipe" to mapOf( + "model" to PortablePreferenceField( + "key_mediapipe_model_id", + PortablePreferenceType.TEXT + ) + ), + "local_stable_diffusion_cpp" to mapOf( + "model" to PortablePreferenceField("key_sdxl_model_id", PortablePreferenceType.TEXT) + ), + "local_apple_core_ml" to mapOf( + "model" to PortablePreferenceField("key_core_ml_model_id", PortablePreferenceType.TEXT) + ), + "local_apple_bonsai" to mapOf( + "model" to PortablePreferenceField("key_bonsai_model_id", PortablePreferenceType.TEXT) + ), + "local_mnn" to mapOf( + "model" to PortablePreferenceField("key_mnn_model_id", PortablePreferenceType.TEXT), + "backend" to PortablePreferenceField("key_mnn_backend", PortablePreferenceType.TEXT) + ) + ) + val settings = mapOf( + "dynamicColors" to PortablePreferenceField( + "key_design_dynamic_colors", + PortablePreferenceType.FLAG + ), + "systemDarkTheme" to PortablePreferenceField( + "key_design_system_dark_theme", + PortablePreferenceType.FLAG + ), + "darkTheme" to PortablePreferenceField( + "key_design_dark_theme", + PortablePreferenceType.FLAG + ), + "colorToken" to PortablePreferenceField( + "key_design_color_token_theme", + PortablePreferenceType.TEXT + ), + "darkToken" to PortablePreferenceField( + "key_design_dark_color_token_theme", + PortablePreferenceType.TEXT + ), + "language" to PortablePreferenceField("key_language_code", PortablePreferenceType.TEXT), + "galleryGrid" to PortablePreferenceField( + "key_gallery_grid", + PortablePreferenceType.INTEGER + ), + "autoSave" to PortablePreferenceField("key_ai_auto_save", PortablePreferenceType.FLAG), + "saveToMediaStore" to PortablePreferenceField( + "key_save_to_media_store", + PortablePreferenceType.FLAG + ), + "advancedOptions" to PortablePreferenceField( + "key_always_show_advanced_options", + PortablePreferenceType.FLAG + ), + "taggedInput" to PortablePreferenceField( + "key_prompt_tagged_input_kb", + PortablePreferenceType.FLAG + ), + "connectionTimeout" to PortablePreferenceField( + "key_connection_timeout_seconds", + PortablePreferenceType.INTEGER + ), + "generationTimeout" to PortablePreferenceField( + "key_generation_request_timeout_seconds", + PortablePreferenceType.INTEGER + ), + "backgroundGeneration" to PortablePreferenceField( + "key_background_generation", + PortablePreferenceType.FLAG + ), + "monitorConnection" to PortablePreferenceField( + "key_monitor_connection", + PortablePreferenceType.FLAG + ), + "textToImageSteps" to PortablePreferenceField( + "key_text_to_image_sampling_steps", + PortablePreferenceType.INTEGER + ), + "textToImageCfg" to PortablePreferenceField( + "key_text_to_image_cfg_scale", + PortablePreferenceType.TEXT + ), + "imageToImageSteps" to PortablePreferenceField( + "key_image_to_image_sampling_steps", + PortablePreferenceType.INTEGER + ), + "imageToImageCfg" to PortablePreferenceField( + "key_image_to_image_cfg_scale", + PortablePreferenceType.TEXT + ) + ) +} diff --git a/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/backup/PortablePreferenceType.kt b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/backup/PortablePreferenceType.kt new file mode 100644 index 000000000..53af3040a --- /dev/null +++ b/data/src/commonMain/kotlin/com/shifthackz/aisdv1/data/preference/backup/PortablePreferenceType.kt @@ -0,0 +1,7 @@ +package com.shifthackz.aisdv1.data.preference.backup + +/** + * Allowed platform preference primitives; arbitrary objects are not portable. + * @author Dmitriy Moroz + */ +internal enum class PortablePreferenceType { TEXT, FLAG, INTEGER } diff --git a/data/src/iosMain/kotlin/com/shifthackz/aisdv1/data/image/PlatformBackupImageDecoder.ios.kt b/data/src/iosMain/kotlin/com/shifthackz/aisdv1/data/image/PlatformBackupImageDecoder.ios.kt new file mode 100644 index 000000000..c513af0cf --- /dev/null +++ b/data/src/iosMain/kotlin/com/shifthackz/aisdv1/data/image/PlatformBackupImageDecoder.ios.kt @@ -0,0 +1,202 @@ +@file:OptIn(ExperimentalForeignApi::class) + +package com.shifthackz.aisdv1.data.image + +import kotlinx.cinterop.ExperimentalForeignApi +import kotlinx.cinterop.IntVar +import kotlinx.cinterop.LongVar +import kotlinx.cinterop.addressOf +import kotlinx.cinterop.alloc +import kotlinx.cinterop.memScoped +import kotlinx.cinterop.ptr +import kotlinx.cinterop.reinterpret +import kotlinx.cinterop.usePinned +import kotlinx.cinterop.value +import platform.CoreFoundation.CFDataCreate +import platform.CoreFoundation.CFDictionaryCreateMutable +import platform.CoreFoundation.CFDictionarySetValue +import platform.CoreFoundation.CFDictionaryGetValue +import platform.CoreFoundation.CFDictionaryRef +import platform.CoreFoundation.CFNumberCreate +import platform.CoreFoundation.CFNumberGetValue +import platform.CoreFoundation.CFRelease +import platform.CoreFoundation.CFStringRef +import platform.CoreFoundation.kCFAllocatorDefault +import platform.CoreFoundation.kCFBooleanTrue +import platform.CoreFoundation.kCFBooleanFalse +import platform.CoreFoundation.kCFNumberIntType +import platform.CoreFoundation.kCFTypeDictionaryKeyCallBacks +import platform.CoreFoundation.kCFTypeDictionaryValueCallBacks +import platform.CoreFoundation.kCFNumberSInt64Type +import platform.CoreGraphics.CGImageGetBytesPerRow +import platform.CoreGraphics.CGImageGetHeight +import platform.CoreGraphics.CGImageGetWidth +import platform.CoreGraphics.CGImageRelease +import platform.ImageIO.CGImageSourceCopyPropertiesAtIndex +import platform.ImageIO.CGImageSourceCreateThumbnailAtIndex +import platform.ImageIO.CGImageSourceCreateWithData +import platform.ImageIO.CGImageSourceGetStatusAtIndex +import platform.ImageIO.CGImageSourceRef +import platform.ImageIO.kCGImagePropertyPixelHeight +import platform.ImageIO.kCGImagePropertyPixelWidth +import platform.ImageIO.kCGImageSourceCreateThumbnailFromImageAlways +import platform.ImageIO.kCGImageSourceShouldCache +import platform.ImageIO.kCGImageSourceShouldCacheImmediately +import platform.ImageIO.kCGImageSourceThumbnailMaxPixelSize +import platform.ImageIO.kCGImageStatusComplete + +/** + * Reads uncached ImageIO properties before creating only a bounded thumbnail for content validation. + * @author Dmitriy Moroz + */ +internal actual class PlatformBackupImageDecoder actual constructor() : BackupImageDecoder { + override fun dimensions(bytes: ByteArray): Pair = withSource(bytes) { source -> + val properties = requireNotNull( + CGImageSourceCopyPropertiesAtIndex( + source, + 0u, + null + ) + ) { "Invalid backup image properties" } + try { + dimension(properties, kCGImagePropertyPixelWidth) to dimension( + properties, + kCGImagePropertyPixelHeight + ) + } finally { + CFRelease(properties) + } + } + + override fun validateSample(bytes: ByteArray, maxEdge: Int) = withSource(bytes) { source -> + val options = imageOptions(maxEdge) + try { + val image = requireNotNull( + CGImageSourceCreateThumbnailAtIndex( + source, + 0u, + options + ) + ) { "Invalid backup image content" } + try { + val width = CGImageGetWidth(image).toLong() + val height = CGImageGetHeight(image).toLong() + val rowBytes = CGImageGetBytesPerRow(image).toLong() + require(width in 1..maxEdge.toLong() && height in 1..maxEdge.toLong()) { "Backup sample exceeds bounds" } + require(rowBytes > 0 && rowBytes <= maxEdge.toLong() * maxEdge * 8 / height) { "Backup sample exceeds byte budget" } + require( + CGImageSourceGetStatusAtIndex( + source, + 0u + ) == kCGImageStatusComplete + ) { "Incomplete backup image content" } + } finally { + CGImageRelease(image) + } + } finally { + CFRelease(options) + } + } + + /** + * Creates an owned CF dictionary with native CFString keys and retained CFBoolean/CFNumber values. + * @param maxEdge Thumbnail edge, or null for metadata-only source options with pixel caching disabled. + * @author Dmitriy Moroz + */ + private fun imageOptions(maxEdge: Int?): CFDictionaryRef = memScoped { + val options = requireNotNull( + CFDictionaryCreateMutable( + kCFAllocatorDefault, + 0, + kCFTypeDictionaryKeyCallBacks.ptr, + kCFTypeDictionaryValueCallBacks.ptr, + ) + ) + try { + if (maxEdge == null) { + CFDictionarySetValue(options, kCGImageSourceShouldCache, kCFBooleanFalse) + } else { + CFDictionarySetValue( + options, + kCGImageSourceCreateThumbnailFromImageAlways, + kCFBooleanTrue + ) + CFDictionarySetValue(options, kCGImageSourceShouldCacheImmediately, kCFBooleanTrue) + val edge = alloc() + edge.value = maxEdge + val number = + requireNotNull(CFNumberCreate(kCFAllocatorDefault, kCFNumberIntType, edge.ptr)) + try { + CFDictionarySetValue(options, kCGImageSourceThumbnailMaxPixelSize, number) + } finally { + CFRelease(number) + } + } + options + } catch (failure: Throwable) { + CFRelease(options) + throw failure + } + } + + /** + * Extracts an integral native dimension without rasterizing the encoded image. + * @param properties ImageIO metadata dictionary retained by the caller. + * @param key Native pixel width or height property identifier. + * @author Dmitriy Moroz + */ + private fun dimension(properties: CFDictionaryRef, key: CFStringRef?): Long = memScoped { + val number = requireNotNull( + CFDictionaryGetValue( + properties, + key + ) + ) { "Missing backup image dimension" } + val result = alloc() + require( + CFNumberGetValue( + number.reinterpret(), + kCFNumberSInt64Type, + result.ptr + ) + ) { "Invalid backup image dimension" } + result.value + } + + /** + * Creates a metadata-only source with deferred pixel caching, releasing every native owner on failure. + * @param bytes Bounded encoded image retained by the caller. + * @param block Metadata probing or sampled validation before native source release. + * @author Dmitriy Moroz + */ + private fun withSource(bytes: ByteArray, block: (CGImageSourceRef) -> T): T { + require(bytes.isNotEmpty()) { "Empty backup image" } + val data = requireNotNull(bytes.usePinned { + CFDataCreate( + kCFAllocatorDefault, + it.addressOf(0).reinterpret(), + bytes.size.toLong() + ) + }) + try { + val options = imageOptions(null) + val source = try { + requireNotNull( + CGImageSourceCreateWithData( + data, + options + ) + ) { "Invalid backup image" } + } finally { + CFRelease(options) + } + try { + return block(source) + } finally { + CFRelease(source) + } + } finally { + CFRelease(data) + } + } +} diff --git a/data/src/iosMain/kotlin/com/shifthackz/aisdv1/data/preference/AppleKeyValueStore.ios.kt b/data/src/iosMain/kotlin/com/shifthackz/aisdv1/data/preference/AppleKeyValueStore.ios.kt index 50bf4b8a4..59ca37809 100644 --- a/data/src/iosMain/kotlin/com/shifthackz/aisdv1/data/preference/AppleKeyValueStore.ios.kt +++ b/data/src/iosMain/kotlin/com/shifthackz/aisdv1/data/preference/AppleKeyValueStore.ios.kt @@ -33,6 +33,28 @@ private class NsUserDefaultsKeyValueStore( } } + /** + * Reports trusted persisted presence, including explicitly saved default values. + * @param key Existing preference key. + * @author Dmitriy Moroz + */ + override fun contains(key: String): Boolean = withMemoryLock { + val mask = configurationMask + when { + mask?.strings?.containsKey(key) == true -> mask.strings[key] != null + mask?.booleans?.containsKey(key) == true -> mask.booleans[key] != null + mask?.integers?.containsKey(key) == true -> mask.integers[key] != null + else -> defaults.objectForKey(key) != null + } + } + + /** Finishes the exact quarantined write before a restore session may be abandoned. @author Dmitriy Moroz */ + override fun retryPendingWrite(): Boolean { + val batch = withMemoryLock { configurationMask } ?: return false + putSettingsDurably(batch.candidateStrings, batch.candidateBooleans, batch.candidateIntegers) + return true + } + private var configurationMask: ConfigurationMemoryMask? = null private var isBatchInFlight = false @@ -83,11 +105,29 @@ private class NsUserDefaultsKeyValueStore( override fun putConfigurationDurably( strings: Map, booleans: Map + ) = putSettingsDurably(strings, booleans, emptyMap()) + + /** + * Persists a complete typed backup settings batch with the same quarantine as configuration. + * @param strings String replacements. + * @param booleans Boolean replacements. + * @param integers Integer replacements. + * @author Dmitriy Moroz + */ + override fun putSettingsDurably( + strings: Map, + booleans: Map, + integers: Map, ) { val batch = withMemoryLock { if (isBatchInFlight) persistenceFailure() val current = configurationMask - if (current != null && !current.matches(strings, booleans)) persistenceFailure() + if (current != null && !current.matches( + strings, + booleans, + integers + ) + ) persistenceFailure() if (current == null) configurationMask = ConfigurationMemoryMask( strings.keys.associateWith { key -> defaults.stringForKey(key) }, booleans.keys.associateWith { key -> @@ -97,6 +137,12 @@ private class NsUserDefaultsKeyValueStore( }, strings.toMap(), booleans.toMap(), + integers.keys.associateWith { key -> + if (defaults.objectForKey(key) != null) defaults.integerForKey( + key + ).toInt() else null + }, + integers.toMap(), ) isBatchInFlight = true checkNotNull(configurationMask) @@ -105,7 +151,7 @@ private class NsUserDefaultsKeyValueStore( try { withMemoryLock { val domain = defaults.persistentDomainForName(name) - .orEmpty() + batch.candidateStrings + batch.candidateBooleans + .orEmpty() + batch.candidateStrings + batch.candidateBooleans + batch.candidateIntegers defaults.setPersistentDomain(domain, name) } check(defaults.synchronize()) { "Configuration persistence failed" } @@ -151,7 +197,10 @@ private class NsUserDefaultsKeyValueStore( * @author Dmitriy Moroz */ override fun getInt(key: String, default: Int): Int = withMemoryLock { - if (defaults.objectForKey(key) == null) default else defaults.integerForKey(key).toInt() + val mask = configurationMask + if (mask?.integers?.containsKey(key) == true) mask.integers[key] ?: default + else if (defaults.objectForKey(key) == null) default else defaults.integerForKey(key) + .toInt() } /** diff --git a/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/mocks/ImmediateGenerationRestoreGate.kt b/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/mocks/ImmediateGenerationRestoreGate.kt new file mode 100644 index 000000000..53800025f --- /dev/null +++ b/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/mocks/ImmediateGenerationRestoreGate.kt @@ -0,0 +1,9 @@ +package com.shifthackz.aisdv1.domain.mocks + +import com.shifthackz.aisdv1.domain.gateway.GenerationRestoreGate + +/** Runs isolated generation component cases without the feature-owned process admission state. @author Dmitriy Moroz */ +class ImmediateGenerationRestoreGate : GenerationRestoreGate { + override suspend fun generating(block: suspend () -> T): T = block() + override suspend fun restoring(block: suspend () -> T): T = block() +} diff --git a/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/ImageToImageUseCaseImplTest.kt b/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/ImageToImageUseCaseImplTest.kt index 9081c1126..97cb2780e 100644 --- a/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/ImageToImageUseCaseImplTest.kt +++ b/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/ImageToImageUseCaseImplTest.kt @@ -1,5 +1,6 @@ package com.shifthackz.aisdv1.domain.usecase.generation +import com.shifthackz.aisdv1.domain.mocks.ImmediateGenerationRestoreGate import com.shifthackz.aisdv1.domain.entity.ServerSource import com.shifthackz.aisdv1.domain.entity.EasyDiffusionConnection import com.shifthackz.aisdv1.domain.entity.EasyDiffusionRequest @@ -48,6 +49,7 @@ class ImageToImageUseCaseImplTest { private val generateEasyDiffusion = mockk() private val captureEasyDiffusion = mockk() private val useCase = ImageToImageUseCaseImpl( + generationRestoreGate = ImmediateGenerationRestoreGate(), generateEasyDiffusionUseCase = generateEasyDiffusion, captureEasyDiffusionConnectionUseCase = captureEasyDiffusion, stableDiffusionGenerationRepository = stubStableDiffusionGenerationRepository, @@ -62,8 +64,9 @@ class ImageToImageUseCaseImplTest { ) @Test - fun `Easy Diffusion captures one immutable connection and delegates the complete batch once`() = + fun `given Easy Diffusion generation, complete batch is submitted, generation is requested, expected one immutable connection capture`() = runTest { + // Given every { stubPreferenceManager.source } returns ServerSource.EASY_DIFFUSION val connection = EasyDiffusionConnection("https://server.example", "folder/model", 7) coEvery { captureEasyDiffusion(7, null) } returns connection @@ -74,7 +77,10 @@ class ImageToImageUseCaseImplTest { sourceSnapshot = ServerSource.EASY_DIFFUSION, providerSelectionRevision = 7, batchCount = 3, seed = "4294967295", base64Image = "AQID", denoisingStrength = 0.5f ) - assertSame(results, useCase(payload)) + // When + val actual = useCase(payload) + // Then + assertSame(results, actual) assertEquals(connection.url, request.captured.url) assertEquals(connection.model, request.captured.model) assertEquals(7L, request.captured.selectionRevision) @@ -84,179 +90,265 @@ class ImageToImageUseCaseImplTest { } @Test - fun `stale Easy Diffusion capture stops dispatch before any generation`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.EASY_DIFFUSION - coEvery { captureEasyDiffusion(6, null) } throws stubException - assertSame(stubException, runCatching { - useCase( - mockImageToImagePayload.copy( - sourceSnapshot = ServerSource.EASY_DIFFUSION, - providerSelectionRevision = 6, base64Image = "AQID", denoisingStrength = 0.5f + fun `given Easy Diffusion generation, captured connection is stale, generation is requested, expected no generation dispatch`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.EASY_DIFFUSION + coEvery { captureEasyDiffusion(6, null) } throws stubException + // When + val actual = runCatching { + useCase( + mockImageToImagePayload.copy( + sourceSnapshot = ServerSource.EASY_DIFFUSION, + providerSelectionRevision = 6, + base64Image = "AQID", + denoisingStrength = 0.5f + ) ) - ) - }.exceptionOrNull()) - coVerify(exactly = 0) { generateEasyDiffusion(any()) } - } + } + // Then + assertSame(stubException, actual.exceptionOrNull()) + coVerify(exactly = 0) { generateEasyDiffusion(any()) } + } @Test - fun `given source is AUTOMATIC1111, expected stable diffusion generation`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.AUTOMATIC1111 - coEvery { stubStableDiffusionGenerationRepository.generateFromImage(any()) } returns listOf( - mockAiGenerationResult - ) + fun `given source is AUTOMATIC1111, generation is requested, expected stable diffusion generation`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.AUTOMATIC1111 + coEvery { stubStableDiffusionGenerationRepository.generateFromImage(any()) } returns listOf( + mockAiGenerationResult + ) - val actual = useCase(mockImageToImagePayload.copy(batchCount = 1)) + // When - assertEquals(listOf(mockAiGenerationResult), actual) - coVerify(exactly = 1) { stubStableDiffusionGenerationRepository.generateFromImage(any()) } - } + val actual = useCase(mockImageToImagePayload.copy(batchCount = 1)) + + // Then + + assertEquals(listOf(mockAiGenerationResult), actual) + coVerify(exactly = 1) { stubStableDiffusionGenerationRepository.generateFromImage(any()) } + } @Test - fun `given source is SWARM_UI, expected swarm ui generation`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.SWARM_UI - coEvery { stubSwarmUiGenerationRepository.generateFromImage(any()) } returns mockAiGenerationResult + fun `given source is SWARM_UI, generation is requested, expected swarm ui generation`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.SWARM_UI + coEvery { stubSwarmUiGenerationRepository.generateFromImage(any()) } returns mockAiGenerationResult - val actual = useCase(mockImageToImagePayload.copy(batchCount = 1)) + // When - assertEquals(listOf(mockAiGenerationResult), actual) - coVerify(exactly = 1) { stubSwarmUiGenerationRepository.generateFromImage(any()) } - } + val actual = useCase(mockImageToImagePayload.copy(batchCount = 1)) + + // Then + + assertEquals(listOf(mockAiGenerationResult), actual) + coVerify(exactly = 1) { stubSwarmUiGenerationRepository.generateFromImage(any()) } + } @Test - fun `given source is HORDE, expected horde generation`() = runTest { + fun `given source is HORDE, generation is requested, expected horde generation`() = runTest { + // Given every { stubPreferenceManager.source } returns ServerSource.HORDE coEvery { stubHordeGenerationRepository.generateFromImage(any()) } returns mockAiGenerationResult + // When + val actual = useCase(mockImageToImagePayload.copy(batchCount = 1)) + // Then + assertEquals(listOf(mockAiGenerationResult), actual) coVerify(exactly = 1) { stubHordeGenerationRepository.generateFromImage(any()) } } @Test - fun `given source is HUGGING_FACE, expected hugging face generation`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.HUGGING_FACE - coEvery { stubHuggingFaceGenerationRepository.generateFromImage(any()) } returns mockAiGenerationResult + fun `given source is HUGGING_FACE, generation is requested, expected hugging face generation`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.HUGGING_FACE + coEvery { stubHuggingFaceGenerationRepository.generateFromImage(any()) } returns mockAiGenerationResult - val actual = useCase(mockImageToImagePayload.copy(batchCount = 1)) + // When - assertEquals(listOf(mockAiGenerationResult), actual) - coVerify(exactly = 1) { stubHuggingFaceGenerationRepository.generateFromImage(any()) } - } + val actual = useCase(mockImageToImagePayload.copy(batchCount = 1)) + + // Then + + assertEquals(listOf(mockAiGenerationResult), actual) + coVerify(exactly = 1) { stubHuggingFaceGenerationRepository.generateFromImage(any()) } + } @Test - fun `given source is STABILITY_AI, expected stability ai generation`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.STABILITY_AI - coEvery { stubStabilityAiGenerationRepository.generateFromImage(any()) } returns mockAiGenerationResult + fun `given source is STABILITY_AI, generation is requested, expected stability ai generation`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.STABILITY_AI + coEvery { stubStabilityAiGenerationRepository.generateFromImage(any()) } returns mockAiGenerationResult - val actual = useCase(mockImageToImagePayload.copy(batchCount = 1)) + // When - assertEquals(listOf(mockAiGenerationResult), actual) - coVerify(exactly = 1) { stubStabilityAiGenerationRepository.generateFromImage(any()) } - } + val actual = useCase(mockImageToImagePayload.copy(batchCount = 1)) + + // Then + + assertEquals(listOf(mockAiGenerationResult), actual) + coVerify(exactly = 1) { stubStabilityAiGenerationRepository.generateFromImage(any()) } + } @Test - fun `given source is LOCAL_APPLE_CORE_ML, expected core ml generation`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.LOCAL_APPLE_CORE_ML - coEvery { stubCoreMlGenerationRepository.generateFromImage(any()) } returns mockAiGenerationResult + fun `given source is LOCAL_APPLE_CORE_ML, generation is requested, expected core ml generation`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.LOCAL_APPLE_CORE_ML + coEvery { stubCoreMlGenerationRepository.generateFromImage(any()) } returns mockAiGenerationResult - val actual = useCase(mockImageToImagePayload.copy(batchCount = 1)) + // When - assertEquals(listOf(mockAiGenerationResult), actual) - coVerify(exactly = 1) { stubCoreMlGenerationRepository.generateFromImage(any()) } - } + val actual = useCase(mockImageToImagePayload.copy(batchCount = 1)) + + // Then + + assertEquals(listOf(mockAiGenerationResult), actual) + coVerify(exactly = 1) { stubCoreMlGenerationRepository.generateFromImage(any()) } + } @Test - fun `given source is FAL_AI, expected fal ai generation`() = runTest { + fun `given source is FAL_AI, generation is requested, expected fal ai generation`() = runTest { + // Given every { stubPreferenceManager.source } returns ServerSource.FAL_AI coEvery { stubFalAiGenerationRepository.generateFromImage(any()) } returns listOf( mockAiGenerationResult ) + // When + val actual = useCase(mockImageToImagePayload.copy(batchCount = 1)) + // Then + assertEquals(listOf(mockAiGenerationResult), actual) coVerify(exactly = 1) { stubFalAiGenerationRepository.generateFromImage(any()) } } @Test - fun `given source is ARLI_AI, expected arli ai generation`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.ARLI_AI - coEvery { stubArliAiGenerationRepository.generateFromImage(any()) } returns listOf( - mockAiGenerationResult - ) + fun `given source is ARLI_AI, generation is requested, expected arli ai generation`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.ARLI_AI + coEvery { stubArliAiGenerationRepository.generateFromImage(any()) } returns listOf( + mockAiGenerationResult + ) - val actual = useCase(mockImageToImagePayload.copy(batchCount = 1)) + // When - assertEquals(listOf(mockAiGenerationResult), actual) - coVerify(exactly = 1) { stubArliAiGenerationRepository.generateFromImage(any()) } - } + val actual = useCase(mockImageToImagePayload.copy(batchCount = 1)) + + // Then + + assertEquals(listOf(mockAiGenerationResult), actual) + coVerify(exactly = 1) { stubArliAiGenerationRepository.generateFromImage(any()) } + } @Test - fun `given automatic1111 batch count is 10, expected batch generated by repository`() = + fun `given automatic1111 batch count is 10, generation is requested, expected batch generated by repository`() = runTest { + // Given every { stubPreferenceManager.source } returns ServerSource.AUTOMATIC1111 coEvery { stubStableDiffusionGenerationRepository.generateFromImage(any()) } returns List( 10 ) { mockAiGenerationResult } + // When + val actual = useCase(mockImageToImagePayload.copy(batchCount = 10)) + // Then + assertEquals(List(10) { mockAiGenerationResult }, actual) coVerify(exactly = 1) { stubStableDiffusionGenerationRepository.generateFromImage(any()) } } @Test - fun `given non batch source batch count is 10, expected generation repeated 10 times`() = + fun `given non batch source batch count is 10, generation is requested, expected generation repeated 10 times`() = runTest { + // Given every { stubPreferenceManager.source } returns ServerSource.HORDE coEvery { stubHordeGenerationRepository.generateFromImage(any()) } returns mockAiGenerationResult + // When + val actual = useCase(mockImageToImagePayload.copy(batchCount = 10)) + // Then + assertEquals(List(10) { mockAiGenerationResult }, actual) coVerify(exactly = 10) { stubHordeGenerationRepository.generateFromImage(any()) } } @Test - fun `given fal ai batch count is 4, expected batch generated by repository`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.FAL_AI - coEvery { stubFalAiGenerationRepository.generateFromImage(any()) } returns List(4) { mockAiGenerationResult } + fun `given fal ai batch count is 4, generation is requested, expected batch generated by repository`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.FAL_AI + coEvery { stubFalAiGenerationRepository.generateFromImage(any()) } returns List(4) { mockAiGenerationResult } - val actual = useCase(mockImageToImagePayload.copy(batchCount = 4)) + // When - assertEquals(List(4) { mockAiGenerationResult }, actual) - coVerify(exactly = 1) { stubFalAiGenerationRepository.generateFromImage(any()) } - } + val actual = useCase(mockImageToImagePayload.copy(batchCount = 4)) + + // Then + + assertEquals(List(4) { mockAiGenerationResult }, actual) + coVerify(exactly = 1) { stubFalAiGenerationRepository.generateFromImage(any()) } + } @Test - fun `given arli ai batch count is 4, expected batch generated by repository`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.ARLI_AI - coEvery { stubArliAiGenerationRepository.generateFromImage(any()) } returns List(4) { mockAiGenerationResult } + fun `given arli ai batch count is 4, generation is requested, expected batch generated by repository`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.ARLI_AI + coEvery { stubArliAiGenerationRepository.generateFromImage(any()) } returns List(4) { mockAiGenerationResult } - val actual = useCase(mockImageToImagePayload.copy(batchCount = 4)) + // When - assertEquals(List(4) { mockAiGenerationResult }, actual) - coVerify(exactly = 1) { stubArliAiGenerationRepository.generateFromImage(any()) } - } + val actual = useCase(mockImageToImagePayload.copy(batchCount = 4)) + + // Then + + assertEquals(List(4) { mockAiGenerationResult }, actual) + coVerify(exactly = 1) { stubArliAiGenerationRepository.generateFromImage(any()) } + } @Test - fun `given generation fails, expected error propagated`() = runTest { + fun `given generation fails, generation is requested, expected error propagated`() = runTest { + // Given every { stubPreferenceManager.source } returns ServerSource.AUTOMATIC1111 coEvery { stubStableDiffusionGenerationRepository.generateFromImage(any()) } throws stubException + // When + val actual = runCatching { useCase(mockImageToImagePayload.copy(batchCount = 1)) } + // Then + assertSame(stubException, actual.exceptionOrNull()) } @Test - fun `given unsupported source, expected unsupported error`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.LOCAL_MICROSOFT_ONNX + fun `given unsupported source, generation is requested, expected unsupported error`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.LOCAL_MICROSOFT_ONNX - val actual = runCatching { useCase(mockImageToImagePayload.copy(batchCount = 1)) } + // When - assertTrue(actual.exceptionOrNull() is IllegalStateException) - assertTrue(actual.exceptionOrNull()?.message?.startsWith("Img2Img not yet supported") == true) - } + val actual = runCatching { useCase(mockImageToImagePayload.copy(batchCount = 1)) } + + // Then + + assertTrue(actual.exceptionOrNull() is IllegalStateException) + assertTrue(actual.exceptionOrNull()?.message?.startsWith("Img2Img not yet supported") == true) + } } diff --git a/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/MnnTextToImageUseCaseTest.kt b/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/MnnTextToImageUseCaseTest.kt index 6a28c450d..2fcc24299 100644 --- a/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/MnnTextToImageUseCaseTest.kt +++ b/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/MnnTextToImageUseCaseTest.kt @@ -1,5 +1,6 @@ package com.shifthackz.aisdv1.domain.usecase.generation +import com.shifthackz.aisdv1.domain.mocks.ImmediateGenerationRestoreGate import com.shifthackz.aisdv1.domain.entity.ServerSource import com.shifthackz.aisdv1.domain.entity.TextToImagePayload import com.shifthackz.aisdv1.domain.mocks.mockAiGenerationResult @@ -50,6 +51,7 @@ class MnnTextToImageUseCaseTest { mnnProfile = "sd15-512-general-int8-v1" ) private val useCase = TextToImageUseCaseImpl( + generationRestoreGate = ImmediateGenerationRestoreGate(), stableDiffusionGenerationRepository = mockk(), hordeGenerationRepository = mockk(), huggingFaceGenerationRepository = mockk(), openAiGenerationRepository = mockk(), openAiCompatibleGenerationRepository = mockk(), openAiOAuthGenerationRepository = mockk(), diff --git a/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/TextToImageUseCaseImplTest.kt b/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/TextToImageUseCaseImplTest.kt index a06a28466..77cdd3855 100644 --- a/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/TextToImageUseCaseImplTest.kt +++ b/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/TextToImageUseCaseImplTest.kt @@ -1,5 +1,6 @@ package com.shifthackz.aisdv1.domain.usecase.generation +import com.shifthackz.aisdv1.domain.mocks.ImmediateGenerationRestoreGate import com.shifthackz.aisdv1.domain.entity.ServerSource import com.shifthackz.aisdv1.domain.entity.EasyDiffusionConnection import com.shifthackz.aisdv1.domain.entity.EasyDiffusionRequest @@ -59,6 +60,7 @@ class TextToImageUseCaseImplTest { private val generateEasyDiffusion = mockk() private val captureEasyDiffusion = mockk() private val useCase = TextToImageUseCaseImpl( + generationRestoreGate = ImmediateGenerationRestoreGate(), generateEasyDiffusionUseCase = generateEasyDiffusion, captureEasyDiffusionConnectionUseCase = captureEasyDiffusion, stableDiffusionGenerationRepository = stubStableDiffusionGenerationRepository, @@ -81,8 +83,9 @@ class TextToImageUseCaseImplTest { ) @Test - fun `Easy Diffusion captures one immutable connection and delegates the complete batch once`() = + fun `given Easy Diffusion generation, complete batch is submitted, generation is requested, expected one immutable connection capture`() = runTest { + // Given every { stubPreferenceManager.source } returns ServerSource.EASY_DIFFUSION val connection = EasyDiffusionConnection("https://server.example", "folder/model", 7) coEvery { captureEasyDiffusion(7, null) } returns connection @@ -93,7 +96,10 @@ class TextToImageUseCaseImplTest { sourceSnapshot = ServerSource.EASY_DIFFUSION, providerSelectionRevision = 7, batchCount = 3, seed = "4294967295" ) - assertSame(results, useCase(payload)) + // When + val actual = useCase(payload) + // Then + assertSame(results, actual) assertEquals(connection.url, request.captured.url) assertEquals(connection.model, request.captured.model) assertEquals(7L, request.captured.selectionRevision) @@ -103,225 +109,332 @@ class TextToImageUseCaseImplTest { } @Test - fun `stale Easy Diffusion capture stops dispatch before any generation`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.EASY_DIFFUSION - coEvery { captureEasyDiffusion(6, null) } throws stubException - assertSame(stubException, runCatching { - useCase( - mockTextToImagePayload.copy( - sourceSnapshot = ServerSource.EASY_DIFFUSION, - providerSelectionRevision = 6 + fun `given Easy Diffusion generation, captured connection is stale, generation is requested, expected no generation dispatch`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.EASY_DIFFUSION + coEvery { captureEasyDiffusion(6, null) } throws stubException + // When + val actual = runCatching { + useCase( + mockTextToImagePayload.copy( + sourceSnapshot = ServerSource.EASY_DIFFUSION, + providerSelectionRevision = 6 + ) ) - ) - }.exceptionOrNull()) - coVerify(exactly = 0) { generateEasyDiffusion(any()) } - } + } + // Then + assertSame(stubException, actual.exceptionOrNull()) + coVerify(exactly = 0) { generateEasyDiffusion(any()) } + } @Test - fun `given source is AUTOMATIC1111, expected stable diffusion generation`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.AUTOMATIC1111 - coEvery { stubStableDiffusionGenerationRepository.generateFromText(any()) } returns listOf( - mockAiGenerationResult - ) + fun `given source is AUTOMATIC1111, generation is requested, expected stable diffusion generation`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.AUTOMATIC1111 + coEvery { stubStableDiffusionGenerationRepository.generateFromText(any()) } returns listOf( + mockAiGenerationResult + ) - val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + // When - assertEquals(listOf(mockAiGenerationResult), actual) - coVerify(exactly = 1) { stubStableDiffusionGenerationRepository.generateFromText(any()) } - } + val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + + // Then + + assertEquals(listOf(mockAiGenerationResult), actual) + coVerify(exactly = 1) { stubStableDiffusionGenerationRepository.generateFromText(any()) } + } @Test - fun `given source is HORDE, expected horde generation`() = runTest { + fun `given source is HORDE, generation is requested, expected horde generation`() = runTest { + // Given every { stubPreferenceManager.source } returns ServerSource.HORDE coEvery { stubHordeGenerationRepository.generateFromText(any()) } returns mockAiGenerationResult + // When + val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + // Then + assertEquals(listOf(mockAiGenerationResult), actual) coVerify(exactly = 1) { stubHordeGenerationRepository.generateFromText(any()) } } @Test - fun `given source is HUGGING_FACE, expected hugging face generation`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.HUGGING_FACE - coEvery { stubHuggingFaceGenerationRepository.generateFromText(any()) } returns mockAiGenerationResult + fun `given source is HUGGING_FACE, generation is requested, expected hugging face generation`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.HUGGING_FACE + coEvery { stubHuggingFaceGenerationRepository.generateFromText(any()) } returns mockAiGenerationResult - val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + // When - assertEquals(listOf(mockAiGenerationResult), actual) - coVerify(exactly = 1) { stubHuggingFaceGenerationRepository.generateFromText(any()) } - } + val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + + // Then + + assertEquals(listOf(mockAiGenerationResult), actual) + coVerify(exactly = 1) { stubHuggingFaceGenerationRepository.generateFromText(any()) } + } @Test - fun `given source is OPEN_AI, expected open ai generation`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.OPEN_AI - coEvery { stubOpenAiGenerationRepository.generateFromText(any()) } returns mockAiGenerationResult + fun `given source is OPEN_AI, generation is requested, expected open ai generation`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.OPEN_AI + coEvery { stubOpenAiGenerationRepository.generateFromText(any()) } returns mockAiGenerationResult - val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + // When - assertEquals(listOf(mockAiGenerationResult), actual) - coVerify(exactly = 1) { stubOpenAiGenerationRepository.generateFromText(any()) } - } + val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + + // Then + + assertEquals(listOf(mockAiGenerationResult), actual) + coVerify(exactly = 1) { stubOpenAiGenerationRepository.generateFromText(any()) } + } @Test - fun `given source is STABILITY_AI, expected stability ai generation`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.STABILITY_AI - coEvery { stubStabilityAiGenerationRepository.generateFromText(any()) } returns mockAiGenerationResult + fun `given source is STABILITY_AI, generation is requested, expected stability ai generation`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.STABILITY_AI + coEvery { stubStabilityAiGenerationRepository.generateFromText(any()) } returns mockAiGenerationResult - val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + // When - assertEquals(listOf(mockAiGenerationResult), actual) - coVerify(exactly = 1) { stubStabilityAiGenerationRepository.generateFromText(any()) } - } + val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + + // Then + + assertEquals(listOf(mockAiGenerationResult), actual) + coVerify(exactly = 1) { stubStabilityAiGenerationRepository.generateFromText(any()) } + } @Test - fun `given source is FAL_AI, expected fal ai generation`() = runTest { + fun `given source is FAL_AI, generation is requested, expected fal ai generation`() = runTest { + // Given every { stubPreferenceManager.source } returns ServerSource.FAL_AI coEvery { stubFalAiGenerationRepository.generateFromText(any()) } returns listOf( mockAiGenerationResult ) + // When + val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + // Then + assertEquals(listOf(mockAiGenerationResult), actual) coVerify(exactly = 1) { stubFalAiGenerationRepository.generateFromText(any()) } } @Test - fun `given source is ARLI_AI, expected arli ai generation`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.ARLI_AI - coEvery { stubArliAiGenerationRepository.generateFromText(any()) } returns listOf( - mockAiGenerationResult - ) + fun `given source is ARLI_AI, generation is requested, expected arli ai generation`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.ARLI_AI + coEvery { stubArliAiGenerationRepository.generateFromText(any()) } returns listOf( + mockAiGenerationResult + ) - val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + // When - assertEquals(listOf(mockAiGenerationResult), actual) - coVerify(exactly = 1) { stubArliAiGenerationRepository.generateFromText(any()) } - } + val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + + // Then + + assertEquals(listOf(mockAiGenerationResult), actual) + coVerify(exactly = 1) { stubArliAiGenerationRepository.generateFromText(any()) } + } @Test - fun `given source is SWARM_UI, expected swarm ui generation`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.SWARM_UI - coEvery { stubSwarmUiGenerationRepository.generateFromText(any()) } returns mockAiGenerationResult + fun `given source is SWARM_UI, generation is requested, expected swarm ui generation`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.SWARM_UI + coEvery { stubSwarmUiGenerationRepository.generateFromText(any()) } returns mockAiGenerationResult - val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + // When - assertEquals(listOf(mockAiGenerationResult), actual) - coVerify(exactly = 1) { stubSwarmUiGenerationRepository.generateFromText(any()) } - } + val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + + // Then + + assertEquals(listOf(mockAiGenerationResult), actual) + coVerify(exactly = 1) { stubSwarmUiGenerationRepository.generateFromText(any()) } + } @Test - fun `given source is LOCAL_MICROSOFT_ONNX, expected local diffusion generation`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.LOCAL_MICROSOFT_ONNX - coEvery { stubLocalDiffusionGenerationRepository.generateFromText(any()) } returns mockAiGenerationResult + fun `given source is LOCAL_MICROSOFT_ONNX, generation is requested, expected local diffusion generation`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.LOCAL_MICROSOFT_ONNX + coEvery { stubLocalDiffusionGenerationRepository.generateFromText(any()) } returns mockAiGenerationResult - val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + // When - assertEquals(listOf(mockAiGenerationResult), actual) - coVerify(exactly = 1) { stubLocalDiffusionGenerationRepository.generateFromText(any()) } - } + val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + + // Then + + assertEquals(listOf(mockAiGenerationResult), actual) + coVerify(exactly = 1) { stubLocalDiffusionGenerationRepository.generateFromText(any()) } + } @Test - fun `given source is LOCAL_GOOGLE_MEDIA_PIPE, expected media pipe generation`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.LOCAL_GOOGLE_MEDIA_PIPE - coEvery { stubMediaPipeGenerationRepository.generateFromText(any()) } returns mockAiGenerationResult + fun `given source is LOCAL_GOOGLE_MEDIA_PIPE, generation is requested, expected media pipe generation`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.LOCAL_GOOGLE_MEDIA_PIPE + coEvery { stubMediaPipeGenerationRepository.generateFromText(any()) } returns mockAiGenerationResult - val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + // When - assertEquals(listOf(mockAiGenerationResult), actual) - coVerify(exactly = 1) { stubMediaPipeGenerationRepository.generateFromText(any()) } - } + val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + + // Then + + assertEquals(listOf(mockAiGenerationResult), actual) + coVerify(exactly = 1) { stubMediaPipeGenerationRepository.generateFromText(any()) } + } @Test - fun `given source is LOCAL_STABLE_DIFFUSION_CPP, expected stable diffusion cpp generation`() = + fun `given source is LOCAL_STABLE_DIFFUSION_CPP, generation is requested, expected stable diffusion cpp generation`() = runTest { + // Given every { stubPreferenceManager.source } returns ServerSource.LOCAL_STABLE_DIFFUSION_CPP coEvery { stubStableDiffusionCppGenerationRepository.generateFromText(any()) } returns mockAiGenerationResult + // When + val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + // Then + assertEquals(listOf(mockAiGenerationResult), actual) coVerify(exactly = 1) { stubStableDiffusionCppGenerationRepository.generateFromText(any()) } } @Test - fun `given source is LOCAL_APPLE_CORE_ML, expected core ml generation`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.LOCAL_APPLE_CORE_ML - coEvery { stubCoreMlGenerationRepository.generateFromText(any()) } returns mockAiGenerationResult + fun `given source is LOCAL_APPLE_CORE_ML, generation is requested, expected core ml generation`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.LOCAL_APPLE_CORE_ML + coEvery { stubCoreMlGenerationRepository.generateFromText(any()) } returns mockAiGenerationResult - val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + // When - assertEquals(listOf(mockAiGenerationResult), actual) - coVerify(exactly = 1) { stubCoreMlGenerationRepository.generateFromText(any()) } - } + val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + + // Then + + assertEquals(listOf(mockAiGenerationResult), actual) + coVerify(exactly = 1) { stubCoreMlGenerationRepository.generateFromText(any()) } + } @Test - fun `given source is LOCAL_APPLE_BONSAI, expected bonsai generation`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.LOCAL_APPLE_BONSAI - coEvery { stubBonsaiGenerationRepository.generateFromText(any()) } returns mockAiGenerationResult + fun `given source is LOCAL_APPLE_BONSAI, generation is requested, expected bonsai generation`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.LOCAL_APPLE_BONSAI + coEvery { stubBonsaiGenerationRepository.generateFromText(any()) } returns mockAiGenerationResult - val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + // When - assertEquals(listOf(mockAiGenerationResult), actual) - coVerify(exactly = 1) { stubBonsaiGenerationRepository.generateFromText(any()) } - } + val actual = useCase(mockTextToImagePayload.copy(batchCount = 1)) + + // Then + + assertEquals(listOf(mockAiGenerationResult), actual) + coVerify(exactly = 1) { stubBonsaiGenerationRepository.generateFromText(any()) } + } @Test - fun `given automatic1111 batch count is 10, expected batch generated by repository`() = + fun `given automatic1111 batch count is 10, generation is requested, expected batch generated by repository`() = runTest { + // Given every { stubPreferenceManager.source } returns ServerSource.AUTOMATIC1111 coEvery { stubStableDiffusionGenerationRepository.generateFromText(any()) } returns List( 10 ) { mockAiGenerationResult } + // When + val actual = useCase(mockTextToImagePayload.copy(batchCount = 10)) + // Then + assertEquals(List(10) { mockAiGenerationResult }, actual) coVerify(exactly = 1) { stubStableDiffusionGenerationRepository.generateFromText(any()) } } @Test - fun `given non batch source batch count is 10, expected generation repeated 10 times`() = + fun `given non batch source batch count is 10, generation is requested, expected generation repeated 10 times`() = runTest { + // Given every { stubPreferenceManager.source } returns ServerSource.HORDE coEvery { stubHordeGenerationRepository.generateFromText(any()) } returns mockAiGenerationResult + // When + val actual = useCase(mockTextToImagePayload.copy(batchCount = 10)) + // Then + assertEquals(List(10) { mockAiGenerationResult }, actual) coVerify(exactly = 10) { stubHordeGenerationRepository.generateFromText(any()) } } @Test - fun `given fal ai batch count is 4, expected batch generated by repository`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.FAL_AI - coEvery { stubFalAiGenerationRepository.generateFromText(any()) } returns List(4) { mockAiGenerationResult } + fun `given fal ai batch count is 4, generation is requested, expected batch generated by repository`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.FAL_AI + coEvery { stubFalAiGenerationRepository.generateFromText(any()) } returns List(4) { mockAiGenerationResult } - val actual = useCase(mockTextToImagePayload.copy(batchCount = 4)) + // When - assertEquals(List(4) { mockAiGenerationResult }, actual) - coVerify(exactly = 1) { stubFalAiGenerationRepository.generateFromText(any()) } - } + val actual = useCase(mockTextToImagePayload.copy(batchCount = 4)) + + // Then + + assertEquals(List(4) { mockAiGenerationResult }, actual) + coVerify(exactly = 1) { stubFalAiGenerationRepository.generateFromText(any()) } + } @Test - fun `given arli ai batch count is 4, expected batch generated by repository`() = runTest { - every { stubPreferenceManager.source } returns ServerSource.ARLI_AI - coEvery { stubArliAiGenerationRepository.generateFromText(any()) } returns List(4) { mockAiGenerationResult } + fun `given arli ai batch count is 4, generation is requested, expected batch generated by repository`() = + runTest { + // Given + every { stubPreferenceManager.source } returns ServerSource.ARLI_AI + coEvery { stubArliAiGenerationRepository.generateFromText(any()) } returns List(4) { mockAiGenerationResult } - val actual = useCase(mockTextToImagePayload.copy(batchCount = 4)) + // When - assertEquals(List(4) { mockAiGenerationResult }, actual) - coVerify(exactly = 1) { stubArliAiGenerationRepository.generateFromText(any()) } - } + val actual = useCase(mockTextToImagePayload.copy(batchCount = 4)) + + // Then + + assertEquals(List(4) { mockAiGenerationResult }, actual) + coVerify(exactly = 1) { stubArliAiGenerationRepository.generateFromText(any()) } + } @Test - fun `given generation fails, expected error propagated`() = runTest { + fun `given generation fails, generation is requested, expected error propagated`() = runTest { + // Given every { stubPreferenceManager.source } returns ServerSource.AUTOMATIC1111 coEvery { stubStableDiffusionGenerationRepository.generateFromText(any()) } throws stubException + // When + val actual = runCatching { useCase(mockTextToImagePayload.copy(batchCount = 1)) } + // Then + assertSame(stubException, actual.exceptionOrNull()) } } diff --git a/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/usecase/settings/SetServerConfigurationUseCaseImplTest.kt b/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/usecase/settings/SetServerConfigurationUseCaseImplTest.kt index b6bb324cf..afda66c79 100644 --- a/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/usecase/settings/SetServerConfigurationUseCaseImplTest.kt +++ b/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/usecase/settings/SetServerConfigurationUseCaseImplTest.kt @@ -6,6 +6,8 @@ import com.shifthackz.aisdv1.domain.gateway.ProviderSelectionGuard import com.shifthackz.aisdv1.domain.feature.auth.AuthorizationStore import com.shifthackz.aisdv1.domain.mocks.ConfigurationStoreStub import com.shifthackz.aisdv1.domain.mocks.mockConfiguration +import com.shifthackz.aisdv1.domain.gateway.backup.BackupPreferencesGateway +import com.shifthackz.aisdv1.domain.entity.backup.BackupStartupStage import com.shifthackz.aisdv1.domain.preference.PreferenceManager import io.mockk.coEvery import io.mockk.coVerify @@ -27,27 +29,32 @@ class DefaultSetServerConfigurationUseCaseImplTest { providerSelectionGuard = ProviderSelectionGuard(), authorizationStore = stubAuthorizationStore, preferenceManager = stubPreferenceManager, + backupPreferences = mockk { every { readStartupStage() } returns BackupStartupStage.COMPLETE }, ) @Test - fun `given configuration apply success, expected complete value`() = runTest { - coEvery { - stubAuthorizationStore.storeAuthorizationCredentials(any(), any()) - } coAnswers { - secondArg Unit>().invoke("configuration-test") - } - coEvery { - stubPreferenceManager.refresh() - } returns Unit + fun `given provider configuration, checked apply succeeds, expected complete saved value`() = + runTest { + // Given + coEvery { + stubAuthorizationStore.storeAuthorizationCredentials(any(), any()) + } coAnswers { + secondArg Unit>().invoke("configuration-test") + } + coEvery { + stubPreferenceManager.refresh() + } returns Unit - useCase(mockConfiguration) + // When + useCase(mockConfiguration) - assertEquals( - mockConfiguration, - stubConfigurationStore.getConfiguration(mockConfiguration.authCredentials) - ) - coVerify { - stubPreferenceManager.refresh() + // Then + assertEquals( + mockConfiguration, + stubConfigurationStore.getConfiguration(mockConfiguration.authCredentials) + ) + coVerify { + stubPreferenceManager.refresh() + } } - } } diff --git a/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/usecase/splash/SplashNavigationUseCaseImplTest.kt b/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/usecase/splash/SplashNavigationUseCaseImplTest.kt index 9b15a9662..47031df0d 100644 --- a/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/usecase/splash/SplashNavigationUseCaseImplTest.kt +++ b/domain/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/domain/usecase/splash/SplashNavigationUseCaseImplTest.kt @@ -1,114 +1,152 @@ package com.shifthackz.aisdv1.domain.usecase.splash -import com.nhaarman.mockitokotlin2.mock -import com.nhaarman.mockitokotlin2.whenever import com.shifthackz.aisdv1.domain.entity.ServerSource +import com.shifthackz.aisdv1.domain.entity.backup.BackupStartupStage +import com.shifthackz.aisdv1.domain.entity.backup.BackupRecovery +import com.shifthackz.aisdv1.domain.entity.backup.BackupRestoreRequest +import com.shifthackz.aisdv1.domain.entity.backup.BackupSelection +import com.shifthackz.aisdv1.domain.entity.backup.BackupInspection import com.shifthackz.aisdv1.domain.preference.PreferenceManager -import kotlinx.coroutines.runBlocking +import com.shifthackz.aisdv1.domain.usecase.backup.GetBackupStartupStageUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.LoadPendingBackupUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.GetPendingBackupExportUseCase +import io.mockk.coEvery +import io.mockk.every +import io.mockk.mockk +import kotlinx.coroutines.test.runTest +import org.junit.Assert.assertEquals +import org.junit.Before import org.junit.Test class SplashNavigationUseCaseImplTest { - - private val stubPreferenceManager = mock() - - private val useCase = SplashNavigationUseCaseImpl(stubPreferenceManager) - - @Test - fun `given onBoardingComplete is false, expected LAUNCH_ONBOARDING`() { - whenever(stubPreferenceManager.onBoardingComplete) - .thenReturn(false) - - val result = runBlocking { useCase() } - - assert(result == SplashNavigationUseCase.Action.LAUNCH_ONBOARDING) + private val preferences = mockk(relaxed = true) + private val stage = mockk() + private val pending = mockk() + private val export = mockk() + private val useCase = SplashNavigationUseCaseImpl(preferences, stage, pending, export) + + @Before + fun setup() { + every { preferences.onBoardingComplete } returns true + every { preferences.source } returns ServerSource.AUTOMATIC1111 + every { preferences.automatic1111ServerUrl } returns "https://server" + every { stage() } returns BackupStartupStage.COMPLETE + coEvery { pending() } returns null + coEvery { export() } returns false } @Test - fun `given forceSetupAfterUpdate is true, expected LAUNCH_SERVER_SETUP`() { - whenever(stubPreferenceManager.onBoardingComplete) - .thenReturn(true) - - whenever(stubPreferenceManager.forceSetupAfterUpdate) - .thenReturn(true) - - val result = runBlocking { useCase() } - - assert(result == SplashNavigationUseCase.Action.LAUNCH_SERVER_SETUP) + fun `given first app launch, onboarding incomplete, expected onboarding route`() = runTest { + // Given + every { preferences.onBoardingComplete } returns false + // When + val action = useCase() + // Then + assertEquals(SplashNavigationUseCase.Action.LAUNCH_ONBOARDING, action) } @Test - fun `given source is AUTOMATIC1111 and server url empty, expected LAUNCH_SERVER_SETUP`() { - whenever(stubPreferenceManager.onBoardingComplete) - .thenReturn(true) - - whenever(stubPreferenceManager.forceSetupAfterUpdate) - .thenReturn(false) - - whenever(stubPreferenceManager.automatic1111ServerUrl) - .thenReturn("") - - whenever(stubPreferenceManager.source) - .thenReturn(ServerSource.AUTOMATIC1111) - - val result = runBlocking { useCase() } - - assert(result == SplashNavigationUseCase.Action.LAUNCH_SERVER_SETUP) - } + fun `given completed onboarding, invitation stage is pending, expected restore invitation`() = + runTest { + // Given + every { stage() } returns BackupStartupStage.INVITATION + // When + val action = useCase() + // Then + assertEquals(SplashNavigationUseCase.Action.LAUNCH_BACKUP_WELCOME, action) + } @Test - fun `given source is AUTOMATIC1111 and server url not empty, expected LAUNCH_HOME`() { - whenever(stubPreferenceManager.onBoardingComplete) - .thenReturn(true) - - whenever(stubPreferenceManager.forceSetupAfterUpdate) - .thenReturn(false) - - whenever(stubPreferenceManager.automatic1111ServerUrl) - .thenReturn("http://192.168.0.1:7860") - - whenever(stubPreferenceManager.source) - .thenReturn(ServerSource.AUTOMATIC1111) - - val result = runBlocking { useCase() } - - assert(result == SplashNavigationUseCase.Action.LAUNCH_HOME) + fun `given first launch restore, process restarts, expected restore only route`() = runTest { + // Given + every { stage() } returns BackupStartupStage.RESTORE + // When + val action = useCase() + // Then + assertEquals(SplashNavigationUseCase.Action.LAUNCH_INITIAL_RESTORE, action) } @Test - fun `given source is LOCAL, and server url is empty, expected LAUNCH_HOME`() { - whenever(stubPreferenceManager.onBoardingComplete) - .thenReturn(true) - - whenever(stubPreferenceManager.forceSetupAfterUpdate) - .thenReturn(false) + fun `given first launch recovery, user proceeds to configuration, expected setup even with restored fields`() = + runTest { + // Given + every { stage() } returns BackupStartupStage.CONFIGURATION + // When + val action = useCase() + // Then + assertEquals(SplashNavigationUseCase.Action.LAUNCH_SERVER_SETUP, action) + } - whenever(stubPreferenceManager.automatic1111ServerUrl) - .thenReturn("") - - whenever(stubPreferenceManager.source) - .thenReturn(ServerSource.LOCAL_MICROSOFT_ONNX) + @Test + fun `given existing configured installation, backup stage is complete, expected normal home route`() = + runTest { + // Given + every { stage() } returns BackupStartupStage.COMPLETE + // When + val action = useCase() + // Then + assertEquals(SplashNavigationUseCase.Action.LAUNCH_HOME, action) + } - val result = runBlocking { useCase() } + @Test + fun `given existing installation, provider setup required by update, expected setup route`() = + runTest { + // Given + every { preferences.forceSetupAfterUpdate } returns true + // When + val action = useCase() + // Then + assertEquals(SplashNavigationUseCase.Action.LAUNCH_SERVER_SETUP, action) + } - assert(result == SplashNavigationUseCase.Action.LAUNCH_HOME) + @Test + fun `given A1111 selection, endpoint is absent, expected setup route`() = runTest { + // Given + every { preferences.automatic1111ServerUrl } returns "" + // When + val action = useCase() + // Then + assertEquals(SplashNavigationUseCase.Action.LAUNCH_SERVER_SETUP, action) } @Test - fun `given source is LOCAL, and server url is not empty, expected LAUNCH_HOME`() { - whenever(stubPreferenceManager.onBoardingComplete) - .thenReturn(true) - - whenever(stubPreferenceManager.forceSetupAfterUpdate) - .thenReturn(false) - - whenever(stubPreferenceManager.automatic1111ServerUrl) - .thenReturn("http://192.168.0.1:7860") + fun `given local provider selection, A1111 endpoint absent, expected normal home route`() = + runTest { + // Given + every { preferences.source } returns ServerSource.LOCAL_MICROSOFT_ONNX + every { preferences.automatic1111ServerUrl } returns "" + // When + val action = useCase() + // Then + assertEquals(SplashNavigationUseCase.Action.LAUNCH_HOME, action) + } - whenever(stubPreferenceManager.source) - .thenReturn(ServerSource.LOCAL_MICROSOFT_ONNX) + @Test + fun `given interrupted settings restore, process restarts, expected pending restore before home`() = + runTest { + // Given + coEvery { pending() } returns BackupRecovery( + BackupRestoreRequest( + "archive", + BackupSelection(), + "session" + ), BackupInspection("archive", 1, "1", "IOS", emptyList(), emptySet()) + ) + // When + val action = useCase() + // Then + assertEquals(SplashNavigationUseCase.Action.LAUNCH_BACKUP_RESTORE, action) + } - val result = runBlocking { useCase() } + @Test + fun `given native export pending, process starts, expected backup route reconnects document result`() = + runTest { + // Given + coEvery { export() } returns true + // When + val action = useCase() + // Then + assertEquals(SplashNavigationUseCase.Action.LAUNCH_BACKUP_RESTORE, action) + } - assert(result == SplashNavigationUseCase.Action.LAUNCH_HOME) - } } diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/di/DomainCoreModule.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/di/DomainCoreModule.kt index 148b31ada..db7341b65 100644 --- a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/di/DomainCoreModule.kt +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/di/DomainCoreModule.kt @@ -410,7 +410,14 @@ val coreDomainModule = module { timeProvider = get(), ) } - factory { SplashNavigationUseCaseImpl(preferenceManager = get()) } + factory { + SplashNavigationUseCaseImpl( + preferenceManager = get(), + getBackupStartupStage = get(), + loadPendingBackup = get(), + getPendingExport = get() + ) + } factory { ObserveLocalOnnxModelsUseCaseImpl(repository = get()) } @@ -450,6 +457,7 @@ val coreDomainModule = module { } factory { TextToImageUseCaseImpl( + generationRestoreGate = get(), generateEasyDiffusionUseCase = get(), captureEasyDiffusionConnectionUseCase = get(), stableDiffusionGenerationRepository = get(), @@ -473,6 +481,7 @@ val coreDomainModule = module { } factory { ImageToImageUseCaseImpl( + generationRestoreGate = get(), generateEasyDiffusionUseCase = get(), captureEasyDiffusionConnectionUseCase = get(), stableDiffusionGenerationRepository = get(), @@ -603,6 +612,7 @@ val coreDomainModule = module { } factory { DefaultSetServerConfigurationUseCaseImpl( + backupPreferences = get(), dispatchersProvider = get(), providerSelectionGuard = get(), configurationStore = get(), diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupCategory.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupCategory.kt new file mode 100644 index 000000000..82f269ccb --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupCategory.kt @@ -0,0 +1,11 @@ +package com.shifthackz.aisdv1.domain.entity.backup + + +/** + * Selectable portable data sections; wire identifiers remain stable across application versions. + * @param key Permanent section identifier stored in backup manifests. + * @author Dmitriy Moroz + */ +enum class BackupCategory(val key: String) { + PROVIDERS("providers"), GALLERY("gallery"), NETWORK("network"), SETTINGS("settings"); +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupEntry.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupEntry.kt new file mode 100644 index 000000000..22f9148fd --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupEntry.kt @@ -0,0 +1,15 @@ +package com.shifthackz.aisdv1.domain.entity.backup + + +/** + * One selectable inventory or inspected archive category. + * @param category Known section identity. + * @param itemCount Number of saved entries, not an estimated compressed size. + * @param isAvailable Whether the current build can import or export this section. + * @author Dmitriy Moroz + */ +data class BackupEntry( + val category: BackupCategory, + val itemCount: Long, + val isAvailable: Boolean = true, +) diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupExport.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupExport.kt new file mode 100644 index 000000000..6e76c7325 --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupExport.kt @@ -0,0 +1,11 @@ +package com.shifthackz.aisdv1.domain.entity.backup + + +/** + * Complete staged backup ready for the native document export flow. + * @param document Opaque platform document reference, never shown as UI text. + * @param filename Suggested public filename ending in .sdaibackup. + * @param handle Generated staging identity persisted before document presentation. + * @author Dmitriy Moroz + */ +data class BackupExport(val document: String, val filename: String, val handle: String) diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupExportCompletion.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupExportCompletion.kt new file mode 100644 index 000000000..b50b6df97 --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupExportCompletion.kt @@ -0,0 +1,33 @@ +package com.shifthackz.aisdv1.domain.entity.backup + +/** + * Native document outcomes tied to the staged source that launched their picker. + * @author Dmitriy Moroz + */ +sealed interface BackupExportCompletion { + /** App-owned staged identity captured before picker presentation. @author Dmitriy Moroz */ + val handle: String + + /** + * Android supplied a write-granted output document for this source. + * @param document Opaque destination associated with this export. + * @param handle App-owned source identity retained by the native launcher. + * @author Dmitriy Moroz + */ + data class DestinationSelected(val document: String, override val handle: String) : + BackupExportCompletion + + /** + * UIKit confirmed this source was copied to its selected destination. + * @param handle App-owned source identity retained by the native launcher. + * @author Dmitriy Moroz + */ + data class NativeCompleted(override val handle: String) : BackupExportCompletion + + /** + * This source's native picker was canceled before destination copying. + * @param handle App-owned source identity retained by the native launcher. + * @author Dmitriy Moroz + */ + data class Canceled(override val handle: String) : BackupExportCompletion +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupExportIntent.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupExportIntent.kt new file mode 100644 index 000000000..1305e0cad --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupExportIntent.kt @@ -0,0 +1,17 @@ +package com.shifthackz.aisdv1.domain.entity.backup + + +/** + * Durable export/result association written before the native document picker opens. + * @param handle Generated app-owned staging identity, without a platform path. + * @param filename Suggested public binary backup filename. + * @param status Last durably acknowledged export stage. + * @param destination Opaque selected output reference, retained for interrupted-copy retry. + * @author Dmitriy Moroz + */ +data class BackupExportIntent( + val handle: String, + val filename: String, + val status: BackupExportStatus = BackupExportStatus.READY, + val destination: String? = null, +) diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupExportOperation.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupExportOperation.kt new file mode 100644 index 000000000..d7da74a58 --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupExportOperation.kt @@ -0,0 +1,13 @@ +package com.shifthackz.aisdv1.domain.entity.backup + + +/** + * Observable application-owned export state; successful status means native completion or completed byte copy. + * @param status Current durable operation stage. + * @param backup Resolved private export reference; no archive payload or credentials. + * @author Dmitriy Moroz + */ +data class BackupExportOperation( + val status: BackupExportStatus = BackupExportStatus.NONE, + val backup: BackupExport? = null +) diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupExportStatus.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupExportStatus.kt new file mode 100644 index 000000000..553e8a981 --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupExportStatus.kt @@ -0,0 +1,8 @@ +package com.shifthackz.aisdv1.domain.entity.backup + + +/** + * Nonsecret lifecycle of one staged export, retained independently from a screen composition. + * @author Dmitriy Moroz + */ +enum class BackupExportStatus { NONE, PROCESSING, READY, COPYING, COMPLETE, FAILED, CANCELED } diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupImageBudget.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupImageBudget.kt new file mode 100644 index 000000000..60a8629f6 --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupImageBudget.kt @@ -0,0 +1,21 @@ +package com.shifthackz.aisdv1.domain.entity.backup + +/** + * Shared gallery-backup admission applied before encoded allocation and native pixel decoding. + * @param maxEncodedBytes Maximum combined output/input encoded image bytes in one gallery record. + * @param maxPixels Maximum original pixel count accepted from native metadata. + * @param maxDecodedBytes Maximum conservative original decoded size, calculated with eight bytes per pixel. + * @param validationEdge Maximum edge of the sampled native content-validation bitmap. + * @author Dmitriy Moroz + */ +data class BackupImageBudget( + val maxEncodedBytes: Int, + val maxPixels: Long, + val maxDecodedBytes: Long, + val validationEdge: Int, +) { + init { + require(maxEncodedBytes > 0 && maxPixels > 0 && maxDecodedBytes > 0) + require(validationEdge in 1..1024) + } +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupInspection.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupInspection.kt new file mode 100644 index 000000000..1edad334f --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupInspection.kt @@ -0,0 +1,25 @@ +package com.shifthackz.aisdv1.domain.entity.backup + + +/** + * Validated archive summary; handle refers only to an app-owned staged copy. + * @param handle Opaque private archive identity; never a user-managed file path. + * @param createdAt Creation timestamp in UTC epoch milliseconds. + * @param appVersion Originating application version for display only. + * @param sourcePlatform Originating platform label. + * @param entries Compatible and unavailable known categories. + * @param providers Supported provider children present in the archive. + * @param skippedCount Number of unsupported section, provider or field entries. + * @param filename User-facing original filename, excluding its storage path. + * @author Dmitriy Moroz + */ +data class BackupInspection( + val handle: String, + val createdAt: Long, + val appVersion: String, + val sourcePlatform: String, + val entries: List, + val providers: Set, + val skippedCount: Int = 0, + val filename: String = "", +) diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupPreferences.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupPreferences.kt new file mode 100644 index 000000000..0d3a8b0bd --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupPreferences.kt @@ -0,0 +1,13 @@ +package com.shifthackz.aisdv1.domain.entity.backup + + +/** + * Allowlisted portable fields keyed by stable provider and field identifiers. Never log credential values. + * @param providers Saved portable fields for each represented provider. + * @param settings Saved user preferences, excluding lifecycle and device state. + * @author Dmitriy Moroz + */ +data class BackupPreferences( + val providers: Map>, + val settings: Map, +) diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupProgress.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupProgress.kt new file mode 100644 index 000000000..f2c96448c --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupProgress.kt @@ -0,0 +1,11 @@ +package com.shifthackz.aisdv1.domain.entity.backup + + +/** + * Progress emitted after bounded work, with committed restore counts distinguished by stage. + * @param category Current section, or null while staging/validating. + * @param completed Processed entry count in the current section. + * @param total Expected entries in the section. + * @author Dmitriy Moroz + */ +data class BackupProgress(val category: BackupCategory?, val completed: Long, val total: Long) diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupRecovery.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupRecovery.kt new file mode 100644 index 000000000..e41fc689d --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupRecovery.kt @@ -0,0 +1,10 @@ +package com.shifthackz.aisdv1.domain.entity.backup + + +/** + * Nonsecret restore state retained across application restarts. + * @param request Original operation and selection binding. + * @param inspection Revalidated staged archive summary. + * @author Dmitriy Moroz + */ +data class BackupRecovery(val request: BackupRestoreRequest, val inspection: BackupInspection) diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupRestoreNotice.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupRestoreNotice.kt new file mode 100644 index 000000000..5e91aa6a6 --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupRestoreNotice.kt @@ -0,0 +1,15 @@ +package com.shifthackz.aisdv1.domain.entity.backup + + +/** + * Typed reasons for deliberately omitted restore data; no credential values are retained. + * @author Dmitriy Moroz + */ +sealed interface BackupRestoreNotice { + /** + * Shared Basic Auth stayed unchanged to protect configured providers outside the restore selection. + * @param providers Unselected configured provider IDs whose credentials were preserved. + * @author Dmitriy Moroz + */ + data class SharedCredentialsRetained(val providers: Set) : BackupRestoreNotice +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupRestoreRequest.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupRestoreRequest.kt new file mode 100644 index 000000000..3d0c9a111 --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupRestoreRequest.kt @@ -0,0 +1,19 @@ +package com.shifthackz.aisdv1.domain.entity.backup + + +/** + * Immutable restore submission; retries retain the same session ID to avoid duplicate additive imports. + * @param handle Validated staged archive identity. + * @param selection Categories and providers explicitly selected by the user. + * @param sessionId Stable operation identity retained across retries and process recovery. + * @param confirmedFingerprint Opaque conflict revision previously confirmed, or null before consent. + * @param shouldProceedToConfiguration Whether a completed first-launch import must durably hand off to configuration. + * @author Dmitriy Moroz + */ +data class BackupRestoreRequest( + val handle: String, + val selection: BackupSelection, + val sessionId: String, + val confirmedFingerprint: String? = null, + val shouldProceedToConfiguration: Boolean = false, +) diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupRestoreResult.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupRestoreResult.kt new file mode 100644 index 000000000..d546dacea --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupRestoreResult.kt @@ -0,0 +1,34 @@ +package com.shifthackz.aisdv1.domain.entity.backup + +/** + * Explicit consent request or durable completion report; no secret values are exposed to UI state. + * @author Dmitriy Moroz + */ +sealed interface BackupRestoreResult { + /** + * Provider replacement requires confirmation of this exact source/destination revision. + * @param providers All configured provider names affected by the replacement. + * @param fingerprint Opaque consent revision invalidated by destination changes. + * @author Dmitriy Moroz + */ + + data class Conflict(val providers: Set, val fingerprint: String) : BackupRestoreResult + + /** + * Reports actual committed work after success or a recoverable category failure. + * @param completed Categories with durable section markers in the journal. + * @param skippedCount Unsupported or deliberately omitted entries. + * @param hasFailed Whether selected data remains unapplied after a category failure. + * @param importedCounts Committed entry counts retained across session retries. + * @param notices Typed explanations identifying deliberately preserved destination data. + * @author Dmitriy Moroz + */ + + data class Finished( + val completed: Set, + val skippedCount: Int, + val hasFailed: Boolean, + val importedCounts: Map = emptyMap(), + val notices: List = emptyList() + ) : BackupRestoreResult +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupSelection.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupSelection.kt new file mode 100644 index 000000000..f06c3e9b3 --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupSelection.kt @@ -0,0 +1,13 @@ +package com.shifthackz.aisdv1.domain.entity.backup + + +/** + * Explicit user choices shared by create and restore screens. + * @param categories Selected available data categories. + * @param providers Selected provider wire identifiers beneath the providers category. + * @author Dmitriy Moroz + */ +data class BackupSelection( + val categories: Set = emptySet(), + val providers: Set = emptySet(), +) diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupStartupStage.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupStartupStage.kt new file mode 100644 index 000000000..f8db20075 --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupStartupStage.kt @@ -0,0 +1,8 @@ +package com.shifthackz.aisdv1.domain.entity.backup + + +/** + * Durable post-onboarding recovery stage. Existing installations default to COMPLETE. + * @author Dmitriy Moroz + */ +enum class BackupStartupStage { INVITATION, RESTORE, CONFIGURATION, COMPLETE } diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupValue.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupValue.kt new file mode 100644 index 000000000..0ccf66985 --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupValue.kt @@ -0,0 +1,35 @@ +package com.shifthackz.aisdv1.domain.entity.backup + +/** + * Typed portable preference primitives. Missing entries retain destination values; never log these objects. + * @author Dmitriy Moroz + */ +sealed interface BackupValue { + /** + * Preserves the presence of an unsupported encoded value without retaining its payload. + * Compatibility filtering can then count the skipped field instead of silently dropping its ID. + * @author Dmitriy Moroz + */ + data object Unsupported : BackupValue + + /** + * Portable string, including an explicitly saved empty value. + * @param value Exact field text, which may contain an API key or password. + * @author Dmitriy Moroz + */ + data class Text(val value: String) : BackupValue + + /** + * Portable boolean whose false value remains distinguishable from a missing field. + * @param isTrue Exact persisted boolean value. + * @author Dmitriy Moroz + */ + data class Flag(val isTrue: Boolean) : BackupValue + + /** + * Portable integral setting such as sampling steps or timeout seconds. + * @param value Exact stored integer; field-specific validation occurs during inspection. + * @author Dmitriy Moroz + */ + data class Integer(val value: Int) : BackupValue +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/gateway/GenerationRestoreGate.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/gateway/GenerationRestoreGate.kt new file mode 100644 index 000000000..fb52955fb --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/gateway/GenerationRestoreGate.kt @@ -0,0 +1,21 @@ +package com.shifthackz.aisdv1.domain.gateway + +/** + * Prevents provider/settings restore from invalidating active foreground or background generation. + * @author Dmitriy Moroz + */ +interface GenerationRestoreGate { + /** + * Runs generation after any active restore has completed; cancellation while waiting propagates. + * @param block Complete provider operation owned by one generation use case. + * @author Dmitriy Moroz + */ + suspend fun generating(block: suspend () -> T): T + + /** + * Rejects restore while generation owns the gate, then prevents new generation until restore finishes. + * @param block Serialized restore operation, including conflict comparison and data commits. + * @author Dmitriy Moroz + */ + suspend fun restoring(block: suspend () -> T): T +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/gateway/backup/BackupChangesGateway.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/gateway/backup/BackupChangesGateway.kt new file mode 100644 index 000000000..7c8f6a0af --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/gateway/backup/BackupChangesGateway.kt @@ -0,0 +1,16 @@ +package com.shifthackz.aisdv1.domain.gateway.backup + +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory + +/** + * Refreshes retained application readers after restore commits or checked preference recovery. + * @author Dmitriy Moroz + */ +interface BackupChangesGateway { + /** + * Refreshes settings, locale and storage snapshots against their current trusted persisted data. + * @param categories Categories affected by restore or pending preference recovery; empty requires no refresh. + * @author Dmitriy Moroz + */ + suspend fun notifyChanged(categories: Set) +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/gateway/backup/BackupExportStateStore.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/gateway/backup/BackupExportStateStore.kt new file mode 100644 index 000000000..39d9bbe3f --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/gateway/backup/BackupExportStateStore.kt @@ -0,0 +1,34 @@ +package com.shifthackz.aisdv1.domain.gateway.backup + +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportIntent + +/** + * Checked nonsecret export persistence isolated from provider and credential preferences. + * @author Dmitriy Moroz + */ +interface BackupExportStateStore { + /** + * Recovers only a pending export-state write before ownership or native outcomes are examined. + * @author Dmitriy Moroz + */ + fun recoverPendingWrite() + + /** + * Returns the pending source/result association, or null when no export owns staging. + * @author Dmitriy Moroz + */ + fun read(): BackupExportIntent? + + /** + * Checks durable publication before native presentation or destination copying starts. + * @param intent Nonsecret staged-source and output association. + * @author Dmitriy Moroz + */ + fun write(intent: BackupExportIntent) + + /** + * Acknowledges dismissal/cancellation before app-owned export staging may be removed. + * @author Dmitriy Moroz + */ + fun clear() +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/gateway/backup/BackupImageValidator.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/gateway/backup/BackupImageValidator.kt new file mode 100644 index 000000000..afa2ed612 --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/gateway/backup/BackupImageValidator.kt @@ -0,0 +1,14 @@ +package com.shifthackz.aisdv1.domain.gateway.backup + +/** + * Checks native image dimensions before allocation and validates content through a bounded platform sample. + * @author Dmitriy Moroz + */ +interface BackupImageValidator { + /** + * Rejects over-budget dimensions, corrupt or unsupported images without decoding an original-size bitmap. + * @param bytes Complete bytes of one bounded gallery image. + * @author Dmitriy Moroz + */ + operator fun invoke(bytes: ByteArray) +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/gateway/backup/BackupPreferencesGateway.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/gateway/backup/BackupPreferencesGateway.kt new file mode 100644 index 000000000..37b976cf7 --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/gateway/backup/BackupPreferencesGateway.kt @@ -0,0 +1,65 @@ +package com.shifthackz.aisdv1.domain.gateway.backup + +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory +import com.shifthackz.aisdv1.domain.entity.backup.BackupPreferences +import com.shifthackz.aisdv1.domain.entity.backup.BackupValue +import com.shifthackz.aisdv1.domain.entity.backup.BackupStartupStage + +/** + * Strict portable preference persistence; transport and storage errors propagate to the caller. + * @author Dmitriy Moroz + */ +interface BackupPreferencesGateway { + /** + * Recovers an already-started checked batch and identifies changed portable preference categories. + * Authorization association and provider revision changes also report PROVIDERS, even without endpoint changes. + * The caller must reconcile protected credentials before publishing these invalidations. + * @author Dmitriy Moroz + */ + fun recoverPendingWrite(): Set + + /** + * Filters removed fields and unknown enum values while rejecting malformed known scalar types. + * @param preferences Portable fields decoded from an archive. + * @author Dmitriy Moroz + */ + fun filterSupported(preferences: BackupPreferences): BackupPreferences + + /** + * Reads meaningful provider or partial-setup groups with persisted field presence, plus effective app settings. + * Auto-written empty/default provider snapshots do not make a provider configured. + * @author Dmitriy Moroz + */ + fun read(): BackupPreferences + + /** + * Atomically persists selected provider fields without selecting a provider. + * @param providers Known provider fields to replace; absent values retain their destination state. + * @param authorizationCommitId New protected Basic Auth association, or null to preserve the existing association. + * @author Dmitriy Moroz + */ + fun writeProviders( + providers: Map>, + authorizationCommitId: String? + ) + + /** + * Atomically persists known user settings; unsupported fields must be ignored. + * @param settings Typed allowlisted field replacements. + * @author Dmitriy Moroz + */ + fun writeSettings(settings: Map) + + /** + * Reads the durable first-launch stage without changing completed existing installations. + * @author Dmitriy Moroz + */ + fun readStartupStage(): BackupStartupStage + + /** + * Persists post-onboarding progression before its route is replaced. + * @param stage New durable startup stage. + * @author Dmitriy Moroz + */ + fun writeStartupStage(stage: BackupStartupStage) +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/CancelBackupExportUseCase.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/CancelBackupExportUseCase.kt new file mode 100644 index 000000000..a461b3c12 --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/CancelBackupExportUseCase.kt @@ -0,0 +1,14 @@ +package com.shifthackz.aisdv1.domain.usecase.backup + + +/** + * Cancels the active destination copy while retaining its staged source for retry. + * @author Dmitriy Moroz + */ +interface CancelBackupExportUseCase { + /** + * Cancels the active destination copy while retaining its staged source for retry. + * @author Dmitriy Moroz + */ + operator fun invoke() +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/CompleteBackupExportUseCase.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/CompleteBackupExportUseCase.kt new file mode 100644 index 000000000..739913ef8 --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/CompleteBackupExportUseCase.kt @@ -0,0 +1,16 @@ +package com.shifthackz.aisdv1.domain.usecase.backup + +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportCompletion + +/** + * Queues native document results without depending on a screen initialization job. + * @author Dmitriy Moroz + */ +interface CompleteBackupExportUseCase { + /** + * Queues native document results without depending on a screen initialization job. + * @param completion Native outcome for the durably pending export. + * @author Dmitriy Moroz + */ + operator fun invoke(completion: BackupExportCompletion) +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/CreateBackupUseCase.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/CreateBackupUseCase.kt new file mode 100644 index 000000000..33d6698a7 --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/CreateBackupUseCase.kt @@ -0,0 +1,22 @@ +package com.shifthackz.aisdv1.domain.usecase.backup + +import com.shifthackz.aisdv1.domain.entity.backup.BackupSelection +import com.shifthackz.aisdv1.domain.entity.backup.BackupProgress +import com.shifthackz.aisdv1.domain.entity.backup.BackupExport + +/** + * Streams selected app data into a complete private binary archive; failure never returns an export. + * @author Dmitriy Moroz + */ +interface CreateBackupUseCase { + /** + * Streams selected app data into a complete private binary archive; failure never returns an export. + * @param selection Available categories and provider children to include. + * @param onProgress Receives bounded work progress; callbacks contain no credentials. + * @author Dmitriy Moroz + */ + suspend operator fun invoke( + selection: BackupSelection, + onProgress: (BackupProgress) -> Unit + ): BackupExport +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/DiscardBackupUseCase.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/DiscardBackupUseCase.kt new file mode 100644 index 000000000..fc27e0e1f --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/DiscardBackupUseCase.kt @@ -0,0 +1,15 @@ +package com.shifthackz.aisdv1.domain.usecase.backup + + +/** + * Releases only app-owned staging for an abandoned or completed archive. + * @author Dmitriy Moroz + */ +interface DiscardBackupUseCase { + /** + * Releases only app-owned staging for an abandoned or completed archive. + * @param handle Opaque archive identity or its private document reference. + * @author Dmitriy Moroz + */ + suspend operator fun invoke(handle: String) +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/DismissBackupExportUseCase.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/DismissBackupExportUseCase.kt new file mode 100644 index 000000000..ee2249031 --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/DismissBackupExportUseCase.kt @@ -0,0 +1,14 @@ +package com.shifthackz.aisdv1.domain.usecase.backup + + +/** + * Acknowledges a completed/abandoned export and releases only its private staging. + * @author Dmitriy Moroz + */ +interface DismissBackupExportUseCase { + /** + * Acknowledges a completed/abandoned export and releases only its private staging. + * @author Dmitriy Moroz + */ + suspend operator fun invoke() +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/ExportBackupUseCase.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/ExportBackupUseCase.kt new file mode 100644 index 000000000..5289a6d3b --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/ExportBackupUseCase.kt @@ -0,0 +1,16 @@ +package com.shifthackz.aisdv1.domain.usecase.backup + + +/** + * Copies a complete private archive to a user-selected Android destination; iOS exports the staged document natively. + * @author Dmitriy Moroz + */ +interface ExportBackupUseCase { + /** + * Copies a complete private archive to a user-selected Android destination; iOS exports the staged document natively. + * @param document Private archive reference produced by create. + * @param destination Opaque destination reference from the native document picker. + * @author Dmitriy Moroz + */ + suspend operator fun invoke(document: String, destination: String) +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/GetBackupStartupStageUseCase.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/GetBackupStartupStageUseCase.kt new file mode 100644 index 000000000..92ab87160 --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/GetBackupStartupStageUseCase.kt @@ -0,0 +1,15 @@ +package com.shifthackz.aisdv1.domain.usecase.backup + +import com.shifthackz.aisdv1.domain.entity.backup.BackupStartupStage + +/** + * Reads durable recovery routing without starting work or changing the active provider. + * @author Dmitriy Moroz + */ +interface GetBackupStartupStageUseCase { + /** + * Reads durable recovery routing without starting work or changing the active provider. + * @author Dmitriy Moroz + */ + operator fun invoke(): BackupStartupStage +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/GetPendingBackupExportUseCase.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/GetPendingBackupExportUseCase.kt new file mode 100644 index 000000000..eb7e96df7 --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/GetPendingBackupExportUseCase.kt @@ -0,0 +1,14 @@ +package com.shifthackz.aisdv1.domain.usecase.backup + + +/** + * Checks durable export intent so startup restores its dedicated route. + * @author Dmitriy Moroz + */ +interface GetPendingBackupExportUseCase { + /** + * Checks durable export intent so startup restores its dedicated route. + * @author Dmitriy Moroz + */ + suspend operator fun invoke(): Boolean +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/InspectBackupUseCase.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/InspectBackupUseCase.kt new file mode 100644 index 000000000..4f613e88d --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/InspectBackupUseCase.kt @@ -0,0 +1,21 @@ +package com.shifthackz.aisdv1.domain.usecase.backup + +import com.shifthackz.aisdv1.domain.entity.backup.BackupInspection +import com.shifthackz.aisdv1.domain.entity.backup.BackupProgress + +/** + * Copies a document into private staging and validates its binary container before any user-data mutation. + * @author Dmitriy Moroz + */ +interface InspectBackupUseCase { + /** + * Copies a document into private staging and validates its binary container before any user-data mutation. + * @param document Opaque reference returned by the native document picker. + * @param onProgress Receives staging and validation progress. + * @author Dmitriy Moroz + */ + suspend operator fun invoke( + document: String, + onProgress: (BackupProgress) -> Unit + ): BackupInspection +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/LoadBackupInventoryUseCase.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/LoadBackupInventoryUseCase.kt new file mode 100644 index 000000000..835b69a9c --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/LoadBackupInventoryUseCase.kt @@ -0,0 +1,15 @@ +package com.shifthackz.aisdv1.domain.usecase.backup + +import com.shifthackz.aisdv1.domain.entity.backup.BackupInspection + +/** + * Loads available portable categories without reading every gallery image. + * @author Dmitriy Moroz + */ +interface LoadBackupInventoryUseCase { + /** + * Loads available portable categories without reading every gallery image. + * @author Dmitriy Moroz + */ + suspend operator fun invoke(): BackupInspection +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/LoadPendingBackupUseCase.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/LoadPendingBackupUseCase.kt new file mode 100644 index 000000000..21b6e7441 --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/LoadPendingBackupUseCase.kt @@ -0,0 +1,15 @@ +package com.shifthackz.aisdv1.domain.usecase.backup + +import com.shifthackz.aisdv1.domain.entity.backup.BackupRecovery + +/** + * Recovers unfinished checked preferences before allowing normal startup and returns resumable restore state. + * @author Dmitriy Moroz + */ +interface LoadPendingBackupUseCase { + /** + * Loads one durable pending operation, or null when startup may continue normally. + * @author Dmitriy Moroz + */ + suspend operator fun invoke(): BackupRecovery? +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/ObserveBackupExportUseCase.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/ObserveBackupExportUseCase.kt new file mode 100644 index 000000000..d03d9c65a --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/ObserveBackupExportUseCase.kt @@ -0,0 +1,16 @@ +package com.shifthackz.aisdv1.domain.usecase.backup + +import kotlinx.coroutines.flow.StateFlow +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportOperation + +/** + * Observes process-owned export progress across screen/activity recreation. + * @author Dmitriy Moroz + */ +interface ObserveBackupExportUseCase { + /** + * Observes process-owned export progress across screen/activity recreation. + * @author Dmitriy Moroz + */ + operator fun invoke(): StateFlow +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/RestoreBackupUseCase.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/RestoreBackupUseCase.kt new file mode 100644 index 000000000..51b64d203 --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/RestoreBackupUseCase.kt @@ -0,0 +1,22 @@ +package com.shifthackz.aisdv1.domain.usecase.backup + +import com.shifthackz.aisdv1.domain.entity.backup.BackupProgress +import com.shifthackz.aisdv1.domain.entity.backup.BackupRestoreRequest +import com.shifthackz.aisdv1.domain.entity.backup.BackupRestoreResult + +/** + * Merges selected data with category-atomic commits and durable retry identity; cancellation propagates. + * @author Dmitriy Moroz + */ +interface RestoreBackupUseCase { + /** + * Merges selected data with category-atomic commits and durable retry identity; cancellation propagates. + * @param request Validated archive, selection and conflict consent. + * @param onProgress Receives current import stage progress. + * @author Dmitriy Moroz + */ + suspend operator fun invoke( + request: BackupRestoreRequest, + onProgress: (BackupProgress) -> Unit + ): BackupRestoreResult +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/SetBackupStartupStageUseCase.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/SetBackupStartupStageUseCase.kt new file mode 100644 index 000000000..37ade1859 --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/backup/SetBackupStartupStageUseCase.kt @@ -0,0 +1,16 @@ +package com.shifthackz.aisdv1.domain.usecase.backup + +import com.shifthackz.aisdv1.domain.entity.backup.BackupStartupStage + +/** + * Persists a forward first-launch transition before navigation; stale earlier stages are ignored. + * @author Dmitriy Moroz + */ +interface SetBackupStartupStageUseCase { + /** + * Persists a forward first-launch transition before navigation; stale earlier stages are ignored. + * @param stage New recovery stage. + * @author Dmitriy Moroz + */ + operator fun invoke(stage: BackupStartupStage) +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/connectivity/ObserveSeverConnectivityUseCase.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/connectivity/ObserveSeverConnectivityUseCase.kt index c81617100..88277c419 100644 --- a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/connectivity/ObserveSeverConnectivityUseCase.kt +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/connectivity/ObserveSeverConnectivityUseCase.kt @@ -5,30 +5,32 @@ import kotlinx.coroutines.flow.Flow import kotlinx.coroutines.flow.distinctUntilChanged /** - * Executes the `function` step in the SDAI domain layer. + * Observes connectivity of the configured generation server. * * @author Dmitriy Moroz */ fun interface ObserveSeverConnectivityUseCase { + /** + * Emits the current connectivity state and later distinct changes. + * + * @author Dmitriy Moroz + */ operator fun invoke(): Flow } /** - * Implements `ObserveSeverConnectivityUseCase` behavior in the SDAI domain layer. + * Observes server connectivity while suppressing consecutive duplicate states. + * + * @param serverConnectivityGateway Supplies connectivity changes for the configured server. * * @author Dmitriy Moroz */ -class ObserveSeverConnectivityUseCaseImpl( - /** - * Exposes the `serverConnectivityGateway` value used by the SDAI domain layer. - * - * @author Dmitriy Moroz - */ +internal class ObserveSeverConnectivityUseCaseImpl( private val serverConnectivityGateway: ServerConnectivityGateway, ) : ObserveSeverConnectivityUseCase { /** - * Executes the `invoke` step in the SDAI domain layer. + * Emits the current connectivity state and subsequent distinct changes. * * @author Dmitriy Moroz */ diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/debug/DebugInsertBadBase64UseCaseImpl.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/debug/DebugInsertBadBase64UseCaseImpl.kt index 93232f5a1..61eebb712 100644 --- a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/debug/DebugInsertBadBase64UseCaseImpl.kt +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/debug/DebugInsertBadBase64UseCaseImpl.kt @@ -5,27 +5,20 @@ import com.shifthackz.aisdv1.domain.entity.AiGenerationResult import com.shifthackz.aisdv1.domain.repository.GenerationResultRepository /** - * Implements `DebugInsertBadBase64UseCase` behavior in the SDAI domain layer. + * Adds a deliberately invalid gallery image for the developer diagnostics action. + * + * @param repository Persists the diagnostic gallery entry. + * @param timeProvider Supplies its creation timestamp and invalid image content. * * @author Dmitriy Moroz */ -class DebugInsertBadBase64UseCaseImpl( - /** - * Exposes the `repository` value used by the SDAI domain layer. - * - * @author Dmitriy Moroz - */ +internal class DebugInsertBadBase64UseCaseImpl( private val repository: GenerationResultRepository, - /** - * Exposes the `timeProvider` value used by the SDAI domain layer. - * - * @author Dmitriy Moroz - */ private val timeProvider: TimeProvider, ) : DebugInsertBadBase64UseCase { /** - * Executes the `invoke` step in the SDAI domain layer. + * Inserts one diagnostic gallery entry with intentionally invalid image bytes. * * @author Dmitriy Moroz */ @@ -33,16 +26,11 @@ class DebugInsertBadBase64UseCaseImpl( repository.insert(stubBadBase64Generation(timeProvider.currentTimeMillis())) } - /** - * Provides the `companion object` singleton used by the SDAI domain layer. - * - * @author Dmitriy Moroz - */ companion object { /** - * Executes the `stubBadBase64Generation` step in the SDAI domain layer. + * Builds an invalid-image entry with otherwise usable generation metadata. * - * @param now now value consumed by the API. + * @param now Creation timestamp also used as deliberately invalid Base64 content. * @author Dmitriy Moroz */ private fun stubBadBase64Generation(now: Long) = AiGenerationResult( diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/donate/FetchSupportersUseCaseImpl.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/donate/FetchSupportersUseCaseImpl.kt index d5cff2b3c..1fc62c335 100644 --- a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/donate/FetchSupportersUseCaseImpl.kt +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/donate/FetchSupportersUseCaseImpl.kt @@ -4,21 +4,18 @@ import com.shifthackz.aisdv1.domain.entity.Supporter import com.shifthackz.aisdv1.domain.repository.SupportersRepository /** - * Implements `FetchSupportersUseCase` behavior in the SDAI domain layer. + * Refreshes the supporter list through its repository. + * + * @param repository Loads the current supporter list and its stored representation. * * @author Dmitriy Moroz */ -class FetchSupportersUseCaseImpl( - /** - * Exposes the `repository` value used by the SDAI domain layer. - * - * @author Dmitriy Moroz - */ +internal class FetchSupportersUseCaseImpl( private val repository: SupportersRepository, ) : FetchSupportersUseCase { /** - * Executes the `invoke` step in the SDAI domain layer. + * Returns supporters after the repository refresh completes. * * @author Dmitriy Moroz */ diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/gallery/GetMediaStoreInfoUseCaseImpl.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/gallery/GetMediaStoreInfoUseCaseImpl.kt index c8b10c1db..255175897 100644 --- a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/gallery/GetMediaStoreInfoUseCaseImpl.kt +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/gallery/GetMediaStoreInfoUseCaseImpl.kt @@ -3,21 +3,18 @@ package com.shifthackz.aisdv1.domain.usecase.gallery import com.shifthackz.aisdv1.domain.gateway.MediaStoreGateway /** - * Implements `GetMediaStoreInfoUseCase` behavior in the SDAI domain layer. + * Reads storage information for the gallery export destination. + * + * @param mediaStoreGateway Provides platform-specific media storage information. * * @author Dmitriy Moroz */ -class GetMediaStoreInfoUseCaseImpl( - /** - * Exposes the `mediaStoreGateway` value used by the SDAI domain layer. - * - * @author Dmitriy Moroz - */ +internal class GetMediaStoreInfoUseCaseImpl( private val mediaStoreGateway: MediaStoreGateway, ) : GetMediaStoreInfoUseCase { /** - * Executes the `invoke` step in the SDAI domain layer. + * Returns the platform media storage information. * * @author Dmitriy Moroz */ diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/GetRandomImageUseCaseImpl.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/GetRandomImageUseCaseImpl.kt index 467167acf..c6d6f4dcc 100644 --- a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/GetRandomImageUseCaseImpl.kt +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/GetRandomImageUseCaseImpl.kt @@ -3,21 +3,18 @@ package com.shifthackz.aisdv1.domain.usecase.generation import com.shifthackz.aisdv1.domain.repository.RandomImageRepository /** - * Implements `GetRandomImageUseCase` behavior in the SDAI domain layer. + * Loads a random reference image for the generation input. + * + * @param randomImageRepository Fetches and stores the random reference image. * * @author Dmitriy Moroz */ -class GetRandomImageUseCaseImpl( - /** - * Exposes the `randomImageRepository` value used by the SDAI domain layer. - * - * @author Dmitriy Moroz - */ +internal class GetRandomImageUseCaseImpl( private val randomImageRepository: RandomImageRepository, ) : GetRandomImageUseCase { /** - * Executes the `invoke` step in the SDAI domain layer. + * Returns the reference image supplied by the repository. * * @author Dmitriy Moroz */ diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/ImageToImageUseCaseImpl.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/ImageToImageUseCaseImpl.kt index 4b40de924..7cc364f67 100644 --- a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/ImageToImageUseCaseImpl.kt +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/ImageToImageUseCaseImpl.kt @@ -7,6 +7,7 @@ import com.shifthackz.aisdv1.domain.usecase.easydiffusion.toEasyDiffusionRequest import kotlinx.coroutines.ensureActive import kotlin.coroutines.coroutineContext +import com.shifthackz.aisdv1.domain.gateway.GenerationRestoreGate import com.shifthackz.aisdv1.domain.entity.AiGenerationResult import com.shifthackz.aisdv1.domain.entity.ImageToImagePayload import com.shifthackz.aisdv1.domain.entity.ServerSource @@ -32,6 +33,7 @@ import com.shifthackz.aisdv1.domain.repository.SwarmUiGenerationRepository * @param falAiGenerationRepository Generation and result persistence for Fal.ai. * @param arliAiGenerationRepository Generation and result persistence for ArliAI. * @param preferenceManager Current provider selection and independent generation preferences. + * @param generationRestoreGate Serializes generation against portable backup restoration. * @param captureEasyDiffusionConnectionUseCase Captures endpoint/checkpoint under the provider-selection lock, retaining the submitted revision. * @param generateEasyDiffusionUseCase Owns captured-task batching, stream recovery, cancellation and deadlines. * @author Dmitriy Moroz @@ -55,6 +57,7 @@ internal class ImageToImageUseCaseImpl( private val arliAiGenerationRepository: ArliAiGenerationRepository, private val preferenceManager: PreferenceManager, + private val generationRestoreGate: GenerationRestoreGate, private val generateEasyDiffusionUseCase: GenerateEasyDiffusionUseCase, private val captureEasyDiffusionConnectionUseCase: CaptureEasyDiffusionConnectionUseCase, ) : ImageToImageUseCase { @@ -65,7 +68,15 @@ internal class ImageToImageUseCaseImpl( * @param payload Immutable supported generation inputs and captured provider identity. * @author Dmitriy Moroz */ - override suspend fun invoke(payload: ImageToImagePayload): List { + override suspend fun invoke(payload: ImageToImagePayload): List = + generationRestoreGate.generating { generate(payload) } + + /** + * Executes a captured image request while this operation owns generation admission. + * @param payload Immutable provider generation inputs and source image. + * @author Dmitriy Moroz + */ + private suspend fun generate(payload: ImageToImagePayload): List { coroutineContext.ensureActive() val source = payload.sourceSnapshot ?: preferenceManager.source check(source == preferenceManager.source) { "Generation source changed" } diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/TextToImageUseCaseImpl.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/TextToImageUseCaseImpl.kt index e3cc96e0b..126fcabe7 100755 --- a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/TextToImageUseCaseImpl.kt +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/generation/TextToImageUseCaseImpl.kt @@ -7,6 +7,7 @@ import com.shifthackz.aisdv1.domain.usecase.easydiffusion.toEasyDiffusionRequest import kotlinx.coroutines.ensureActive import kotlin.coroutines.coroutineContext +import com.shifthackz.aisdv1.domain.gateway.GenerationRestoreGate import com.shifthackz.aisdv1.domain.entity.AiGenerationResult import com.shifthackz.aisdv1.domain.entity.ServerSource import com.shifthackz.aisdv1.domain.entity.TextToImagePayload @@ -49,6 +50,7 @@ import com.shifthackz.aisdv1.domain.repository.SwarmUiGenerationRepository * @param bonsaiGenerationRepository Generation and result persistence for Bonsai. * @param mnnGenerationRepository Isolated MNN request execution after fixed-profile and seed admission. * @param preferenceManager Current provider selection and independent generation preferences. + * @param generationRestoreGate Serializes generation against portable backup restoration. * @param generateEasyDiffusionUseCase Owns captured-task batching, stream recovery, cancellation and deadlines. * @param captureEasyDiffusionConnectionUseCase Captures endpoint/checkpoint under the provider-selection lock, retaining the submitted revision. * @@ -86,6 +88,7 @@ internal class TextToImageUseCaseImpl( private val mnnGenerationRepository: MnnGenerationRepository, private val preferenceManager: PreferenceManager, + private val generationRestoreGate: GenerationRestoreGate, private val generateEasyDiffusionUseCase: GenerateEasyDiffusionUseCase, private val captureEasyDiffusionConnectionUseCase: CaptureEasyDiffusionConnectionUseCase, ) : TextToImageUseCase { @@ -101,9 +104,15 @@ internal class TextToImageUseCaseImpl( * * @author Dmitriy Moroz */ - override suspend operator fun invoke( - payload: TextToImagePayload, - ): List { + override suspend operator fun invoke(payload: TextToImagePayload): List = + generationRestoreGate.generating { generate(payload) } + + /** + * Executes a captured text request while this operation owns generation admission. + * @param payload Immutable provider generation inputs. + * @author Dmitriy Moroz + */ + private suspend fun generate(payload: TextToImagePayload): List { val source = payload.sourceSnapshot ?: preferenceManager.source check(source == preferenceManager.source) { "Generation source changed" } if (source == ServerSource.LOCAL_MNN) { diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/huggingface/FetchHuggingFaceModelsUseCaseImpl.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/huggingface/FetchHuggingFaceModelsUseCaseImpl.kt index 95771b49a..cfd00debd 100644 --- a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/huggingface/FetchHuggingFaceModelsUseCaseImpl.kt +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/huggingface/FetchHuggingFaceModelsUseCaseImpl.kt @@ -6,29 +6,22 @@ import com.shifthackz.aisdv1.domain.preference.PreferenceManager import com.shifthackz.aisdv1.domain.repository.HuggingFaceModelsRepository /** - * Implements `FetchHuggingFaceModelsUseCase` behavior in the SDAI domain layer. + * Loads Hugging Face models only while that provider is selected. + * + * @param preferenceManager Identifies the currently selected generation provider. + * @param repository Refreshes and reads the Hugging Face model catalog. * * @author Dmitriy Moroz */ -class FetchHuggingFaceModelsUseCaseImpl( - /** - * Exposes the `preferenceManager` value used by the SDAI domain layer. - * - * @author Dmitriy Moroz - */ +internal class FetchHuggingFaceModelsUseCaseImpl( private val preferenceManager: PreferenceManager, - /** - * Exposes the `repository` value used by the SDAI domain layer. - * - * @author Dmitriy Moroz - */ private val repository: HuggingFaceModelsRepository, ) : FetchHuggingFaceModelsUseCase { /** - * Executes the `invoke` step in the SDAI domain layer. + * Returns refreshed Hugging Face models, or an empty list for another provider. * - * @return Result produced by `invoke`. + * @return The catalog available for the current provider. * @author Dmitriy Moroz */ override suspend fun invoke(): List { diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/report/SendReportUseCaseImpl.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/report/SendReportUseCaseImpl.kt index 3a3dd3e81..642462383 100644 --- a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/report/SendReportUseCaseImpl.kt +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/report/SendReportUseCaseImpl.kt @@ -4,25 +4,22 @@ import com.shifthackz.aisdv1.domain.entity.ReportReason import com.shifthackz.aisdv1.domain.repository.ReportRepository /** - * Implements `SendReportUseCase` behavior in the SDAI domain layer. + * Submits a user report with its reason and attached image. + * + * @param repository Delivers the report to the configured reporting destination. * * @author Dmitriy Moroz */ -class SendReportUseCaseImpl( - /** - * Exposes the `repository` value used by the SDAI domain layer. - * - * @author Dmitriy Moroz - */ +internal class SendReportUseCaseImpl( private val repository: ReportRepository, ) : SendReportUseCase { /** - * Executes the `invoke` step in the SDAI domain layer. + * Sends the supplied report and propagates delivery failures. * - * @param text text value consumed by the API. - * @param reason reason value consumed by the API. - * @param image image value consumed by the API. + * @param text User-provided description of the issue. + * @param reason Report category selected by the user. + * @param image Image attachment passed to the reporting repository. * @author Dmitriy Moroz */ override suspend fun invoke(text: String, reason: ReportReason, image: String) = diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/sdembedding/FetchAndGetEmbeddingsUseCaseImpl.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/sdembedding/FetchAndGetEmbeddingsUseCaseImpl.kt index 7a330c52c..aaa1bbf03 100644 --- a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/sdembedding/FetchAndGetEmbeddingsUseCaseImpl.kt +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/sdembedding/FetchAndGetEmbeddingsUseCaseImpl.kt @@ -4,21 +4,18 @@ import com.shifthackz.aisdv1.domain.entity.Embedding import com.shifthackz.aisdv1.domain.repository.EmbeddingsRepository /** - * Implements `FetchAndGetEmbeddingsUseCase` behavior in the SDAI domain layer. + * Refreshes and reads the configured server embedding catalog. + * + * @param repository Refreshes embedding descriptors and reads the resulting catalog. * * @author Dmitriy Moroz */ -class FetchAndGetEmbeddingsUseCaseImpl( - /** - * Exposes the `repository` value used by the SDAI domain layer. - * - * @author Dmitriy Moroz - */ +internal class FetchAndGetEmbeddingsUseCaseImpl( private val repository: EmbeddingsRepository, ) : FetchAndGetEmbeddingsUseCase { /** - * Executes the `invoke` step in the SDAI domain layer. + * Returns the embedding catalog after its repository refresh. * * @author Dmitriy Moroz */ diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/sdlora/FetchAndGetLorasUseCaseImpl.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/sdlora/FetchAndGetLorasUseCaseImpl.kt index 46af5001f..a250d8ffd 100644 --- a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/sdlora/FetchAndGetLorasUseCaseImpl.kt +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/sdlora/FetchAndGetLorasUseCaseImpl.kt @@ -3,21 +3,18 @@ package com.shifthackz.aisdv1.domain.usecase.sdlora import com.shifthackz.aisdv1.domain.repository.LorasRepository /** - * Implements `FetchAndGetLorasUseCase` behavior in the SDAI domain layer. + * Refreshes and reads the configured server LoRA catalog. + * + * @param lorasRepository Refreshes LoRA descriptors and reads the resulting catalog. * * @author Dmitriy Moroz */ -class FetchAndGetLorasUseCaseImpl( - /** - * Exposes the `lorasRepository` value used by the SDAI domain layer. - * - * @author Dmitriy Moroz - */ +internal class FetchAndGetLorasUseCaseImpl( private val lorasRepository: LorasRepository, ) : FetchAndGetLorasUseCase { /** - * Executes the `invoke` step in the SDAI domain layer. + * Returns the LoRA catalog after its repository refresh. * * @author Dmitriy Moroz */ diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/sdmodel/GetStableDiffusionModelsUseCaseImpl.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/sdmodel/GetStableDiffusionModelsUseCaseImpl.kt index 7d37c22fe..c223afc81 100644 --- a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/sdmodel/GetStableDiffusionModelsUseCaseImpl.kt +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/sdmodel/GetStableDiffusionModelsUseCaseImpl.kt @@ -7,35 +7,24 @@ import com.shifthackz.aisdv1.domain.repository.ServerConfigurationRepository import com.shifthackz.aisdv1.domain.repository.StableDiffusionModelsRepository /** - * Implements `GetStableDiffusionModelsUseCase` behavior in the SDAI domain layer. + * Loads Automatic1111 checkpoints and marks the server-selected checkpoint. + * + * @param preferenceManager Identifies whether Automatic1111 is the selected provider. + * @param serverConfigurationRepository Reads the refreshed server checkpoint selection. + * @param sdModelsRepository Refreshes and reads available checkpoint descriptors. * * @author Dmitriy Moroz */ -class GetStableDiffusionModelsUseCaseImpl( - /** - * Exposes the `preferenceManager` value used by the SDAI domain layer. - * - * @author Dmitriy Moroz - */ +internal class GetStableDiffusionModelsUseCaseImpl( private val preferenceManager: PreferenceManager, - /** - * Exposes the `serverConfigurationRepository` value used by the SDAI domain layer. - * - * @author Dmitriy Moroz - */ private val serverConfigurationRepository: ServerConfigurationRepository, - /** - * Exposes the `sdModelsRepository` value used by the SDAI domain layer. - * - * @author Dmitriy Moroz - */ private val sdModelsRepository: StableDiffusionModelsRepository, ) : GetStableDiffusionModelsUseCase { /** - * Executes the `invoke` step in the SDAI domain layer. + * Returns checkpoints paired with their selected state, or an empty list for another provider. * - * @return Result produced by `invoke`. + * @return The catalog available for the current provider. * @author Dmitriy Moroz */ override suspend operator fun invoke(): List> { diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/sdsampler/GetStableDiffusionSamplersUseCaseImpl.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/sdsampler/GetStableDiffusionSamplersUseCaseImpl.kt index 33caf9bb5..e05fbc729 100644 --- a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/sdsampler/GetStableDiffusionSamplersUseCaseImpl.kt +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/sdsampler/GetStableDiffusionSamplersUseCaseImpl.kt @@ -10,7 +10,7 @@ import kotlinx.coroutines.CancellationException * @param repository Fetches samplers from the configured server and reads their cache. * @author Dmitriy Moroz */ -class GetStableDiffusionSamplersUseCaseImpl( +internal class GetStableDiffusionSamplersUseCaseImpl( private val repository: StableDiffusionSamplersRepository, ) : GetStableDiffusionSamplersUseCase { diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/settings/DefaultSetServerConfigurationUseCaseImpl.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/settings/DefaultSetServerConfigurationUseCaseImpl.kt index 7fcaa78b8..12209bdf6 100644 --- a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/settings/DefaultSetServerConfigurationUseCaseImpl.kt +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/settings/DefaultSetServerConfigurationUseCaseImpl.kt @@ -2,6 +2,8 @@ package com.shifthackz.aisdv1.domain.usecase.settings import com.shifthackz.aisdv1.core.common.schedulers.DispatchersProvider import com.shifthackz.aisdv1.domain.entity.AuthorizationStorageFailure +import com.shifthackz.aisdv1.domain.entity.backup.BackupStartupStage +import com.shifthackz.aisdv1.domain.gateway.backup.BackupPreferencesGateway import com.shifthackz.aisdv1.domain.entity.Configuration import com.shifthackz.aisdv1.domain.entity.ServerSource import com.shifthackz.aisdv1.domain.feature.auth.AuthorizationStore @@ -23,6 +25,7 @@ import kotlinx.coroutines.withContext * @param authorizationStore Commits protected Basic Auth before publishing its provider settings. * @param preferenceManager Refreshes observers after the complete transition. * @param providerSelectionGuard Serializes source changes and identity-sensitive publication. + * @param backupPreferences Completes first-launch recovery only after a real provider configuration commit. * @author Dmitriy Moroz */ internal class DefaultSetServerConfigurationUseCaseImpl( @@ -31,6 +34,7 @@ internal class DefaultSetServerConfigurationUseCaseImpl( private val authorizationStore: AuthorizationStore, private val preferenceManager: PreferenceManager, private val providerSelectionGuard: ProviderSelectionGuard, + private val backupPreferences: BackupPreferencesGateway, ) : SetServerConfigurationUseCase { /** * Commits Basic Auth only for providers that use it, preserving stored credentials otherwise. @@ -60,6 +64,9 @@ internal class DefaultSetServerConfigurationUseCaseImpl( configurationStore.getAuthorizationCommitId() ) } + if (backupPreferences.readStartupStage() == BackupStartupStage.CONFIGURATION) { + backupPreferences.writeStartupStage(BackupStartupStage.COMPLETE) + } preferenceManager.refresh() } } diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/settings/NetworkUsageUseCases.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/settings/NetworkUsageUseCases.kt index 9984824c7..cee7de19c 100644 --- a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/settings/NetworkUsageUseCases.kt +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/settings/NetworkUsageUseCases.kt @@ -25,7 +25,7 @@ fun interface ObserveNetworkUsageUseCase { * * @author Dmitriy Moroz */ -class ObserveNetworkUsageUseCaseImpl( +internal class ObserveNetworkUsageUseCaseImpl( private val repository: NetworkUsageRepository, ) : ObserveNetworkUsageUseCase { override fun invoke(): Flow = repository.observe() @@ -52,7 +52,7 @@ fun interface ResetNetworkUsageUseCase { * * @author Dmitriy Moroz */ -class ResetNetworkUsageUseCaseImpl( +internal class ResetNetworkUsageUseCaseImpl( private val repository: NetworkUsageRepository, ) : ResetNetworkUsageUseCase { override suspend fun invoke() = repository.reset() diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/splash/SplashNavigationUseCase.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/splash/SplashNavigationUseCase.kt index b1a43bff3..f082a270c 100644 --- a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/splash/SplashNavigationUseCase.kt +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/splash/SplashNavigationUseCase.kt @@ -1,70 +1,31 @@ package com.shifthackz.aisdv1.domain.usecase.splash -import com.shifthackz.aisdv1.domain.entity.ServerSource -import com.shifthackz.aisdv1.domain.preference.PreferenceManager /** - * Defines the `SplashNavigationUseCase` contract for the SDAI domain layer. + * Chooses startup routing from onboarding, recovery and saved provider state. * * @author Dmitriy Moroz */ interface SplashNavigationUseCase { /** - * Executes the `invoke` step in the SDAI domain layer. + * Returns the first route that can safely publish the current persisted configuration. * - * @return Result produced by `invoke`. + * @return Startup destination after pending restore checks. * @author Dmitriy Moroz */ suspend operator fun invoke(): Action /** - * Coordinates `Action` behavior in the SDAI domain layer. + * Startup destinations evaluated before normal provider loading. * * @author Dmitriy Moroz */ enum class Action { LAUNCH_ONBOARDING, + LAUNCH_BACKUP_WELCOME, + LAUNCH_BACKUP_RESTORE, + LAUNCH_INITIAL_RESTORE, LAUNCH_SERVER_SETUP, LAUNCH_HOME; } } - -/** - * Implements `SplashNavigationUseCase` behavior in the SDAI domain layer. - * - * @author Dmitriy Moroz - */ -class SplashNavigationUseCaseImpl( - /** - * Exposes the `preferenceManager` value used by the SDAI domain layer. - * - * @author Dmitriy Moroz - */ - private val preferenceManager: PreferenceManager, -) : SplashNavigationUseCase { - - /** - * Executes the `invoke` step in the SDAI domain layer. - * - * @return Result produced by `invoke`. - * @author Dmitriy Moroz - */ - override suspend fun invoke(): SplashNavigationUseCase.Action { - return when { - !preferenceManager.onBoardingComplete -> { - SplashNavigationUseCase.Action.LAUNCH_ONBOARDING - } - - preferenceManager.forceSetupAfterUpdate -> { - SplashNavigationUseCase.Action.LAUNCH_SERVER_SETUP - } - - preferenceManager.automatic1111ServerUrl.isEmpty() && - preferenceManager.source == ServerSource.AUTOMATIC1111 -> { - SplashNavigationUseCase.Action.LAUNCH_SERVER_SETUP - } - - else -> SplashNavigationUseCase.Action.LAUNCH_HOME - } - } -} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/splash/SplashNavigationUseCaseImpl.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/splash/SplashNavigationUseCaseImpl.kt new file mode 100644 index 000000000..97cd28531 --- /dev/null +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/splash/SplashNavigationUseCaseImpl.kt @@ -0,0 +1,38 @@ +package com.shifthackz.aisdv1.domain.usecase.splash + +import com.shifthackz.aisdv1.domain.entity.ServerSource +import com.shifthackz.aisdv1.domain.entity.backup.BackupStartupStage +import com.shifthackz.aisdv1.domain.preference.PreferenceManager +import com.shifthackz.aisdv1.domain.usecase.backup.GetBackupStartupStageUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.LoadPendingBackupUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.GetPendingBackupExportUseCase + +/** + * Routes unfinished recovery before publishing normal provider state; existing installations skip the invitation. + * + * @param preferenceManager Existing onboarding and provider prerequisites. + * @param getBackupStartupStage Durable fresh-install recovery progression. + * @param loadPendingBackup Revalidates pending restore intent and recovers checked credential associations. + * @param getPendingExport Checks for a staged native export that needs its backup route restored. + * + * @author Dmitriy Moroz + */ +internal class SplashNavigationUseCaseImpl( + private val preferenceManager: PreferenceManager, + private val getBackupStartupStage: GetBackupStartupStageUseCase, + private val loadPendingBackup: LoadPendingBackupUseCase, + private val getPendingExport: GetPendingBackupExportUseCase, +) : SplashNavigationUseCase { + + override suspend fun invoke(): SplashNavigationUseCase.Action = when { + !preferenceManager.onBoardingComplete -> SplashNavigationUseCase.Action.LAUNCH_ONBOARDING + loadPendingBackup() != null -> if (getBackupStartupStage() == BackupStartupStage.RESTORE) SplashNavigationUseCase.Action.LAUNCH_INITIAL_RESTORE else SplashNavigationUseCase.Action.LAUNCH_BACKUP_RESTORE + getBackupStartupStage() == BackupStartupStage.INVITATION -> SplashNavigationUseCase.Action.LAUNCH_BACKUP_WELCOME + getBackupStartupStage() == BackupStartupStage.RESTORE -> SplashNavigationUseCase.Action.LAUNCH_INITIAL_RESTORE + getBackupStartupStage() == BackupStartupStage.CONFIGURATION -> SplashNavigationUseCase.Action.LAUNCH_SERVER_SETUP + getPendingExport() -> SplashNavigationUseCase.Action.LAUNCH_BACKUP_RESTORE + preferenceManager.forceSetupAfterUpdate -> SplashNavigationUseCase.Action.LAUNCH_SERVER_SETUP + preferenceManager.automatic1111ServerUrl.isEmpty() && preferenceManager.source == ServerSource.AUTOMATIC1111 -> SplashNavigationUseCase.Action.LAUNCH_SERVER_SETUP + else -> SplashNavigationUseCase.Action.LAUNCH_HOME + } +} diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/stabilityai/FetchStabilityAiEnginesUseCase.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/stabilityai/FetchStabilityAiEnginesUseCase.kt index 3f0530cc2..be731846b 100644 --- a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/stabilityai/FetchStabilityAiEnginesUseCase.kt +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/stabilityai/FetchStabilityAiEnginesUseCase.kt @@ -4,41 +4,38 @@ import com.shifthackz.aisdv1.domain.entity.StabilityAiEngine import com.shifthackz.aisdv1.domain.repository.StabilityAiEnginesRepository /** - * Defines the `FetchStabilityAiEnginesUseCase` contract for the SDAI domain layer. + * Loads the engines available to a Stability AI account. * * @author Dmitriy Moroz */ interface FetchStabilityAiEnginesUseCase { /** - * Executes the `invoke` step in the SDAI domain layer. + * Returns the engines available to the authenticated account. * - * @param apiKey api key value consumed by the API. - * @return Result produced by `invoke`. + * @param apiKey Account API key used to authenticate the engine request. + * @return The catalog available for the current provider. * @author Dmitriy Moroz */ suspend operator fun invoke(apiKey: String): List } /** - * Implements `FetchStabilityAiEnginesUseCase` behavior in the SDAI domain layer. + * Loads the Stability AI engines available to the supplied account. + * + * @param repository Fetches engine descriptors using the supplied API key. * * @author Dmitriy Moroz */ -class FetchStabilityAiEnginesUseCaseImpl( - /** - * Exposes the `repository` value used by the SDAI domain layer. - * - * @author Dmitriy Moroz - */ +internal class FetchStabilityAiEnginesUseCaseImpl( private val repository: StabilityAiEnginesRepository, ) : FetchStabilityAiEnginesUseCase { /** - * Executes the `invoke` step in the SDAI domain layer. + * Returns the engines available to the authenticated account. * - * @param apiKey api key value consumed by the API. - * @return Result produced by `invoke`. + * @param apiKey Account API key used to authenticate the engine request. + * @return The catalog available for the current provider. * @author Dmitriy Moroz */ override suspend fun invoke(apiKey: String): List = diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/stabilityai/ObserveStabilityAiCreditsUseCaseImpl.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/stabilityai/ObserveStabilityAiCreditsUseCaseImpl.kt index 1abcd3429..77f2ba6a8 100644 --- a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/stabilityai/ObserveStabilityAiCreditsUseCaseImpl.kt +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/stabilityai/ObserveStabilityAiCreditsUseCaseImpl.kt @@ -4,21 +4,18 @@ import com.shifthackz.aisdv1.domain.repository.StabilityAiCreditsRepository import kotlinx.coroutines.flow.catch /** - * Implements `ObserveStabilityAiCreditsUseCase` behavior in the SDAI domain layer. + * Observes refreshed Stability AI credits, emitting zero when the credit stream fails. + * + * @param repository Refreshes and observes the account credit balance. * * @author Dmitriy Moroz */ -class ObserveStabilityAiCreditsUseCaseImpl( - /** - * Exposes the `repository` value used by the SDAI domain layer. - * - * @author Dmitriy Moroz - */ +internal class ObserveStabilityAiCreditsUseCaseImpl( private val repository: StabilityAiCreditsRepository, ) : ObserveStabilityAiCreditsUseCase { /** - * Executes the `invoke` step in the SDAI domain layer. + * Emits account credits, or zero if refreshing or observing fails. * * @author Dmitriy Moroz */ diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/swarmmodel/FetchSwarmUiModelsUseCase.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/swarmmodel/FetchSwarmUiModelsUseCase.kt index 5d83e40ed..38997c144 100644 --- a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/swarmmodel/FetchSwarmUiModelsUseCase.kt +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/usecase/swarmmodel/FetchSwarmUiModelsUseCase.kt @@ -5,19 +5,19 @@ import com.shifthackz.aisdv1.domain.entity.SwarmUiModel import com.shifthackz.aisdv1.domain.feature.auth.AuthorizationCredentials /** - * Defines the `FetchSwarmUiModelsUseCase` contract for the SDAI domain layer. + * Loads model descriptors from an authenticated Swarm UI session. * * @author Dmitriy Moroz */ interface FetchSwarmUiModelsUseCase { /** - * Executes the `invoke` step in the SDAI domain layer. + * Returns models reported by the selected Swarm UI session. * - * @param baseUrl base url value consumed by the API. - * @param sessionId session id value consumed by the API. - * @param credentials credentials value consumed by the API. - * @return Result produced by `invoke`. + * @param baseUrl Full API base URL of the selected Swarm UI server. + * @param sessionId Active Swarm UI session identifier. + * @param credentials Optional transport authorization for the server. + * @return The catalog available for the current provider. * @author Dmitriy Moroz */ suspend operator fun invoke( @@ -28,26 +28,23 @@ interface FetchSwarmUiModelsUseCase { } /** - * Implements `FetchSwarmUiModelsUseCase` behavior in the SDAI domain layer. + * Loads models from the selected Swarm UI server session. + * + * @param remoteDataSource Requests model descriptors with server session and transport credentials. * * @author Dmitriy Moroz */ -class FetchSwarmUiModelsUseCaseImpl( - /** - * Exposes the `remoteDataSource` value used by the SDAI domain layer. - * - * @author Dmitriy Moroz - */ +internal class FetchSwarmUiModelsUseCaseImpl( private val remoteDataSource: SwarmUiModelsRemoteDataSource, ) : FetchSwarmUiModelsUseCase { /** - * Executes the `invoke` step in the SDAI domain layer. + * Returns models reported by the selected Swarm UI session. * - * @param baseUrl base url value consumed by the API. - * @param sessionId session id value consumed by the API. - * @param credentials credentials value consumed by the API. - * @return Result produced by `invoke`. + * @param baseUrl Full API base URL of the selected Swarm UI server. + * @param sessionId Active Swarm UI session identifier. + * @param credentials Optional transport authorization for the server. + * @return The catalog available for the current provider. * @author Dmitriy Moroz */ override suspend fun invoke( diff --git a/feature/backup/build.gradle.kts b/feature/backup/build.gradle.kts new file mode 100644 index 000000000..13a47d089 --- /dev/null +++ b/feature/backup/build.gradle.kts @@ -0,0 +1,24 @@ +plugins { + alias(libs.plugins.generic.kmp.library) + alias(libs.plugins.jetbrains.kotlin.serialization) +} +android { namespace = "com.shifthackz.aisdv1.feature.backup" } +kotlin { + sourceSets { + commonMain.dependencies { + implementation(project(":domain")) + implementation(project(":storage")) + implementation(project(":core:common")) + implementation(libs.kotlinx.coroutines.core) + implementation(libs.kotlinx.serialization.json) + implementation(libs.koin.core) + implementation(libs.okio) + } + androidMain.dependencies { implementation(libs.koin.android) } + androidUnitTest.dependencies { + implementation(libs.test.junit) + implementation(libs.test.mockk) + implementation(libs.test.coroutines) + } + } +} diff --git a/feature/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/feature/backup/di/BackupPlatformModule.android.kt b/feature/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/feature/backup/di/BackupPlatformModule.android.kt new file mode 100644 index 000000000..785de1652 --- /dev/null +++ b/feature/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/feature/backup/di/BackupPlatformModule.android.kt @@ -0,0 +1,14 @@ +package com.shifthackz.aisdv1.feature.backup.di + +import com.shifthackz.aisdv1.feature.backup.io.BackupFileStore +import com.shifthackz.aisdv1.feature.backup.io.AndroidBackupFileStore +import org.koin.core.module.Module +import org.koin.dsl.module +import org.koin.android.ext.koin.androidContext + +/** + * Binds native document transport while retaining the shared backup API. + * @author Dmitriy Moroz + */ +internal actual val backupPlatformModule: Module = + module { single { AndroidBackupFileStore(androidContext()) } } diff --git a/feature/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.android.kt b/feature/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.android.kt new file mode 100644 index 000000000..1ff5dc3df --- /dev/null +++ b/feature/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.android.kt @@ -0,0 +1,53 @@ +package com.shifthackz.aisdv1.feature.backup.io + +import android.content.Context +import android.net.Uri +import android.os.StatFs +import android.provider.OpenableColumns +import java.util.UUID +import java.io.File +import okio.Path +import okio.Path.Companion.toPath +import okio.buffer +import okio.source +import okio.sink + +/** + * Stages archives in app-private durable files and streams Storage Access Framework documents. + * @param context Application context used only for private files and document resolver access. + * @author Dmitriy Moroz + */ +internal class AndroidBackupFileStore(private val context: Context) : BackupFileStore { + override val root: Path get() = context.filesDir.resolve("backup").absolutePath.toPath() + override fun documentReference(path: Path): String = + Uri.fromFile(File(path.toString())).toString() + + override fun documentPath(reference: String): Path { + val uri = Uri.parse(reference) + require(uri.scheme == "file") { "Not a private backup document" } + return checkNotNull(uri.path).toPath() + } + + override fun documentName(document: String): String { + val uri = Uri.parse(document) + return context.contentResolver.query( + uri, + arrayOf(OpenableColumns.DISPLAY_NAME), + null, + null, + null + )?.use { cursor -> + if (cursor.moveToFirst()) cursor.getString(0) else null + } ?: "SDAI.sdaibackup" + } + + override fun newId(): String = UUID.randomUUID().toString() + override fun openDocument(document: String) = + checkNotNull(context.contentResolver.openInputStream(Uri.parse(document))).source().buffer() + + override fun writeDocument(document: String) = + checkNotNull(context.contentResolver.openOutputStream(Uri.parse(document), "wt")).sink() + .buffer() + + override fun availableBytes(): Long = StatFs(context.filesDir.absolutePath).availableBytes +} diff --git a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupStagingCleanerTest.kt b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupStagingCleanerTest.kt new file mode 100644 index 000000000..77dd9e9b8 --- /dev/null +++ b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupStagingCleanerTest.kt @@ -0,0 +1,216 @@ +package com.shifthackz.aisdv1.feature.backup.archive + +import com.shifthackz.aisdv1.feature.backup.io.BackupFileStore +import com.shifthackz.aisdv1.domain.gateway.backup.BackupExportStateStore +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportIntent +import com.shifthackz.aisdv1.storage.db.persistent.dao.RestoreSessionDao +import com.shifthackz.aisdv1.storage.db.persistent.entity.RestoreSessionEntity +import com.shifthackz.aisdv1.storage.gateway.BackupStorage +import io.mockk.coEvery +import io.mockk.coVerify +import io.mockk.every +import io.mockk.mockk +import kotlinx.coroutines.CompletableDeferred +import kotlinx.coroutines.ExperimentalCoroutinesApi +import kotlinx.coroutines.async +import kotlinx.coroutines.test.runCurrent +import kotlinx.coroutines.test.runTest +import okio.FileSystem +import okio.Path +import okio.Path.Companion.toPath +import org.junit.Assert.assertEquals +import org.junit.Assert.assertFalse +import org.junit.Assert.assertTrue +import org.junit.Before +import org.junit.Rule +import org.junit.Test +import org.junit.rules.TemporaryFolder +import java.nio.file.Files + +@OptIn(ExperimentalCoroutinesApi::class) +class DefaultBackupStagingCleanerTest { + @get:Rule + val temporary = TemporaryFolder() + + private val files = mockk() + private val database = mockk() + private val exports = mockk(relaxed = true) + private val ledger = mockk() + private lateinit var root: Path + private lateinit var cleaner: BackupStagingCleaner + + @Before + fun setup() { + root = temporary.newFolder("backup").absolutePath.toPath() + every { files.root } returns root + every { database.restoreSessionDao() } returns ledger + coEvery { ledger.pending() } returns emptyList() + every { exports.read() } returns null + cleaner = DefaultBackupStagingCleaner(files, database, exports) + } + + private fun staged(handle: String): Path { + val directory = root / handle + FileSystem.SYSTEM.createDirectories(directory) + (directory / "archive.sdaibackup").toFile().writeText("private archive") + return directory + } + + @Test + fun `given previous process staging, startup cleanup runs, expected only unreferenced generated directories removed`() = + runTest { + // Given + val orphan = staged(ORPHAN) + val retained = staged(RETAINED) + val unknown = staged("unrelated-entry") + val external = temporary.newFile("source.sdaibackup").apply { writeText("user source") } + coEvery { ledger.pending() } returns listOf( + RestoreSessionEntity( + "pending", + RETAINED, + "selection" + ) + ) + + // When + cleaner.prepare() + + // Then + assertFalse(FileSystem.SYSTEM.exists(orphan)) + assertTrue(FileSystem.SYSTEM.exists(retained / "archive.sdaibackup")) + assertTrue(FileSystem.SYSTEM.exists(unknown / "archive.sdaibackup")) + assertEquals("user source", external.readText()) + } + + @Test + fun `given staging initialized, later active operation creates files, expected repeated recovery calls never rescan them`() = + runTest { + // Given + cleaner.prepare() + val active = staged(ORPHAN) + + // When + cleaner.prepare() + + // Then + assertTrue(FileSystem.SYSTEM.exists(active / "archive.sdaibackup")) + coVerify(exactly = 1) { ledger.pending() } + } + + @Test + fun `given startup cleanup in progress, concurrent create awaits admission, expected new files created only after cleanup`() = + runTest { + // Given + val old = staged(ORPHAN) + val release = CompletableDeferred() + coEvery { ledger.pending() } coAnswers { + release.await() + emptyList() + } + val startup = async { cleaner.prepare() } + runCurrent() + var hasCreated = false + + // When + val create = async { + cleaner.prepare() + staged(RETAINED) + hasCreated = true + } + runCurrent() + + // Then + assertFalse(hasCreated) + release.complete(Unit) + startup.await() + create.await() + assertFalse(FileSystem.SYSTEM.exists(old)) + assertTrue(FileSystem.SYSTEM.exists(root / RETAINED / "archive.sdaibackup")) + coVerify(exactly = 1) { ledger.pending() } + } + + @Test + fun `given orphan directory contains external symlink, startup cleanup runs, expected linked user source remains untouched`() = + runTest { + // Given + val orphan = staged(ORPHAN) + val external = temporary.newFolder("user-model").apply { + resolve("model.bin").writeText("original model") + } + Files.createSymbolicLink((orphan / "linked-model").toFile().toPath(), external.toPath()) + + // When + cleaner.prepare() + + // Then + assertFalse(FileSystem.SYSTEM.exists(orphan)) + assertEquals("original model", external.resolve("model.bin").readText()) + } + + @Test + fun `given staging root is a symbolic link, startup cleanup runs, expected rejection without external deletion`() = + runTest { + // Given + val external = temporary.newFolder("outside") + val outsideArchive = + external.resolve(ORPHAN).apply { mkdir(); resolve("archive").writeText("keep") } + val link = temporary.root.resolve("linked-backup") + Files.createSymbolicLink(link.toPath(), external.toPath()) + every { files.root } returns link.absolutePath.toPath() + + // When + val failure = try { + cleaner.prepare() + null + } catch (error: IllegalStateException) { + error + } + + // Then + assertTrue(failure != null) + assertEquals("keep", outsideArchive.resolve("archive").readText()) + } + + @Test + fun `given restore ledger is unreadable, startup cleanup fails then retries, expected files retained until ownership can be read`() = + runTest { + // Given + val orphan = staged(ORPHAN) + coEvery { ledger.pending() } throws IllegalStateException("ledger unavailable") + + // When + val failure = try { + cleaner.prepare() + null + } catch (error: IllegalStateException) { + error + } + + // Then + assertTrue(failure != null) + assertTrue(FileSystem.SYSTEM.exists(orphan)) + coEvery { ledger.pending() } returns emptyList() + cleaner.prepare() + assertFalse(FileSystem.SYSTEM.exists(orphan)) + coVerify(exactly = 2) { ledger.pending() } + } + + @Test + fun `given native destination picker owns export, startup cleanup runs, expected pending export source retained`() = + runTest { + // Given + val retained = staged(RETAINED) + val orphan = staged(ORPHAN) + every { exports.read() } returns BackupExportIntent(RETAINED, "backup.sdaibackup") + // When + cleaner.prepare() + // Then + assertTrue(FileSystem.SYSTEM.exists(retained / "archive.sdaibackup")) + assertFalse(FileSystem.SYSTEM.exists(orphan)) + } + + private companion object { + const val ORPHAN = "11111111-1111-1111-1111-111111111111" + const val RETAINED = "22222222-2222-2222-2222-222222222222" + } +} diff --git a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BackupPreferencesCodecTest.kt b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BackupPreferencesCodecTest.kt new file mode 100644 index 000000000..c43061f44 --- /dev/null +++ b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BackupPreferencesCodecTest.kt @@ -0,0 +1,34 @@ +package com.shifthackz.aisdv1.feature.backup.codec + +import com.shifthackz.aisdv1.domain.entity.backup.BackupValue +import kotlinx.serialization.json.Json +import org.junit.Assert.assertEquals +import org.junit.Test + +class BackupPreferencesCodecTest { + @Test + fun `given future preference shapes, structured and unsupported scalar fields decode, expected rejected identifiers retained for skipped counts`() { + // Given + val codec = DefaultBackupPreferencesCodec(Json) + val text = + """{"known":"value","object":{},"array":[],"fraction":1.5,"large":9223372036854775807,"null":null}""" + // When + val decoded = codec.decode(text) + // Then + assertEquals(6, decoded.size) + assertEquals(BackupValue.Text("value"), decoded["known"]) + assertEquals(5, decoded.values.count { it == BackupValue.Unsupported }) + } + + @Test + fun `given future provider group, provider has unknown structured contract, expected provider retained for skipped accounting`() { + // Given + val codec = DefaultBackupPreferencesCodec(Json) + // When + val decoded = codec.decodeProviders("""{"future":[],"known":{"setting":true}}""") + // Then + assertEquals(2, decoded.size) + assertEquals(BackupValue.Unsupported, decoded.getValue("future").getValue("")) + assertEquals(BackupValue.Flag(true), decoded.getValue("known").getValue("setting")) + } +} diff --git a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BinaryBackupArchiveCodecTest.kt b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BinaryBackupArchiveCodecTest.kt new file mode 100644 index 000000000..bd84d2df7 --- /dev/null +++ b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BinaryBackupArchiveCodecTest.kt @@ -0,0 +1,158 @@ +package com.shifthackz.aisdv1.feature.backup.codec + +import kotlinx.serialization.json.Json +import kotlinx.coroutines.test.runTest +import kotlinx.coroutines.runBlocking +import okio.Path +import okio.Buffer +import okio.FileSystem +import okio.Path.Companion.toPath +import okio.buffer +import org.junit.Assert.assertEquals +import org.junit.Assert.assertThrows +import org.junit.Rule +import org.junit.Test +import org.junit.rules.TemporaryFolder + +class BinaryBackupArchiveCodecTest { + @get:Rule + val temporary = TemporaryFolder() + private val codec = + BinaryBackupArchiveCodec(Json { ignoreUnknownKeys = true; encodeDefaults = true }) + + private suspend fun fixture( + id: String = "settings", + body: String = "portable fields" + ): Pair { + val payload = temporary.newFile().absolutePath.toPath() + FileSystem.SYSTEM.sink(payload).buffer().use { it.writeUtf8(body) } + val section = codec.describe(payload, id, 1) + val manifest = BackupManifest("archive", 100, "1.2.0", "ANDROID", listOf(section)) + val archive = temporary.newFile().absolutePath.toPath() + codec.write(archive, manifest, listOf(payload)) + return archive to manifest + } + + @Test + fun `given binary backup, archive round trips, expected stable manifest and section bytes`() = + runTest { + // Given + val (archive, expected) = fixture() + // When + val actual = codec.inspect(archive) + val body = codec.openSection(archive, actual, "settings").use { it.readUtf8() } + // Then + assertEquals(expected, actual) + assertEquals("portable fields", body) + } + + @Test + fun `given binary backup, payload byte is changed, expected checksum rejection`() = runTest { + // Given + val (archive, _) = fixture() + val bytes = archive.toFile().readBytes() + .also { it[it.lastIndex] = (it.last().toInt() xor 1).toByte() } + archive.toFile().writeBytes(bytes) + // When + val failure = + assertThrows(IllegalArgumentException::class.java) { runBlocking { codec.inspect(archive) } } + // Then + assertEquals("Backup checksum mismatch", failure.message) + } + + @Test + fun `given binary backup, file is truncated, expected rejection before restoration`() = + runTest { + // Given + val (archive, _) = fixture() + archive.toFile().writeBytes(archive.toFile().readBytes().dropLast(1).toByteArray()) + // When + val failure = assertThrows(IllegalArgumentException::class.java) { + runBlocking { + codec.inspect(archive) + } + } + // Then + assertEquals("Invalid section length", failure.message) + } + + @Test + fun `given future backup section, framing is compatible, expected integrity validation without field knowledge`() = + runTest { + // Given + val (archive, expected) = fixture("future_feature") + // When + val actual = codec.inspect(archive) + // Then + assertEquals(expected.sections, actual.sections) + } + + @Test + fun `given binary backup, duplicate section IDs exist, expected rejection`() = runTest { + // Given + val payload = temporary.newFile().absolutePath.toPath() + payload.toFile().writeText("data") + val section = codec.describe(payload, "gallery", 1) + val manifest = BackupManifest("archive", 100, "1", "IOS", listOf(section, section)) + val archive = temporary.newFile().absolutePath.toPath() + codec.write(archive, manifest, listOf(payload, payload)) + // When + val failure = + assertThrows(IllegalArgumentException::class.java) { runBlocking { codec.inspect(archive) } } + // Then + assertEquals("Duplicate backup sections", failure.message) + } + + @Test + fun `given binary backup, unsupported major framing is present, expected rejection`() = + runTest { + // Given + val (archive, _) = fixture() + archive.toFile().writeBytes(archive.toFile().readBytes().also { it[8] = 2 }) + // When + val failure = assertThrows(IllegalArgumentException::class.java) { + runBlocking { + codec.inspect(archive) + } + } + // Then + assertEquals("Unsupported backup container version", failure.message) + } + + @Test + fun `given binary backup, additive minor framing is present, expected compatible read`() = + runTest { + // Given + val (archive, manifest) = fixture() + archive.toFile().writeBytes(archive.toFile().readBytes().also { it[10] = 2 }) + // When + val actual = codec.inspect(archive) + // Then + assertEquals(manifest, actual) + } + + @Test + fun `given binary backup, bytes follow declared sections, expected rejection`() = runTest { + // Given + val (archive, _) = fixture() + archive.toFile().appendBytes(byteArrayOf(1)) + // When + val failure = + assertThrows(IllegalArgumentException::class.java) { runBlocking { codec.inspect(archive) } } + // Then + assertEquals("Unexpected trailing backup data", failure.message) + } + + @Test + fun `given binary section, decoder reaches its boundary, expected adjacent bytes remain inaccessible`() = + runTest { + // Given + val source = Buffer().writeUtf8("firstSECOND") + val section = BoundedBackupSource(source, 5).buffer() + // When + val text = section.readUtf8() + // Then + assertEquals("first", text) + assertEquals("SECOND", source.readUtf8()) + } +} diff --git a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/codec/GalleryBackupCodecTest.kt b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/codec/GalleryBackupCodecTest.kt new file mode 100644 index 000000000..6829956f3 --- /dev/null +++ b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/codec/GalleryBackupCodecTest.kt @@ -0,0 +1,180 @@ +package com.shifthackz.aisdv1.feature.backup.codec + +import com.shifthackz.aisdv1.domain.gateway.backup.BackupImageValidator +import com.shifthackz.aisdv1.domain.entity.backup.BackupImageBudget +import com.shifthackz.aisdv1.storage.db.persistent.entity.GenerationResultEntity +import io.mockk.every +import io.mockk.mockk +import io.mockk.verify +import kotlinx.serialization.json.Json +import okio.Buffer +import org.junit.Assert.assertEquals +import org.junit.Assert.assertNull +import org.junit.Assert.assertThrows +import org.junit.Assert.assertTrue +import org.junit.Test + +class GalleryBackupCodecTest { + private val validator = + mockk { every { this@mockk.invoke(any()) } returns Unit } + private val codec = + DefaultGalleryBackupCodec( + BinaryBackupArchiveCodec(Json { encodeDefaults = true }), + Json { encodeDefaults = true; ignoreUnknownKeys = true }, + validator, + BackupImageBudget(24 * 1024 * 1024, 16_777_216L, 128L * 1024 * 1024, 256) + ) + private val row = GenerationResultEntity( + 17, + "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+aGXYAAAAASUVORK5CYII=", + "", + 100, + "txt2img", + "prompt", + "negative", + 1, + 1, + 20, + 7.5f, + false, + "Euler", + "42", + "9", + 0.25f, + 0.5f, + true, + true, + "model", + "old revision" + ) + + @Test + fun `given saved gallery row, binary record round trips, expected fresh identity and preserved history flags`() { + // Given + val source = Buffer() + codec.write(source, row) + // When + val imported = codec.read(source, "new revision")!! + // Then + assertEquals(0L, imported.id) + assertEquals("new revision", imported.imageRevision) + assertEquals(row.copy(id = 0, imageRevision = "new revision"), imported) + verify(exactly = 2) { validator(any()) } + } + + @Test + fun `given future generation type, next known gallery record follows, expected unknown row skipped without desynchronizing stream`() { + // Given + val source = Buffer() + codec.write(source, row.copy(generationType = "future")) + codec.write(source, row) + // When + val unknown = codec.read(source, "ignored") + val known = codec.read(source, "new") + // Then + assertNull(unknown) + assertEquals(row.prompt, known?.prompt) + assertEquals(true, source.exhausted()) + } + + @Test + fun `given archived image bytes, native decoder rejects input, expected gallery validation failure`() { + // Given + val source = Buffer() + codec.write(source, row) + every { validator(any()) } throws IllegalArgumentException("Image decoding failed") + // When + val failure = + assertThrows(IllegalArgumentException::class.java) { codec.read(source, "new") } + // Then + assertEquals("Image decoding failed", failure.message) + } + + @Test + fun `given OpenAI compatible gallery row, zero sampling steps round trip, expected saved metadata restored`() { + // Given + val original = row.copy(samplingSteps = 0) + val source = Buffer() + codec.write(source, original) + // When + val restored = codec.read(source, "imported") + // Then + assertEquals(original.copy(id = 0, imageRevision = "imported"), restored) + } + + @Test + fun `given oversized archived image record count, reader reaches image frame, expected rejection before allocating or reading payload`() { + // Given + val source = Buffer() + BinaryBackupArchiveCodec(Json).writeJson(source, "{}") + source.writeIntLe(24 * 1024 * 1024 + 1) + // When + val failure = + assertThrows(IllegalArgumentException::class.java) { codec.read(source, "revision") } + // Then + assertEquals("Backup image exceeds encoded record budget", failure.message) + assertTrue(source.exhausted()) + verify(exactly = 0) { validator(any()) } + } + + @Test + fun `given image bytes exceed a configured export budget, writer encodes row, expected rejection before native validation or image allocation`() { + // Given + val constrained = DefaultGalleryBackupCodec( + BinaryBackupArchiveCodec(Json), Json, validator, + BackupImageBudget(12, 16_777_216, 128L * 1024 * 1024, 256) + ) + // When + val failure = + assertThrows(IllegalArgumentException::class.java) { constrained.write(Buffer(), row) } + // Then + assertEquals("Backup image exceeds encoded record budget", failure.message) + verify(exactly = 0) { validator(any()) } + } + + @Test + fun `given individually admitted output and input images, combined gallery record exceeds budget, expected matching export and import rejection`() { + // Given + val admitted = Buffer().also { codec.write(it, row) } + val metadata = BinaryBackupArchiveCodec(Json).readJson(admitted) + val byteCount = admitted.readIntLe() + val constrained = DefaultGalleryBackupCodec( + BinaryBackupArchiveCodec(Json), Json, validator, + BackupImageBudget(byteCount, 16_777_216, 128L * 1024 * 1024, 256) + ) + val oversizedPair = Buffer() + BinaryBackupArchiveCodec(Json).writeJson(oversizedPair, metadata) + oversizedPair.writeIntLe(byteCount) + oversizedPair.write(admitted.readByteArray(byteCount.toLong())) + oversizedPair.writeIntLe(byteCount) + // When + val exportFailure = assertThrows(IllegalArgumentException::class.java) { + constrained.write( + Buffer(), + row.copy(originalImageBase64 = row.imageBase64) + ) + } + val importFailure = assertThrows(IllegalArgumentException::class.java) { + constrained.read( + oversizedPair, + "revision" + ) + } + // Then + assertEquals("Backup image exceeds encoded record budget", exportFailure.message) + assertEquals(exportFailure.message, importFailure.message) + } + + @Test + fun `given saved alternate Base64 alphabet, backup writer normalizes image bytes, expected equivalent standard image restored`() { + // Given + val alternate = row.imageBase64.replace('/', '_').replace('+', '-') + val source = Buffer() + // When + codec.write(source, row.copy(imageBase64 = alternate)) + val restored = codec.read(source, "imported") + // Then + assertEquals(row.copy(id = 0, imageRevision = "imported"), restored) + } + +} diff --git a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/export/DefaultBackupExportCoordinatorTest.kt b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/export/DefaultBackupExportCoordinatorTest.kt new file mode 100644 index 000000000..81a3fd418 --- /dev/null +++ b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/export/DefaultBackupExportCoordinatorTest.kt @@ -0,0 +1,229 @@ +package com.shifthackz.aisdv1.feature.backup.export + +import com.shifthackz.aisdv1.core.common.schedulers.DispatchersProvider +import com.shifthackz.aisdv1.domain.entity.backup.BackupExport +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportCompletion +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportIntent +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportStatus +import com.shifthackz.aisdv1.domain.gateway.backup.BackupExportStateStore +import com.shifthackz.aisdv1.domain.usecase.backup.ExportBackupUseCase +import com.shifthackz.aisdv1.feature.backup.archive.BackupArchiveStore +import io.mockk.coEvery +import io.mockk.coVerify +import io.mockk.every +import io.mockk.mockk +import io.mockk.verify +import kotlinx.coroutines.CompletableDeferred +import kotlinx.coroutines.ExperimentalCoroutinesApi +import kotlinx.coroutines.test.StandardTestDispatcher +import kotlinx.coroutines.test.TestScope +import kotlinx.coroutines.test.advanceUntilIdle +import kotlinx.coroutines.test.runCurrent +import kotlinx.coroutines.test.runTest +import org.junit.Assert.assertEquals +import org.junit.Assert.assertNull +import org.junit.Test + +@OptIn(ExperimentalCoroutinesApi::class) +class DefaultBackupExportCoordinatorTest { + private val archives = mockk(relaxed = true) + private val records = mockk(relaxed = true) + private val export = mockk() + private val backup = BackupExport( + "file:///private/staged", + "backup.sdaibackup", + "11111111-1111-1111-1111-111111111111" + ) + private var stored: BackupExportIntent? = null + + private fun TestScope.coordinator(): DefaultBackupExportCoordinator { + every { records.read() } answers { stored } + every { records.write(any()) } answers { stored = firstArg() } + every { records.clear() } answers { stored = null } + every { archives.preparedExport(backup.handle, backup.filename) } returns backup + val dispatcher = StandardTestDispatcher(testScheduler) + return DefaultBackupExportCoordinator( + archives, + records, + export, + mockk { every { io } returns dispatcher }) + } + + @Test + fun `given recreated host, native callback arrives before async recovery, expected complete destination copy bound to staged source`() = + runTest { + // Given + stored = BackupExportIntent(backup.handle, backup.filename) + coEvery { export(backup.document, "destination") } returns Unit + val owner = coordinator() + // When + owner.submit(BackupExportCompletion.DestinationSelected("destination", backup.handle)) + advanceUntilIdle() + // Then + assertEquals(BackupExportStatus.COMPLETE, stored?.status) + assertEquals(backup, owner.observe().value.backup) + coVerify(exactly = 1) { export(backup.document, "destination") } + verify(exactly = 0) { archives.discard(any()) } + owner.close() + } + + @Test + fun `given interrupted destination copy, graph restarts with durable destination, expected idempotent copy resumed and completion recorded`() = + runTest { + // Given + stored = BackupExportIntent( + backup.handle, + backup.filename, + BackupExportStatus.COPYING, + "destination" + ) + coEvery { export(backup.document, "destination") } returns Unit + // When + val owner = coordinator() + advanceUntilIdle() + // Then + assertEquals(BackupExportStatus.COMPLETE, stored?.status) + coVerify(exactly = 1) { export(backup.document, "destination") } + owner.close() + } + + @Test + fun `given pending source, destination copy fails, expected source retained and explicit failure without success`() = + runTest { + // Given + stored = BackupExportIntent(backup.handle, backup.filename) + coEvery { export(any(), any()) } throws IllegalStateException("write failed") + val owner = coordinator() + // When + owner.submit(BackupExportCompletion.DestinationSelected("destination", backup.handle)) + advanceUntilIdle() + // Then + assertEquals(BackupExportStatus.FAILED, stored?.status) + assertEquals(BackupExportStatus.FAILED, owner.observe().value.status) + assertEquals(backup, owner.observe().value.backup) + verify(exactly = 0) { archives.discard(any()); records.clear() } + owner.close() + } + + @Test + fun `given new export owns staging, old native cancellation arrives, expected newer source and association retained`() = + runTest { + // Given + stored = BackupExportIntent(backup.handle, backup.filename) + val owner = coordinator() + // When + owner.submit(BackupExportCompletion.Canceled("old-export")) + advanceUntilIdle() + // Then + assertEquals(backup.handle, stored?.handle) + assertEquals(BackupExportStatus.READY, owner.observe().value.status) + verify(exactly = 0) { records.clear(); archives.discard(any()) } + owner.close() + } + + @Test + fun `given native cancellation, result is queued before another prepare, expected canceled source acknowledged before new source created`() = + runTest { + // Given + stored = BackupExportIntent(backup.handle, backup.filename) + val owner = coordinator() + advanceUntilIdle() + // When + owner.submit(BackupExportCompletion.Canceled(backup.handle)) + // Then + assertEquals(BackupExportStatus.PROCESSING, owner.observe().value.status) + advanceUntilIdle() + assertNull(stored) + assertEquals(BackupExportStatus.NONE, owner.observe().value.status) + verify(exactly = 1) { archives.discard(backup.handle) } + owner.close() + } + + @Test + fun `given active export, screen is disposed while copying, expected graph owns completion and only explicit cancel interrupts copy`() = + runTest { + // Given + stored = BackupExportIntent(backup.handle, backup.filename) + val finish = CompletableDeferred() + coEvery { export(any(), any()) } coAnswers { finish.await() } + val owner = coordinator() + owner.submit(BackupExportCompletion.DestinationSelected("destination", backup.handle)) + runCurrent() + // When + owner.cancel() + advanceUntilIdle() + // Then + assertEquals(BackupExportStatus.CANCELED, stored?.status) + assertEquals(backup, owner.observe().value.backup) + verify(exactly = 0) { archives.discard(any()) } + owner.close() + } + + @Test + fun `given missing export association, native destination result arrives, expected explicit failure without empty saved success`() = + runTest { + // Given + val owner = coordinator() + // When + owner.submit( + BackupExportCompletion.DestinationSelected( + "destination", + "missing-export" + ) + ) + advanceUntilIdle() + // Then + assertEquals(BackupExportStatus.FAILED, owner.observe().value.status) + coVerify(exactly = 0) { export(any(), any()) } + owner.close() + } + + @Test + fun `given complete export record recovered after failed checked write, fresh picker chooses new destination, expected retained bytes copied again`() = + runTest { + // Given + stored = BackupExportIntent( + backup.handle, + backup.filename, + BackupExportStatus.COMPLETE, + "old-destination" + ) + coEvery { export(any(), any()) } returns Unit + val owner = coordinator() + // When + owner.submit( + BackupExportCompletion.DestinationSelected( + "new-destination", + backup.handle + ) + ) + advanceUntilIdle() + // Then + coVerify(exactly = 1) { export(backup.document, "new-destination") } + assertEquals(BackupExportStatus.COMPLETE, stored?.status) + assertEquals("new-destination", stored?.destination) + owner.close() + } + + @Test + fun `given previously completed export, fresh picker truncates same URI, expected exact source bytes copied again`() = + runTest { + // Given + stored = BackupExportIntent( + backup.handle, + backup.filename, + BackupExportStatus.COMPLETE, + "destination" + ) + coEvery { export(any(), any()) } returns Unit + val owner = coordinator() + // When + owner.submit(BackupExportCompletion.DestinationSelected("destination", backup.handle)) + advanceUntilIdle() + // Then + coVerify(exactly = 1) { export(backup.document, "destination") } + assertEquals(BackupExportStatus.COMPLETE, stored?.status) + owner.close() + } + +} diff --git a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupProviderPlannerTest.kt b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupProviderPlannerTest.kt new file mode 100644 index 000000000..c17f18caa --- /dev/null +++ b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupProviderPlannerTest.kt @@ -0,0 +1,181 @@ +package com.shifthackz.aisdv1.feature.backup.restore + +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory +import com.shifthackz.aisdv1.domain.entity.backup.BackupPreferences +import com.shifthackz.aisdv1.domain.entity.backup.BackupSelection +import com.shifthackz.aisdv1.domain.entity.backup.BackupValue +import com.shifthackz.aisdv1.domain.feature.auth.AuthorizationCredentials +import com.shifthackz.aisdv1.feature.backup.codec.DefaultBackupPreferencesCodec +import kotlinx.serialization.json.Json +import org.junit.Assert.assertEquals +import org.junit.Assert.assertNotEquals +import org.junit.Assert.assertNull +import org.junit.Assert.assertThrows +import org.junit.Test + +class DefaultBackupProviderPlannerTest { + private val planner = DefaultBackupProviderPlanner(DefaultBackupPreferencesCodec(Json)) + private val selection = BackupSelection(setOf(BackupCategory.PROVIDERS), setOf("custom")) + private fun preferences(vararg values: Pair>) = + BackupPreferences(mapOf(*values), emptyMap()) + + private fun text(value: String) = BackupValue.Text(value) + + @Test + fun `given missing provider configuration, backup is selected, expected fill without conflict`() { + // Given + val incoming = preferences("custom" to mapOf("serverUrl" to text("https://server"))) + // When + val plan = planner.plan(preferences(), incoming, selection, AuthorizationCredentials.None) + // Then + assertEquals(incoming.providers, plan.providers) + assertEquals(emptySet(), plan.conflicts) + } + + @Test + fun `given existing saved default, different backup field is selected, expected provider conflict`() { + // Given + val current = preferences("custom" to mapOf("demoMode" to BackupValue.Flag(false))) + val incoming = preferences("custom" to mapOf("demoMode" to BackupValue.Flag(true))) + // When + val plan = planner.plan(current, incoming, selection, AuthorizationCredentials.None) + // Then + assertEquals(setOf("custom"), plan.conflicts) + } + + @Test + fun `given existing provider, backup omits a field, expected omitted field is not replaced`() { + // Given + val current = preferences( + "custom" to mapOf( + "serverUrl" to text("https://server"), + "model" to text("keep") + ) + ) + val incoming = preferences("custom" to mapOf("serverUrl" to text("https://server"))) + // When + val plan = planner.plan(current, incoming, selection, AuthorizationCredentials.None) + // Then + assertEquals(emptySet(), plan.conflicts) + assertEquals(setOf("serverUrl"), plan.providers.getValue("custom").keys) + } + + @Test + fun `given configured unselected provider, backup contains its fields, expected fields remain unselected`() { + // Given + val incoming = preferences("swarm_ui" to mapOf("serverUrl" to text("https://other"))) + // When + val plan = planner.plan(preferences(), incoming, selection, AuthorizationCredentials.None) + // Then + assertEquals(emptyMap>(), plan.providers) + } + + @Test + fun `given shared Basic Auth and unselected SwarmUI, A1111 credentials restore, expected shared credentials skipped`() { + // Given + val current = preferences( + "custom" to mapOf("serverUrl" to text("a")), + "swarm_ui" to mapOf("serverUrl" to text("b")) + ) + val incoming = preferences( + "custom" to mapOf( + "basicLogin" to text("new"), + "basicPassword" to text("new password") + ) + ) + // When + val plan = planner.plan( + current, + incoming, + selection, + AuthorizationCredentials.HttpBasic("old", "old password") + ) + // Then + assertNull(plan.credentials) + assertEquals(2, plan.skippedCount) + assertEquals(setOf("swarm_ui"), plan.retainedCredentialProviders) + assertEquals(emptySet(), plan.conflicts) + } + + @Test + fun `given shared Basic Auth and both providers selected, credentials differ, expected both named conflicts`() { + // Given + val current = preferences( + "custom" to mapOf("serverUrl" to text("a")), + "swarm_ui" to mapOf("serverUrl" to text("b")) + ) + val incoming = preferences( + "custom" to mapOf( + "basicLogin" to text("new"), + "basicPassword" to text("new password") + ) + ) + val all = selection.copy(providers = setOf("custom", "swarm_ui")) + // When + val plan = planner.plan( + current, + incoming, + all, + AuthorizationCredentials.HttpBasic("old", "old password") + ) + // Then + assertEquals(setOf("custom", "swarm_ui"), plan.conflicts) + assertEquals(AuthorizationCredentials.HttpBasic("new", "new password"), plan.credentials) + } + + @Test + fun `given Basic Auth with omitted password, login changes, expected destination password retained`() { + // Given + val incoming = preferences("custom" to mapOf("basicLogin" to text("new"))) + // When + val plan = planner.plan( + preferences(), + incoming, + selection, + AuthorizationCredentials.HttpBasic("old", "keep") + ) + // Then + assertEquals(AuthorizationCredentials.HttpBasic("new", "keep"), plan.credentials) + } + + @Test + fun `given provider conflict consent, destination changes afterward, expected fingerprint changes`() { + // Given + val incoming = preferences("custom" to mapOf("serverUrl" to text("import"))) + val before = planner.plan( + preferences("custom" to mapOf("serverUrl" to text("before"))), + incoming, + selection, + AuthorizationCredentials.None + ) + // When + val after = planner.plan( + preferences("custom" to mapOf("serverUrl" to text("after"))), + incoming, + selection, + AuthorizationCredentials.None + ) + // Then + assertNotEquals(before.fingerprint, after.fingerprint) + } + + @Test + fun `given two contradictory shared credential records, both selected, expected rejection`() { + // Given + val incoming = preferences( + "custom" to mapOf("basicLogin" to text("one")), + "swarm_ui" to mapOf("basicLogin" to text("two")) + ) + // When + val failure = assertThrows(IllegalArgumentException::class.java) { + planner.plan( + preferences(), + incoming, + selection.copy(providers = setOf("custom", "swarm_ui")), + AuthorizationCredentials.None + ) + } + // Then + assertEquals("Conflicting shared Basic Auth records", failure.message) + } +} diff --git a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultGenerationRestoreGateTest.kt b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultGenerationRestoreGateTest.kt new file mode 100644 index 000000000..29f7010cf --- /dev/null +++ b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultGenerationRestoreGateTest.kt @@ -0,0 +1,86 @@ +package com.shifthackz.aisdv1.feature.backup.restore + +import kotlinx.coroutines.CompletableDeferred +import kotlinx.coroutines.ExperimentalCoroutinesApi +import kotlinx.coroutines.async +import kotlinx.coroutines.cancelAndJoin +import kotlinx.coroutines.test.runCurrent +import kotlinx.coroutines.test.runTest +import org.junit.Assert.assertFalse +import org.junit.Assert.assertTrue +import org.junit.Test + +@OptIn(ExperimentalCoroutinesApi::class) +class DefaultGenerationRestoreGateTest { + @Test + fun `given active generation, restore attempts admission, expected rejection without disturbing generation`() = + runTest { + // Given + val gate = DefaultGenerationRestoreGate() + val finish = CompletableDeferred() + val generation = async { gate.generating { finish.await() } } + runCurrent() + // When + val failure = try { + gate.restoring { }; null + } catch (error: IllegalStateException) { + error + } + // Then + assertTrue(failure != null) + assertTrue(generation.isActive) + finish.complete(Unit) + generation.await() + } + + @Test + fun `given concurrent generation requests, both start before restore, expected existing concurrency preserved`() = + runTest { + // Given + val gate = DefaultGenerationRestoreGate() + val finish = CompletableDeferred() + var active = 0 + // When + val first = async { gate.generating { active++; finish.await() } } + val second = async { gate.generating { active++; finish.await() } } + runCurrent() + // Then + assertTrue(active == 2) + finish.complete(Unit) + first.await(); second.await() + } + + @Test + fun `given active restore, generation is submitted, expected dispatch waits until restore completes`() = + runTest { + // Given + val gate = DefaultGenerationRestoreGate() + val finish = CompletableDeferred() + val restoration = async { gate.restoring { finish.await() } } + runCurrent() + var hasDispatched = false + // When + val generation = async { gate.generating { hasDispatched = true } } + runCurrent() + // Then + assertFalse(hasDispatched) + finish.complete(Unit) + restoration.await(); generation.await() + assertTrue(hasDispatched) + } + + @Test + fun `given generation cancellation, its owner exits, expected subsequent restore admitted`() = + runTest { + // Given + val gate = DefaultGenerationRestoreGate() + val waiting = CompletableDeferred() + val generation = async { gate.generating { waiting.await() } } + runCurrent() + // When + generation.cancelAndJoin() + val hasRestored = gate.restoring { true } + // Then + assertTrue(hasRestored) + } +} diff --git a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriterTest.kt b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriterTest.kt new file mode 100644 index 000000000..bcf6de82d --- /dev/null +++ b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriterTest.kt @@ -0,0 +1,96 @@ +package com.shifthackz.aisdv1.feature.backup.restore + +import com.shifthackz.aisdv1.domain.entity.backup.BackupProgress +import com.shifthackz.aisdv1.feature.backup.archive.StagedBackup +import com.shifthackz.aisdv1.feature.backup.codec.BackupArchiveCodec +import com.shifthackz.aisdv1.feature.backup.codec.BackupManifest +import com.shifthackz.aisdv1.feature.backup.codec.BackupSection +import com.shifthackz.aisdv1.feature.backup.codec.GalleryBackupCodec +import com.shifthackz.aisdv1.feature.backup.io.BackupFileStore +import com.shifthackz.aisdv1.storage.db.persistent.dao.RestoreSessionDao +import com.shifthackz.aisdv1.storage.gateway.BackupStorage +import io.mockk.coEvery +import io.mockk.every +import io.mockk.mockk +import kotlinx.coroutines.test.runTest +import kotlinx.serialization.json.Json +import okio.Buffer +import okio.Path.Companion.toPath +import org.junit.Assert.assertEquals +import org.junit.Assert.assertTrue +import org.junit.Test + +class RoomBackupRestoreWriterTest { + private val database = mockk() + private val ledger = mockk(relaxed = true) + private val codec = mockk() + private val gallery = mockk() + private val files = mockk { every { newId() } returns "revision" } + private val archive = StagedBackup( + "handle", + "/private/archive".toPath(), + BackupManifest( + "id", + 1, + "1", + "IOS", + listOf( + BackupSection( + "gallery", + storedBytes = 1, + decodedBytes = 1, + sha256 = "a".repeat(64), + itemCount = 1 + ) + ) + ) + ) + + @Test + fun `given gallery transaction, rows process then commit fails, expected no durable completion progress`() = + runTest { + // Given + every { database.restoreSessionDao() } returns ledger + coEvery { ledger.completed(any()) } returns emptyList() + every { codec.openSection(any(), any(), any()) } answers { Buffer() } + every { gallery.read(any(), any()) } returns null + coEvery { database.writeTransaction(any()) } coAnswers { + firstArg Unit>()() + throw IllegalStateException("commit failed") + } + val writer = RoomBackupRestoreWriter(database, codec, gallery, files, Json) + val progress = mutableListOf() + var hasFailed = false + // When + try { + writer.gallery("session", archive, progress::add) + } catch (_: IllegalStateException) { + hasFailed = true + } + // Then + assertTrue(hasFailed) + assertTrue(progress.isEmpty()) + } + + @Test + fun `given gallery transaction, category commit completes, expected progress published after transaction returns`() = + runTest { + // Given + every { database.restoreSessionDao() } returns ledger + coEvery { ledger.completed(any()) } returns emptyList() + every { codec.openSection(any(), any(), any()) } answers { Buffer() } + every { gallery.read(any(), any()) } returns null + var hasCommitted = false + coEvery { database.writeTransaction(any()) } coAnswers { + firstArg Unit>()() + hasCommitted = true + } + val writer = RoomBackupRestoreWriter(database, codec, gallery, files, Json) + val progress = mutableListOf() + // When + writer.gallery("session", archive) { assertTrue(hasCommitted); progress += it } + // Then + assertEquals(1, progress.size) + assertEquals(0L, progress.single().completed) + } +} diff --git a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/DiscardBackupUseCaseImplTest.kt b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/DiscardBackupUseCaseImplTest.kt new file mode 100644 index 000000000..9a14627b8 --- /dev/null +++ b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/DiscardBackupUseCaseImplTest.kt @@ -0,0 +1,121 @@ +package com.shifthackz.aisdv1.feature.backup.usecase + +import com.shifthackz.aisdv1.core.common.schedulers.DispatchersProvider +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory +import com.shifthackz.aisdv1.domain.entity.backup.BackupSelection +import com.shifthackz.aisdv1.domain.feature.auth.AuthorizationStore +import com.shifthackz.aisdv1.domain.feature.auth.AuthorizationCredentials +import com.shifthackz.aisdv1.domain.gateway.ProviderSelectionGuard +import com.shifthackz.aisdv1.domain.gateway.backup.BackupChangesGateway +import com.shifthackz.aisdv1.domain.gateway.backup.BackupPreferencesGateway +import com.shifthackz.aisdv1.domain.preference.ConfigurationStore +import com.shifthackz.aisdv1.feature.backup.archive.BackupArchiveStore +import com.shifthackz.aisdv1.feature.backup.restore.DefaultBackupRestoreGuard +import com.shifthackz.aisdv1.feature.backup.restore.DefaultBackupSessionCodec +import com.shifthackz.aisdv1.storage.db.persistent.dao.RestoreSessionDao +import com.shifthackz.aisdv1.storage.db.persistent.entity.RestoreSessionEntity +import com.shifthackz.aisdv1.storage.gateway.BackupStorage +import io.mockk.coEvery +import io.mockk.coVerify +import io.mockk.coVerifyOrder +import io.mockk.every +import io.mockk.mockk +import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.test.runTest +import kotlinx.serialization.json.Json +import org.junit.Assert.assertEquals +import org.junit.Assert.assertTrue +import org.junit.Test + +class DiscardBackupUseCaseImplTest { + private val archives = mockk(relaxed = true) + private val database = mockk() + private val ledger = mockk(relaxed = true) + private val preferences = mockk(relaxed = true) + private val configuration = mockk(relaxed = true) + private val authorization = mockk(relaxed = true) + private val changes = mockk(relaxed = true) + private val sessions = DefaultBackupSessionCodec(Json) + private val useCase = DiscardBackupUseCaseImpl( + archives, + database, + preferences, + configuration, + authorization, + ProviderSelectionGuard(), + DefaultBackupRestoreGuard(), + mockk { every { io } returns Dispatchers.Unconfined }, + sessions, + changes + ) + + private fun pending(category: BackupCategory) { + every { database.restoreSessionDao() } returns ledger + coEvery { ledger.pending() } returns listOf( + RestoreSessionEntity( + "session", + "handle", + sessions.encode(BackupSelection(setOf(category))) + ) + ) + } + + @Test + fun `given quarantined settings without ledger marker, user abandons restore, expected recovered settings published before abandonment completes`() = + runTest { + // Given + pending(BackupCategory.SETTINGS) + every { preferences.recoverPendingWrite() } returns setOf(BackupCategory.SETTINGS) + var hasReconciled = false + var hasNotified = false + coEvery { authorization.getAuthorizationCredentials() } coAnswers { + hasReconciled = true; AuthorizationCredentials.None + } + coEvery { changes.notifyChanged(setOf(BackupCategory.SETTINGS)) } coAnswers { + assertTrue( + hasReconciled + ); hasNotified = true + } + coEvery { ledger.finish("session") } coAnswers { assertTrue(hasNotified) } + // When + useCase("handle") + // Then + coVerifyOrder { + preferences.recoverPendingWrite(); authorization.getAuthorizationCredentials(); changes.notifyChanged( + setOf(BackupCategory.SETTINGS) + ); ledger.finish("session"); archives.discard("handle") + } + } + + @Test + fun `given provider association replay without ordinary field changes, user abandons restore, expected provider readers refreshed`() = + runTest { + // Given + pending(BackupCategory.GALLERY) + every { preferences.recoverPendingWrite() } returns setOf(BackupCategory.PROVIDERS) + // When + useCase("handle") + // Then + coVerify { changes.notifyChanged(setOf(BackupCategory.PROVIDERS)) } + } + + @Test + fun `given previously recovered write without marker, notification fails during abandonment, expected recoverable journal and source retained`() = + runTest { + // Given + pending(BackupCategory.SETTINGS) + val failure = IllegalStateException("notify failed") + coEvery { changes.notifyChanged(any()) } throws failure + var caught: Throwable? = null + // When + try { + useCase("handle") + } catch (error: Throwable) { + caught = error + } + // Then + assertEquals(failure.message, caught?.message) + assertTrue(caught is IllegalStateException) + coVerify(exactly = 0) { ledger.finish(any()); archives.discard(any()) } + } +} diff --git a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/LoadPendingBackupUseCaseImplTest.kt b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/LoadPendingBackupUseCaseImplTest.kt new file mode 100644 index 000000000..e54566f4d --- /dev/null +++ b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/LoadPendingBackupUseCaseImplTest.kt @@ -0,0 +1,138 @@ +package com.shifthackz.aisdv1.feature.backup.usecase + +import com.shifthackz.aisdv1.core.common.schedulers.DispatchersProvider +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory +import com.shifthackz.aisdv1.domain.entity.backup.BackupSelection +import com.shifthackz.aisdv1.domain.entity.backup.BackupStartupStage +import com.shifthackz.aisdv1.domain.feature.auth.AuthorizationStore +import com.shifthackz.aisdv1.domain.gateway.ProviderSelectionGuard +import com.shifthackz.aisdv1.domain.gateway.backup.BackupChangesGateway +import com.shifthackz.aisdv1.domain.gateway.backup.BackupPreferencesGateway +import com.shifthackz.aisdv1.domain.preference.ConfigurationStore +import com.shifthackz.aisdv1.feature.backup.archive.BackupArchiveStore +import com.shifthackz.aisdv1.feature.backup.archive.BackupStagingCleaner +import com.shifthackz.aisdv1.feature.backup.restore.DefaultBackupSessionCodec +import com.shifthackz.aisdv1.storage.db.persistent.dao.RestoreSessionDao +import com.shifthackz.aisdv1.storage.db.persistent.entity.RestoreSessionEntity +import com.shifthackz.aisdv1.storage.gateway.BackupStorage +import io.mockk.coEvery +import io.mockk.coVerify +import io.mockk.every +import io.mockk.mockk +import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.test.runTest +import kotlinx.serialization.json.Json +import org.junit.Assert.assertEquals +import org.junit.Assert.assertFalse +import org.junit.Assert.assertNull +import org.junit.Assert.assertTrue +import org.junit.Before +import org.junit.Test + +class LoadPendingBackupUseCaseImplTest { + private val database = mockk() + private val ledger = mockk(relaxed = true) + private val preferences = mockk(relaxed = true) + private val changes = mockk(relaxed = true) + private val archives = mockk(relaxed = true) + private val sessions = DefaultBackupSessionCodec(Json) + private var stage = BackupStartupStage.RESTORE + private var pending = RestoreSessionEntity( + "session", + "handle", + sessions.encode(BackupSelection(setOf(BackupCategory.GALLERY))), + requiresConfiguration = true + ) + private val useCase = LoadPendingBackupUseCaseImpl( + database, + preferences, + archives, + sessions, + mockk(relaxed = true), + mockk(relaxed = true), + ProviderSelectionGuard(), + mockk { every { io } returns Dispatchers.Unconfined }, + mockk(relaxed = true), + changes + ) + + @Before + fun setup() { + every { database.restoreSessionDao() } returns ledger + coEvery { ledger.pending() } answers { if (pending.requiresConfiguration) listOf(pending) else emptyList() } + coEvery { ledger.completed(any()) } returns listOf("gallery") + coEvery { ledger.finish(any()) } answers { pending = pending.copy(isComplete = true) } + coEvery { ledger.acknowledgeConfiguration(any()) } answers { + pending = pending.copy(requiresConfiguration = false) + } + every { preferences.readStartupStage() } answers { stage } + every { preferences.writeStartupStage(any()) } answers { stage = firstArg() } + } + + @Test + fun `given first launch last section committed before crash, session finish not recorded, expected configuration handoff without reimport`() = + runTest { + // Given + assertFalse(pending.isComplete) + // When + val recovery = useCase() + // Then + assertNull(recovery) + assertEquals(BackupStartupStage.CONFIGURATION, stage) + assertTrue(pending.isComplete) + assertFalse(pending.requiresConfiguration) + coVerify(exactly = 0) { archives.staged(any()) } + coVerify(exactly = 1) { archives.discard("handle") } + } + + @Test + fun `given completed first launch import, configuration write fails then startup retries, expected completion intent retained until checked acknowledgment`() = + runTest { + // Given + pending = pending.copy(isComplete = true) + every { preferences.writeStartupStage(any()) } throws IllegalStateException("checked write failed") + var hasFailed = false + // When + try { + useCase() + } catch (_: IllegalStateException) { + hasFailed = true + } + // Then + assertTrue(hasFailed) + assertTrue(pending.requiresConfiguration) + coVerify(exactly = 0) { ledger.acknowledgeConfiguration(any()); archives.discard(any()) } + every { preferences.writeStartupStage(any()) } answers { stage = firstArg() } + assertNull(useCase()) + assertEquals(BackupStartupStage.CONFIGURATION, stage) + assertFalse(pending.requiresConfiguration) + coVerify(exactly = 0) { archives.staged(any()) } + } + + @Test + fun `given replayed settings write without ledger marker, pending recovery succeeds, expected retained readers refreshed after association recovery`() = + runTest { + // Given + every { preferences.recoverPendingWrite() } returns setOf(BackupCategory.SETTINGS) + // When + useCase() + // Then + coVerify { changes.notifyChanged(setOf(BackupCategory.SETTINGS)) } + } + + @Test + fun `given setup already complete and restore handoff remains pending, startup recovers committed sections, expected completion acknowledged without stage downgrade`() = + runTest { + // Given + stage = BackupStartupStage.COMPLETE + pending = pending.copy(isComplete = true) + // When + val recovery = useCase() + // Then + assertNull(recovery) + assertEquals(BackupStartupStage.COMPLETE, stage) + assertFalse(pending.requiresConfiguration) + coVerify(exactly = 0) { preferences.writeStartupStage(any()) } + } + +} diff --git a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/RestoreBackupUseCaseImplTest.kt b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/RestoreBackupUseCaseImplTest.kt new file mode 100644 index 000000000..c0e072925 --- /dev/null +++ b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/RestoreBackupUseCaseImplTest.kt @@ -0,0 +1,383 @@ +package com.shifthackz.aisdv1.feature.backup.usecase + +import com.shifthackz.aisdv1.core.common.schedulers.DispatchersProvider +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory +import com.shifthackz.aisdv1.domain.entity.backup.BackupEntry +import com.shifthackz.aisdv1.domain.entity.backup.BackupInspection +import com.shifthackz.aisdv1.domain.entity.backup.BackupPreferences +import com.shifthackz.aisdv1.domain.entity.backup.BackupRestoreRequest +import com.shifthackz.aisdv1.domain.entity.backup.BackupRestoreResult +import com.shifthackz.aisdv1.domain.entity.backup.BackupSelection +import com.shifthackz.aisdv1.domain.entity.backup.BackupValue +import com.shifthackz.aisdv1.domain.feature.auth.AuthorizationStore +import com.shifthackz.aisdv1.domain.feature.auth.AuthorizationCredentials +import com.shifthackz.aisdv1.domain.feature.work.BackgroundWorkObserver +import com.shifthackz.aisdv1.domain.gateway.ProviderSelectionGuard +import com.shifthackz.aisdv1.domain.gateway.backup.BackupPreferencesGateway +import com.shifthackz.aisdv1.domain.preference.ConfigurationStore +import com.shifthackz.aisdv1.domain.gateway.GenerationRestoreGate +import com.shifthackz.aisdv1.domain.gateway.backup.BackupChangesGateway +import kotlinx.coroutines.sync.Mutex +import kotlinx.coroutines.sync.withLock +import com.shifthackz.aisdv1.feature.backup.archive.BackupArchiveStore +import com.shifthackz.aisdv1.feature.backup.archive.StagedBackup +import com.shifthackz.aisdv1.feature.backup.codec.BackupManifest +import com.shifthackz.aisdv1.feature.backup.codec.BackupSection +import com.shifthackz.aisdv1.feature.backup.codec.DefaultBackupPreferencesCodec +import com.shifthackz.aisdv1.feature.backup.restore.DefaultBackupProviderPlanner +import com.shifthackz.aisdv1.feature.backup.restore.DefaultBackupRestoreGuard +import com.shifthackz.aisdv1.feature.backup.restore.DefaultBackupSessionCodec +import com.shifthackz.aisdv1.feature.backup.restore.BackupRestoreWriter +import com.shifthackz.aisdv1.storage.gateway.BackupStorage +import com.shifthackz.aisdv1.storage.db.persistent.dao.RestoreSessionDao +import com.shifthackz.aisdv1.storage.db.persistent.entity.RestoreSessionEntity +import com.shifthackz.aisdv1.storage.db.persistent.entity.RestoreSectionEntity +import io.mockk.coEvery +import io.mockk.coVerify +import io.mockk.every +import io.mockk.mockk +import io.mockk.coVerifyOrder +import kotlinx.coroutines.CancellationException +import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.test.runTest +import kotlinx.serialization.json.Json +import okio.Path.Companion.toPath +import org.junit.Assert.assertEquals +import org.junit.Assert.assertFalse +import org.junit.Assert.assertTrue +import org.junit.Assert.assertSame +import org.junit.Before +import org.junit.Test + +class RestoreBackupUseCaseImplTest { + private val archives = mockk() + private val preferences = mockk(relaxed = true) + private val configuration = mockk(relaxed = true) + private val authorization = mockk(relaxed = true) + private val writer = mockk() + private val database = mockk() + private val ledger = mockk() + private val work = mockk() + private val changes = mockk(relaxed = true) + private val gate = object : GenerationRestoreGate { + override suspend fun generating(block: suspend () -> T): T = block() + override suspend fun restoring(block: suspend () -> T): T = block() + } + private val sessions = DefaultBackupSessionCodec(Json) + private val committed = mutableListOf() + private val intents = mutableMapOf() + private val request = BackupRestoreRequest( + "11111111-1111-1111-1111-111111111111", + BackupSelection(setOf(BackupCategory.GALLERY, BackupCategory.NETWORK)), + "22222222-2222-2222-2222-222222222222" + ) + private val archive = StagedBackup( + request.handle, + "/private/archive".toPath(), + BackupManifest( + "archive", + 1, + "1", + "IOS", + BackupCategory.entries.map { + BackupSection( + it.key, + storedBytes = 1, + decodedBytes = 1, + sha256 = "a".repeat(64), + itemCount = 1 + ) + }) + ) + private val summary = BackupInspection( + request.handle, + 1, + "1", + "IOS", + BackupCategory.entries.map { BackupEntry(it, 1) }, + setOf("custom") + ) + private val useCase = RestoreBackupUseCaseImpl( + archives, + preferences, + configuration, + authorization, + ProviderSelectionGuard(), + DefaultBackupRestoreGuard(), + DefaultBackupProviderPlanner(DefaultBackupPreferencesCodec(Json)), + writer, + sessions, + database, + work, + changes, + gate, + mockk { every { io } returns Dispatchers.Unconfined }) + + @Before + fun setup() { + every { database.restoreSessionDao() } returns ledger + coEvery { archives.staged(request.handle) } returns archive + every { archives.summary(archive) } returns summary + every { archives.preferences(archive) } returns BackupPreferences(emptyMap(), emptyMap()) + every { preferences.read() } returns BackupPreferences(emptyMap(), emptyMap()) + coEvery { authorization.getAuthorizationCredentials() } returns AuthorizationCredentials.None + every { work.hasActiveTasks() } returns false + coEvery { ledger.get(any()) } answers { intents[firstArg()] } + coEvery { ledger.pending() } answers { intents.values.filter { !it.isComplete } } + coEvery { ledger.completed(any()) } answers { + committed.filter { it.sessionId == firstArg() }.map { it.category } + } + coEvery { ledger.results(any()) } answers { committed.filter { it.sessionId == firstArg() } } + coEvery { ledger.insert(any()) } answers { + val value = firstArg(); intents[value.id] = value + } + coEvery { ledger.mark(any()) } answers { committed += firstArg() } + coEvery { ledger.finish(any()) } answers { + val id = firstArg(); intents[id]?.let { + intents[id] = it.copy(isComplete = true) + }; Unit + } + coEvery { + writer.gallery( + any(), + any(), + any() + ) + } coAnswers { ledger.mark(RestoreSectionEntity(firstArg(), "gallery", 1)) } + coEvery { writer.network(any(), any()) } coAnswers { + ledger.mark( + RestoreSectionEntity( + firstArg(), + "network", + 1 + ) + ) + } + } + + @Test + fun `given gallery restore committed before interruption, same session retries, expected gallery not added twice`() = + runTest { + // Given + intents[request.sessionId] = RestoreSessionEntity( + request.sessionId, + request.handle, + sessions.encode(request.selection) + ) + committed += RestoreSectionEntity(request.sessionId, "gallery", 3) + // When + val result = useCase(request) {} as BackupRestoreResult.Finished + // Then + coVerify(exactly = 0) { writer.gallery(any(), any(), any()) } + coVerify(exactly = 1) { writer.network(request.sessionId, archive) } + assertEquals(3L, result.importedCounts[BackupCategory.GALLERY]) + assertFalse(result.hasFailed) + } + + @Test + fun `given two additive categories, second write fails, expected partial report preserving first commit`() = + runTest { + // Given + coEvery { writer.network(any(), any()) } throws IllegalStateException("storage failure") + // When + val result = useCase(request) {} as BackupRestoreResult.Finished + // Then + assertTrue(result.hasFailed) + assertEquals(setOf(BackupCategory.GALLERY), result.completed) + assertEquals(1L, result.importedCounts[BackupCategory.GALLERY]) + coVerify(exactly = 0) { ledger.finish(any()) } + } + + @Test + fun `given failed second category, user retries same session, expected only failed category applied`() = + runTest { + // Given + coEvery { writer.network(any(), any()) } throws IllegalStateException("storage failure") + useCase(request) {} + coEvery { writer.network(any(), any()) } coAnswers { + ledger.mark( + RestoreSectionEntity( + firstArg(), + "network", + 1 + ) + ) + } + // When + val result = useCase(request) {} as BackupRestoreResult.Finished + // Then + coVerify(exactly = 1) { writer.gallery(any(), any(), any()) } + assertFalse(result.hasFailed) + assertEquals(setOf(BackupCategory.GALLERY, BackupCategory.NETWORK), result.completed) + assertEquals(2, committed.size) + } + + @Test + fun `given gallery only restore, protected auth storage is unreadable, expected no credential access`() = + runTest { + // Given + coEvery { authorization.getAuthorizationCredentials() } throws IllegalStateException("unavailable") + // When + val result = useCase(request) {} as BackupRestoreResult.Finished + // Then + assertFalse(result.hasFailed) + coVerify(exactly = 0) { authorization.getAuthorizationCredentials() } + } + + @Test + fun `given conflicting provider and gallery selected, no consent exists, expected no mutation in any category`() = + runTest { + // Given + every { preferences.read() } returns BackupPreferences( + mapOf( + "custom" to mapOf( + "serverUrl" to BackupValue.Text( + "current" + ) + ) + ), emptyMap() + ) + every { archives.preferences(archive) } returns BackupPreferences( + mapOf( + "custom" to mapOf( + "serverUrl" to BackupValue.Text("incoming") + ) + ), emptyMap() + ) + val selected = request.copy( + selection = BackupSelection( + setOf( + BackupCategory.PROVIDERS, + BackupCategory.GALLERY + ), setOf("custom") + ) + ) + // When + val result = useCase(selected) {} as BackupRestoreResult.Conflict + // Then + assertEquals(setOf("custom"), result.providers) + coVerify(exactly = 0) { ledger.insert(any()); writer.gallery(any(), any(), any()) } + } + + @Test + fun `given completed additive import, explicit new restore session starts, expected data added again`() = + runTest { + // Given + useCase(request) {} + val repeated = request.copy(sessionId = "33333333-3333-3333-3333-333333333333") + // When + val result = useCase(repeated) {} as BackupRestoreResult.Finished + // Then + coVerify(exactly = 2) { writer.gallery(any(), any(), any()) } + coVerify(exactly = 2) { writer.network(any(), any()) } + assertFalse(result.hasFailed) + assertEquals(4, committed.size) + } + + @Test + fun `given pending provider batch, restore retries on same screen, expected exact batch recovered before auth read`() = + runTest { + // Given + val selected = request.copy( + selection = BackupSelection( + setOf(BackupCategory.PROVIDERS), + setOf("custom") + ) + ) + // When + useCase(selected) {} + // Then + coVerifyOrder { configuration.retryPendingConfiguration(); preferences.recoverPendingWrite(); authorization.getAuthorizationCredentials() } + } + + @Test + fun `given settings committed, next category is canceled, expected cancellation propagated and observers notified`() = + runTest { + // Given + val selected = request.copy( + selection = BackupSelection( + setOf( + BackupCategory.SETTINGS, + BackupCategory.GALLERY + ) + ) + ) + var wasCanceled = false + // When + try { + useCase(selected) { + if (it.category == BackupCategory.GALLERY) throw CancellationException( + "user canceled" + ) + } + } catch (_: CancellationException) { + wasCanceled = true + } + // Then + assertTrue(wasCanceled) + coVerify { changes.notifyChanged(setOf(BackupCategory.SETTINGS)) } + coVerify(exactly = 0) { writer.gallery(any(), any(), any()); ledger.finish(any()) } + } + + @Test + fun `given first launch final section committed, configuration navigation is not acknowledged, expected journal remains recoverable`() = + runTest { + // Given + val selected = request.copy(shouldProceedToConfiguration = true) + // When + useCase(selected) {} + // Then + assertTrue(intents.getValue(request.sessionId).isComplete) + assertTrue(intents.getValue(request.sessionId).requiresConfiguration) + } + + @Test + fun `given committed settings and primary cancellation, observer publication fails, expected original cancellation with suppressed notification failure`() = + runTest { + // Given + val selected = request.copy( + selection = BackupSelection( + setOf( + BackupCategory.SETTINGS, + BackupCategory.GALLERY + ) + ) + ) + val cancellation = CancellationException("cancel") + val notificationFailure = IllegalStateException("notification failed") + coEvery { changes.notifyChanged(any()) } throws notificationFailure + var caught: Throwable? = null + // When + try { + useCase(selected) { if (it.category == BackupCategory.GALLERY) throw cancellation } + } catch (failure: Throwable) { + caught = failure + } + // Then + assertSame(cancellation, caught) + assertEquals( + listOf(notificationFailure.message), + caught?.suppressedExceptions?.map { it.message }) + } + + @Test + fun `given completed restore and no primary failure, observer publication fails, expected failure propagated and retry intent retained`() = + runTest { + // Given + val notificationFailure = IllegalStateException("notification failed") + coEvery { changes.notifyChanged(any()) } throws notificationFailure + var caught: Throwable? = null + // When + try { + useCase(request) {} + } catch (failure: Throwable) { + caught = failure + } + // Then + assertEquals(notificationFailure.message, caught?.message) + assertTrue(caught is IllegalStateException) + coVerify(exactly = 0) { ledger.finish(request.sessionId) } + assertFalse(intents.getValue(request.sessionId).isComplete) + } + +} diff --git a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/SetBackupStartupStageUseCaseImplTest.kt b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/SetBackupStartupStageUseCaseImplTest.kt new file mode 100644 index 000000000..3ecc09ffb --- /dev/null +++ b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/SetBackupStartupStageUseCaseImplTest.kt @@ -0,0 +1,34 @@ +package com.shifthackz.aisdv1.feature.backup.usecase + +import com.shifthackz.aisdv1.domain.entity.backup.BackupStartupStage +import com.shifthackz.aisdv1.domain.gateway.backup.BackupPreferencesGateway +import io.mockk.every +import io.mockk.mockk +import io.mockk.verify +import org.junit.Test + +class SetBackupStartupStageUseCaseImplTest { + @Test + fun `given setup already complete, stale first launch screen requests configuration, expected durable completion preserved`() { + // Given + val preferences = + mockk(relaxed = true) { every { readStartupStage() } returns BackupStartupStage.COMPLETE } + val useCase = SetBackupStartupStageUseCaseImpl(preferences) + // When + useCase(BackupStartupStage.CONFIGURATION) + // Then + verify(exactly = 0) { preferences.writeStartupStage(any()) } + } + + @Test + fun `given invitation stage, user chooses restore, expected checked forward transition before navigation`() { + // Given + val preferences = + mockk(relaxed = true) { every { readStartupStage() } returns BackupStartupStage.INVITATION } + val useCase = SetBackupStartupStageUseCaseImpl(preferences) + // When + useCase(BackupStartupStage.RESTORE) + // Then + verify(exactly = 1) { preferences.writeStartupStage(BackupStartupStage.RESTORE) } + } +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupArchiveStore.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupArchiveStore.kt new file mode 100644 index 000000000..637071461 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupArchiveStore.kt @@ -0,0 +1,79 @@ +package com.shifthackz.aisdv1.feature.backup.archive + +import com.shifthackz.aisdv1.domain.entity.backup.BackupExport +import com.shifthackz.aisdv1.domain.entity.backup.BackupInspection +import com.shifthackz.aisdv1.domain.entity.backup.BackupPreferences +import com.shifthackz.aisdv1.domain.entity.backup.BackupProgress +import com.shifthackz.aisdv1.domain.entity.backup.BackupSelection + +/** + * Strict archive operations; restore merge and recovery policy belongs to use-case implementations. + * @author Dmitriy Moroz + */ +internal interface BackupArchiveStore { + /** + * Resolves a retained staged source without persisting platform-specific private paths. + * @param handle Generated app-owned staging directory. + * @param filename Suggested export filename retained by the operation. + * @author Dmitriy Moroz + */ + fun preparedExport(handle: String, filename: String): BackupExport + + /** + * Reads current selectable counts and portable fields without requiring protected credentials. + * @author Dmitriy Moroz + */ + suspend fun inventory(): BackupInspection + + /** + * Captures selected portable settings and a paged gallery/statistics snapshot into private binary staging. + * @param selection Available categories and provider children. + * @param progress Nonsecret work-stage callback; failure never reports an exported file. + * @author Dmitriy Moroz + */ + suspend fun create(selection: BackupSelection, progress: (BackupProgress) -> Unit): BackupExport + + /** + * Stages a selected native document and validates all known payloads before any app-data writes. + * @param document Opaque native source reference; original source is never deleted. + * @param progress Bounded staging and validation progress. + * @author Dmitriy Moroz + */ + suspend fun inspect(document: String, progress: (BackupProgress) -> Unit): BackupInspection + + /** + * Revalidates the binary integrity of an existing private archive for retry or recovery. + * @param handle Generated private archive identity, never an external path. + * @author Dmitriy Moroz + */ + suspend fun staged(handle: String): StagedBackup + + /** + * Reads supported portable fields while ignoring removed providers/fields and retaining omitted values. + * @param archive Integrity-validated staged archive. + * @author Dmitriy Moroz + */ + fun preferences(archive: StagedBackup): BackupPreferences + + /** + * Describes readable sections and skipped data without exposing provider credentials. + * @param archive Validated staged archive and its manifest. + * @author Dmitriy Moroz + */ + fun summary(archive: StagedBackup): BackupInspection + + /** + * Streams complete staged bytes into the selected destination; write failure propagates. + * @param document App-owned staged export reference. + * @param destination Native user-selected output reference. + * @author Dmitriy Moroz + */ + suspend fun export(document: String, destination: String) + + /** + * Deletes only generated app-owned staging; the caller must resolve pending journal intent first. + * @param handle Generated staging identity or its private document reference. + * @author Dmitriy Moroz + */ + fun discard(handle: String) +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupStagingCleaner.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupStagingCleaner.kt new file mode 100644 index 000000000..d0cc7b0fc --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupStagingCleaner.kt @@ -0,0 +1,17 @@ +package com.shifthackz.aisdv1.feature.backup.archive + +/** + * Initializes private staging once per process before any archive operation may create files. + * Journal-owned archives survive cleanup; later calls never rescan files owned by active operations. + * + * @author Dmitriy Moroz + */ +internal interface BackupStagingCleaner { + /** + * Removes generated staging left by a previous process, preserving every pending restore handle. + * Concurrent callers wait for the same initialization; failure propagates without marking it complete. + * + * @author Dmitriy Moroz + */ + suspend fun prepare() +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupArchiveStore.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupArchiveStore.kt new file mode 100644 index 000000000..cc72d861b --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupArchiveStore.kt @@ -0,0 +1,411 @@ +package com.shifthackz.aisdv1.feature.backup.archive + +import okio.use +import com.shifthackz.aisdv1.core.common.appbuild.BuildInfoProvider +import com.shifthackz.aisdv1.core.common.time.TimeProvider +import com.shifthackz.aisdv1.domain.entity.ServerSource +import com.shifthackz.aisdv1.domain.entity.NetworkUsageBucket +import com.shifthackz.aisdv1.domain.entity.setupAllowedModes +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory +import com.shifthackz.aisdv1.domain.entity.backup.BackupEntry +import com.shifthackz.aisdv1.domain.entity.backup.BackupExport +import com.shifthackz.aisdv1.domain.entity.backup.BackupInspection +import com.shifthackz.aisdv1.domain.entity.backup.BackupPreferences +import com.shifthackz.aisdv1.domain.entity.backup.BackupProgress +import com.shifthackz.aisdv1.domain.entity.backup.BackupSelection +import com.shifthackz.aisdv1.domain.entity.backup.BackupValue +import com.shifthackz.aisdv1.domain.feature.auth.AuthorizationStore +import com.shifthackz.aisdv1.domain.feature.auth.AuthorizationCredentials +import com.shifthackz.aisdv1.domain.gateway.ProviderSelectionGuard +import com.shifthackz.aisdv1.domain.gateway.backup.BackupPreferencesGateway +import com.shifthackz.aisdv1.feature.backup.codec.BackupArchiveCodec +import com.shifthackz.aisdv1.feature.backup.codec.BackupManifest +import com.shifthackz.aisdv1.feature.backup.codec.BackupSection +import com.shifthackz.aisdv1.feature.backup.codec.BackupPreferencesCodec +import com.shifthackz.aisdv1.feature.backup.codec.GalleryBackupCodec +import com.shifthackz.aisdv1.feature.backup.io.BackupFileStore +import com.shifthackz.aisdv1.storage.gateway.BackupStorage +import kotlinx.coroutines.currentCoroutineContext +import kotlinx.coroutines.ensureActive +import kotlinx.coroutines.flow.first +import kotlinx.serialization.encodeToString +import kotlinx.serialization.json.Json +import okio.Buffer +import okio.FileSystem +import okio.Path +import okio.buffer + +/** + * Creates consistent paged snapshots and validates immutable staged files before restore. + * @param files Platform document transport and durable private directory. + * @param codec Bounded binary framing and section integrity. + * @param galleryCodec Portable gallery record codec. + * @param preferencesCodec Portable scalar field codec. + * @param database Shared Room database used for consistent snapshot reads. + * @param preferencesGateway Strict allowlisted preference store. + * @param authorizationStore Protected portable Basic Auth source. + * @param selectionGuard Serializes provider snapshot reads with configuration publication. + * @param buildInfo Flavor/platform availability and source version. + * @param clock UTC archive timestamp. + * @param json Forward-compatible metadata serializer. + * @param staging Admits file creation only after one-time orphan cleanup has preserved pending restores. + * @author Dmitriy Moroz + */ +internal class DefaultBackupArchiveStore( + private val files: BackupFileStore, + private val codec: BackupArchiveCodec, + private val galleryCodec: GalleryBackupCodec, + private val preferencesCodec: BackupPreferencesCodec, + private val database: BackupStorage, + private val preferencesGateway: BackupPreferencesGateway, + private val authorizationStore: AuthorizationStore, + private val selectionGuard: ProviderSelectionGuard, + private val buildInfo: BuildInfoProvider, + private val clock: TimeProvider, + private val json: Json, + private val staging: BackupStagingCleaner, +) : BackupArchiveStore { + override fun preparedExport(handle: String, filename: String): BackupExport { + val path = directory(handle) / ARCHIVE + check(FileSystem.SYSTEM.exists(path)) { "Pending backup source is unavailable" } + return BackupExport(files.documentReference(path), filename, handle) + } + + override suspend fun inventory(): BackupInspection { + val preferences = ordinarySnapshot() + return BackupInspection( + "", + 0, + "", + "", + listOf( + BackupEntry( + BackupCategory.PROVIDERS, + preferences.providers.size.toLong(), + preferences.providers.isNotEmpty() + ), + BackupEntry( + BackupCategory.GALLERY, + database.generationResultDao().observeCount().first().toLong() + ), + BackupEntry( + BackupCategory.NETWORK, + database.networkUsageDao().query().size.toLong() + ), + BackupEntry( + BackupCategory.SETTINGS, + preferences.settings.size.toLong(), + preferences.settings.isNotEmpty() + ), + ).map { if (it.itemCount == 0L) it.copy(isAvailable = false) else it }, + preferences.providers.keys + ) + } + + override suspend fun create( + selection: BackupSelection, + progress: (BackupProgress) -> Unit + ): BackupExport { + staging.prepare() + require(selection.categories.isNotEmpty()) { "Select backup data" } + val snapshot = + if (BackupCategory.PROVIDERS in selection.categories) portableSnapshot() else ordinarySnapshot() + val handle = files.newId() + val directory = directory(handle) + FileSystem.SYSTEM.createDirectories(directory) + try { + val sections = mutableListOf() + val payloads = mutableListOf() + suspend fun payload(category: BackupCategory, block: suspend (Path) -> Long) { + if (category !in selection.categories) return + currentCoroutineContext().ensureActive() + val path = directory / category.key + val count = block(path) + sections += codec.describe(path, category.key, count) + payloads += path + } + payload(BackupCategory.PROVIDERS) { path -> + val values = snapshot.providers.filterKeys { it in selection.providers } + require(values.isNotEmpty()) { "Select providers" } + FileSystem.SYSTEM.sink(path).buffer() + .use { codec.writeJson(it, preferencesCodec.encodeProviders(values)) } + values.size.toLong() + } + payload(BackupCategory.SETTINGS) { path -> + FileSystem.SYSTEM.sink(path).buffer() + .use { codec.writeJson(it, preferencesCodec.encode(snapshot.settings)) } + snapshot.settings.size.toLong() + } + database.readSnapshot { + payload(BackupCategory.GALLERY) { path -> + var offset = 0L + var afterId = 0L + FileSystem.SYSTEM.sink(path).buffer().use { sink -> + while (true) { + currentCoroutineContext().ensureActive() + val row = database.generationResultDao().queryBackupPage(afterId, 1) + .firstOrNull() ?: break + galleryCodec.write(sink, row) + offset++ + afterId = row.id + progress(BackupProgress(BackupCategory.GALLERY, offset.toLong(), 0)) + } + } + offset.toLong() + } + payload(BackupCategory.NETWORK) { path -> + val values = database.networkUsageDao().query() + .filter { NetworkUsageBucket.parse(it.category) != null } + .associate { it.category to it.bytes } + require(values.values.all { it >= 0 }) { "Invalid saved network counter" } + FileSystem.SYSTEM.sink(path).buffer() + .use { codec.writeJson(it, json.encodeToString(values)) } + values.size.toLong() + } + } + val manifest = BackupManifest( + handle, + clock.currentTimeMillis(), + buildInfo.version.toString(), + buildInfo.platform.name, + sections + ) + codec.write(directory / ARCHIVE, manifest, payloads) + payloads.forEach { FileSystem.SYSTEM.delete(it) } + return BackupExport( + files.documentReference(directory / ARCHIVE), + "SDAI-${manifest.createdAt}.sdaibackup", + handle + ) + } catch (failure: Throwable) { + FileSystem.SYSTEM.deleteRecursively(directory, mustExist = false) + throw failure + } + } + + override suspend fun inspect( + document: String, + progress: (BackupProgress) -> Unit + ): BackupInspection { + staging.prepare() + val handle = files.newId() + val directory = directory(handle) + FileSystem.SYSTEM.createDirectories(directory) + try { + val target = directory / ARCHIVE + val displayName = files.documentName(document).take(512) + FileSystem.SYSTEM.sink(directory / "name").buffer().use { it.writeUtf8(displayName) } + files.openDocument(document).use { source -> + FileSystem.SYSTEM.sink(target).buffer().use { sink -> + val buffer = Buffer() + var copied = 0L + while (true) { + currentCoroutineContext().ensureActive() + val read = source.read(buffer, 65536) + if (read == -1L) break + require(files.availableBytes() > read + 1024 * 1024) { "Not enough storage for backup" } + sink.write(buffer, read) + copied += read + progress(BackupProgress(null, copied, 0)) + } + } + } + val archive = staged(handle) + validatePayloads(archive, progress) + return summary(archive) + } catch (failure: Throwable) { + FileSystem.SYSTEM.deleteRecursively(directory, mustExist = false) + throw failure + } + } + + override suspend fun staged(handle: String): StagedBackup { + val path = directory(handle) / ARCHIVE + return StagedBackup(handle, path, codec.inspect(path)) + } + + override fun preferences(archive: StagedBackup): BackupPreferences { + val providers = if (compatible(archive, BackupCategory.PROVIDERS)) { + codec.openSection(archive.path, archive.manifest, BackupCategory.PROVIDERS.key) + .use { source -> + preferencesCodec.decodeProviders(codec.readJson(source)) + .also { require(source.exhausted()) { "Unexpected provider payload" } } + } + } else emptyMap() + val settings = if (compatible(archive, BackupCategory.SETTINGS)) { + codec.openSection(archive.path, archive.manifest, BackupCategory.SETTINGS.key) + .use { source -> + preferencesCodec.decode(codec.readJson(source)) + .also { require(source.exhausted()) { "Unexpected settings payload" } } + } + } else emptyMap() + val allowed = buildInfo.setupAllowedModes().map { it.key }.toSet() + val supported = preferencesGateway.filterSupported( + BackupPreferences( + providers.filterKeys { it in allowed }, + settings + ) + ) + val withCredentials = supported.providers.mapValues { (key, values) -> + val basic = + providers[key].orEmpty() + .filter { (field, value) -> key in BASIC_PROVIDERS && field in BASIC_FIELDS && value is BackupValue.Text } + values + basic + } + return supported.copy(providers = withCredentials.filterValues { it.isNotEmpty() }) + } + + override fun summary(archive: StagedBackup): BackupInspection { + val preferences = preferences(archive) + val entries = archive.manifest.sections.mapNotNull { section -> + val category = BackupCategory.entries.firstOrNull { it.key == section.id } + ?: return@mapNotNull null + val count = when (category) { + BackupCategory.PROVIDERS -> preferences.providers.size.toLong() + BackupCategory.SETTINGS -> preferences.settings.size.toLong() + else -> section.itemCount + } + BackupEntry( + category, + count, + section.codec == "stored" && section.requiredReaderVersion <= 1 && count > 0 + ) + } + var skipped = + archive.manifest.sections.count { section -> entries.none { it.category.key == section.id && it.isAvailable } } + if (compatible(archive, BackupCategory.PROVIDERS)) { + val original = codec.openSection(archive.path, archive.manifest, "providers") + .use { preferencesCodec.decodeProviders(codec.readJson(it)) } + skipped += original.entries.sumOf { (provider, fields) -> + val supported = preferences.providers[provider] + if (supported == null) 1 else fields.keys.count { it !in supported } + } + } + if (compatible(archive, BackupCategory.SETTINGS)) { + val original = codec.openSection(archive.path, archive.manifest, "settings") + .use { preferencesCodec.decode(codec.readJson(it)) } + skipped += original.keys.count { it !in preferences.settings } + } + val nameFile = archive.path.parent!! / "name" + val filename = + if (FileSystem.SYSTEM.exists(nameFile)) FileSystem.SYSTEM.source(nameFile).buffer() + .use { it.readUtf8() } else "SDAI.sdaibackup" + return BackupInspection( + archive.handle, + archive.manifest.createdAt, + archive.manifest.appVersion, + archive.manifest.sourcePlatform, + entries, + preferences.providers.keys, + skipped, + filename + ) + } + + override suspend fun export(document: String, destination: String) { + val path = privateDocument(document) + FileSystem.SYSTEM.source(path).buffer().use { source -> + files.writeDocument(destination).use { sink -> + val buffer = Buffer() + while (true) { + currentCoroutineContext().ensureActive() + val count = source.read(buffer, 65536) + if (count == -1L) break + sink.write(buffer, count) + } + } + } + } + + override fun discard(handle: String) { + val id = if (handle.startsWith("file://")) privateDocument(handle).parent!!.name else handle + // The discard use case resolves pending checked writes and abandons intent before cleanup. + FileSystem.SYSTEM.deleteRecursively(directory(id), mustExist = false) + } + + private fun ordinarySnapshot(): BackupPreferences { + val snapshot = preferencesGateway.read() + val allowed = buildInfo.setupAllowedModes().map { it.key }.toSet() + return snapshot.copy(providers = snapshot.providers.filterKeys { it in allowed }) + } + + private suspend fun portableSnapshot(): BackupPreferences = selectionGuard.withSelection { + val snapshot = preferencesGateway.read() + val allowed = buildInfo.setupAllowedModes().map { it.key }.toSet() + val providers = snapshot.providers.filterKeys { it in allowed }.toMutableMap() + val credentials = authorizationStore.getAuthorizationCredentials() + if (credentials is AuthorizationCredentials.HttpBasic) { + BASIC_PROVIDERS.filter { it in allowed }.forEach { key -> + providers[key] = providers[key].orEmpty() + mapOf( + "basicLogin" to BackupValue.Text(credentials.login), + "basicPassword" to BackupValue.Text(credentials.password) + ) + } + } + snapshot.copy(providers = providers) + } + + private suspend fun validatePayloads( + archive: StagedBackup, + progress: (BackupProgress) -> Unit + ) { + preferences(archive) + for (section in archive.manifest.sections) { + if (section.codec != "stored" || section.requiredReaderVersion > 1) continue + when (section.id) { + "gallery" -> codec.openSection(archive.path, archive.manifest, section.id) + .use { source -> + repeatCount(section.itemCount) { index -> + currentCoroutineContext().ensureActive() + galleryCodec.read(source, "validation") + progress( + BackupProgress( + BackupCategory.GALLERY, + index + 1, + section.itemCount + ) + ) + } + require(source.exhausted()) { "Unexpected gallery payload" } + } + + "network" -> codec.openSection(archive.path, archive.manifest, section.id) + .use { source -> + val counters = + json.decodeFromString>(codec.readJson(source)) + require(counters.values.all { it >= 0 } && source.exhausted()) { "Invalid network payload" } + } + } + } + } + + private fun compatible(archive: StagedBackup, category: BackupCategory) = + archive.manifest.sections.any { + it.id == category.key && it.codec == "stored" && it.requiredReaderVersion <= 1 + } + + private fun directory(handle: String): Path { + require(handle.matches(Regex("[0-9a-fA-F-]{36}"))) { "Invalid backup handle" } + return files.root / handle + } + + private fun privateDocument(document: String): Path { + val path = files.documentPath(document) + val parts = path.relativeTo(files.root).segments + require(parts.size == 2 && parts[1] == ARCHIVE) { "Invalid backup document" } + return directory(parts[0]) / ARCHIVE + } + + private suspend fun repeatCount(count: Long, block: suspend (Long) -> Unit) { + var index = 0L + while (index < count) { + block(index); index++ + } + } + + private companion object { + const val ARCHIVE = "archive.sdaibackup" + val BASIC_PROVIDERS = setOf("custom", "swarm_ui") + val BASIC_FIELDS = setOf("basicLogin", "basicPassword") + } +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupStagingCleaner.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupStagingCleaner.kt new file mode 100644 index 000000000..f2653874a --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupStagingCleaner.kt @@ -0,0 +1,74 @@ +package com.shifthackz.aisdv1.feature.backup.archive + +import com.shifthackz.aisdv1.feature.backup.io.BackupFileStore +import com.shifthackz.aisdv1.domain.gateway.backup.BackupExportStateStore +import com.shifthackz.aisdv1.storage.gateway.BackupStorage +import kotlinx.coroutines.currentCoroutineContext +import kotlinx.coroutines.ensureActive +import kotlinx.coroutines.sync.Mutex +import kotlinx.coroutines.sync.withLock +import okio.FileSystem +import okio.Path + +/** + * Cleans only generated directories under the app-owned backup root before new operations are admitted. + * A single initialization mutex prevents a concurrent create/import from allocating files during cleanup. + * + * @param files Platform-owned private staging root; user-selected documents are never inspected here. + * @param database Durable restore ledger identifying archives that must remain available for recovery. + * @param exports Durable native export ownership retained across host/process recreation. + * + * @author Dmitriy Moroz + */ +internal class DefaultBackupStagingCleaner( + private val files: BackupFileStore, + private val database: BackupStorage, + private val exports: BackupExportStateStore, +) : BackupStagingCleaner { + private val initialization = Mutex() + private var hasPrepared = false + + override suspend fun prepare() = initialization.withLock { + if (hasPrepared) return@withLock + exports.recoverPendingWrite() + val retained = + database.restoreSessionDao().pending().map { it.archiveHandle }.toSet() + listOfNotNull( + exports.read()?.handle + ) + val root = files.root + val metadata = FileSystem.SYSTEM.metadataOrNull(root) + if (metadata != null) { + check(metadata.isDirectory && metadata.symlinkTarget == null) { + "Private backup staging root is not an owned directory" + } + FileSystem.SYSTEM.list(root).forEach { child -> + currentCoroutineContext().ensureActive() + if (child.name.matches(GENERATED_HANDLE) && child.name !in retained) { + deleteOwnedEntry(child) + } + } + } + hasPrepared = true + } + + /** + * Deletes a private tree without following symbolic links into user-managed storage. + * + * @param path Entry below a generated app-owned staging directory. + * + * @author Dmitriy Moroz + */ + private suspend fun deleteOwnedEntry(path: Path) { + currentCoroutineContext().ensureActive() + val metadata = FileSystem.SYSTEM.metadata(path) + if (metadata.isDirectory && metadata.symlinkTarget == null) { + FileSystem.SYSTEM.list(path).forEach { child -> deleteOwnedEntry(child) } + } + FileSystem.SYSTEM.delete(path) + } + + private companion object { + val GENERATED_HANDLE = + Regex("[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}") + } +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/StagedBackup.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/StagedBackup.kt new file mode 100644 index 000000000..c8141dc09 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/StagedBackup.kt @@ -0,0 +1,13 @@ +package com.shifthackz.aisdv1.feature.backup.archive + +import com.shifthackz.aisdv1.feature.backup.codec.BackupManifest +import okio.Path + +/** + * Verified immutable archive reference owned by private staging. + * @param handle Private generated directory name. + * @param path Private binary archive path. + * @param manifest Verified framing and integrity summary. + * @author Dmitriy Moroz + */ +internal data class StagedBackup(val handle: String, val path: Path, val manifest: BackupManifest) diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BackupArchiveCodec.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BackupArchiveCodec.kt new file mode 100644 index 000000000..9d14ef83e --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BackupArchiveCodec.kt @@ -0,0 +1,60 @@ +package com.shifthackz.aisdv1.feature.backup.codec + +import okio.Path +import okio.BufferedSink +import okio.BufferedSource + +/** + * Framing and integrity operations for the portable binary container. + * @author Dmitriy Moroz + */ +internal interface BackupArchiveCodec { + /** + * Writes a complete binary envelope from precomputed streamed sections; cancellation or write failure propagates. + * @param path Private target archive. + * @param manifest Descriptors whose lengths and digests match payload files. + * @param payloads Private section files in manifest order. + * @author Dmitriy Moroz + */ + suspend fun write(path: Path, manifest: BackupManifest, payloads: List) + + /** + * Checks framing, supported container major, lengths and every section digest before returning metadata. + * @param path Immutable staged archive; malformed or truncated input throws. + * @author Dmitriy Moroz + */ + suspend fun inspect(path: Path): BackupManifest + + /** + * Opens a bounded reader that cannot consume the next section; the caller owns closing it. + * @param path Validated staged archive. + * @param manifest Verified descriptor order and lengths. + * @param id Known section identifier to read. + * @author Dmitriy Moroz + */ + fun openSection(path: Path, manifest: BackupManifest, id: String): BufferedSource + + /** + * Computes the streamed SHA-256 and size descriptor without retaining the payload in memory. + * @param path Completed private section file. + * @param id Stable section wire key. + * @param count Number of records actually encoded. + * @author Dmitriy Moroz + */ + suspend fun describe(path: Path, id: String, count: Long): BackupSection + + /** + * Writes one bounded UTF8 metadata frame, rejecting records over the metadata limit. + * @param sink Owned binary section writer. + * @param text Typed metadata JSON, excluding binary image data. + * @author Dmitriy Moroz + */ + fun writeJson(sink: BufferedSink, text: String) + + /** + * Reads exactly one bounded metadata frame; invalid length or truncation throws. + * @param source Reader confined to the selected section. + * @author Dmitriy Moroz + */ + fun readJson(source: BufferedSource): String +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BackupManifest.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BackupManifest.kt new file mode 100644 index 000000000..0c7080c21 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BackupManifest.kt @@ -0,0 +1,23 @@ +package com.shifthackz.aisdv1.feature.backup.codec + +import kotlinx.serialization.Serializable + +/** + * Versioned archive metadata independent of Room entities and application versions. + * @param archiveId Unique exported snapshot identity. + * @param createdAt UTC epoch milliseconds. + * @param appVersion Display-only source version. + * @param sourcePlatform Source platform label. + * @param sections Ordered length-delimited section descriptors. + * @param schemaVersion Manifest schema version. + * @author Dmitriy Moroz + */ +@Serializable +internal data class BackupManifest( + val archiveId: String, + val createdAt: Long, + val appVersion: String, + val sourcePlatform: String, + val sections: List, + val schemaVersion: Int = 1, +) diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BackupPreferencesCodec.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BackupPreferencesCodec.kt new file mode 100644 index 000000000..7fbcdc5d1 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BackupPreferencesCodec.kt @@ -0,0 +1,37 @@ +package com.shifthackz.aisdv1.feature.backup.codec + +import com.shifthackz.aisdv1.domain.entity.backup.BackupValue + +/** + * Encodes portable scalar fields and preserves unsupported field identifiers for compatibility reporting. + * @author Dmitriy Moroz + */ +internal interface BackupPreferencesCodec { + /** + * Serializes only explicitly present typed scalar fields. + * @param values Stable field IDs and their portable scalar values. + * @author Dmitriy Moroz + */ + fun encode(values: Map): String + + /** + * Decodes scalar fields while retaining missing-entry semantics; unsupported value identifiers remain available for skipped-field accounting. + * @param text One bounded metadata JSON object. + * @author Dmitriy Moroz + */ + fun decode(text: String): Map + + /** + * Encodes independent provider groups using stable provider and field IDs. + * @param values Selected portable provider groups; may contain credentials and must not be logged. + * @author Dmitriy Moroz + */ + fun encodeProviders(values: Map>): String + + /** + * Decodes independent provider objects without requiring any currently mandatory setup fields. + * @param text Bounded provider-section metadata JSON. + * @author Dmitriy Moroz + */ + fun decodeProviders(text: String): Map> +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BackupSection.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BackupSection.kt new file mode 100644 index 000000000..250ff4dc2 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BackupSection.kt @@ -0,0 +1,27 @@ +package com.shifthackz.aisdv1.feature.backup.codec + +import kotlinx.serialization.Serializable + +/** + * Length-delimited manifest descriptor; digest covers the exact stored payload bytes. + * @param id Stable section key. + * @param schemaVersion Writer section schema. + * @param requiredReaderVersion Minimum compatible section reader. + * @param codec Payload encoding. + * @param storedBytes Exact payload byte length. + * @param decodedBytes Decoded byte length; identical for stored payloads. + * @param sha256 Lowercase SHA-256 integrity digest. + * @param itemCount Number of represented records. + * @author Dmitriy Moroz + */ +@Serializable +internal data class BackupSection( + val id: String, + val schemaVersion: Int = 1, + val requiredReaderVersion: Int = 1, + val codec: String = "stored", + val storedBytes: Long, + val decodedBytes: Long, + val sha256: String, + val itemCount: Long, +) diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BinaryBackupArchiveCodec.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BinaryBackupArchiveCodec.kt new file mode 100644 index 000000000..afba9d85d --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BinaryBackupArchiveCodec.kt @@ -0,0 +1,141 @@ +package com.shifthackz.aisdv1.feature.backup.codec + +import okio.use +import kotlinx.coroutines.currentCoroutineContext +import kotlinx.coroutines.ensureActive +import kotlinx.serialization.encodeToString +import kotlinx.serialization.json.Json +import okio.blackholeSink +import okio.Buffer +import okio.BufferedSink +import okio.BufferedSource +import okio.FileSystem +import okio.HashingSink +import okio.HashingSource +import okio.Path +import okio.buffer + +/** + * Streams bounded, length-delimited sections with independently verified SHA-256 checksums. + * @param json Forward-compatible JSON metadata decoder; binary payloads never become one JSON document. + * @author Dmitriy Moroz + */ +internal class BinaryBackupArchiveCodec(private val json: Json) : BackupArchiveCodec { + override suspend fun write(path: Path, manifest: BackupManifest, payloads: List) { + val bytes = json.encodeToString(manifest).encodeToByteArray() + require(bytes.size <= MAX_METADATA) { "Backup manifest is too large" } + FileSystem.SYSTEM.sink(path).buffer().use { sink -> + sink.write(MAGIC) + sink.writeShortLe(1) + sink.writeShortLe(0) + sink.writeIntLe(bytes.size) + sink.write(bytes) + payloads.forEach { payload -> + FileSystem.SYSTEM.source(payload).buffer().use { source -> + val buffer = Buffer() + while (true) { + currentCoroutineContext().ensureActive() + val count = source.read(buffer, 65536) + if (count == -1L) break + sink.write(buffer, count) + } + } + } + } + } + + override suspend fun inspect(path: Path): BackupManifest { + FileSystem.SYSTEM.source(path).buffer().use { source -> + require(source.readByteArray(8).contentEquals(MAGIC)) { "Not an SDAI backup" } + require(source.readShortLe().toInt() == 1) { "Unsupported backup container version" } + source.readShortLe() // Additive minor versions preserve framing. + val length = source.readIntLe() + require(length in 1..MAX_METADATA) { "Invalid backup manifest length" } + val manifest = json.decodeFromString(source.readUtf8(length.toLong())) + require(manifest.schemaVersion == 1 && manifest.sections.size <= 128) { "Unsupported backup manifest" } + require(manifest.archiveId.isNotBlank() && manifest.createdAt >= 0) { "Invalid backup metadata" } + require(manifest.sections.map { it.id } + .distinct().size == manifest.sections.size) { "Duplicate backup sections" } + var remaining = FileSystem.SYSTEM.metadata(path).size!! - 16L - length + manifest.sections.forEach { section -> + require(section.storedBytes >= 0 && section.storedBytes <= remaining && section.itemCount >= 0) { "Invalid section length" } + require(section.schemaVersion > 0 && section.requiredReaderVersion > 0) { "Invalid section version" } + require(section.sha256.matches(Regex("[0-9a-f]{64}"))) { "Invalid backup checksum" } + if (section.codec == "stored") require(section.decodedBytes == section.storedBytes) { "Invalid decoded length" } + val hashing = HashingSink.sha256(blackholeSink()) + val buffer = Buffer() + var left = section.storedBytes + hashing.use { output -> + while (left > 0) { + currentCoroutineContext().ensureActive() + val read = source.read(buffer, minOf(left, 65536L)) + require(read > 0) { "Truncated backup section" } + output.write(buffer, read) + left -= read + } + } + require(hashing.hash.hex() == section.sha256) { "Backup checksum mismatch" } + remaining -= section.storedBytes + } + require(remaining == 0L && source.exhausted()) { "Unexpected trailing backup data" } + return manifest + } + } + + override fun openSection(path: Path, manifest: BackupManifest, id: String): BufferedSource { + val source = FileSystem.SYSTEM.source(path).buffer() + try { + source.skip(12) + val size = source.readIntLe() + source.skip(size.toLong()) + for (section in manifest.sections) { + if (section.id == id) return BoundedBackupSource( + source, + section.storedBytes + ).buffer() + source.skip(section.storedBytes) + } + error("Backup section is absent") + } catch (failure: Throwable) { + source.close() + throw failure + } + } + + override suspend fun describe(path: Path, id: String, count: Long): BackupSection { + val hashing = HashingSource.sha256(FileSystem.SYSTEM.source(path)) + hashing.buffer().use { input -> + val buffer = Buffer() + while (input.read(buffer, 65536) != -1L) { + currentCoroutineContext().ensureActive() + buffer.clear() + } + } + val size = FileSystem.SYSTEM.metadata(path).size!! + return BackupSection( + id = id, + storedBytes = size, + decodedBytes = size, + sha256 = hashing.hash.hex(), + itemCount = count + ) + } + + override fun writeJson(sink: BufferedSink, text: String) { + val bytes = text.encodeToByteArray() + require(bytes.size <= MAX_METADATA) { "Backup record metadata is too large" } + sink.writeIntLe(bytes.size) + sink.write(bytes) + } + + override fun readJson(source: BufferedSource): String { + val count = source.readIntLe() + require(count in 0..MAX_METADATA) { "Invalid backup record metadata length" } + return source.readUtf8(count.toLong()) + } + + private companion object { + const val MAX_METADATA = 1024 * 1024 + val MAGIC = byteArrayOf(83, 68, 65, 73, 66, 65, 75, 0) + } +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BoundedBackupSource.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BoundedBackupSource.kt new file mode 100644 index 000000000..deb69969a --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BoundedBackupSource.kt @@ -0,0 +1,26 @@ +package com.shifthackz.aisdv1.feature.backup.codec + +import okio.Source +import okio.Buffer +import okio.Timeout + +/** + * Prevents a section decoder from consuming adjacent binary sections. + * @param source Owned archive source positioned at a section boundary. + * @param remaining Validated length of the selected section. + * @author Dmitriy Moroz + */ +internal class BoundedBackupSource(private val source: Source, private var remaining: Long) : + Source { + override fun read(sink: Buffer, byteCount: Long): Long { + require(byteCount >= 0) + if (remaining == 0L) return -1 + val read = source.read(sink, minOf(byteCount, remaining)) + check(read >= 0) { "Truncated backup section" } + remaining -= read + return read + } + + override fun timeout(): Timeout = source.timeout() + override fun close() = source.close() +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/DefaultBackupPreferencesCodec.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/DefaultBackupPreferencesCodec.kt new file mode 100644 index 000000000..f577bc819 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/DefaultBackupPreferencesCodec.kt @@ -0,0 +1,52 @@ +package com.shifthackz.aisdv1.feature.backup.codec + +import com.shifthackz.aisdv1.domain.entity.backup.BackupValue +import kotlinx.serialization.json.Json +import kotlinx.serialization.json.JsonObject +import kotlinx.serialization.json.JsonPrimitive +import kotlinx.serialization.json.booleanOrNull +import kotlinx.serialization.json.intOrNull + +/** + * Serializes portable scalar fields without leaking preference storage keys or inventing absent values. + * @param json Forward-compatible JSON parser. + * @author Dmitriy Moroz + */ +internal class DefaultBackupPreferencesCodec(private val json: Json) : BackupPreferencesCodec { + override fun encode(values: Map): String = + JsonObject(values.mapValues { (_, value) -> + when (value) { + BackupValue.Unsupported -> error("Unsupported portable values cannot be exported") + is BackupValue.Text -> JsonPrimitive(value.value) + is BackupValue.Flag -> JsonPrimitive(value.isTrue) + is BackupValue.Integer -> JsonPrimitive(value.value) + } + }).toString() + + override fun decode(text: String): Map { + val values = + json.parseToJsonElement(text) as? JsonObject ?: error("Invalid backup preferences") + return values.mapNotNull { (key, value) -> + val scalar = value as? JsonPrimitive ?: return@mapNotNull key to BackupValue.Unsupported + val decoded = when { + scalar.isString -> BackupValue.Text(scalar.content) + scalar.booleanOrNull != null -> BackupValue.Flag(scalar.booleanOrNull!!) + scalar.intOrNull != null -> BackupValue.Integer(scalar.intOrNull!!) + else -> BackupValue.Unsupported + } + key to decoded + }.toMap() + } + + override fun encodeProviders(values: Map>): String = + JsonObject(values.mapValues { (_, fields) -> json.parseToJsonElement(encode(fields)) }).toString() + + override fun decodeProviders(text: String): Map> { + val values = + json.parseToJsonElement(text) as? JsonObject ?: error("Invalid backup providers") + return values.mapNotNull { (provider, fields) -> + if (fields !is JsonObject) return@mapNotNull provider to mapOf("" to BackupValue.Unsupported) + provider to decode(fields.toString()) + }.toMap() + } +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/DefaultGalleryBackupCodec.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/DefaultGalleryBackupCodec.kt new file mode 100644 index 000000000..bf93f1404 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/DefaultGalleryBackupCodec.kt @@ -0,0 +1,160 @@ +package com.shifthackz.aisdv1.feature.backup.codec + +import com.shifthackz.aisdv1.storage.db.persistent.entity.GenerationResultEntity +import com.shifthackz.aisdv1.domain.gateway.backup.BackupImageValidator +import com.shifthackz.aisdv1.domain.entity.backup.BackupImageBudget +import kotlinx.serialization.encodeToString +import kotlinx.serialization.json.Json +import okio.BufferedSink +import okio.BufferedSource +import kotlin.io.encoding.Base64 +import kotlin.io.encoding.Base64.PaddingOption +import kotlin.io.encoding.ExperimentalEncodingApi + +/** + * Encodes one gallery row at a time without loading the whole gallery. + * @param archive Length-prefixed metadata codec. + * @param json Forward-compatible typed metadata serializer. + * @param imageValidator Budgeted native probe and sampled content validator. + * @param budget Shared encoded-record admission applied before allocating encoded image buffers. + * @author Dmitriy Moroz + */ +@OptIn(ExperimentalEncodingApi::class) +internal class DefaultGalleryBackupCodec( + private val archive: BackupArchiveCodec, + private val json: Json, + private val imageValidator: BackupImageValidator, + private val budget: BackupImageBudget, +) : GalleryBackupCodec { + override fun write(sink: BufferedSink, row: GenerationResultEntity) { + val record = GalleryBackupRecord( + createdAt = row.createdAt, + generationType = row.generationType, + prompt = row.prompt, + negativePrompt = row.negativePrompt, + width = row.width, + height = row.height, + samplingSteps = row.samplingSteps, + cfgScale = row.cfgScale, + isRestoreFaces = row.restoreFaces, + sampler = row.sampler, + seed = row.seed, + subSeed = row.subSeed, + subSeedStrength = row.subSeedStrength, + denoisingStrength = row.denoisingStrength, + isHidden = row.hidden, + isLiked = row.liked, + modelName = row.modelName, + ) + archive.writeJson(sink, json.encodeToString(record)) + val outputBytes = writeImage(sink, row.imageBase64, false, budget.maxEncodedBytes) + writeImage(sink, row.originalImageBase64, true, budget.maxEncodedBytes - outputBytes) + } + + override fun read(source: BufferedSource, revision: String): GenerationResultEntity? { + val record = json.decodeFromString(archive.readJson(source)) + val (image, outputBytes) = readImage(source, false, budget.maxEncodedBytes) + val (original, _) = readImage(source, true, budget.maxEncodedBytes - outputBytes) + if (record.generationType !in setOf("txt2img", "img2img")) return null + require(record.width > 0 && record.height > 0 && record.samplingSteps >= 0 && record.cfgScale.isFinite()) { "Invalid gallery metadata" } + require(record.subSeedStrength.isFinite() && record.denoisingStrength.isFinite()) { "Invalid gallery metadata" } + return GenerationResultEntity( + id = 0, + imageBase64 = image, + originalImageBase64 = original, + imageRevision = revision, + createdAt = record.createdAt, + generationType = record.generationType, + prompt = record.prompt, + negativePrompt = record.negativePrompt, + width = record.width, + height = record.height, + samplingSteps = record.samplingSteps, + cfgScale = record.cfgScale, + restoreFaces = record.isRestoreFaces, + sampler = record.sampler, + seed = record.seed, + subSeed = record.subSeed, + subSeedStrength = record.subSeedStrength, + denoisingStrength = record.denoisingStrength, + hidden = record.isHidden, + liked = record.isLiked, + modelName = record.modelName, + ) + } + + /** + * Admits encoded text before allocating binary bytes and emits one validated image frame. + * @param sink Current gallery section writer. + * @param value Saved Base64 image text, including supported alternate alphabet or whitespace. + * @param canBeEmpty Whether this is the optional original input image. + * @param remainingBytes Encoded-byte allowance left in this output/input record. + * @author Dmitriy Moroz + */ + private fun writeImage( + sink: BufferedSink, + value: String, + canBeEmpty: Boolean, + remainingBytes: Int + ): Int { + // Admit the Base64 text before allocating its decoded byte array or a normalized copy. + val maxChars = ((remainingBytes.toLong() + 2) / 3) * 4 + require(value.length.toLong() <= maxChars) { "Backup image exceeds encoded record budget" } + val normalized = + if (value.any { it.isWhitespace() || it == '-' || it == '_' }) buildString(value.length) { + value.forEach { character -> + if (!character.isWhitespace()) append( + when (character) { + '-' -> '+'; '_' -> '/'; else -> character + } + ) + } + } else value + val bytes = + if (normalized.isEmpty()) byteArrayOf() else Base64.Default.withPadding(PaddingOption.PRESENT_OPTIONAL) + .decode(normalized) + require(bytes.size <= remainingBytes) { "Backup image exceeds encoded record budget" } + validateImage(bytes, canBeEmpty) + sink.writeIntLe(bytes.size) + sink.write(bytes) + return bytes.size + } + + /** + * Checks the frame length before allocation and returns Base64 text with its consumed binary byte count. + * @param source Bounded gallery section reader. + * @param canBeEmpty Whether the optional original input may be absent. + * @param remainingBytes Encoded-byte allowance left after preceding image frames. + * @author Dmitriy Moroz + */ + private fun readImage( + source: BufferedSource, + canBeEmpty: Boolean, + remainingBytes: Int + ): Pair { + val count = source.readIntLe() + require(count in 0..remainingBytes) { "Backup image exceeds encoded record budget" } + val bytes = source.readByteArray(count.toLong()) + validateImage(bytes, canBeEmpty) + return Base64.encode(bytes) to count + } + + /** + * Requires supported encoded formats and native budgeted content validation before accepting a frame. + * @param bytes Already-admitted encoded image bytes. + * @param canBeEmpty Whether a missing original input is allowed. + * @author Dmitriy Moroz + */ + private fun validateImage(bytes: ByteArray, canBeEmpty: Boolean) { + if (bytes.isEmpty() && canBeEmpty) return + require(bytes.size in 12..budget.maxEncodedBytes) { "Invalid image payload" } + val isPng = bytes.take(8) == listOf(137, 80, 78, 71, 13, 10, 26, 10).map(Int::toByte) + val isJpeg = + bytes[0] == 0xff.toByte() && bytes[1] == 0xd8.toByte() && bytes[2] == 0xff.toByte() + val isWebp = bytes.copyOfRange(0, 4).decodeToString() == "RIFF" && bytes.copyOfRange(8, 12) + .decodeToString() == "WEBP" + require(isPng || isJpeg || isWebp) { "Unsupported image payload" } + imageValidator(bytes) + } + +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/GalleryBackupCodec.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/GalleryBackupCodec.kt new file mode 100644 index 000000000..b85c34b13 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/GalleryBackupCodec.kt @@ -0,0 +1,27 @@ +package com.shifthackz.aisdv1.feature.backup.codec + +import okio.BufferedSink +import okio.BufferedSource +import com.shifthackz.aisdv1.storage.db.persistent.entity.GenerationResultEntity + +/** + * Frames gallery metadata and validated image bytes without carrying source database identities. + * @author Dmitriy Moroz + */ +internal interface GalleryBackupCodec { + /** + * Writes one metadata record and its binary output/input images without serializing local row identity. + * @param sink Section writer owned by the export operation. + * @param row Saved gallery row from a consistent database snapshot. + * @author Dmitriy Moroz + */ + fun write(sink: BufferedSink, row: GenerationResultEntity) + + /** + * Decodes and validates one row with a fresh destination ID/revision; unknown generation types are skipped. + * @param source Bounded gallery section reader. + * @param revision Fresh destination image revision unrelated to archived identity. + * @author Dmitriy Moroz + */ + fun read(source: BufferedSource, revision: String): GenerationResultEntity? +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/GalleryBackupRecord.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/GalleryBackupRecord.kt new file mode 100644 index 000000000..c8b98bed7 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/GalleryBackupRecord.kt @@ -0,0 +1,46 @@ +package com.shifthackz.aisdv1.feature.backup.codec + +import kotlinx.serialization.Serializable +import kotlinx.serialization.SerialName + +/** + * Portable image metadata. Images are separate binary frames; local IDs, revisions and transient guards are never serialized. + * @param createdAt Original creation time in epoch milliseconds. + * @param generationType Stable txt2img/img2img discriminator; future values are skipped. + * @param prompt Original positive generation prompt. + * @param negativePrompt Original negative generation prompt. + * @param width Positive output width in pixels. + * @param height Positive output height in pixels. + * @param samplingSteps Recorded sampling steps, including zero for providers that do not expose a sampler. + * @param cfgScale Finite guidance scale recorded by generation. + * @param isRestoreFaces Whether face restoration was requested. + * @param sampler Recorded sampler identifier; an empty value is preserved. + * @param seed Original textual seed without numeric reinterpretation. + * @param subSeed Original textual variation seed. + * @param subSeedStrength Finite variation strength recorded by generation. + * @param denoisingStrength Finite image-to-image denoising strength. + * @param isHidden Whether the history item is hidden from the gallery. + * @param isLiked Whether the history item is marked as a favorite. + * @param modelName Original generation model name without requiring that model on the destination. + * @author Dmitriy Moroz + */ +@Serializable +internal data class GalleryBackupRecord( + val createdAt: Long = 0, + val generationType: String = "txt2img", + val prompt: String = "", + val negativePrompt: String = "", + val width: Int = 512, + val height: Int = 512, + val samplingSteps: Int = 20, + val cfgScale: Float = 7f, + @SerialName("restoreFaces") val isRestoreFaces: Boolean = false, + val sampler: String = "", + val seed: String = "", + val subSeed: String = "", + val subSeedStrength: Float = 0f, + val denoisingStrength: Float = 0f, + @SerialName("hidden") val isHidden: Boolean = false, + @SerialName("liked") val isLiked: Boolean = false, + val modelName: String = "", +) diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/di/BackupModule.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/di/BackupModule.kt new file mode 100644 index 000000000..5efe4ba15 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/di/BackupModule.kt @@ -0,0 +1,177 @@ +package com.shifthackz.aisdv1.feature.backup.di + +import com.shifthackz.aisdv1.feature.backup.archive.BackupArchiveStore +import com.shifthackz.aisdv1.feature.backup.archive.BackupStagingCleaner +import com.shifthackz.aisdv1.feature.backup.archive.DefaultBackupStagingCleaner +import com.shifthackz.aisdv1.feature.backup.archive.DefaultBackupArchiveStore +import com.shifthackz.aisdv1.feature.backup.codec.BackupArchiveCodec +import com.shifthackz.aisdv1.feature.backup.codec.BinaryBackupArchiveCodec +import com.shifthackz.aisdv1.feature.backup.codec.BackupPreferencesCodec +import com.shifthackz.aisdv1.feature.backup.codec.DefaultBackupPreferencesCodec +import com.shifthackz.aisdv1.feature.backup.codec.GalleryBackupCodec +import com.shifthackz.aisdv1.feature.backup.codec.DefaultGalleryBackupCodec +import com.shifthackz.aisdv1.feature.backup.restore.BackupProviderPlanner +import com.shifthackz.aisdv1.feature.backup.restore.DefaultBackupProviderPlanner +import com.shifthackz.aisdv1.feature.backup.restore.BackupRestoreGuard +import com.shifthackz.aisdv1.feature.backup.restore.DefaultBackupRestoreGuard +import com.shifthackz.aisdv1.feature.backup.restore.BackupRestoreWriter +import com.shifthackz.aisdv1.feature.backup.restore.RoomBackupRestoreWriter +import com.shifthackz.aisdv1.feature.backup.restore.BackupSessionCodec +import com.shifthackz.aisdv1.feature.backup.restore.DefaultBackupSessionCodec +import com.shifthackz.aisdv1.domain.usecase.backup.LoadBackupInventoryUseCase +import com.shifthackz.aisdv1.feature.backup.usecase.LoadBackupInventoryUseCaseImpl +import com.shifthackz.aisdv1.domain.usecase.backup.CreateBackupUseCase +import com.shifthackz.aisdv1.feature.backup.usecase.CreateBackupUseCaseImpl +import com.shifthackz.aisdv1.domain.usecase.backup.InspectBackupUseCase +import com.shifthackz.aisdv1.feature.backup.usecase.InspectBackupUseCaseImpl +import com.shifthackz.aisdv1.domain.usecase.backup.RestoreBackupUseCase +import com.shifthackz.aisdv1.feature.backup.usecase.RestoreBackupUseCaseImpl +import com.shifthackz.aisdv1.domain.usecase.backup.ExportBackupUseCase +import com.shifthackz.aisdv1.feature.backup.usecase.ExportBackupUseCaseImpl +import com.shifthackz.aisdv1.domain.usecase.backup.DiscardBackupUseCase +import com.shifthackz.aisdv1.feature.backup.usecase.DiscardBackupUseCaseImpl +import com.shifthackz.aisdv1.domain.usecase.backup.GetBackupStartupStageUseCase +import com.shifthackz.aisdv1.feature.backup.usecase.GetBackupStartupStageUseCaseImpl +import com.shifthackz.aisdv1.domain.usecase.backup.SetBackupStartupStageUseCase +import com.shifthackz.aisdv1.feature.backup.usecase.SetBackupStartupStageUseCaseImpl +import com.shifthackz.aisdv1.domain.usecase.backup.LoadPendingBackupUseCase +import com.shifthackz.aisdv1.feature.backup.usecase.LoadPendingBackupUseCaseImpl +import kotlinx.serialization.json.Json +import org.koin.core.module.Module +import org.koin.core.qualifier.named +import com.shifthackz.aisdv1.domain.gateway.GenerationRestoreGate +import com.shifthackz.aisdv1.feature.backup.restore.DefaultGenerationRestoreGate +import com.shifthackz.aisdv1.domain.usecase.backup.CompleteBackupExportUseCase +import com.shifthackz.aisdv1.feature.backup.usecase.CompleteBackupExportUseCaseImpl +import com.shifthackz.aisdv1.domain.usecase.backup.ObserveBackupExportUseCase +import com.shifthackz.aisdv1.feature.backup.usecase.ObserveBackupExportUseCaseImpl +import com.shifthackz.aisdv1.domain.usecase.backup.CancelBackupExportUseCase +import com.shifthackz.aisdv1.feature.backup.usecase.CancelBackupExportUseCaseImpl +import com.shifthackz.aisdv1.domain.usecase.backup.DismissBackupExportUseCase +import com.shifthackz.aisdv1.feature.backup.usecase.DismissBackupExportUseCaseImpl +import com.shifthackz.aisdv1.domain.usecase.backup.GetPendingBackupExportUseCase +import com.shifthackz.aisdv1.feature.backup.usecase.GetPendingBackupExportUseCaseImpl +import com.shifthackz.aisdv1.feature.backup.export.BackupExportCoordinator +import com.shifthackz.aisdv1.feature.backup.export.DefaultBackupExportCoordinator +import org.koin.dsl.module +import org.koin.dsl.onClose + +/** + * Installs platform file transport behind the same common backup contracts on both targets. + * @author Dmitriy Moroz + */ +internal expect val backupPlatformModule: Module + +/** + * Registers backup implementations without exposing feature dependencies to presentation leaves. + * @author Dmitriy Moroz + */ +val backupModule = module { + includes(backupPlatformModule) + single { DefaultGenerationRestoreGate() } + single(named("backupJson")) { Json { ignoreUnknownKeys = true; encodeDefaults = true } } + single { BinaryBackupArchiveCodec(get(named("backupJson"))) } + single { DefaultBackupPreferencesCodec(get(named("backupJson"))) } + single { + DefaultGalleryBackupCodec( + get(), + get(named("backupJson")), + get(), + get() + ) + } + single { DefaultBackupRestoreGuard() } + single { DefaultBackupProviderPlanner(get()) } + single { DefaultBackupSessionCodec(get(named("backupJson"))) } + single { + RoomBackupRestoreWriter( + get(), + get(), + get(), + get(), + get(named("backupJson")) + ) + } + single { DefaultBackupStagingCleaner(get(), get(), get()) } + single { + DefaultBackupArchiveStore( + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get(named("backupJson")), + get() + ) + } + factory { LoadBackupInventoryUseCaseImpl(get(), get()) } + single { + DefaultBackupExportCoordinator( + get(), + get(), + get(), + get() + ) + } onClose { it?.close() } + factory { CompleteBackupExportUseCaseImpl(get()) } + factory { ObserveBackupExportUseCaseImpl(get()) } + factory { CancelBackupExportUseCaseImpl(get()) } + factory { DismissBackupExportUseCaseImpl(get()) } + factory { GetPendingBackupExportUseCaseImpl(get(), get()) } + factory { CreateBackupUseCaseImpl(get(), get()) } + factory { InspectBackupUseCaseImpl(get(), get()) } + factory { ExportBackupUseCaseImpl(get(), get()) } + factory { GetBackupStartupStageUseCaseImpl(get()) } + factory { SetBackupStartupStageUseCaseImpl(get()) } + factory { + LoadPendingBackupUseCaseImpl( + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get() + ) + } + factory { + DiscardBackupUseCaseImpl( + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get() + ) + } + factory { + RestoreBackupUseCaseImpl( + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get() + ) + } +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/export/BackupExportCoordinator.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/export/BackupExportCoordinator.kt new file mode 100644 index 000000000..45254a363 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/export/BackupExportCoordinator.kt @@ -0,0 +1,56 @@ +package com.shifthackz.aisdv1.feature.backup.export + +import com.shifthackz.aisdv1.domain.entity.backup.BackupExport +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportCompletion +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportOperation +import com.shifthackz.aisdv1.domain.entity.backup.BackupProgress +import com.shifthackz.aisdv1.domain.entity.backup.BackupSelection +import kotlinx.coroutines.flow.StateFlow + +/** + * Owns one process-scoped export; native callbacks are serialized independently from screen lifetimes. + * @author Dmitriy Moroz + */ +internal interface BackupExportCoordinator { + /** + * Creates or resumes a staged source and persists association before native picker presentation. + * @param selection Explicit data selection when creating a new source. + * @param progress Bounded source-creation progress. + * @author Dmitriy Moroz + */ + suspend fun prepare( + selection: BackupSelection, + progress: (BackupProgress) -> Unit + ): BackupExport + + /** + * Observes nonsecret pending/completed operation state across composition recreation. + * @author Dmitriy Moroz + */ + fun observe(): StateFlow + + /** + * Queues a native result even while screen initialization is running. + * @param completion Destination or native completion/cancellation outcome. + * @author Dmitriy Moroz + */ + fun submit(completion: BackupExportCompletion) + + /** + * Cancels only the currently active copy, preserving its source and explicit retry state. + * @author Dmitriy Moroz + */ + fun cancel() + + /** + * Acknowledges the current export before releasing its app-owned staged source. + * @author Dmitriy Moroz + */ + suspend fun dismiss() + + /** + * Closes the process owner when its Koin graph is stopped; durable intent remains recoverable. + * @author Dmitriy Moroz + */ + fun close() +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/export/DefaultBackupExportCoordinator.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/export/DefaultBackupExportCoordinator.kt new file mode 100644 index 000000000..de1788aff --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/export/DefaultBackupExportCoordinator.kt @@ -0,0 +1,216 @@ +package com.shifthackz.aisdv1.feature.backup.export + +import com.shifthackz.aisdv1.core.common.schedulers.DispatchersProvider +import com.shifthackz.aisdv1.domain.entity.backup.BackupExport +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportCompletion +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportIntent +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportOperation +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportStatus +import com.shifthackz.aisdv1.domain.entity.backup.BackupProgress +import com.shifthackz.aisdv1.domain.entity.backup.BackupSelection +import com.shifthackz.aisdv1.domain.gateway.backup.BackupExportStateStore +import com.shifthackz.aisdv1.domain.usecase.backup.ExportBackupUseCase +import com.shifthackz.aisdv1.feature.backup.archive.BackupArchiveStore +import kotlinx.coroutines.CancellationException +import kotlinx.coroutines.CoroutineScope +import kotlinx.coroutines.Job +import kotlinx.coroutines.NonCancellable +import kotlinx.coroutines.SupervisorJob +import kotlinx.coroutines.cancel +import kotlinx.coroutines.currentCoroutineContext +import kotlinx.coroutines.job +import kotlinx.coroutines.launch +import kotlinx.coroutines.withContext +import kotlinx.coroutines.flow.MutableStateFlow +import kotlinx.coroutines.flow.StateFlow +import kotlinx.coroutines.flow.asStateFlow +import kotlinx.coroutines.flow.update +import kotlinx.coroutines.sync.Mutex +import kotlinx.coroutines.sync.withLock + +/** + * Keeps destination copying and its durable association alive when a screen/activity is recreated. + * @param archives Strict app-owned archive creation, source resolution and cleanup. + * @param records Dedicated checked nonsecret operation persistence. + * @param export Strict complete-byte destination writer. + * @param dispatchers Application IO dispatcher owned by this graph-scoped coordinator. + * @author Dmitriy Moroz + */ +internal class DefaultBackupExportCoordinator( + private val archives: BackupArchiveStore, + private val records: BackupExportStateStore, + private val export: ExportBackupUseCase, + private val dispatchers: DispatchersProvider, +) : BackupExportCoordinator { + private val scope = CoroutineScope(SupervisorJob() + dispatchers.io) + private val serialization = Mutex() + private val operation = MutableStateFlow(BackupExportOperation()) + private val queuedResults = MutableStateFlow(0) + private val copyingJob = MutableStateFlow(null) + + init { + scope.launch { + serialization.withLock { + try { + records.recoverPendingWrite() + val intent = records.read() + if (intent != null) { + if (intent.status == BackupExportStatus.COPYING && intent.destination != null) copy( + intent + ) + else publish(intent) + } + } catch (cancelled: CancellationException) { + throw cancelled + } catch (_: Exception) { + operation.value = BackupExportOperation(BackupExportStatus.FAILED) + } + } + } + } + + override suspend fun prepare( + selection: BackupSelection, + progress: (BackupProgress) -> Unit + ): BackupExport = withContext(dispatchers.io) { + serialization.withLock { + records.recoverPendingWrite() + records.read()?.let { + return@withLock publish(it).backup ?: error("Pending backup source is unavailable") + } + val backup = archives.create(selection, progress) + val intent = BackupExportIntent(backup.handle, backup.filename) + // Never delete this source on a failed checked write: its quarantined intent can be retried. + records.write(intent) + publish(intent) + backup + } + } + + override fun observe(): StateFlow = operation.asStateFlow() + + override fun submit(completion: BackupExportCompletion) { + queuedResults.update { it + 1 } + operation.value = operation.value.copy(status = BackupExportStatus.PROCESSING) + scope.launch { + serialization.withLock { + var hasFailed = false + try { + records.recoverPendingWrite() + val intent = + checkNotNull(records.read()) { "No staged export owns this document result" } + if (intent.handle != completion.handle) { + publish(intent) + return@withLock + } + when (completion) { + is BackupExportCompletion.DestinationSelected -> { + require(completion.document.isNotBlank()) { "Empty backup destination" } + // A fresh picker can truncate even a previously completed destination URI. + copy( + intent.copy( + destination = completion.document + ) + ) + } + + is BackupExportCompletion.NativeCompleted -> { + val complete = intent.copy(status = BackupExportStatus.COMPLETE) + records.write(complete) + publish(complete) + } + + is BackupExportCompletion.Canceled -> if (intent.status != BackupExportStatus.COMPLETE) dismissLocked( + intent + ) + } + } catch (cancelled: CancellationException) { + throw cancelled + } catch (_: Exception) { + hasFailed = true + operation.value = operation.value.copy(status = BackupExportStatus.FAILED) + } finally { + queuedResults.update { it - 1 } + if (queuedResults.value == 0) { + try { + val current = records.read() + if (current == null) operation.value = + BackupExportOperation(if (hasFailed) BackupExportStatus.FAILED else BackupExportStatus.NONE) + else { + publish(current) + if (hasFailed) operation.value = + operation.value.copy(status = BackupExportStatus.FAILED) + } + } catch (_: Exception) { + operation.value = + operation.value.copy(status = BackupExportStatus.FAILED) + } + } + } + } + } + } + + private suspend fun copy(intent: BackupExportIntent) { + val backup = archives.preparedExport(intent.handle, intent.filename) + val destination = checkNotNull(intent.destination) { "Missing backup destination" } + val copying = intent.copy(status = BackupExportStatus.COPYING) + withContext(NonCancellable) { records.write(copying) } + operation.value = BackupExportOperation(BackupExportStatus.COPYING, backup) + val owner = currentCoroutineContext().job + copyingJob.value = owner + try { + export(backup.document, destination) + withContext(NonCancellable) { + val completed = copying.copy(status = BackupExportStatus.COMPLETE) + records.write(completed) + publish(completed) + } + } catch (cancelled: CancellationException) { + withContext(NonCancellable) { + val canceled = copying.copy(status = BackupExportStatus.CANCELED) + records.write(canceled) + publish(canceled) + } + throw cancelled + } catch (failure: Exception) { + withContext(NonCancellable) { + val failed = copying.copy(status = BackupExportStatus.FAILED) + records.write(failed) + publish(failed) + } + throw failure + } finally { + if (copyingJob.value === owner) copyingJob.value = null + } + } + + override fun cancel() { + copyingJob.value?.cancel() + } + + override suspend fun dismiss() = withContext(dispatchers.io) { + serialization.withLock { + records.recoverPendingWrite() + records.read()?.let { dismissLocked(it) } + Unit + } + } + + private fun dismissLocked(intent: BackupExportIntent) { + records.clear() + operation.value = + BackupExportOperation(if (queuedResults.value > 0) BackupExportStatus.PROCESSING else BackupExportStatus.NONE) + archives.discard(intent.handle) + } + + private fun publish(intent: BackupExportIntent): BackupExportOperation = + BackupExportOperation( + if (queuedResults.value > 0) BackupExportStatus.PROCESSING else intent.status, + archives.preparedExport(intent.handle, intent.filename) + ).also { operation.value = it } + + override fun close() { + scope.cancel() + } +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.kt new file mode 100644 index 000000000..9ef58a1d4 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.kt @@ -0,0 +1,60 @@ +package com.shifthackz.aisdv1.feature.backup.io + +import okio.Path +import okio.BufferedSource +import okio.BufferedSink + +/** + * Private durable archive staging and native document transport. User-selected sources are never deleted. + * @author Dmitriy Moroz + */ +internal interface BackupFileStore { + val root: Path + + /** + * Creates an escaped native file URL for a private completed archive. + * @param path App-owned private archive path. + * @author Dmitriy Moroz + */ + fun documentReference(path: Path): String + + /** + * Resolves a private native file URL without treating its encoded path as display text. + * @param reference Native file reference; non-file schemes are rejected. + * @author Dmitriy Moroz + */ + fun documentPath(reference: String): Path + /** + * Returns a fresh UUID used only for private staging, sessions or imported revisions. + * @author Dmitriy Moroz + */ + /** + * Reads only the display filename of a selected source, never its full storage path. + * @param document Native user-selected source reference. + * @author Dmitriy Moroz + */ + fun documentName(document: String): String + + /** Returns a fresh UUID for app-owned staging, sessions or imported image revisions. @author Dmitriy Moroz */ + fun newId(): String + + /** + * Opens a read-granted native document stream; caller closes it after private staging. + * @param document Native URI or sandbox-copy URL selected by the user. + * @author Dmitriy Moroz + */ + fun openDocument(document: String): BufferedSource + + /** + * Opens the user-selected destination for complete export; failures propagate. + * @param document Native write-granted document reference. + * @author Dmitriy Moroz + */ + fun writeDocument(document: String): BufferedSink + + /** + * Returns current private-filesystem free bytes for bounded staging admission. + * @author Dmitriy Moroz + */ + fun availableBytes(): Long +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupProviderPlan.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupProviderPlan.kt new file mode 100644 index 000000000..3631c7d97 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupProviderPlan.kt @@ -0,0 +1,23 @@ +package com.shifthackz.aisdv1.feature.backup.restore + +import com.shifthackz.aisdv1.domain.entity.backup.BackupValue +import com.shifthackz.aisdv1.domain.feature.auth.AuthorizationCredentials + +/** + * Immutable selective provider merge prepared under the provider transition guard. + * @param providers Portable independent field replacements. + * @param credentials Shared Basic Auth replacement, or null to retain destination credentials. + * @param conflicts Configured providers whose existing values would change. + * @param fingerprint Opaque consent revision binding both source and destination. + * @param skippedCount Credential fields omitted to preserve unselected configured providers. + * @param retainedCredentialProviders Unselected configured providers that prevented shared credential replacement. + * @author Dmitriy Moroz + */ +internal data class BackupProviderPlan( + val providers: Map>, + val credentials: AuthorizationCredentials?, + val conflicts: Set, + val fingerprint: String, + val skippedCount: Int, + val retainedCredentialProviders: Set = emptySet(), +) diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupProviderPlanner.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupProviderPlanner.kt new file mode 100644 index 000000000..ecb0e5669 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupProviderPlanner.kt @@ -0,0 +1,26 @@ +package com.shifthackz.aisdv1.feature.backup.restore + +import com.shifthackz.aisdv1.domain.entity.backup.BackupPreferences +import com.shifthackz.aisdv1.domain.entity.backup.BackupSelection +import com.shifthackz.aisdv1.domain.feature.auth.AuthorizationCredentials + +/** + * Determines provider conflicts and shared-credential eligibility without mutating storage. + * @author Dmitriy Moroz + */ +internal interface BackupProviderPlanner { + /** + * Builds a presence-aware selective merge and consent fingerprint without changing stored data. + * @param current Destination portable settings with persisted presence. + * @param incoming Supported archive fields including selected portable Basic Auth. + * @param selection Explicitly selected provider children. + * @param credentials Trusted destination Basic Auth snapshot used to protect other consumers. + * @author Dmitriy Moroz + */ + fun plan( + current: BackupPreferences, + incoming: BackupPreferences, + selection: BackupSelection, + credentials: AuthorizationCredentials + ): BackupProviderPlan +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupRestoreGuard.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupRestoreGuard.kt new file mode 100644 index 000000000..bb0221685 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupRestoreGuard.kt @@ -0,0 +1,14 @@ +package com.shifthackz.aisdv1.feature.backup.restore + +/** + * Serializes restore operations across screens and recovery entry points. + * @author Dmitriy Moroz + */ +internal interface BackupRestoreGuard { + /** + * Runs one restore or staging-discard operation at a time; cancellation while waiting propagates. + * @param block Complete operation that owns private staging and journal transitions. + * @author Dmitriy Moroz + */ + suspend fun exclusive(block: suspend () -> T): T +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupRestoreWriter.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupRestoreWriter.kt new file mode 100644 index 000000000..18a2fbd61 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupRestoreWriter.kt @@ -0,0 +1,31 @@ +package com.shifthackz.aisdv1.feature.backup.restore + +import com.shifthackz.aisdv1.feature.backup.archive.StagedBackup +import com.shifthackz.aisdv1.domain.entity.backup.BackupProgress + +/** + * Strict additive Room writes; each category and its ledger marker commit together. + * @author Dmitriy Moroz + */ +internal interface BackupRestoreWriter { + /** + * Allocates fresh IDs and imports gallery rows with their section marker in one Room transaction. + * @param sessionId Stable restore retry identity. + * @param archive Validated immutable staged archive. + * @param progress Processed-row progress; completion is acknowledged only after commit. + * @author Dmitriy Moroz + */ + suspend fun gallery( + sessionId: String, + archive: StagedBackup, + progress: (BackupProgress) -> Unit + ) + + /** + * Adds checked known byte buckets and their section marker atomically, never resetting existing counters. + * @param sessionId Stable restore retry identity. + * @param archive Validated immutable staged archive. + * @author Dmitriy Moroz + */ + suspend fun network(sessionId: String, archive: StagedBackup) +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupSessionCodec.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupSessionCodec.kt new file mode 100644 index 000000000..cae34ebbf --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupSessionCodec.kt @@ -0,0 +1,23 @@ +package com.shifthackz.aisdv1.feature.backup.restore + +import com.shifthackz.aisdv1.domain.entity.backup.BackupSelection + +/** + * Typed BackupSessionCodec operations used by backup orchestration and implementations. + * @author Dmitriy Moroz + */ +internal interface BackupSessionCodec { + /** + * Produces deterministic nonsecret selection JSON for binding a retry session to its original choices. + * @param selection Selected category/provider IDs only. + * @author Dmitriy Moroz + */ + fun encode(selection: BackupSelection): String + + /** + * Restores known category/provider identifiers from the journal; unknown categories are ignored. + * @param value Persisted nonsecret selection JSON. + * @author Dmitriy Moroz + */ + fun decode(value: String): BackupSelection +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupProviderPlanner.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupProviderPlanner.kt new file mode 100644 index 000000000..deb4ec8e5 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupProviderPlanner.kt @@ -0,0 +1,90 @@ +package com.shifthackz.aisdv1.feature.backup.restore + +import com.shifthackz.aisdv1.domain.entity.backup.BackupPreferences +import com.shifthackz.aisdv1.domain.entity.backup.BackupSelection +import com.shifthackz.aisdv1.domain.entity.backup.BackupValue +import com.shifthackz.aisdv1.domain.feature.auth.AuthorizationCredentials +import com.shifthackz.aisdv1.feature.backup.codec.BackupPreferencesCodec +import okio.ByteString.Companion.encodeUtf8 + +/** + * Preserves absent fields and every unselected provider, including shared Basic Auth consumers. + * @param codec Deterministic portable preference encoding for opaque consent fingerprints. + * @author Dmitriy Moroz + */ +internal class DefaultBackupProviderPlanner(private val codec: BackupPreferencesCodec) : + BackupProviderPlanner { + override fun plan( + current: BackupPreferences, + incoming: BackupPreferences, + selection: BackupSelection, + credentials: AuthorizationCredentials + ): BackupProviderPlan { + val selected = incoming.providers.filterKeys { it in selection.providers } + val conflicts = mutableSetOf() + val fields = selected.mapValues { (provider, values) -> + values.filterKeys { it !in BASIC_FIELDS }.also { changes -> + val existing = current.providers[provider].orEmpty() + if (changes.any { (key, value) -> existing.containsKey(key) && existing[key] != value }) conflicts += provider + } + } + val credentialValues = + selected.filterKeys { it in BASIC_PROVIDERS }.values.map { it.filterKeys { key -> key in BASIC_FIELDS } } + .filter { it.isNotEmpty() }.distinct() + require(credentialValues.size <= 1) { "Conflicting shared Basic Auth records" } + val incomingBasic = credentialValues.firstOrNull() + val affected = current.providers.keys.intersect(BASIC_PROVIDERS) + var replacement: AuthorizationCredentials? = null + var skipped = 0 + var retainedCredentialProviders = emptySet() + if (incomingBasic != null) { + if (!selection.providers.containsAll(affected)) { + skipped += incomingBasic.size + retainedCredentialProviders = affected - selection.providers + } else { + val old = credentials as? AuthorizationCredentials.HttpBasic + val login = (incomingBasic["basicLogin"] as? BackupValue.Text)?.value + ?: old?.login.orEmpty() + val password = (incomingBasic["basicPassword"] as? BackupValue.Text)?.value + ?: old?.password.orEmpty() + val candidate = AuthorizationCredentials.HttpBasic(login, password) + if (candidate != credentials) { + replacement = candidate + if (credentials !is AuthorizationCredentials.None) conflicts += affected.ifEmpty { + selected.keys.intersect( + BASIC_PROVIDERS + ) + } + } + } + } + val credentialSnapshot = when (credentials) { + AuthorizationCredentials.None -> emptyMap() + is AuthorizationCredentials.HttpBasic -> mapOf( + "login" to BackupValue.Text(credentials.login), + "password" to BackupValue.Text(credentials.password) + ) + } + val fingerprint = (codec.encodeProviders( + current.providers.filterKeys { it in selection.providers }.toList() + .sortedBy { it.first }.toMap() + .mapValues { it.value.toList().sortedBy { it.first }.toMap() }) + + codec.encodeProviders( + selected.toList().sortedBy { it.first }.toMap().mapValues { + it.value.toList().sortedBy { it.first }.toMap() + }) + codec.encode(credentialSnapshot)).encodeUtf8().sha256().hex() + return BackupProviderPlan( + fields, + replacement, + conflicts, + fingerprint, + skipped, + retainedCredentialProviders + ) + } + + private companion object { + val BASIC_PROVIDERS = setOf("custom", "swarm_ui") + val BASIC_FIELDS = setOf("basicLogin", "basicPassword") + } +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupRestoreGuard.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupRestoreGuard.kt new file mode 100644 index 000000000..ede073c30 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupRestoreGuard.kt @@ -0,0 +1,13 @@ +package com.shifthackz.aisdv1.feature.backup.restore + +import kotlinx.coroutines.sync.Mutex +import kotlinx.coroutines.sync.withLock + +/** + * Owns one process-wide restore lock; no user-data work escapes its operation scope. + * @author Dmitriy Moroz + */ +internal class DefaultBackupRestoreGuard : BackupRestoreGuard { + private val mutex = Mutex() + override suspend fun exclusive(block: suspend () -> T): T = mutex.withLock { block() } +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupSessionCodec.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupSessionCodec.kt new file mode 100644 index 000000000..ac42d73ba --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupSessionCodec.kt @@ -0,0 +1,26 @@ +package com.shifthackz.aisdv1.feature.backup.restore + +import com.shifthackz.aisdv1.domain.entity.backup.BackupSelection +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory +import kotlinx.serialization.encodeToString +import kotlinx.serialization.json.Json + +/** + * Encodes journal selection IDs only; no credentials or application payloads enter the restore ledger. + * @param json Serializer for nonsecret selection lists. + * @author Dmitriy Moroz + */ +internal class DefaultBackupSessionCodec(private val json: Json) : BackupSessionCodec { + override fun encode(selection: BackupSelection): String = json.encodeToString( + mapOf( + "categories" to selection.categories.map { it.key }.sorted(), + "providers" to selection.providers.sorted(), + ) + ) + + override fun decode(value: String): BackupSelection { + val entries = json.decodeFromString>>(value) + return BackupSelection(BackupCategory.entries.filter { it.key in entries["categories"].orEmpty() } + .toSet(), entries["providers"].orEmpty().toSet()) + } +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultGenerationRestoreGate.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultGenerationRestoreGate.kt new file mode 100644 index 000000000..55147cc8d --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultGenerationRestoreGate.kt @@ -0,0 +1,49 @@ +package com.shifthackz.aisdv1.feature.backup.restore + +import com.shifthackz.aisdv1.domain.gateway.GenerationRestoreGate + +import kotlinx.coroutines.CompletableDeferred +import kotlinx.coroutines.NonCancellable +import kotlinx.coroutines.withContext +import kotlinx.coroutines.sync.Mutex +import kotlinx.coroutines.sync.withLock + +/** + * Allows existing concurrent generation while admitting restore only when every generation owner is idle. + * New generation waits cancellably while restore owns the exclusive transition. + * @author Dmitriy Moroz + */ +internal class DefaultGenerationRestoreGate : GenerationRestoreGate { + private val state = Mutex() + private var activeGenerations = 0 + private var restoration: CompletableDeferred? = null + + override suspend fun generating(block: suspend () -> T): T { + while (true) { + val pendingRestore = state.withLock { + restoration.also { if (it == null) activeGenerations++ } + } + if (pendingRestore == null) break + pendingRestore.await() + } + return try { + block() + } finally { + withContext(NonCancellable) { state.withLock { activeGenerations-- } } + } + } + + override suspend fun restoring(block: suspend () -> T): T { + state.withLock { + check(activeGenerations == 0 && restoration == null) { "Wait for generation to finish before restoring" } + restoration = CompletableDeferred() + } + return try { + block() + } finally { + withContext(NonCancellable) { + state.withLock { restoration?.complete(Unit); restoration = null } + } + } + } +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriter.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriter.kt new file mode 100644 index 000000000..a14283e98 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriter.kt @@ -0,0 +1,108 @@ +package com.shifthackz.aisdv1.feature.backup.restore + +import okio.use +import com.shifthackz.aisdv1.domain.entity.NetworkUsageBucket +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory +import com.shifthackz.aisdv1.domain.entity.backup.BackupProgress +import com.shifthackz.aisdv1.feature.backup.archive.StagedBackup +import com.shifthackz.aisdv1.feature.backup.codec.BackupArchiveCodec +import com.shifthackz.aisdv1.feature.backup.codec.GalleryBackupCodec +import com.shifthackz.aisdv1.feature.backup.io.BackupFileStore +import com.shifthackz.aisdv1.storage.gateway.BackupStorage +import com.shifthackz.aisdv1.storage.db.persistent.entity.RestoreSectionEntity +import kotlinx.coroutines.currentCoroutineContext +import kotlinx.coroutines.ensureActive +import kotlinx.serialization.json.Json + +/** + * Imports directly into Room, avoiding generation-save auto-export and preserving all existing rows. + * @param database Destination database and category commit ledger. + * @param codec Validated length-delimited section reader. + * @param galleryCodec Per-image metadata and binary image decoder. + * @param files Fresh imported image revision identities. + * @param json Typed network counter decoder. + * @author Dmitriy Moroz + */ +internal class RoomBackupRestoreWriter( + private val database: BackupStorage, + private val codec: BackupArchiveCodec, + private val galleryCodec: GalleryBackupCodec, + private val files: BackupFileStore, + private val json: Json, +) : BackupRestoreWriter { + override suspend fun gallery( + sessionId: String, + archive: StagedBackup, + progress: (BackupProgress) -> Unit + ) { + val descriptor = archive.manifest.sections.single { it.id == "gallery" } + var committedCount: Long? = null + database.writeTransaction { + if ("gallery" in database.restoreSessionDao() + .completed(sessionId) + ) return@writeTransaction + var count = 0L + var skipped = 0L + codec.openSection(archive.path, archive.manifest, "gallery").use { source -> + var index = 0L + while (index < descriptor.itemCount) { + currentCoroutineContext().ensureActive() + val row = galleryCodec.read(source, files.newId()) + if (row == null) skipped++ else { + database.generationResultDao().insert(row) + count++ + } + index++ + } + require(source.exhausted()) { "Unexpected gallery payload" } + } + database.restoreSessionDao() + .mark(RestoreSectionEntity(sessionId, "gallery", count, skipped)) + committedCount = count + } + committedCount?.let { + progress( + BackupProgress( + BackupCategory.GALLERY, + it, + descriptor.itemCount + ) + ) + } + } + + override suspend fun network(sessionId: String, archive: StagedBackup) { + val values = codec.openSection(archive.path, archive.manifest, "network").use { source -> + val counters = json.decodeFromString>(codec.readJson(source)) + require(source.exhausted() && counters.values.all { it >= 0 }) { "Invalid network counter" } + counters + } + database.writeTransaction { + if ("network" in database.restoreSessionDao() + .completed(sessionId) + ) return@writeTransaction + val current = database.networkUsageDao().query().associate { it.category to it.bytes } + val supported = values.filterKeys { NetworkUsageBucket.parse(it) != null } + supported.forEach { (key, bytes) -> + val old = current[key] ?: 0 + require(old >= 0 && bytes <= Long.MAX_VALUE - old) { "Network counter overflow" } + } + // Also protect the existing totalBytes aggregate from overflow. + var total = 0L + NetworkUsageBucket.entries.forEach { bucket -> + val bytes = (current[bucket.key] ?: 0) + (supported[bucket.key] ?: 0) + require(bytes >= 0 && bytes <= Long.MAX_VALUE - total) { "Network total overflow" } + total += bytes + } + supported.forEach { (key, bytes) -> database.networkUsageDao().addBytes(key, bytes) } + database.restoreSessionDao().mark( + RestoreSectionEntity( + sessionId, + "network", + supported.size.toLong(), + (values.size - supported.size).toLong() + ) + ) + } + } +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CancelBackupExportUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CancelBackupExportUseCaseImpl.kt new file mode 100644 index 000000000..9c3b74ecf --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CancelBackupExportUseCaseImpl.kt @@ -0,0 +1,15 @@ +package com.shifthackz.aisdv1.feature.backup.usecase + +import com.shifthackz.aisdv1.domain.usecase.backup.CancelBackupExportUseCase +import com.shifthackz.aisdv1.feature.backup.export.BackupExportCoordinator + + +/** + * Interrupts active destination copying while retaining a durable source for an explicit retry. + * @param coordinator Owns durable export association independently from screen lifetimes. + * @author Dmitriy Moroz + */ +internal class CancelBackupExportUseCaseImpl(private val coordinator: BackupExportCoordinator) : + CancelBackupExportUseCase { + override fun invoke(): Unit = coordinator.cancel() +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CompleteBackupExportUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CompleteBackupExportUseCaseImpl.kt new file mode 100644 index 000000000..322b72f45 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CompleteBackupExportUseCaseImpl.kt @@ -0,0 +1,15 @@ +package com.shifthackz.aisdv1.feature.backup.usecase + +import com.shifthackz.aisdv1.domain.usecase.backup.CompleteBackupExportUseCase +import com.shifthackz.aisdv1.feature.backup.export.BackupExportCoordinator +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportCompletion + +/** + * Queues native outcomes through the graph owner, including results delivered before screen initialization. + * @param coordinator Owns durable export association independently from screen lifetimes. + * @author Dmitriy Moroz + */ +internal class CompleteBackupExportUseCaseImpl(private val coordinator: BackupExportCoordinator) : + CompleteBackupExportUseCase { + override fun invoke(completion: BackupExportCompletion): Unit = coordinator.submit(completion) +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CreateBackupUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CreateBackupUseCaseImpl.kt new file mode 100644 index 000000000..f656739e6 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CreateBackupUseCaseImpl.kt @@ -0,0 +1,25 @@ +package com.shifthackz.aisdv1.feature.backup.usecase + +import com.shifthackz.aisdv1.domain.entity.backup.BackupSelection +import com.shifthackz.aisdv1.domain.entity.backup.BackupProgress +import com.shifthackz.aisdv1.domain.entity.backup.BackupExport +import com.shifthackz.aisdv1.domain.usecase.backup.CreateBackupUseCase +import com.shifthackz.aisdv1.feature.backup.export.BackupExportCoordinator +import com.shifthackz.aisdv1.core.common.schedulers.DispatchersProvider +import kotlinx.coroutines.withContext + +/** + * Runs the strict create archive operation on the IO dispatcher. + * @param coordinator Owns source creation and durable association before document presentation. + * @param dispatchers Runs file and database work off the UI thread. + * @author Dmitriy Moroz + */ +internal class CreateBackupUseCaseImpl( + private val coordinator: BackupExportCoordinator, + private val dispatchers: DispatchersProvider +) : CreateBackupUseCase { + override suspend operator fun invoke( + selection: BackupSelection, + onProgress: (BackupProgress) -> Unit + ): BackupExport = withContext(dispatchers.io) { coordinator.prepare(selection, onProgress) } +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/DiscardBackupUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/DiscardBackupUseCaseImpl.kt new file mode 100644 index 000000000..f3fbf940e --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/DiscardBackupUseCaseImpl.kt @@ -0,0 +1,72 @@ +package com.shifthackz.aisdv1.feature.backup.usecase + +import com.shifthackz.aisdv1.core.common.schedulers.DispatchersProvider +import com.shifthackz.aisdv1.domain.entity.backup.BackupStartupStage +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory +import com.shifthackz.aisdv1.domain.gateway.backup.BackupChangesGateway +import com.shifthackz.aisdv1.domain.feature.auth.AuthorizationStore +import com.shifthackz.aisdv1.domain.gateway.backup.BackupPreferencesGateway +import com.shifthackz.aisdv1.domain.gateway.ProviderSelectionGuard +import com.shifthackz.aisdv1.domain.preference.ConfigurationStore +import com.shifthackz.aisdv1.domain.usecase.backup.DiscardBackupUseCase +import com.shifthackz.aisdv1.feature.backup.archive.BackupArchiveStore +import com.shifthackz.aisdv1.feature.backup.restore.BackupRestoreGuard +import com.shifthackz.aisdv1.feature.backup.restore.BackupSessionCodec +import com.shifthackz.aisdv1.storage.gateway.BackupStorage +import kotlinx.coroutines.NonCancellable +import kotlinx.coroutines.withContext + +/** + * Abandons an unfinished operation only after checked configuration/credentials are trusted; removes private staging only. + * @param archives Owns generated private archive paths. + * @param preferences Recovers an already-started checked typed settings batch before startup or abandonment. + * @param database Durable pending intent records. + * @param configuration Checked preference quarantine owner. + * @param authorization Protected Basic Auth recovery owner. + * @param selectionGuard Serializes association recovery before abandonment. + * @param restoreGuard Prevents deletion during active import. + * @param dispatchers Runs cleanup on IO. + * @param sessions Reads category intent when a previous replay committed without a section marker. + * @param changes Refreshes retained preference readers after protected association recovery. + * @author Dmitriy Moroz + */ +internal class DiscardBackupUseCaseImpl( + private val archives: BackupArchiveStore, + private val database: BackupStorage, + private val preferences: BackupPreferencesGateway, + private val configuration: ConfigurationStore, + private val authorization: AuthorizationStore, + private val selectionGuard: ProviderSelectionGuard, + private val restoreGuard: BackupRestoreGuard, + private val dispatchers: DispatchersProvider, + private val sessions: BackupSessionCodec, + private val changes: BackupChangesGateway, +) : DiscardBackupUseCase { + override suspend fun invoke(handle: String) = withContext(dispatchers.io) { + restoreGuard.exclusive { + val pending = + database.restoreSessionDao().pending().filter { it.archiveHandle == handle } + if (pending.isNotEmpty()) selectionGuard.withSelection { + val recovered = pending.flatMap { sessions.decode(it.selection).categories } + .filter { it == BackupCategory.PROVIDERS || it == BackupCategory.SETTINGS } + .toMutableSet() + if (configuration.retryPendingConfiguration()) recovered += BackupCategory.PROVIDERS + recovered += preferences.recoverPendingWrite() + authorization.getAuthorizationCredentials() + withContext(NonCancellable) { changes.notifyChanged(recovered) } + if (pending.any { it.requiresConfiguration } && preferences.readStartupStage() in setOf( + BackupStartupStage.INVITATION, + BackupStartupStage.RESTORE + )) preferences.writeStartupStage( + BackupStartupStage.CONFIGURATION + ) + pending.forEach { + database.restoreSessionDao().finish(it.id) + if (it.requiresConfiguration) database.restoreSessionDao() + .acknowledgeConfiguration(it.id) + } + } + archives.discard(handle) + } + } +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/DismissBackupExportUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/DismissBackupExportUseCaseImpl.kt new file mode 100644 index 000000000..1020beea3 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/DismissBackupExportUseCaseImpl.kt @@ -0,0 +1,14 @@ +package com.shifthackz.aisdv1.feature.backup.usecase + +import com.shifthackz.aisdv1.domain.usecase.backup.DismissBackupExportUseCase +import com.shifthackz.aisdv1.feature.backup.export.BackupExportCoordinator + +/** + * Acknowledges export state before releasing private source ownership. + * @param coordinator Process-owned serialized export lifecycle. + * @author Dmitriy Moroz + */ +internal class DismissBackupExportUseCaseImpl(private val coordinator: BackupExportCoordinator) : + DismissBackupExportUseCase { + override suspend fun invoke() = coordinator.dismiss() +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/ExportBackupUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/ExportBackupUseCaseImpl.kt new file mode 100644 index 000000000..d21cae7fd --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/ExportBackupUseCaseImpl.kt @@ -0,0 +1,21 @@ +package com.shifthackz.aisdv1.feature.backup.usecase + + +import com.shifthackz.aisdv1.domain.usecase.backup.ExportBackupUseCase +import com.shifthackz.aisdv1.feature.backup.archive.BackupArchiveStore +import com.shifthackz.aisdv1.core.common.schedulers.DispatchersProvider +import kotlinx.coroutines.withContext + +/** + * Runs the strict export archive operation on the IO dispatcher. + * @param archives Injected archive framing and staging owner. + * @param dispatchers Runs file and database work off the UI thread. + * @author Dmitriy Moroz + */ +internal class ExportBackupUseCaseImpl( + private val archives: BackupArchiveStore, + private val dispatchers: DispatchersProvider +) : ExportBackupUseCase { + override suspend operator fun invoke(document: String, destination: String): Unit = + withContext(dispatchers.io) { archives.export(document, destination) } +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/GetBackupStartupStageUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/GetBackupStartupStageUseCaseImpl.kt new file mode 100644 index 000000000..3c72aee53 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/GetBackupStartupStageUseCaseImpl.kt @@ -0,0 +1,15 @@ +package com.shifthackz.aisdv1.feature.backup.usecase + +import com.shifthackz.aisdv1.domain.entity.backup.BackupStartupStage +import com.shifthackz.aisdv1.domain.gateway.backup.BackupPreferencesGateway +import com.shifthackz.aisdv1.domain.usecase.backup.GetBackupStartupStageUseCase + +/** + * Persists or reads the durable post-onboarding recovery stage. + * @param preferences Checked stage persistence shared with startup routing. + * @author Dmitriy Moroz + */ +internal class GetBackupStartupStageUseCaseImpl(private val preferences: BackupPreferencesGateway) : + GetBackupStartupStageUseCase { + override operator fun invoke(): BackupStartupStage = preferences.readStartupStage() +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/GetPendingBackupExportUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/GetPendingBackupExportUseCaseImpl.kt new file mode 100644 index 000000000..1cc2ccc82 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/GetPendingBackupExportUseCaseImpl.kt @@ -0,0 +1,22 @@ +package com.shifthackz.aisdv1.feature.backup.usecase + +import com.shifthackz.aisdv1.core.common.schedulers.DispatchersProvider +import com.shifthackz.aisdv1.domain.gateway.backup.BackupExportStateStore +import com.shifthackz.aisdv1.domain.usecase.backup.GetPendingBackupExportUseCase +import kotlinx.coroutines.withContext + +/** + * Routes durable pending or completed export outcomes back to the dedicated backup screen. + * @param records Checked nonsecret export association. + * @param dispatchers Keeps preference recovery on IO. + * @author Dmitriy Moroz + */ +internal class GetPendingBackupExportUseCaseImpl( + private val records: BackupExportStateStore, + private val dispatchers: DispatchersProvider +) : GetPendingBackupExportUseCase { + override suspend fun invoke(): Boolean = withContext(dispatchers.io) { + records.recoverPendingWrite() + records.read() != null + } +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/InspectBackupUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/InspectBackupUseCaseImpl.kt new file mode 100644 index 000000000..6e42dbc70 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/InspectBackupUseCaseImpl.kt @@ -0,0 +1,24 @@ +package com.shifthackz.aisdv1.feature.backup.usecase + +import com.shifthackz.aisdv1.domain.entity.backup.BackupInspection +import com.shifthackz.aisdv1.domain.entity.backup.BackupProgress +import com.shifthackz.aisdv1.domain.usecase.backup.InspectBackupUseCase +import com.shifthackz.aisdv1.feature.backup.archive.BackupArchiveStore +import com.shifthackz.aisdv1.core.common.schedulers.DispatchersProvider +import kotlinx.coroutines.withContext + +/** + * Runs the strict inspect archive operation on the IO dispatcher. + * @param archives Injected archive framing and staging owner. + * @param dispatchers Runs file and database work off the UI thread. + * @author Dmitriy Moroz + */ +internal class InspectBackupUseCaseImpl( + private val archives: BackupArchiveStore, + private val dispatchers: DispatchersProvider +) : InspectBackupUseCase { + override suspend operator fun invoke( + document: String, + onProgress: (BackupProgress) -> Unit + ): BackupInspection = withContext(dispatchers.io) { archives.inspect(document, onProgress) } +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/LoadBackupInventoryUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/LoadBackupInventoryUseCaseImpl.kt new file mode 100644 index 000000000..ee1f136bb --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/LoadBackupInventoryUseCaseImpl.kt @@ -0,0 +1,21 @@ +package com.shifthackz.aisdv1.feature.backup.usecase + +import com.shifthackz.aisdv1.domain.entity.backup.BackupInspection +import com.shifthackz.aisdv1.domain.usecase.backup.LoadBackupInventoryUseCase +import com.shifthackz.aisdv1.feature.backup.archive.BackupArchiveStore +import com.shifthackz.aisdv1.core.common.schedulers.DispatchersProvider +import kotlinx.coroutines.withContext + +/** + * Runs the strict inventory archive operation on the IO dispatcher. + * @param archives Injected archive framing and staging owner. + * @param dispatchers Runs file and database work off the UI thread. + * @author Dmitriy Moroz + */ +internal class LoadBackupInventoryUseCaseImpl( + private val archives: BackupArchiveStore, + private val dispatchers: DispatchersProvider +) : LoadBackupInventoryUseCase { + override suspend operator fun invoke(): BackupInspection = + withContext(dispatchers.io) { archives.inventory() } +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/LoadPendingBackupUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/LoadPendingBackupUseCaseImpl.kt new file mode 100644 index 000000000..6ddb96d18 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/LoadPendingBackupUseCaseImpl.kt @@ -0,0 +1,86 @@ +package com.shifthackz.aisdv1.feature.backup.usecase + +import com.shifthackz.aisdv1.core.common.schedulers.DispatchersProvider +import com.shifthackz.aisdv1.domain.entity.backup.BackupRecovery +import com.shifthackz.aisdv1.domain.entity.backup.BackupStartupStage +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory +import com.shifthackz.aisdv1.domain.gateway.backup.BackupChangesGateway +import kotlinx.coroutines.NonCancellable +import com.shifthackz.aisdv1.domain.entity.backup.BackupRestoreRequest +import com.shifthackz.aisdv1.domain.feature.auth.AuthorizationStore +import com.shifthackz.aisdv1.domain.gateway.backup.BackupPreferencesGateway +import com.shifthackz.aisdv1.domain.gateway.ProviderSelectionGuard +import com.shifthackz.aisdv1.domain.preference.ConfigurationStore +import com.shifthackz.aisdv1.domain.usecase.backup.LoadPendingBackupUseCase +import com.shifthackz.aisdv1.feature.backup.archive.BackupArchiveStore +import com.shifthackz.aisdv1.feature.backup.archive.BackupStagingCleaner +import com.shifthackz.aisdv1.feature.backup.restore.BackupSessionCodec +import com.shifthackz.aisdv1.storage.gateway.BackupStorage +import kotlinx.coroutines.withContext + +/** + * Recovers checked credential association before exposing the staged unfinished operation. + * @param preferences Recovers an already-started checked typed settings batch before startup or abandonment. + * @param database Restore intent ledger. + * @param archives Revalidates retained private archive bytes. + * @param sessions Decodes nonsecret category/provider selection. + * @param configuration Retries an exact failed checked preference write. + * @param authorization Recovers protected credential association before normal app publication. + * @param guard Serializes recovery with provider transitions. + * @param dispatchers Runs disk and protected-store work on IO. + * @param staging Cleans previous-process orphan files once, retaining every pending restore archive. + * @param changes Refreshes retained preference readers after protected association recovery. + * @author Dmitriy Moroz + */ +internal class LoadPendingBackupUseCaseImpl( + private val database: BackupStorage, + private val preferences: BackupPreferencesGateway, + private val archives: BackupArchiveStore, + private val sessions: BackupSessionCodec, + private val configuration: ConfigurationStore, + private val authorization: AuthorizationStore, + private val guard: ProviderSelectionGuard, + private val dispatchers: DispatchersProvider, + private val staging: BackupStagingCleaner, + private val changes: BackupChangesGateway, +) : LoadPendingBackupUseCase { + override suspend fun invoke(): BackupRecovery? = withContext(dispatchers.io) { + staging.prepare() + val pending = + database.restoreSessionDao().pending().firstOrNull() ?: return@withContext null + val selection = sessions.decode(pending.selection) + guard.withSelection { + val recovered = + selection.categories.filter { it == BackupCategory.PROVIDERS || it == BackupCategory.SETTINGS } + .toMutableSet() + if (configuration.retryPendingConfiguration()) recovered += BackupCategory.PROVIDERS + recovered += preferences.recoverPendingWrite() + authorization.getAuthorizationCredentials() + withContext(NonCancellable) { changes.notifyChanged(recovered) } + } + val completed = database.restoreSessionDao().completed(pending.id).toSet() + val hasCommittedSelection = selection.categories.all { it.key in completed } + if (pending.requiresConfiguration && (pending.isComplete || hasCommittedSelection || preferences.readStartupStage() == BackupStartupStage.CONFIGURATION)) { + withContext(NonCancellable) { + if (preferences.readStartupStage() in setOf( + BackupStartupStage.INVITATION, + BackupStartupStage.RESTORE + ) + ) preferences.writeStartupStage(BackupStartupStage.CONFIGURATION) + database.restoreSessionDao().finish(pending.id) + database.restoreSessionDao().acknowledgeConfiguration(pending.id) + archives.discard(pending.archiveHandle) + } + return@withContext null + } + val archive = archives.staged(pending.archiveHandle) + BackupRecovery( + BackupRestoreRequest( + pending.archiveHandle, + selection, + pending.id, + shouldProceedToConfiguration = pending.requiresConfiguration + ), archives.summary(archive) + ) + } +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/ObserveBackupExportUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/ObserveBackupExportUseCaseImpl.kt new file mode 100644 index 000000000..354da9468 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/ObserveBackupExportUseCaseImpl.kt @@ -0,0 +1,16 @@ +package com.shifthackz.aisdv1.feature.backup.usecase + +import com.shifthackz.aisdv1.domain.usecase.backup.ObserveBackupExportUseCase +import com.shifthackz.aisdv1.feature.backup.export.BackupExportCoordinator +import kotlinx.coroutines.flow.StateFlow +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportOperation + +/** + * Shares export progress and completion with each recreated screen without transferring job ownership. + * @param coordinator Owns durable export association independently from screen lifetimes. + * @author Dmitriy Moroz + */ +internal class ObserveBackupExportUseCaseImpl(private val coordinator: BackupExportCoordinator) : + ObserveBackupExportUseCase { + override fun invoke(): StateFlow = coordinator.observe() +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/RestoreBackupUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/RestoreBackupUseCaseImpl.kt new file mode 100644 index 000000000..514064651 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/RestoreBackupUseCaseImpl.kt @@ -0,0 +1,246 @@ +package com.shifthackz.aisdv1.feature.backup.usecase + +import com.shifthackz.aisdv1.core.common.schedulers.DispatchersProvider +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory +import com.shifthackz.aisdv1.domain.entity.backup.BackupProgress +import com.shifthackz.aisdv1.domain.entity.backup.BackupRestoreRequest +import com.shifthackz.aisdv1.domain.entity.backup.BackupRestoreResult +import com.shifthackz.aisdv1.domain.entity.backup.BackupRestoreNotice +import com.shifthackz.aisdv1.domain.feature.auth.AuthorizationCredentials +import com.shifthackz.aisdv1.domain.feature.auth.AuthorizationStore +import com.shifthackz.aisdv1.domain.feature.work.BackgroundWorkObserver +import com.shifthackz.aisdv1.domain.gateway.GenerationRestoreGate +import com.shifthackz.aisdv1.domain.gateway.backup.BackupChangesGateway +import com.shifthackz.aisdv1.domain.gateway.ProviderSelectionGuard +import com.shifthackz.aisdv1.domain.gateway.backup.BackupPreferencesGateway +import com.shifthackz.aisdv1.domain.preference.ConfigurationStore +import com.shifthackz.aisdv1.domain.usecase.backup.RestoreBackupUseCase +import com.shifthackz.aisdv1.feature.backup.archive.BackupArchiveStore +import com.shifthackz.aisdv1.feature.backup.restore.BackupProviderPlanner +import com.shifthackz.aisdv1.feature.backup.restore.BackupRestoreGuard +import com.shifthackz.aisdv1.feature.backup.restore.BackupRestoreWriter +import com.shifthackz.aisdv1.feature.backup.restore.BackupSessionCodec +import com.shifthackz.aisdv1.storage.gateway.BackupStorage +import com.shifthackz.aisdv1.storage.db.persistent.entity.RestoreSessionEntity +import com.shifthackz.aisdv1.storage.db.persistent.entity.RestoreSectionEntity +import kotlinx.coroutines.CancellationException +import kotlinx.coroutines.NonCancellable +import kotlinx.coroutines.currentCoroutineContext +import kotlinx.coroutines.ensureActive +import kotlinx.coroutines.withContext + +/** + * Applies explicitly selected categories with guarded provider consent and durable category-level retries. + * @param archives Immutable staged archive reader. + * @param preferences Strict selective preference writer. + * @param configuration Existing checked configuration quarantine owner. + * @param authorization Protected Basic Auth association owner. + * @param selectionGuard Serializes conflict comparison and credential/configuration publication. + * @param restoreGuard Serializes whole restore sessions. + * @param planner Computes independent-provider conflicts without changing selection. + * @param writer Atomic additive Room imports. + * @param sessions Nonsecret selection encoder. + * @param database Durable intent and committed-category ledger. + * @param work Rejects replacement while generation work is active. + * @param changes Refreshes retained settings, locale and storage readers after durable commits. + * @param generationGate Rejects restore during generation and defers new generation until restoration finishes. + * @param dispatchers Runs durable work on IO. + * @author Dmitriy Moroz + */ +internal class RestoreBackupUseCaseImpl( + private val archives: BackupArchiveStore, + private val preferences: BackupPreferencesGateway, + private val configuration: ConfigurationStore, + private val authorization: AuthorizationStore, + private val selectionGuard: ProviderSelectionGuard, + private val restoreGuard: BackupRestoreGuard, + private val planner: BackupProviderPlanner, + private val writer: BackupRestoreWriter, + private val sessions: BackupSessionCodec, + private val database: BackupStorage, + private val work: BackgroundWorkObserver, + private val changes: BackupChangesGateway, + private val generationGate: GenerationRestoreGate, + private val dispatchers: DispatchersProvider, +) : RestoreBackupUseCase { + override suspend fun invoke( + request: BackupRestoreRequest, + onProgress: (BackupProgress) -> Unit + ): BackupRestoreResult = withContext(dispatchers.io) { + restoreGuard.exclusive { + generationGate.restoring { + require(request.sessionId.matches(Regex("[0-9a-fA-F-]{36}"))) { "Invalid restore session" } + require(request.selection.categories.isNotEmpty()) { "Select restore data" } + val archive = archives.staged(request.handle) + val summary = archives.summary(archive) + require(request.selection.categories.all { category -> summary.entries.any { it.category == category && it.isAvailable } }) { "Unavailable backup section" } + require(summary.providers.containsAll(request.selection.providers)) { "Unavailable backup provider" } + val incoming = archives.preferences(archive) + val ledger = database.restoreSessionDao() + val selectionJson = sessions.encode(request.selection) + val recoveredPreferences = mutableSetOf() + val operationResult = runCatching { + val existing = ledger.get(request.sessionId) + check(existing == null || existing.archiveHandle == request.handle && existing.selection == selectionJson) { "Restore session belongs to another request" } + check( + ledger.pending() + .none { it.id != request.sessionId }) { "Finish or cancel the pending restore first" } + var hasFailed = false + val conflict = selectionGuard.withSelection { + check(!work.hasActiveTasks()) { "Wait for generation to finish before restoring" } + val hasRecoveredConfiguration = configuration.retryPendingConfiguration() + val recovered = preferences.recoverPendingWrite() + val hasProviderSection = + BackupCategory.PROVIDERS in request.selection.categories && "providers" !in ledger.completed( + request.sessionId + ) + val credentials = + if (hasProviderSection) authorization.getAuthorizationCredentials() else AuthorizationCredentials.None + if (hasRecoveredConfiguration) recoveredPreferences += BackupCategory.PROVIDERS + recoveredPreferences += recovered + val plan = if (hasProviderSection) planner.plan( + preferences.read(), + incoming, + request.selection, + credentials + ) else null + if (plan != null && plan.conflicts.isNotEmpty() && plan.fingerprint != request.confirmedFingerprint) { + return@withSelection BackupRestoreResult.Conflict( + plan.conflicts, + plan.fingerprint + ) + } + if (existing == null) ledger.insert( + RestoreSessionEntity( + request.sessionId, + request.handle, + selectionJson, + requiresConfiguration = request.shouldProceedToConfiguration + ) + ) + if (plan != null) { + currentCoroutineContext().ensureActive() + try { + withContext(NonCancellable) { + if (plan.credentials != null) authorization.storeAuthorizationCredentials( + plan.credentials + ) { commitId -> + preferences.writeProviders(plan.providers, commitId) + } else preferences.writeProviders(plan.providers, null) + ledger.mark( + RestoreSectionEntity( + request.sessionId, + "providers", + plan.providers.size.toLong(), + plan.skippedCount.toLong(), + plan.retainedCredentialProviders.sorted() + .joinToString(",") + ) + ) + } + } catch (cancelled: CancellationException) { + throw cancelled + } catch (_: Exception) { + hasFailed = true + } + } + null + } + if (conflict != null) return@runCatching conflict + if (!hasFailed) { + for (category in listOf( + BackupCategory.SETTINGS, + BackupCategory.GALLERY, + BackupCategory.NETWORK + )) { + if (category !in request.selection.categories || category.key in ledger.completed( + request.sessionId + ) + ) continue + currentCoroutineContext().ensureActive() + onProgress( + BackupProgress( + category, + 0, + archive.manifest.sections.single { it.id == category.key }.itemCount + ) + ) + try { + when (category) { + BackupCategory.SETTINGS -> withContext(NonCancellable) { + preferences.writeSettings(incoming.settings) + ledger.mark( + RestoreSectionEntity( + request.sessionId, + "settings", + incoming.settings.size.toLong() + ) + ) + } + + BackupCategory.GALLERY -> writer.gallery( + request.sessionId, + archive, + onProgress + ) + + BackupCategory.NETWORK -> writer.network( + request.sessionId, + archive + ) + + BackupCategory.PROVIDERS -> Unit + } + } catch (cancelled: CancellationException) { + throw cancelled + } catch (_: Exception) { + hasFailed = true; break + } + } + } + val results = ledger.results(request.sessionId) + val completed = + BackupCategory.entries.filter { category -> results.any { it.category == category.key } } + .toSet() + BackupRestoreResult.Finished( + completed, + summary.skippedCount + results.sumOf { it.skippedCount }.toInt(), + hasFailed, + results.mapNotNull { result -> + BackupCategory.entries.firstOrNull { it.key == result.category } + ?.let { it to result.importedCount } + }.toMap(), + results.mapNotNull { result -> + result.retainedCredentialProviders.split(',').filter { it.isNotBlank() } + .toSet().takeIf { it.isNotEmpty() } + ?.let { BackupRestoreNotice.SharedCredentialsRetained(it) } + } + ) + } + val publicationResult = runCatching { + withContext(NonCancellable) { + val committed = ledger.results(request.sessionId) + val completedCategories = + BackupCategory.entries.filter { category -> committed.any { it.category == category.key } } + .toSet() + val changed = completedCategories + recoveredPreferences + if (changed.isNotEmpty()) changes.notifyChanged(changed) + if (completedCategories.containsAll(request.selection.categories)) ledger.finish( + request.sessionId + ) + } + } + val operationFailure = operationResult.exceptionOrNull() + val publicationFailure = publicationResult.exceptionOrNull() + if (operationFailure != null) { + if (publicationFailure != null && publicationFailure !== operationFailure) operationFailure.addSuppressed( + publicationFailure + ) + throw operationFailure + } + publicationResult.getOrThrow() + operationResult.getOrThrow() + } + } + } +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/SetBackupStartupStageUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/SetBackupStartupStageUseCaseImpl.kt new file mode 100644 index 000000000..e33cc013a --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/SetBackupStartupStageUseCaseImpl.kt @@ -0,0 +1,18 @@ +package com.shifthackz.aisdv1.feature.backup.usecase + +import com.shifthackz.aisdv1.domain.entity.backup.BackupStartupStage +import com.shifthackz.aisdv1.domain.gateway.backup.BackupPreferencesGateway +import com.shifthackz.aisdv1.domain.usecase.backup.SetBackupStartupStageUseCase + +/** + * Advances durable recovery progression so a stale screen cannot reopen completed provider setup. + * @param preferences Checked stage persistence shared with startup routing. + * @author Dmitriy Moroz + */ +internal class SetBackupStartupStageUseCaseImpl(private val preferences: BackupPreferencesGateway) : + SetBackupStartupStageUseCase { + override operator fun invoke(stage: BackupStartupStage) { + if (stage.ordinal < preferences.readStartupStage().ordinal) return + preferences.writeStartupStage(stage) + } +} diff --git a/feature/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/feature/backup/di/BackupPlatformModule.ios.kt b/feature/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/feature/backup/di/BackupPlatformModule.ios.kt new file mode 100644 index 000000000..15e0ba9eb --- /dev/null +++ b/feature/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/feature/backup/di/BackupPlatformModule.ios.kt @@ -0,0 +1,13 @@ +package com.shifthackz.aisdv1.feature.backup.di + +import com.shifthackz.aisdv1.feature.backup.io.BackupFileStore +import com.shifthackz.aisdv1.feature.backup.io.IosBackupFileStore +import org.koin.core.module.Module +import org.koin.dsl.module + +/** + * Binds native document transport while retaining the shared backup API. + * @author Dmitriy Moroz + */ +internal actual val backupPlatformModule: Module = + module { single { IosBackupFileStore() } } diff --git a/feature/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.ios.kt b/feature/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.ios.kt new file mode 100644 index 000000000..d06262b57 --- /dev/null +++ b/feature/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.ios.kt @@ -0,0 +1,49 @@ +package com.shifthackz.aisdv1.feature.backup.io + +import okio.FileSystem +import okio.Path +import okio.Path.Companion.toPath +import okio.buffer +import platform.Foundation.NSFileManager +import platform.Foundation.NSFileSystemFreeSize +import platform.Foundation.NSHomeDirectory +import platform.Foundation.NSNumber +import platform.Foundation.NSURL +import platform.Foundation.NSUUID +import kotlinx.cinterop.ExperimentalForeignApi + +/** + * Stages archives in Application Support; imported picker documents are copied by UIKit into the sandbox. + * @author Dmitriy Moroz + */ +@OptIn(ExperimentalForeignApi::class) +internal class IosBackupFileStore : BackupFileStore { + override val root: Path get() = (NSHomeDirectory() + "/Library/Application Support/backup").toPath() + override fun documentReference(path: Path): String = + NSURL.fileURLWithPath(path.toString()).absoluteString!! + + override fun documentPath(reference: String): Path { + val url = checkNotNull(NSURL.URLWithString(reference)) + require(url.scheme == "file") { "Not a private backup document" } + return checkNotNull(url.path).toPath() + } + + override fun documentName(document: String): String = + NSURL.URLWithString(document)?.lastPathComponent ?: "SDAI.sdaibackup" + + override fun newId(): String = NSUUID().UUIDString + override fun openDocument(document: String) = + FileSystem.SYSTEM.source(checkNotNull(NSURL.URLWithString(document)?.path).toPath()) + .buffer() + + override fun writeDocument(document: String) = + FileSystem.SYSTEM.sink(checkNotNull(NSURL.URLWithString(document)?.path).toPath()).buffer() + + override fun availableBytes(): Long = + checkNotNull( + NSFileManager.defaultManager.attributesOfFileSystemForPath( + NSHomeDirectory(), + null + )?.get(NSFileSystemFreeSize) as? NSNumber + ) { "Could not inspect private storage" }.longLongValue +} diff --git a/gradle/libs.versions.toml b/gradle/libs.versions.toml index c72309b5c..9522598ff 100644 --- a/gradle/libs.versions.toml +++ b/gradle/libs.versions.toml @@ -17,6 +17,7 @@ lifecycleViewModel = "2.10.0" navigation = "2.9.8" gson = "2.15.0" okhttp = "5.4.0" +okio = "3.17.0" ktor = "3.5.0" koin = "4.2.1" koinCompose = "4.2.1" @@ -46,6 +47,7 @@ dokka = "2.3.0" detekt = "2.0.0-alpha.3" [libraries] +okio = { group = "com.squareup.okio", name = "okio", version.ref = "okio" } android-tools-build-gradle = { group = "com.android.tools.build", name = "gradle", version.ref = "agp" } kotlin-gradle-plugin = { group = "org.jetbrains.kotlin", name = "kotlin-gradle-plugin", version.ref = "kotlin" } apache-stringutils = { group = "org.apache.commons", name = "commons-lang3", version.ref = "apacheStringUtils" } diff --git a/presentation/app/build.gradle.kts b/presentation/app/build.gradle.kts index 5619fae95..dbbc3f1ec 100644 --- a/presentation/app/build.gradle.kts +++ b/presentation/app/build.gradle.kts @@ -24,6 +24,7 @@ kotlin { sourceSets { commonMain.dependencies { implementation(project(":presentation:benchmark")) + implementation(project(":presentation:backup")) implementation(project(":presentation:components")) implementation(project(":presentation:configuration")) implementation(project(":presentation:debug")) @@ -48,6 +49,7 @@ kotlin { implementation(project(":demo")) implementation(project(":network")) implementation(project(":feature:auth")) + implementation(project(":feature:backup")) implementation(project(":feature:benchmark")) implementation(project(":feature:work")) api(project(":feature:bonsai")) @@ -75,6 +77,8 @@ kotlin { implementation(libs.koin.android) } + androidUnitTest.dependencies { implementation(libs.test.junit) } + iosMain.dependencies { implementation(project(":feature:sdxl")) } diff --git a/presentation/app/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/app/BackupRouterSaverTest.kt b/presentation/app/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/app/BackupRouterSaverTest.kt new file mode 100644 index 000000000..0fa7cd91a --- /dev/null +++ b/presentation/app/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/app/BackupRouterSaverTest.kt @@ -0,0 +1,49 @@ +package com.shifthackz.aisdv1.presentation.app + +import androidx.compose.runtime.saveable.SaverScope +import com.shifthackz.aisdv1.core.navigation.AppRoute +import com.shifthackz.aisdv1.core.navigation.LaunchSource +import com.shifthackz.aisdv1.core.navigation.RootAppRouter +import org.junit.Assert.assertEquals +import org.junit.Test + +class BackupRouterSaverTest { + private val scope = object : SaverScope { + override fun canBeSaved(value: Any): Boolean = true + } + + private fun saved(router: RootAppRouter): String = + with(backupRouterSaver) { scope.save(router)!! } + + @Test + fun `given settings native backup picker, host route is saved and restored, expected backup callback destination and settings back route retained`() { + // Given + val router = RootAppRouter(AppRoute.Settings).also { it.navigateToBackup() } + // When + val restored = backupRouterSaver.restore(saved(router))!! + // Then + assertEquals(AppRoute.Backup(LaunchSource.SETTINGS), restored.route.value) + restored.navigateBack() + assertEquals(AppRoute.Settings, restored.route.value) + } + + @Test + fun `given initial restore route, host route is saved and restored, expected first launch mode retained`() { + // Given + val router = RootAppRouter(AppRoute.Backup(LaunchSource.SPLASH)) + // When + val restored = backupRouterSaver.restore(saved(router))!! + // Then + assertEquals(AppRoute.Backup(LaunchSource.SPLASH), restored.route.value) + } + + @Test + fun `given route with unrelated transient arguments, host route is saved, expected existing splash startup validation`() { + // Given + val router = RootAppRouter(AppRoute.TextToImage) + // When + val restored = backupRouterSaver.restore(saved(router))!! + // Then + assertEquals(AppRoute.Splash, restored.route.value) + } +} diff --git a/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/AiSdApp.kt b/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/AiSdApp.kt index b409df0fa..cb9acf8ac 100644 --- a/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/AiSdApp.kt +++ b/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/AiSdApp.kt @@ -19,6 +19,7 @@ import androidx.compose.runtime.collectAsState import androidx.compose.runtime.getValue import androidx.compose.runtime.mutableStateListOf import androidx.compose.runtime.mutableStateOf +import androidx.compose.runtime.saveable.rememberSaveable import androidx.compose.runtime.remember import androidx.compose.runtime.setValue import androidx.compose.ui.Modifier @@ -55,7 +56,7 @@ fun AiSdApp( val preferenceManager = remember(koin) { koin.get() } - val router = remember { RootAppRouter() } + val router = rememberSaveable(saver = backupRouterSaver) { RootAppRouter() } val route by router.route.collectAsState() val isDrawerOpen by router.drawerOpen.collectAsState() val canNavigateBack by router.canNavigateBack.collectAsState() diff --git a/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/AiSdAppRoutes.kt b/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/AiSdAppRoutes.kt index f87d8486b..67bda23aa 100644 --- a/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/AiSdAppRoutes.kt +++ b/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/AiSdAppRoutes.kt @@ -1,6 +1,13 @@ package com.shifthackz.aisdv1.presentation.app import com.shifthackz.aisdv1.presentation.home.AppScaffold +import com.shifthackz.aisdv1.core.navigation.LaunchSource +import com.shifthackz.aisdv1.presentation.backup.BackupScreen +import com.shifthackz.aisdv1.presentation.backup.BackupScreenMode +import com.shifthackz.aisdv1.presentation.backup.BackupViewModel +import com.shifthackz.aisdv1.presentation.backup.BackupIntent +import com.shifthackz.aisdv1.presentation.backup.BackupEffect +import com.shifthackz.aisdv1.presentation.backup.platform.rememberBackupDocumentLauncher import androidx.compose.runtime.getValue import androidx.compose.foundation.layout.Box @@ -226,6 +233,50 @@ internal fun OverlayRouteContent( AppRoute.Settings, -> Unit + AppRoute.BackupWelcome, is AppRoute.Backup -> { + val mode = when (route) { + AppRoute.BackupWelcome -> BackupScreenMode.WELCOME + is AppRoute.Backup -> if (route.source == LaunchSource.SPLASH) BackupScreenMode.FIRST_LAUNCH else BackupScreenMode.SETTINGS + } + val viewModel = remember(koin, router, mode) { + koin.get { + parametersOf( + mode, + router + ) + } + } + val launcher = rememberBackupDocumentLauncher( + onPicked = { viewModel.processIntent(BackupIntent.DocumentSelected(it)) }, + onExported = { destination, hasExported, handle -> + viewModel.processIntent( + BackupIntent.ExportFinished( + destination, + hasExported, + handle + ) + ) + }, + ) + DisposableEffect(viewModel) { onDispose { viewModel.onRouteDisposed() } } + RootBackHandler(enabled = true) { + if (mode != BackupScreenMode.WELCOME) viewModel.processIntent(BackupIntent.NavigateBack) + } + MviComponent(viewModel = viewModel, processEffect = { effect -> + when (effect) { + BackupEffect.OpenDocument -> launcher.open() + is BackupEffect.ExportDocument -> launcher.export(effect.backup) + } + }) { state, processIntent -> + BackupScreen( + mode, + state, + processIntent, + Modifier.fillMaxSize() + ) + } + } + AppRoute.StorageUsage -> { StorageUsageScreen( modifier = Modifier.fillMaxSize(), diff --git a/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/BackupRouterSaver.kt b/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/BackupRouterSaver.kt new file mode 100644 index 000000000..7198c8646 --- /dev/null +++ b/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/BackupRouterSaver.kt @@ -0,0 +1,29 @@ +package com.shifthackz.aisdv1.presentation.app + +import androidx.compose.runtime.saveable.Saver +import com.shifthackz.aisdv1.core.navigation.AppRoute +import com.shifthackz.aisdv1.core.navigation.LaunchSource +import com.shifthackz.aisdv1.core.navigation.RootAppRouter + +/** + * Retains only nonsecret backup launch context so native document results reconnect after host recreation. + * Other routes retain the existing cold-start behavior and are rebuilt through startup validation. + * @author Dmitriy Moroz + */ +internal val backupRouterSaver = Saver( + save = { router -> + when (val route = router.route.value) { + is AppRoute.Backup -> if (route.source == LaunchSource.SPLASH) "initial" else "settings" + AppRoute.BackupWelcome -> "welcome" + else -> "splash" + } + }, + restore = { context -> + when (context) { + "initial" -> RootAppRouter(AppRoute.Backup(LaunchSource.SPLASH)) + "settings" -> RootAppRouter(AppRoute.Settings).also { it.navigateToBackup() } + "welcome" -> RootAppRouter(AppRoute.BackupWelcome) + else -> RootAppRouter() + } + } +) diff --git a/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/di/AppCoreModule.kt b/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/di/AppCoreModule.kt index 5a3e40e1c..8f114637b 100644 --- a/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/di/AppCoreModule.kt +++ b/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/di/AppCoreModule.kt @@ -43,6 +43,8 @@ import com.shifthackz.aisdv1.core.navigation.router.StorageUsageRouter import com.shifthackz.aisdv1.core.navigation.router.TextToImageRouter import com.shifthackz.aisdv1.core.navigation.router.WebUiRouter import com.shifthackz.aisdv1.core.mvi.diagnostics.uiDiagnosticsModule +import com.shifthackz.aisdv1.core.navigation.router.BackupRouter +import com.shifthackz.aisdv1.core.navigation.router.NoOpBackupRouter import org.koin.dsl.module /** @@ -52,6 +54,7 @@ import org.koin.dsl.module * @author Dmitriy Moroz */ val appCoreModule = module { + single { NoOpBackupRouter } includes(uiDiagnosticsModule(isEnabled = false)) single { DefaultLinksProvider } single { createPlatformBuildInfoProvider() } diff --git a/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/di/KoinBootstrap.kt b/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/di/KoinBootstrap.kt index 89e3f62af..3f95084cc 100644 --- a/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/di/KoinBootstrap.kt +++ b/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/di/KoinBootstrap.kt @@ -8,6 +8,7 @@ import com.shifthackz.aisdv1.demo.di.demoModule import com.shifthackz.aisdv1.domain.di.coreDomainModule import com.shifthackz.aisdv1.domain.di.benchmarkUseCaseModule import com.shifthackz.aisdv1.feature.auth.di.authModule +import com.shifthackz.aisdv1.feature.backup.di.backupModule import com.shifthackz.aisdv1.feature.benchmark.di.benchmarkModule import com.shifthackz.aisdv1.feature.bonsai.di.bonsaiModule import com.shifthackz.aisdv1.feature.coreml.di.coreMlModule @@ -26,9 +27,22 @@ import com.shifthackz.aisdv1.domain.preference.PreferenceManager * @author Dmitriy Moroz */ internal val commonApplicationModules = listOf( - coreNetworkModule, networkModule, validatorsModule, coreDomainModule, benchmarkUseCaseModule, - coreDataModule, *dataModule, demoModule, authModule, benchmarkModule, bonsaiModule, - coreMlModule, mnnHostRuntimeModule, backgroundWorkModule, corePresentationModule, + coreNetworkModule, + networkModule, + validatorsModule, + coreDomainModule, + benchmarkUseCaseModule, + coreDataModule, + *dataModule, + demoModule, + authModule, + backupModule, + benchmarkModule, + bonsaiModule, + coreMlModule, + mnnHostRuntimeModule, + backgroundWorkModule, + corePresentationModule, ) /** diff --git a/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/di/PresentationCoreModule.kt b/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/di/PresentationCoreModule.kt index fa243edaa..e57d94574 100644 --- a/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/di/PresentationCoreModule.kt +++ b/presentation/app/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/app/di/PresentationCoreModule.kt @@ -22,6 +22,7 @@ import com.shifthackz.aisdv1.presentation.generation.di.generationCoreModule import com.shifthackz.aisdv1.presentation.generation.di.generationViewModelModule import com.shifthackz.aisdv1.presentation.debug.di.debugCoreModule import com.shifthackz.aisdv1.presentation.debug.di.debugViewModelModule +import com.shifthackz.aisdv1.presentation.backup.di.backupViewModelModule import org.koin.dsl.module /** @@ -31,6 +32,7 @@ import org.koin.dsl.module */ val corePresentationModule = module { includes( + backupViewModelModule, benchmarkCoreModule, benchmarkViewModelModule, statisticsViewModelModule, diff --git a/presentation/backup/build.gradle.kts b/presentation/backup/build.gradle.kts new file mode 100644 index 000000000..3a04b3360 --- /dev/null +++ b/presentation/backup/build.gradle.kts @@ -0,0 +1,51 @@ +plugins { + alias(libs.plugins.generic.kmp.compose) +} + +android { + namespace = "com.shifthackz.aisdv1.presentation.backup" + testOptions.unitTests { + all { test -> + test.jvmArgs( + "--add-opens", "java.base/java.lang=ALL-UNNAMED", + "--add-opens", "java.base/java.lang.reflect=ALL-UNNAMED" + ) + } + isReturnDefaultValues = true + } +} + +kotlin { + sourceSets { + commonMain.dependencies { + implementation(project(":core:common")) + implementation(project(":core:localization")) + implementation(project(":core:ui")) + implementation(project(":domain")) + implementation(project(":presentation:components")) + implementation(compose.runtime) + implementation(compose.ui) + implementation(compose.foundation) + implementation(compose.material3) + implementation(compose.materialIconsExtended) + implementation(libs.androidx.lifecycle.compose) + implementation(libs.kotlinx.coroutines.core) + implementation(libs.koin.core) + } + + androidMain.dependencies { implementation(libs.androidx.compose.activity) } + androidUnitTest.dependencies { + implementation(libs.test.junit) + implementation(libs.test.mockk) + implementation(libs.test.coroutines) + } + } +} + +// Reports describe compiler stability/skipping decisions; they do not measure frame performance. +composeCompiler { + if (providers.gradleProperty("sdaiComposeReports").orNull == "true") { + metricsDestination.set(layout.buildDirectory.dir("compose-metrics")) + reportsDestination.set(layout.buildDirectory.dir("compose-reports")) + } +} diff --git a/presentation/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDateFormatter.android.kt b/presentation/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDateFormatter.android.kt new file mode 100644 index 000000000..ad9946d50 --- /dev/null +++ b/presentation/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDateFormatter.android.kt @@ -0,0 +1,12 @@ +package com.shifthackz.aisdv1.presentation.backup.platform + +import java.text.DateFormat +import java.util.Date + +/** + * Formats a UTC timestamp using the current platform locale and date/time conventions. + * @param epochMillis Archive creation time in milliseconds since the Unix epoch. + * @author Dmitriy Moroz + */ +internal actual fun formatBackupCreatedAt(epochMillis: Long): String = + DateFormat.getDateTimeInstance(DateFormat.MEDIUM, DateFormat.SHORT).format(Date(epochMillis)) diff --git a/presentation/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDocumentLauncher.android.kt b/presentation/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDocumentLauncher.android.kt new file mode 100644 index 000000000..55fb4a942 --- /dev/null +++ b/presentation/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDocumentLauncher.android.kt @@ -0,0 +1,50 @@ +package com.shifthackz.aisdv1.presentation.backup.platform + +import androidx.activity.compose.rememberLauncherForActivityResult +import androidx.activity.result.contract.ActivityResultContracts +import androidx.compose.runtime.Composable +import androidx.compose.runtime.remember +import androidx.compose.runtime.rememberUpdatedState +import androidx.compose.runtime.saveable.rememberSaveable +import androidx.compose.runtime.mutableStateOf +import androidx.compose.runtime.getValue +import androidx.compose.runtime.setValue +import com.shifthackz.aisdv1.domain.entity.backup.BackupExport + +/** + * Uses Android Storage Access Framework without broad storage permissions or retained external ownership. + * @param onPicked Receives a read-granted document URI or neutral cancellation. + * @param onExported Receives a destination URI; file writing remains a domain operation. + * @author Dmitriy Moroz + */ +@Composable +actual fun rememberBackupDocumentLauncher( + onPicked: (String?) -> Unit, + onExported: (String?, Boolean, String) -> Unit +): BackupDocumentLauncher { + val picked = rememberUpdatedState(onPicked) + val exported = rememberUpdatedState(onExported) + var exportHandle by rememberSaveable { mutableStateOf("") } + val open = + rememberLauncherForActivityResult(ActivityResultContracts.OpenDocument()) { picked.value(it?.toString()) } + val save = + rememberLauncherForActivityResult(ActivityResultContracts.CreateDocument("application/octet-stream")) { + exported.value( + it?.toString(), + false, + exportHandle + ) + } + return remember(open, save) { + object : BackupDocumentLauncher { + override fun open() { + open.launch(arrayOf("application/octet-stream", "*/*")) + } + + override fun export(backup: BackupExport) { + exportHandle = backup.handle + save.launch(backup.filename) + } + } + } +} diff --git a/presentation/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupViewModelTest.kt b/presentation/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupViewModelTest.kt new file mode 100644 index 000000000..3b84434a0 --- /dev/null +++ b/presentation/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupViewModelTest.kt @@ -0,0 +1,386 @@ +package com.shifthackz.aisdv1.presentation.backup + +import com.shifthackz.aisdv1.core.common.schedulers.DispatchersProvider +import com.shifthackz.aisdv1.core.navigation.router.BackupRouter +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory +import com.shifthackz.aisdv1.domain.entity.backup.BackupEntry +import com.shifthackz.aisdv1.domain.entity.backup.BackupExport +import com.shifthackz.aisdv1.domain.entity.backup.BackupInspection +import com.shifthackz.aisdv1.domain.entity.backup.BackupRestoreResult +import com.shifthackz.aisdv1.domain.entity.backup.BackupStartupStage +import com.shifthackz.aisdv1.domain.usecase.backup.CreateBackupUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.InspectBackupUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.RestoreBackupUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.ObserveBackupExportUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.CompleteBackupExportUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.CancelBackupExportUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.DismissBackupExportUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.GetBackupStartupStageUseCase +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportOperation +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportStatus +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportCompletion +import kotlinx.coroutines.flow.MutableStateFlow +import kotlinx.coroutines.CompletableDeferred +import com.shifthackz.aisdv1.domain.usecase.backup.DiscardBackupUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.LoadBackupInventoryUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.LoadPendingBackupUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.SetBackupStartupStageUseCase +import io.mockk.coEvery +import io.mockk.coVerify +import io.mockk.every +import io.mockk.mockk +import io.mockk.verify +import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.ExperimentalCoroutinesApi +import kotlinx.coroutines.test.StandardTestDispatcher +import kotlinx.coroutines.test.TestScope +import kotlinx.coroutines.test.advanceUntilIdle +import kotlinx.coroutines.test.resetMain +import kotlinx.coroutines.test.runTest +import kotlinx.coroutines.test.runCurrent +import kotlinx.coroutines.test.setMain +import org.junit.After +import org.junit.Assert.assertEquals +import org.junit.Assert.assertFalse +import org.junit.Assert.assertNull +import org.junit.Assert.assertTrue +import org.junit.Test + +@OptIn(ExperimentalCoroutinesApi::class) +class BackupViewModelTest { + private val router = mockk(relaxed = true) + private val inventory = mockk() + private val create = mockk() + private val inspect = mockk() + private val restore = mockk() + private val exportState = MutableStateFlow(BackupExportOperation()) + private val observeExport = + mockk { every { this@mockk.invoke() } returns exportState } + private val completeExport = mockk(relaxed = true) + private val cancelExport = mockk(relaxed = true) + private val dismissExport = mockk(relaxed = true) + private val getStage = + mockk { every { this@mockk.invoke() } returns BackupStartupStage.RESTORE } + private val discard = mockk(relaxed = true) + private val pending = mockk() + private val startup = mockk(relaxed = true) + private val summary = BackupInspection( + "11111111-1111-1111-1111-111111111111", + 100, + "1", + "IOS", + listOf(BackupEntry(BackupCategory.GALLERY, 2), BackupEntry(BackupCategory.SETTINGS, 1)), + emptySet() + ) + + @After + fun tearDown() { + Dispatchers.resetMain() + } + + private fun TestScope.viewModel(mode: BackupScreenMode = BackupScreenMode.SETTINGS): BackupViewModel { + val dispatcher = StandardTestDispatcher(testScheduler) + Dispatchers.setMain(dispatcher) + coEvery { pending() } returns null + coEvery { inventory() } returns summary + val dispatchers = + mockk { every { io } returns dispatcher; every { immediate } returns dispatcher } + return BackupViewModel( + mode, + router, + mockk(relaxed = true), + dispatchers, + inventory, + create, + inspect, + restore, + observeExport, + completeExport, + cancelExport, + dismissExport, + getStage, + discard, + pending, + startup + ) + } + + @Test + fun `given backup tabs, selection changes before switching twice, expected create selection retained`() = + runTest { + // Given + val vm = viewModel() + advanceUntilIdle() + // When + vm.processIntent(BackupIntent.ToggleCategory(BackupCategory.GALLERY)) + vm.processIntent(BackupIntent.SelectTab(true)) + vm.processIntent(BackupIntent.SelectTab(false)) + // Then + assertEquals(setOf(BackupCategory.SETTINGS), vm.state.value.create.selection.categories) + assertFalse(vm.state.value.isRestoreTab) + } + + @Test + fun `given restore file picker, user cancels document selection, expected neutral state without inspection`() = + runTest { + // Given + val vm = viewModel() + advanceUntilIdle() + vm.processIntent(BackupIntent.SelectTab(true)) + vm.processIntent(BackupIntent.ChooseFile) + advanceUntilIdle() + // When + vm.processIntent(BackupIntent.DocumentSelected(null)) + advanceUntilIdle() + // Then + assertFalse(vm.state.value.isPicking) + assertFalse(vm.state.value.hasError) + assertNull(vm.state.value.restore.inspection) + coVerify(exactly = 0) { inspect(any(), any()) } + } + + @Test + fun `given first launch invitation, user continues, expected configuration stage and route`() = + runTest { + // Given + val vm = viewModel(BackupScreenMode.WELCOME) + // When + vm.processIntent(BackupIntent.Continue) + advanceUntilIdle() + // Then + verify { startup(BackupStartupStage.CONFIGURATION); router.navigateToInitialConfiguration() } + verify(exactly = 0) { router.navigateBack() } + } + + @Test + fun `given first launch restore screen, user cancels decision, expected configuration without returning onboarding`() = + runTest { + // Given + val vm = viewModel(BackupScreenMode.FIRST_LAUNCH) + advanceUntilIdle() + // When + vm.processIntent(BackupIntent.NavigateBack) + advanceUntilIdle() + // Then + verify { startup(BackupStartupStage.CONFIGURATION); router.navigateToInitialConfiguration() } + verify(exactly = 0) { router.navigateBack() } + } + + @Test + fun `given staged export, coordinator reports write failure, expected error without saved success`() = + runTest { + // Given + val vm = viewModel() + coEvery { create(any(), any()) } returns BackupExport( + "file:///private/archive", + "backup.sdaibackup", + "export" + ) + + advanceUntilIdle() + vm.processIntent(BackupIntent.Submit) + advanceUntilIdle() + // When + vm.processIntent(BackupIntent.ExportFinished("content://destination", false, "export")) + advanceUntilIdle() + exportState.value = BackupExportOperation(BackupExportStatus.FAILED) + advanceUntilIdle() + // Then + assertTrue(vm.state.value.hasError) + assertFalse(vm.state.value.hasExported) + verify { + completeExport( + BackupExportCompletion.DestinationSelected( + "content://destination", + "export" + ) + ) + } + coVerify(exactly = 0) { discard(any()) } + } + + @Test + fun `given restore conflict dialog, user cancels replacement, expected editable selection and no success`() = + runTest { + // Given + val vm = viewModel() + coEvery { inspect(any(), any()) } returns summary + coEvery { restore(any(), any()) } returns BackupRestoreResult.Conflict( + setOf("custom"), + "fingerprint" + ) + advanceUntilIdle() + vm.processIntent(BackupIntent.SelectTab(true)) + vm.processIntent(BackupIntent.DocumentSelected("content://backup")) + advanceUntilIdle() + vm.processIntent(BackupIntent.Submit) + advanceUntilIdle() + // When + vm.processIntent(BackupIntent.DismissConflict) + vm.processIntent(BackupIntent.ToggleCategory(BackupCategory.GALLERY)) + // Then + assertNull(vm.state.value.conflict) + assertEquals( + setOf(BackupCategory.SETTINGS), + vm.state.value.restore.selection.categories + ) + assertNull(vm.state.value.result) + } + + @Test + fun `given first launch restore, selected sections succeed, expected restored setup flow`() = + runTest { + // Given + val vm = viewModel(BackupScreenMode.FIRST_LAUNCH) + coEvery { inspect(any(), any()) } returns summary + coEvery { restore(any(), any()) } returns BackupRestoreResult.Finished( + setOf( + BackupCategory.GALLERY, + BackupCategory.SETTINGS + ), 0, false + ) + advanceUntilIdle() + vm.processIntent(BackupIntent.DocumentSelected("content://backup")) + advanceUntilIdle() + // When + vm.processIntent(BackupIntent.Submit) + advanceUntilIdle() + // Then + verify { startup(BackupStartupStage.CONFIGURATION); router.navigateToInitialConfiguration() } + coVerify { discard(summary.handle) } + verify(exactly = 0) { router.navigateBack() } + } + + @Test + fun `given inspected backup with custom selection, next picker is canceled, expected original file and choices retained`() = + runTest { + // Given + val vm = viewModel() + coEvery { inspect(any(), any()) } returns summary + advanceUntilIdle() + vm.processIntent(BackupIntent.SelectTab(true)) + vm.processIntent(BackupIntent.DocumentSelected("content://original")) + advanceUntilIdle() + vm.processIntent(BackupIntent.ToggleCategory(BackupCategory.GALLERY)) + // When + vm.processIntent(BackupIntent.ChooseFile) + advanceUntilIdle() + vm.processIntent(BackupIntent.DocumentSelected(null)) + advanceUntilIdle() + // Then + assertEquals(summary, vm.state.value.restore.inspection) + assertEquals( + setOf(BackupCategory.SETTINGS), + vm.state.value.restore.selection.categories + ) + coVerify(exactly = 0) { discard(any()) } + } + + @Test + fun `given recreated backup route, native callback arrives before initialization completes, expected result queued without dropping destination`() = + runTest { + // Given + val vm = viewModel() + val initialization = CompletableDeferred() + every { completeExport(any()) } answers { + exportState.value = BackupExportOperation(BackupExportStatus.PROCESSING) + } + coEvery { pending() } coAnswers { initialization.await(); null } + // When + vm.processIntent( + BackupIntent.ExportFinished( + "content://destination", + false, + "durable-export" + ) + ) + advanceUntilIdle() + // Then + verify(exactly = 1) { + completeExport( + BackupExportCompletion.DestinationSelected( + "content://destination", + "durable-export" + ) + ) + } + assertTrue(vm.state.value.isExporting) + initialization.complete(Unit) + advanceUntilIdle() + vm.onRouteDisposed() + } + + @Test + fun `given reconstructed first launch route, recovery acknowledged configuration, expected direct setup navigation`() = + runTest { + // Given + every { getStage() } returns BackupStartupStage.CONFIGURATION + // When + val vm = viewModel(BackupScreenMode.FIRST_LAUNCH) + advanceUntilIdle() + // Then + verify(exactly = 1) { router.navigateToInitialConfiguration() } + coVerify(exactly = 0) { inventory(); restore(any(), any()) } + vm.onRouteDisposed() + } + + @Test + fun `given recreated export route, durable copy is running, expected editing disabled and source retained on disposal`() = + runTest { + // Given + exportState.value = BackupExportOperation( + BackupExportStatus.COPYING, + BackupExport("source", "name", "handle") + ) + val vm = viewModel() + advanceUntilIdle() + val original = vm.state.value.create.selection + // When + vm.processIntent(BackupIntent.ToggleCategory(BackupCategory.GALLERY)) + vm.onRouteDisposed() + // Then + assertEquals(original, vm.state.value.create.selection) + assertTrue(vm.state.value.isExporting) + verify(exactly = 0) { cancelExport() } + coVerify(exactly = 0) { dismissExport(); discard(any()) } + } + + @Test + fun `given recreated import picker, document arrives during initialization, expected queued inspection and visible Restore tab`() = + runTest { + // Given + val vm = viewModel() + val initialized = CompletableDeferred() + coEvery { pending() } coAnswers { initialized.await(); null } + coEvery { inspect("content://restored-result", any()) } returns summary + runCurrent() + // When + vm.processIntent(BackupIntent.DocumentSelected("content://restored-result")) + runCurrent() + // Then + coVerify(exactly = 0) { inspect(any(), any()) } + assertTrue(vm.state.value.isPicking) + initialized.complete(Unit) + advanceUntilIdle() + coVerify(exactly = 1) { inspect("content://restored-result", any()) } + assertTrue(vm.state.value.isRestoreTab) + assertEquals(summary, vm.state.value.restore.inspection) + assertFalse(vm.state.value.isPicking) + vm.onRouteDisposed() + } + + @Test + fun `given reconstructed first launch route, setup has already completed before handoff acknowledgment, expected home without empty restore screen`() = + runTest { + // Given + every { getStage() } returns BackupStartupStage.COMPLETE + // When + val vm = viewModel(BackupScreenMode.FIRST_LAUNCH) + advanceUntilIdle() + // Then + verify(exactly = 1) { router.navigateToHomeScreen() } + verify(exactly = 0) { startup(any()); router.navigateToInitialConfiguration() } + vm.onRouteDisposed() + } + +} diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupEffect.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupEffect.kt new file mode 100644 index 000000000..16f7a811e --- /dev/null +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupEffect.kt @@ -0,0 +1,20 @@ +package com.shifthackz.aisdv1.presentation.backup + +import com.shifthackz.aisdv1.core.mvi.MviEffect +import com.shifthackz.aisdv1.domain.entity.backup.BackupExport + +/** + * Lifecycle-aware requests for native document pickers. + * @author Dmitriy Moroz + */ +sealed interface BackupEffect : MviEffect { + /** Opens the system document picker without discarding the previous file. @author Dmitriy Moroz */ + data object OpenDocument : BackupEffect + + /** + * Presents native export after a complete binary archive has been staged. + * @param backup Private document reference and suggested filename. + * @author Dmitriy Moroz + */ + data class ExportDocument(val backup: BackupExport) : BackupEffect +} diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupIntent.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupIntent.kt new file mode 100644 index 000000000..14554dcbd --- /dev/null +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupIntent.kt @@ -0,0 +1,105 @@ +package com.shifthackz.aisdv1.presentation.backup + +import com.shifthackz.aisdv1.core.mvi.MviIntent +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory + +/** + * Explicit backup actions and native document results; no action contains decoded archive data. + * @author Dmitriy Moroz + */ +sealed interface BackupIntent : MviIntent { + /** + * Returns to Settings or mandatory first-launch configuration after resolving staged ownership. + * @author Dmitriy Moroz + */ + data object NavigateBack : BackupIntent + + /** + * Consumes the first-launch invitation and proceeds through provider configuration. + * @author Dmitriy Moroz + */ + data object Continue : BackupIntent + + /** + * Opens restore-only content while persisting first-launch recovery progression. + * @author Dmitriy Moroz + */ + data object BeginInitialRestore : BackupIntent + + /** + * Changes visible tab while retaining each page selection. + * @param isRestore Whether the Restore tab should be selected. + * @author Dmitriy Moroz + */ + data class SelectTab(val isRestore: Boolean) : BackupIntent + + /** + * Changes one available category selection. + * @param category Stable category represented by the checklist row. + * @author Dmitriy Moroz + */ + data class ToggleCategory(val category: BackupCategory) : BackupIntent + + /** + * Changes one supported provider child selection. + * @param key Stable provider wire identifier. + * @author Dmitriy Moroz + */ + data class ToggleProvider(val key: String) : BackupIntent + + /** + * Expands or collapses provider choices without changing selection. + * @author Dmitriy Moroz + */ + data object ToggleProvidersExpanded : BackupIntent + + /** + * Opens a native picker while retaining the previous inspection until a new selection succeeds. + * @author Dmitriy Moroz + */ + data object ChooseFile : BackupIntent + + /** + * Starts export or submits the selected restore plan with its current retry identity. + * @author Dmitriy Moroz + */ + data object Submit : BackupIntent + + /** + * Confirms only the current displayed conflict fingerprint; changed destination values require renewed consent. + * @author Dmitriy Moroz + */ + data object ConfirmProviderReplacement : BackupIntent + + /** + * Cancels replacement before any category mutation and returns to editable selection. + * @author Dmitriy Moroz + */ + data object DismissConflict : BackupIntent + + /** + * Cancels active bounded work; already committed categories remain journal-owned. + * @author Dmitriy Moroz + */ + data object CancelWork : BackupIntent + + /** + * Delivers a native import result; null is neutral picker cancellation. + * @param document Opaque native source reference or null. + * @author Dmitriy Moroz + */ + data class DocumentSelected(val document: String?) : BackupIntent + + /** + * Delivers a destination or completed UIKit export; neither means cancellation. + * @param destination Android write-granted output reference, or null on iOS/cancel. + * @param hasExported Whether UIKit confirmed completed native export. + * @param handle Nonsecret staged identity saved by the launcher across host recreation. + * @author Dmitriy Moroz + */ + data class ExportFinished( + val destination: String?, + val hasExported: Boolean, + val handle: String + ) : BackupIntent +} diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupPageState.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupPageState.kt new file mode 100644 index 000000000..08cda1068 --- /dev/null +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupPageState.kt @@ -0,0 +1,17 @@ +package com.shifthackz.aisdv1.presentation.backup + +import com.shifthackz.aisdv1.domain.entity.backup.BackupInspection +import com.shifthackz.aisdv1.domain.entity.backup.BackupSelection + +/** + * Independent tab inventory and selection; switching tabs retains both pages. + * @param inspection Available data or validated archive summary. + * @param selection Explicit category and provider choices. + * @param areProvidersExpanded Whether nested provider choices are visible. + * @author Dmitriy Moroz + */ +data class BackupPageState( + val inspection: BackupInspection? = null, + val selection: BackupSelection = BackupSelection(), + val areProvidersExpanded: Boolean = true, +) diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupScreen.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupScreen.kt new file mode 100644 index 000000000..71d216328 --- /dev/null +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupScreen.kt @@ -0,0 +1,199 @@ +package com.shifthackz.aisdv1.presentation.backup + +import androidx.compose.foundation.layout.WindowInsets +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Row +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.layout.safeDrawingPadding +import androidx.compose.foundation.layout.size +import androidx.compose.foundation.rememberScrollState +import androidx.compose.foundation.verticalScroll +import androidx.compose.material.icons.Icons +import androidx.compose.material.icons.automirrored.filled.ArrowBack +import androidx.compose.material3.AlertDialog +import androidx.compose.material3.Button +import androidx.compose.material3.CircularProgressIndicator +import androidx.compose.material3.ExperimentalMaterial3Api +import androidx.compose.material3.Icon +import androidx.compose.material3.IconButton +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.Scaffold +import androidx.compose.material3.Tab +import androidx.compose.material3.TabRow +import androidx.compose.material3.Text +import androidx.compose.material3.TextButton +import androidx.compose.material3.TopAppBar +import androidx.compose.runtime.Composable +import androidx.compose.ui.Modifier +import androidx.compose.ui.unit.dp +import com.shifthackz.aisdv1.core.localization.Localization +import com.shifthackz.aisdv1.domain.entity.backup.BackupRestoreNotice +import com.shifthackz.aisdv1.presentation.backup.component.providerName +import com.shifthackz.aisdv1.presentation.backup.create.CreateBackupScreen +import com.shifthackz.aisdv1.presentation.backup.restore.RestoreBackupScreen +import com.shifthackz.aisdv1.presentation.backup.welcome.RestoreWelcomeScreen + +/** + * Stateless backup host; dedicated create/restore content remains reusable across launch contexts. + * @param mode Normal tabs or first-launch recovery chrome. + * @param state Current nonsecret screen state. + * @param processIntent Caller-owned MVI event sink. + * @param modifier Root screen placement. + * @author Dmitriy Moroz + */ +@OptIn(ExperimentalMaterial3Api::class) +@Composable +fun BackupScreen( + mode: BackupScreenMode, + state: BackupState, + processIntent: (BackupIntent) -> Unit, + modifier: Modifier = Modifier +) { + val isEnabled = !state.isBusy && !state.isPicking && !state.isExporting + if (mode == BackupScreenMode.WELCOME) { + RestoreWelcomeScreen( + isEnabled, + state.hasError, + { processIntent(BackupIntent.BeginInitialRestore) }, + { processIntent(BackupIntent.Continue) }, + modifier + ) + return + } + val page = if (state.isRestoreTab) state.restore else state.create + Scaffold(modifier.safeDrawingPadding(), topBar = { + TopAppBar( + windowInsets = WindowInsets(0, 0, 0, 0), + title = { Text(Localization.string("backup_title")) }, + navigationIcon = { + IconButton( + onClick = { processIntent(BackupIntent.NavigateBack) }, + enabled = isEnabled + ) { + Icon(Icons.AutoMirrored.Filled.ArrowBack, Localization.string("action_back")) + } + }) + }, bottomBar = { + Column(Modifier.fillMaxWidth().padding(horizontal = 24.dp, vertical = 16.dp)) { + if (state.isBusy || state.isExporting) { + Row { + CircularProgressIndicator(Modifier.size(24.dp)); Spacer(Modifier.size(12.dp)); Text( + Localization.string("backup_working") + ) + } + state.progress?.let { progress -> + Text( + if (progress.total > 0) "${progress.completed} / ${progress.total}" else progress.completed.toString(), + style = MaterialTheme.typography.bodySmall + ) + } + TextButton(onClick = { processIntent(BackupIntent.CancelWork) }) { + Text( + Localization.string( + "backup_cancel" + ) + ) + } + } else { + val isFinished = + if (state.isRestoreTab) state.result?.hasFailed == false else state.hasExported + Button( + onClick = { processIntent(if (isFinished) BackupIntent.NavigateBack else BackupIntent.Submit) }, + enabled = isEnabled && (isFinished || page.selection.categories.isNotEmpty()), + modifier = Modifier.fillMaxWidth() + ) { + Text(Localization.string(if (isFinished) "backup_done" else if (state.isRestoreTab) "backup_restore" else "backup_create")) + } + } + } + }) { padding -> + Column(Modifier.padding(padding)) { + if (mode == BackupScreenMode.SETTINGS) TabRow(selectedTabIndex = if (state.isRestoreTab) 1 else 0) { + Tab( + selected = !state.isRestoreTab, + onClick = { processIntent(BackupIntent.SelectTab(false)) }, + enabled = isEnabled, + text = { Text(Localization.string("backup_create_tab")) }) + Tab( + selected = state.isRestoreTab, + onClick = { processIntent(BackupIntent.SelectTab(true)) }, + enabled = isEnabled, + text = { Text(Localization.string("backup_restore_tab")) }) + } + Column(Modifier.fillMaxSize().verticalScroll(rememberScrollState()).padding(24.dp)) { + if (state.hasError) Text( + Localization.string("backup_error"), + color = MaterialTheme.colorScheme.error + ) + if (state.hasCanceled) Text( + Localization.string("backup_canceled"), + style = MaterialTheme.typography.bodyMedium + ) + if (state.hasExported && !state.isRestoreTab) Text( + Localization.string("backup_exported"), + color = MaterialTheme.colorScheme.primary + ) + state.result?.let { result -> + Text( + Localization.string(if (result.hasFailed) "backup_partial" else "backup_restored"), + style = MaterialTheme.typography.titleMedium + ) + result.importedCounts.forEach { (category, count) -> Text(Localization.string("backup_category_" + category.key) + ": " + count) } + result.notices.forEach { notice -> + when (notice) { + is BackupRestoreNotice.SharedCredentialsRetained -> Text( + Localization.string( + "backup_shared_credentials_retained", + notice.providers.joinToString(", ", transform = ::providerName) + ) + ) + } + } + if (result.skippedCount > 0) Text( + Localization.string( + "backup_skipped", + result.skippedCount + ) + ) + } + if (state.isRestoreTab) RestoreBackupScreen( + page, + isEnabled, + !state.isRestoreSelectionLocked, + processIntent + ) + else CreateBackupScreen(page, isEnabled && !state.hasPendingExport, processIntent) + } + } + } + state.conflict?.let { conflict -> + AlertDialog( + onDismissRequest = { processIntent(BackupIntent.DismissConflict) }, + title = { Text(Localization.string("backup_conflict_title")) }, + text = { + Text( + Localization.string( + "backup_conflict_description", + conflict.providers.joinToString(", ", transform = ::providerName) + ) + ) + }, + confirmButton = { + TextButton(onClick = { processIntent(BackupIntent.ConfirmProviderReplacement) }) { + Text( + Localization.string("backup_replace_providers") + ) + } + }, + dismissButton = { + TextButton(onClick = { processIntent(BackupIntent.DismissConflict) }) { + Text( + Localization.string("backup_cancel") + ) + } + }) + } +} diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupScreenMode.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupScreenMode.kt new file mode 100644 index 000000000..6efb415f5 --- /dev/null +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupScreenMode.kt @@ -0,0 +1,7 @@ +package com.shifthackz.aisdv1.presentation.backup + +/** + * Controls chrome and completion behavior while reusing the same create and restore content. + * @author Dmitriy Moroz + */ +enum class BackupScreenMode { SETTINGS, FIRST_LAUNCH, WELCOME } diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupState.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupState.kt new file mode 100644 index 000000000..314d4d946 --- /dev/null +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupState.kt @@ -0,0 +1,42 @@ +package com.shifthackz.aisdv1.presentation.backup + +import com.shifthackz.aisdv1.core.mvi.MviState +import com.shifthackz.aisdv1.domain.entity.backup.BackupProgress +import com.shifthackz.aisdv1.domain.entity.backup.BackupRestoreResult + +/** + * Nonsecret backup UI state. Archive bytes and provider credential values never enter this model. + * @param create Create inventory and choices. + * @param restore Restore summary and choices. + * @param isRestoreTab Current tab, or true in first-launch restore-only mode. + * @param isBusy Whether a serialized file or commit job owns the screen. + * @param isExporting Whether graph-owned destination copying is in progress. + * @param hasPendingExport Whether a durable export intent owns the staged source. + * @param isPicking Whether a native document picker is open. + * @param progress Current bounded work stage. + * @param conflict Named provider conflicts and opaque consent fingerprint. + * @param result Durable completion report, including partial failure. + * @param hasError Whether the last operation failed before a completion report. + * @param hasCanceled Whether the user canceled active work. + * @param hasExported Whether native document export actually completed. + * @param hasPendingSession Whether unfinished restore intent owns the staged archive. + * @param isRestoreSelectionLocked Whether displayed choices are bound to a submitted or completed restore operation. + * @author Dmitriy Moroz + */ +data class BackupState( + val create: BackupPageState = BackupPageState(), + val restore: BackupPageState = BackupPageState(), + val isRestoreTab: Boolean = false, + val isBusy: Boolean = false, + val isExporting: Boolean = false, + val hasPendingExport: Boolean = false, + val isPicking: Boolean = false, + val progress: BackupProgress? = null, + val conflict: BackupRestoreResult.Conflict? = null, + val result: BackupRestoreResult.Finished? = null, + val hasError: Boolean = false, + val hasCanceled: Boolean = false, + val hasExported: Boolean = false, + val hasPendingSession: Boolean = false, + val isRestoreSelectionLocked: Boolean = false, +) : MviState diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupViewModel.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupViewModel.kt new file mode 100644 index 000000000..7808a3822 --- /dev/null +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupViewModel.kt @@ -0,0 +1,391 @@ +package com.shifthackz.aisdv1.presentation.backup + +import com.shifthackz.aisdv1.core.common.schedulers.DispatchersProvider +import com.shifthackz.aisdv1.core.mvi.BaseMviViewModel +import com.shifthackz.aisdv1.core.mvi.diagnostics.UiDiagnostics +import com.shifthackz.aisdv1.core.mvi.diagnostics.asDiagnosticScreen +import com.shifthackz.aisdv1.core.navigation.NavigationDestination +import com.shifthackz.aisdv1.core.navigation.router.BackupRouter +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory +import com.shifthackz.aisdv1.domain.entity.backup.BackupExport +import com.shifthackz.aisdv1.domain.entity.backup.BackupInspection +import com.shifthackz.aisdv1.domain.entity.backup.BackupProgress +import com.shifthackz.aisdv1.domain.entity.backup.BackupRestoreRequest +import com.shifthackz.aisdv1.domain.entity.backup.BackupRestoreResult +import com.shifthackz.aisdv1.domain.entity.backup.BackupSelection +import com.shifthackz.aisdv1.domain.entity.backup.BackupStartupStage +import com.shifthackz.aisdv1.domain.usecase.backup.CreateBackupUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.InspectBackupUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.RestoreBackupUseCase +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportCompletion +import com.shifthackz.aisdv1.domain.entity.backup.BackupExportStatus +import com.shifthackz.aisdv1.domain.usecase.backup.ObserveBackupExportUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.CompleteBackupExportUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.CancelBackupExportUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.DismissBackupExportUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.GetBackupStartupStageUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.DiscardBackupUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.LoadBackupInventoryUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.LoadPendingBackupUseCase +import com.shifthackz.aisdv1.domain.usecase.backup.SetBackupStartupStageUseCase +import kotlinx.coroutines.CancellationException +import kotlinx.coroutines.Job +import kotlinx.coroutines.withContext +import kotlin.random.Random + +/** + * Owns independent tab selections, native picker outcomes and resumable restore intent. + * @param mode Settings tabs or first-launch recovery context. + * @param router Caller-owned navigation contract. + * @param diagnostics Bounded nonsecret MVI diagnostics. + * @param dispatchers IO work and immediate UI publication dispatchers. + * @param inventory Loads current selectable app data. + * @param createBackup Creates a complete staged binary archive. + * @param inspectBackup Stages and validates a native document. + * @param restoreBackup Merges selected categories with durable retry identity. + * @param observeExport Observes graph-owned export work across host recreation. + * @param completeExport Queues native outcomes independently of screen initialization. + * @param cancelExport Interrupts destination copying while retaining its owned source. + * @param dismissExport Acknowledges export completion or abandons a staged export. + * @param getStartupStage Reads acknowledged first-launch progression after pending recovery. + * @param discardBackup Releases staging after resolving checked writes. + * @param loadPending Loads nonsecret process-recovery intent. + * @param setStartupStage Persists first-launch progression before navigation. + * @author Dmitriy Moroz + */ +class BackupViewModel( + val mode: BackupScreenMode, + private val router: BackupRouter, + diagnostics: UiDiagnostics, + private val dispatchers: DispatchersProvider, + private val inventory: LoadBackupInventoryUseCase, + private val createBackup: CreateBackupUseCase, + private val inspectBackup: InspectBackupUseCase, + private val restoreBackup: RestoreBackupUseCase, + private val observeExport: ObserveBackupExportUseCase, + private val completeExport: CompleteBackupExportUseCase, + private val cancelExport: CancelBackupExportUseCase, + private val dismissExport: DismissBackupExportUseCase, + private val getStartupStage: GetBackupStartupStageUseCase, + private val discardBackup: DiscardBackupUseCase, + private val loadPending: LoadPendingBackupUseCase, + private val setStartupStage: SetBackupStartupStageUseCase, +) : BaseMviViewModel( + diagnostics, NavigationDestination.BACKUP.asDiagnosticScreen(), + BackupState(isRestoreTab = mode == BackupScreenMode.FIRST_LAUNCH), dispatchers.immediate, +) { + private var operation: Job? = null + private var documentResult: Job? = null + private var documentResultId = 0L + private var pendingExport: BackupExport? = null + private var restoreRequest: BackupRestoreRequest? = null + + private val exportObserver = launch(dispatchers.immediate) { + observeExport().collect { export -> + pendingExport = export.backup + updateState { + it.copy( + isExporting = export.status == BackupExportStatus.COPYING || export.status == BackupExportStatus.PROCESSING, + hasPendingExport = export.backup != null, + hasExported = export.status == BackupExportStatus.COMPLETE, + hasCanceled = it.hasCanceled || export.status == BackupExportStatus.CANCELED, + hasError = it.hasError || export.status == BackupExportStatus.FAILED, + ) + } + } + } + + init { + if (mode != BackupScreenMode.WELCOME) runOperation { + val recovery = loadPending() + if (recovery != null) { + restoreRequest = recovery.request + updateState { + it.copy( + isRestoreTab = true, + hasPendingSession = true, + isRestoreSelectionLocked = true, + restore = BackupPageState(recovery.inspection, recovery.request.selection) + ) + } + } + if (recovery == null && mode == BackupScreenMode.FIRST_LAUNCH) { + when (getStartupStage()) { + BackupStartupStage.CONFIGURATION -> { + withContext(dispatchers.immediate) { router.navigateToInitialConfiguration() } + return@runOperation + } + + BackupStartupStage.COMPLETE -> { + withContext(dispatchers.immediate) { router.navigateToHomeScreen() } + return@runOperation + } + + BackupStartupStage.INVITATION, BackupStartupStage.RESTORE -> Unit + } + } + val values = inventory() + updateState { it.copy(create = BackupPageState(values, allSelected(values))) } + } + } + + /** + * Applies UI choices or native document outcomes while rejecting overlapping jobs. + * @param intent User action or native document picker result. + * @author Dmitriy Moroz + */ + override fun processIntent(intent: BackupIntent) { + when (intent) { + BackupIntent.CancelWork -> { + documentResult?.cancel(); operation?.cancel(); cancelExport() + } + + BackupIntent.NavigateBack -> if (canInteract()) leave() + BackupIntent.Continue -> transition(BackupStartupStage.CONFIGURATION) { router.navigateToInitialConfiguration() } + BackupIntent.BeginInitialRestore -> transition(BackupStartupStage.RESTORE) { router.navigateToInitialRestore() } + is BackupIntent.SelectTab -> if (canInteract()) updateState { + it.copy( + isRestoreTab = intent.isRestore, + result = null, + hasError = false, + hasCanceled = false + ) + } + + is BackupIntent.ToggleCategory -> if (canEdit()) editPage { page -> + val selected = page.selection.categories + val categories = + if (intent.category in selected) selected - intent.category else selected + intent.category + val providers = if (intent.category == BackupCategory.PROVIDERS) { + if (intent.category in categories) page.inspection?.providers.orEmpty() else emptySet() + } else page.selection.providers + page.copy(selection = BackupSelection(categories, providers)) + } + + is BackupIntent.ToggleProvider -> if (canEdit()) editPage { page -> + val providers = + page.selection.providers.let { if (intent.key in it) it - intent.key else it + intent.key } + val categories = + if (providers.isEmpty()) page.selection.categories - BackupCategory.PROVIDERS else page.selection.categories + BackupCategory.PROVIDERS + page.copy(selection = BackupSelection(categories, providers)) + } + + BackupIntent.ToggleProvidersExpanded -> if (canInteract()) editPage { + it.copy( + areProvidersExpanded = !it.areProvidersExpanded + ) + } + + BackupIntent.ChooseFile -> if (canInteract()) runOperation { + updateState { it.copy(isPicking = true) } + emitEffect(BackupEffect.OpenDocument) + } + + is BackupIntent.DocumentSelected -> selectDocument(intent.document) + + BackupIntent.Submit -> if (canInteract()) submit(null) + BackupIntent.ConfirmProviderReplacement -> currentState.conflict?.let { submit(it.fingerprint) } + BackupIntent.DismissConflict -> { + if (!currentState.hasPendingSession) restoreRequest = null + updateState { + it.copy( + conflict = null, + isRestoreSelectionLocked = restoreRequest != null + ) + } + } + + is BackupIntent.ExportFinished -> completeExport(intent) + } + } + + private fun selectDocument(document: String?) { + if (document == null) { + updateState { it.copy(isPicking = false) } + return + } + documentResult?.cancel() + val resultId = ++documentResultId + val preceding = operation + updateState { it.copy(isPicking = true) } + documentResult = launch(dispatchers.io) { + try { + preceding?.join() + withContext(dispatchers.immediate) { + updateState { it.copy(isPicking = false, isRestoreTab = true) } + runOperation { + val inspected = inspectBackup(document, ::progress) + try { + clearRestore() + } catch (failure: Throwable) { + discardBackup(inspected.handle) + throw failure + } + updateState { + it.copy( + restore = BackupPageState(inspected, allSelected(inspected)), + hasPendingSession = false, + isRestoreSelectionLocked = false, + result = null, + ) + } + } + } + } finally { + if (resultId == documentResultId) updateState { it.copy(isPicking = false) } + } + } + } + + private fun submit(fingerprint: String?) { + val snapshot = currentState + if (!snapshot.isRestoreTab) { + if (snapshot.create.selection.categories.isEmpty()) return + runOperation { + val backup = pendingExport ?: createBackup(snapshot.create.selection, ::progress) + pendingExport = backup + updateState { it.copy(isPicking = true) } + emitEffect(BackupEffect.ExportDocument(backup)) + } + } else { + val inspection = snapshot.restore.inspection ?: return + if (snapshot.restore.selection.categories.isEmpty()) return + val request = (restoreRequest ?: BackupRestoreRequest( + inspection.handle, + snapshot.restore.selection, + newSessionId(), + shouldProceedToConfiguration = mode == BackupScreenMode.FIRST_LAUNCH + )).copy(confirmedFingerprint = fingerprint) + restoreRequest = request + updateState { it.copy(conflict = null, isRestoreSelectionLocked = true) } + runOperation { + when (val result = restoreBackup(request, ::progress)) { + is BackupRestoreResult.Conflict -> updateState { it.copy(conflict = result) } + is BackupRestoreResult.Finished -> { + updateState { + it.copy( + result = result, + hasPendingSession = result.hasFailed + ) + } + if (!result.hasFailed && mode == BackupScreenMode.FIRST_LAUNCH) { + setStartupStage(BackupStartupStage.CONFIGURATION) + discardBackup(inspection.handle) + restoreRequest = null + withContext(dispatchers.immediate) { router.navigateToInitialConfiguration() } + } + } + } + } + } + } + + private fun completeExport(result: BackupIntent.ExportFinished) { + updateState { it.copy(isPicking = false, isExporting = true) } + // This callback may precede asynchronous initialization on a recreated host. + completeExport( + when { + result.destination != null -> BackupExportCompletion.DestinationSelected( + result.destination, + result.handle + ) + + result.hasExported -> BackupExportCompletion.NativeCompleted(result.handle) + else -> BackupExportCompletion.Canceled(result.handle) + } + ) + } + + private fun leave() = runOperation { + if (mode == BackupScreenMode.FIRST_LAUNCH) setStartupStage(BackupStartupStage.CONFIGURATION) + clearRestore() + dismissExport() + pendingExport = null + if (mode == BackupScreenMode.FIRST_LAUNCH) { + withContext(dispatchers.immediate) { router.navigateToInitialConfiguration() } + } else withContext(dispatchers.immediate) { router.navigateBack() } + } + + private suspend fun clearRestore() { + currentState.restore.inspection?.let { discardBackup(it.handle) } + restoreRequest = null + updateState { + it.copy( + restore = BackupPageState(), + hasPendingSession = false, + isRestoreSelectionLocked = false + ) + } + } + + private fun transition(stage: BackupStartupStage, navigate: () -> Unit) { + if (!canInteract()) return + runOperation { + setStartupStage(stage) + withContext(dispatchers.immediate) { navigate() } + } + } + + private fun runOperation(block: suspend () -> Unit) { + if (operation?.isActive == true) return + updateState { + it.copy( + isBusy = true, + hasError = false, + hasCanceled = false, + progress = null + ) + } + operation = launch(dispatchers.io) { + try { + block() + } catch (cancelled: CancellationException) { + updateState { it.copy(hasCanceled = true) } + throw cancelled + } catch (_: Exception) { + updateState { it.copy(hasError = true) } + } finally { + updateState { it.copy(isBusy = false, progress = null) } + } + } + } + + private fun progress(value: BackupProgress) = updateState { it.copy(progress = value) } + private fun canInteract() = + !currentState.isBusy && !currentState.isPicking && !currentState.isExporting + + private fun canEdit() = + canInteract() && (if (currentState.isRestoreTab) !currentState.isRestoreSelectionLocked else !currentState.hasPendingExport) + + private fun editPage(transform: (BackupPageState) -> BackupPageState) = updateState { + if (it.isRestoreTab) it.copy(restore = transform(it.restore)) else it.copy( + create = transform( + it.create + ) + ) + } + + private fun allSelected(summary: BackupInspection) = + BackupSelection( + summary.entries.filter { it.isAvailable }.map { it.category }.toSet(), + summary.providers + ) + + private fun newSessionId(): String = + List(16) { Random.nextInt(256).toString(16).padStart(2, '0') }.joinToString("").let { + it.take(8) + "-" + it.substring(8, 12) + "-" + it.substring( + 12, + 16 + ) + "-" + it.substring(16, 20) + "-" + it.substring(20) + } + + /** + * Stops owned work on route disposal. Interrupted restore staging remains journal-owned for recovery. + * @author Dmitriy Moroz + */ + fun onRouteDisposed() { + documentResult?.cancel() + operation?.cancel() + exportObserver.cancel() + } +} diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/component/BackupSelectionList.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/component/BackupSelectionList.kt new file mode 100644 index 000000000..fcf74874d --- /dev/null +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/component/BackupSelectionList.kt @@ -0,0 +1,150 @@ +package com.shifthackz.aisdv1.presentation.backup.component + +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Row +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.heightIn +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.layout.size +import androidx.compose.foundation.selection.triStateToggleable +import androidx.compose.foundation.selection.toggleable +import androidx.compose.material.icons.Icons +import androidx.compose.material.icons.filled.ExpandLess +import androidx.compose.material.icons.filled.ExpandMore +import androidx.compose.material3.Card +import androidx.compose.material3.Checkbox +import androidx.compose.material3.Icon +import androidx.compose.material3.IconButton +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.Text +import androidx.compose.material3.TriStateCheckbox +import androidx.compose.runtime.Composable +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.semantics.Role +import androidx.compose.ui.state.ToggleableState +import androidx.compose.ui.unit.dp +import com.shifthackz.aisdv1.domain.entity.ServerSource +import com.shifthackz.aisdv1.presentation.components.model.shortDisplayName +import com.shifthackz.aisdv1.core.localization.Localization +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory +import com.shifthackz.aisdv1.presentation.backup.BackupPageState +import com.shifthackz.aisdv1.presentation.backup.BackupIntent + +/** + * Shared category and nested-provider selection for create and restore. Selection is always caller-owned. + * @param state Current page inventory and choices; contains no credential values. + * @param isEnabled Whether selection can change during this operation. + * @param processIntent Receives selection and disclosure actions. + * @param modifier Layout applied to the root list container. + * @author Dmitriy Moroz + */ +@Composable +internal fun BackupSelectionList( + state: BackupPageState, + isEnabled: Boolean, + processIntent: (BackupIntent) -> Unit, + modifier: Modifier = Modifier +) { + Column(modifier) { + state.inspection?.entries?.forEach { entry -> + val category = entry.category + val isSelected = category in state.selection.categories + val hasSomeProviders = + category == BackupCategory.PROVIDERS && state.selection.providers.isNotEmpty() + val hasAllProviders = state.selection.providers.containsAll(state.inspection.providers) + Card(Modifier.fillMaxWidth().padding(vertical = 6.dp)) { + Row( + Modifier.fillMaxWidth().then( + if (category == BackupCategory.PROVIDERS) Modifier.triStateToggleable( + state = when { + hasSomeProviders && !hasAllProviders -> ToggleableState.Indeterminate + isSelected -> ToggleableState.On + else -> ToggleableState.Off + }, + enabled = isEnabled && entry.isAvailable, + role = Role.Checkbox, + onClick = { processIntent(BackupIntent.ToggleCategory(category)) }, + ) else Modifier.toggleable( + value = isSelected, + enabled = isEnabled && entry.isAvailable, + role = Role.Checkbox, + onValueChange = { processIntent(BackupIntent.ToggleCategory(category)) }, + ) + ).padding(horizontal = 16.dp, vertical = 12.dp), + verticalAlignment = Alignment.CenterVertically + ) { + if (category == BackupCategory.PROVIDERS) { + TriStateCheckbox( + state = when { + hasSomeProviders && !hasAllProviders -> ToggleableState.Indeterminate + isSelected -> ToggleableState.On + else -> ToggleableState.Off + }, onClick = null, enabled = isEnabled && entry.isAvailable + ) + } else Checkbox( + checked = isSelected, + onCheckedChange = null, + enabled = isEnabled && entry.isAvailable + ) + Spacer(Modifier.size(12.dp)) + Column(Modifier.weight(1f)) { + Text( + Localization.string("backup_category_" + category.key), + style = MaterialTheme.typography.titleMedium + ) + Text( + if (entry.isAvailable) Localization.string( + "backup_items", + entry.itemCount + ) else Localization.string("backup_unavailable"), + style = MaterialTheme.typography.bodyMedium, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + } + if (category == BackupCategory.PROVIDERS && state.inspection.providers.isNotEmpty()) IconButton( + onClick = { processIntent(BackupIntent.ToggleProvidersExpanded) }, + enabled = isEnabled + ) { + Icon( + if (state.areProvidersExpanded) Icons.Default.ExpandLess else Icons.Default.ExpandMore, + Localization.string("backup_provider_choices") + ) + } + } + if (category == BackupCategory.PROVIDERS && state.areProvidersExpanded) { + state.inspection.providers.sorted().forEach { provider -> + Row( + Modifier.fillMaxWidth().heightIn(min = 48.dp).toggleable( + value = provider in state.selection.providers, + enabled = isEnabled && entry.isAvailable, + role = Role.Checkbox, + onValueChange = { processIntent(BackupIntent.ToggleProvider(provider)) }, + ).padding(start = 44.dp, end = 16.dp, top = 8.dp, bottom = 8.dp), + verticalAlignment = Alignment.CenterVertically + ) { + Checkbox( + checked = provider in state.selection.providers, + onCheckedChange = null, + enabled = isEnabled && entry.isAvailable + ) + Spacer(Modifier.size(12.dp)) + Text(providerName(provider), style = MaterialTheme.typography.bodyLarge) + } + } + } + } + } + } +} + +/** + * Resolves a known stable provider ID through the existing localized short display-name mapping. + * Unknown IDs retain their literal identifier so inspection can still describe unsupported data. + * + * @param key Stable provider wire identifier from backup metadata. + * @author Dmitriy Moroz + */ +internal fun providerName(key: String): String = + ServerSource.entries.firstOrNull { it.key == key }?.shortDisplayName() ?: key diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/create/CreateBackupScreen.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/create/CreateBackupScreen.kt new file mode 100644 index 000000000..71e3afcf4 --- /dev/null +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/create/CreateBackupScreen.kt @@ -0,0 +1,41 @@ +package com.shifthackz.aisdv1.presentation.backup.create + +import androidx.compose.foundation.layout.Column +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.ui.Modifier +import com.shifthackz.aisdv1.core.localization.Localization +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory +import com.shifthackz.aisdv1.presentation.backup.BackupPageState +import com.shifthackz.aisdv1.presentation.backup.BackupIntent +import com.shifthackz.aisdv1.presentation.backup.component.BackupSelectionList + +/** + * Dedicated reusable create content with a visible portable-credential disclosure. + * @param state Create inventory and independent selection. + * @param isEnabled Whether the checklist can be edited. + * @param processIntent Selection and navigation actions. + * @param modifier Root content placement. + * @author Dmitriy Moroz + */ +@Composable +internal fun CreateBackupScreen( + state: BackupPageState, + isEnabled: Boolean, + processIntent: (BackupIntent) -> Unit, + modifier: Modifier = Modifier +) { + Column(modifier) { + Text( + Localization.string("backup_create_description"), + style = MaterialTheme.typography.bodyLarge + ) + BackupSelectionList(state, isEnabled, processIntent) + if (BackupCategory.PROVIDERS in state.selection.categories) Text( + Localization.string("backup_secrets_warning"), + color = MaterialTheme.colorScheme.error, + style = MaterialTheme.typography.bodyMedium + ) + } +} diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/di/BackupViewModelModule.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/di/BackupViewModelModule.kt new file mode 100644 index 000000000..9128d6251 --- /dev/null +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/di/BackupViewModelModule.kt @@ -0,0 +1,36 @@ +package com.shifthackz.aisdv1.presentation.backup.di + +import com.shifthackz.aisdv1.core.navigation.router.BackupRouter +import com.shifthackz.aisdv1.presentation.backup.BackupScreenMode +import com.shifthackz.aisdv1.presentation.backup.BackupViewModel +import com.shifthackz.aisdv1.domain.gateway.backup.BackupChangesGateway +import com.shifthackz.aisdv1.presentation.backup.service.BackupChangesGatewayImpl +import org.koin.dsl.module + +/** + * Creates caller-owned backup state holders with shared domain operations. + * @author Dmitriy Moroz + */ +val backupViewModelModule = module { + single { BackupChangesGatewayImpl(get(), get()) } + factory { (mode: BackupScreenMode, router: BackupRouter) -> + BackupViewModel( + mode, + router, + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get(), + get() + ) + } +} diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDateFormatter.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDateFormatter.kt new file mode 100644 index 000000000..974b95919 --- /dev/null +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDateFormatter.kt @@ -0,0 +1,8 @@ +package com.shifthackz.aisdv1.presentation.backup.platform + +/** + * Formats a UTC timestamp using the current platform locale and date/time conventions. + * @param epochMillis Archive creation time in milliseconds since the Unix epoch. + * @author Dmitriy Moroz + */ +internal expect fun formatBackupCreatedAt(epochMillis: Long): String diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDocumentLauncher.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDocumentLauncher.kt new file mode 100644 index 000000000..c18a6baa4 --- /dev/null +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDocumentLauncher.kt @@ -0,0 +1,35 @@ +package com.shifthackz.aisdv1.presentation.backup.platform + +import androidx.compose.runtime.Composable +import com.shifthackz.aisdv1.domain.entity.backup.BackupExport + +/** + * Native document presentation owned by the Compose route lifecycle. + * @author Dmitriy Moroz + */ +interface BackupDocumentLauncher { + /** + * Opens a single backup file using the system document picker. + * @author Dmitriy Moroz + */ + fun open() + + /** + * Presents native export for a complete staged document. + * @param backup Private staged document and suggested public filename. + * @author Dmitriy Moroz + */ + fun export(backup: BackupExport) +} + +/** + * Remembers native activity-result launchers or a retained UIKit document delegate. + * @param onPicked Opaque selected document, or null after neutral cancellation. + * @param onExported Android destination reference or iOS completion flag; cancellation reports neither. + * @author Dmitriy Moroz + */ +@Composable +expect fun rememberBackupDocumentLauncher( + onPicked: (String?) -> Unit, + onExported: (String?, Boolean, String) -> Unit +): BackupDocumentLauncher diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/restore/RestoreBackupScreen.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/restore/RestoreBackupScreen.kt new file mode 100644 index 000000000..0d62d6cf9 --- /dev/null +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/restore/RestoreBackupScreen.kt @@ -0,0 +1,73 @@ +package com.shifthackz.aisdv1.presentation.backup.restore + +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.height +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.OutlinedButton +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.ui.Modifier +import androidx.compose.ui.unit.dp +import com.shifthackz.aisdv1.presentation.backup.platform.formatBackupCreatedAt +import com.shifthackz.aisdv1.core.localization.Localization +import com.shifthackz.aisdv1.presentation.backup.BackupPageState +import com.shifthackz.aisdv1.presentation.backup.BackupIntent +import com.shifthackz.aisdv1.presentation.backup.component.BackupSelectionList + +/** + * Dedicated restore content shared by settings tabs and first-launch recovery. + * @param state Inspected file summary and category choices. + * @param isEnabled Whether a new file can be selected. + * @param canEditSelection Whether choices are still editable before a journal-bound restore. + * @param processIntent Native picker and selection requests. + * @param modifier Root content placement. + * @author Dmitriy Moroz + */ +@Composable +internal fun RestoreBackupScreen( + state: BackupPageState, + isEnabled: Boolean, + canEditSelection: Boolean, + processIntent: (BackupIntent) -> Unit, + modifier: Modifier = Modifier +) { + Column(modifier) { + Text( + Localization.string("backup_restore_description"), + style = MaterialTheme.typography.bodyLarge + ) + Spacer(Modifier.height(16.dp)) + OutlinedButton( + onClick = { processIntent(BackupIntent.ChooseFile) }, + enabled = isEnabled + ) { Text(Localization.string("backup_choose_file")) } + state.inspection?.let { archive -> + Spacer(Modifier.height(16.dp)) + Text(archive.filename, style = MaterialTheme.typography.titleMedium) + Text( + Localization.string( + "backup_archive_details", + archive.appVersion, + archive.sourcePlatform + ), style = MaterialTheme.typography.titleSmall + ) + Text( + Localization.string("backup_created_at", formatBackupCreatedAt(archive.createdAt)), + style = MaterialTheme.typography.bodySmall + ) + if (archive.skippedCount > 0) Text( + Localization.string( + "backup_skipped", + archive.skippedCount + ), color = MaterialTheme.colorScheme.onSurfaceVariant + ) + BackupSelectionList(state, isEnabled && canEditSelection, processIntent) + Text( + Localization.string("backup_secrets_warning"), + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + } + } +} diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/service/BackupChangesGatewayImpl.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/service/BackupChangesGatewayImpl.kt new file mode 100644 index 000000000..e4558037c --- /dev/null +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/service/BackupChangesGatewayImpl.kt @@ -0,0 +1,24 @@ +package com.shifthackz.aisdv1.presentation.backup.service + +import com.shifthackz.aisdv1.core.localization.Localization +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory +import com.shifthackz.aisdv1.domain.gateway.backup.BackupChangesGateway +import com.shifthackz.aisdv1.domain.preference.PreferenceManager +import com.shifthackz.aisdv1.presentation.components.service.storage.StorageUsageObserver + +/** + * Keeps retained UI snapshots consistent with committed portable data without feature-to-presentation dependencies. + * @param preferences Current checked settings and their shared invalidation flow. + * @param storage Shared storage usage revision observed by Settings and storage screens. + * @author Dmitriy Moroz + */ +internal class BackupChangesGatewayImpl( + private val preferences: PreferenceManager, + private val storage: StorageUsageObserver +) : BackupChangesGateway { + override suspend fun notifyChanged(categories: Set) { + if (BackupCategory.SETTINGS in categories) Localization.setLanguageCode(preferences.languageCode.takeIf { it.isNotBlank() }) + if (categories.isNotEmpty()) preferences.refresh() + if (BackupCategory.GALLERY in categories) storage.notifyChanged() + } +} diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/welcome/RestoreWelcomeScreen.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/welcome/RestoreWelcomeScreen.kt new file mode 100644 index 000000000..201b84cad --- /dev/null +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/welcome/RestoreWelcomeScreen.kt @@ -0,0 +1,85 @@ +package com.shifthackz.aisdv1.presentation.backup.welcome + +import androidx.compose.foundation.layout.Arrangement +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.layout.safeDrawingPadding +import androidx.compose.foundation.layout.size +import androidx.compose.foundation.rememberScrollState +import androidx.compose.foundation.verticalScroll +import androidx.compose.material.icons.Icons +import androidx.compose.material.icons.outlined.Restore +import androidx.compose.material3.Button +import androidx.compose.material3.Icon +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.OutlinedButton +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.unit.dp +import com.shifthackz.aisdv1.core.localization.Localization + +/** + * First-launch invitation with two bottom actions and no path back to onboarding. + * @param isEnabled Whether a durable navigation transition can start. + * @param hasError Whether checked startup progression failed and can be retried. + * @param onRestore Opens restore-only recovery. + * @param onContinue Continues through provider setup toward home. + * @param modifier Root full-screen layout. + * @author Dmitriy Moroz + */ +@Composable +internal fun RestoreWelcomeScreen( + isEnabled: Boolean, + hasError: Boolean, + onRestore: () -> Unit, + onContinue: () -> Unit, + modifier: Modifier = Modifier +) { + Column( + modifier.fillMaxSize().safeDrawingPadding().padding(24.dp), + horizontalAlignment = Alignment.CenterHorizontally + ) { + Column( + Modifier.weight(1f).verticalScroll(rememberScrollState()), + verticalArrangement = Arrangement.Center, + horizontalAlignment = Alignment.CenterHorizontally + ) { + Icon( + Icons.Outlined.Restore, + null, + Modifier.size(96.dp), + tint = MaterialTheme.colorScheme.primary + ) + Spacer(Modifier.size(32.dp)) + Text( + Localization.string("backup_welcome_title"), + style = MaterialTheme.typography.headlineLarge + ) + Spacer(Modifier.size(16.dp)) + Text( + Localization.string("backup_welcome_description"), + style = MaterialTheme.typography.bodyLarge, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + } + if (hasError) Text( + Localization.string("backup_error"), + color = MaterialTheme.colorScheme.error + ) + Button(onClick = onRestore, enabled = isEnabled, modifier = Modifier.fillMaxWidth()) { + Text( + Localization.string("backup_restore_from_file") + ) + } + OutlinedButton( + onClick = onContinue, + enabled = isEnabled, + modifier = Modifier.fillMaxWidth() + ) { Text(Localization.string("backup_continue")) } + } +} diff --git a/presentation/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDateFormatter.ios.kt b/presentation/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDateFormatter.ios.kt new file mode 100644 index 000000000..7fdc8a361 --- /dev/null +++ b/presentation/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDateFormatter.ios.kt @@ -0,0 +1,16 @@ +package com.shifthackz.aisdv1.presentation.backup.platform + +import platform.Foundation.NSDate +import platform.Foundation.NSDateFormatter +import platform.Foundation.NSDateFormatterMediumStyle +import platform.Foundation.NSDateFormatterShortStyle + +/** + * Formats a UTC timestamp using the current platform locale and date/time conventions. + * @param epochMillis Archive creation time in milliseconds since the Unix epoch. + * @author Dmitriy Moroz + */ +internal actual fun formatBackupCreatedAt(epochMillis: Long): String = NSDateFormatter().apply { + dateStyle = NSDateFormatterMediumStyle + timeStyle = NSDateFormatterShortStyle +}.stringFromDate(NSDate(timeIntervalSinceReferenceDate = epochMillis / 1000.0 - 978307200.0)) diff --git a/presentation/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDocumentLauncher.ios.kt b/presentation/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDocumentLauncher.ios.kt new file mode 100644 index 000000000..78698f0fb --- /dev/null +++ b/presentation/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/presentation/backup/platform/BackupDocumentLauncher.ios.kt @@ -0,0 +1,130 @@ +package com.shifthackz.aisdv1.presentation.backup.platform + +import androidx.compose.runtime.Composable +import androidx.compose.runtime.DisposableEffect +import androidx.compose.runtime.remember +import androidx.compose.runtime.rememberUpdatedState +import com.shifthackz.aisdv1.domain.entity.backup.BackupExport +import platform.Foundation.NSURL +import platform.UIKit.UIApplication +import platform.UIKit.UIDocumentPickerDelegateProtocol +import platform.UIKit.UIDocumentPickerViewController +import platform.UIKit.UIViewController +import platform.UIKit.UIWindow +import platform.UniformTypeIdentifiers.UTTypeData +import platform.darwin.NSObject + +/** + * Retains UIKit delegate callbacks for import/export and treats picker cancellation as neutral. + * @param onPicked Receives a sandbox-copy URL; no persistent security-scoped grant is retained. + * @param onExported Receives true only after UIKit confirms completed export. + * @author Dmitriy Moroz + */ +@Composable +actual fun rememberBackupDocumentLauncher( + onPicked: (String?) -> Unit, + onExported: (String?, Boolean, String) -> Unit +): BackupDocumentLauncher { + val picked = rememberUpdatedState(onPicked) + val exported = rememberUpdatedState(onExported) + val launcher = + remember { + IosBackupDocumentLauncher( + { picked.value(it) }, + { hasExported, handle -> exported.value(null, hasExported, handle) }) + } + DisposableEffect(launcher) { onDispose { launcher.release() } } + return launcher +} + +/** + * Owns the native modal and delegate until its result is delivered. + * @param onPicked Import result callback receiving only a sandbox-copy document reference. + * @param onExported Export success callback, false for cancellation. + * @author Dmitriy Moroz + */ +private class IosBackupDocumentLauncher( + private val onPicked: (String?) -> Unit, + private val onExported: (Boolean, String) -> Unit, +) : BackupDocumentLauncher { + private val delegate = BackupDocumentDelegate(::onDocumentsPicked, ::onPickerCanceled) + private var picker: UIDocumentPickerViewController? = null + private var exportHandle: String = "" + private var isExporting = false + + override fun open() { + isExporting = false + present( + UIDocumentPickerViewController( + forOpeningContentTypes = listOf(UTTypeData), + asCopy = true + ) + ) + } + + override fun export(backup: BackupExport) { + exportHandle = backup.handle + isExporting = true + val url = NSURL.URLWithString(backup.document) + if (url == null) { + onExported(false, exportHandle); return + } + present(UIDocumentPickerViewController(forExportingURLs = listOf(url), asCopy = true)) + } + + private fun present(controller: UIDocumentPickerViewController) { + val application = UIApplication.sharedApplication + val root = application.keyWindow?.rootViewController + ?: application.windows.filterIsInstance() + .firstOrNull { it.isKeyWindow() }?.rootViewController + val presenter = root?.topmost() + if (presenter == null) { + if (isExporting) onExported(false, exportHandle) else onPicked(null); return + } + picker = controller + controller.delegate = delegate + controller.allowsMultipleSelection = false + presenter.presentViewController(controller, true, null) + } + + private fun onDocumentsPicked(didPickDocumentsAtURLs: List<*>) { + if (isExporting) onExported(true, exportHandle) + else onPicked((didPickDocumentsAtURLs.firstOrNull() as? NSURL)?.absoluteString) + picker?.delegate = null + picker = null + } + + private fun onPickerCanceled() { + if (isExporting) onExported(false, exportHandle) else onPicked(null) + picker?.delegate = null + picker = null + } + + fun release() { + picker?.delegate = null + picker?.dismissViewControllerAnimated(false, null) + picker = null + } + + private fun UIViewController.topmost(): UIViewController = + presentedViewController?.topmost() ?: this +} + +/** + * Bridges Objective-C picker events without mixing Objective-C and Kotlin interface inheritance. + * @param onPicked Selected sandbox document URLs or completed export destinations. + * @param onCanceled Neutral picker cancellation. + * @author Dmitriy Moroz + */ +private class BackupDocumentDelegate( + private val onPicked: (List<*>) -> Unit, + private val onCanceled: () -> Unit, +) : NSObject(), UIDocumentPickerDelegateProtocol { + override fun documentPicker( + controller: UIDocumentPickerViewController, + didPickDocumentsAtURLs: List<*> + ) = onPicked(didPickDocumentsAtURLs) + + override fun documentPickerWasCancelled(controller: UIDocumentPickerViewController) = + onCanceled() +} diff --git a/presentation/onboarding/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/onboarding/OnBoardingViewModelSplashSourceTest.kt b/presentation/onboarding/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/onboarding/OnBoardingViewModelSplashSourceTest.kt index 6a36467e4..7fea14de8 100644 --- a/presentation/onboarding/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/onboarding/OnBoardingViewModelSplashSourceTest.kt +++ b/presentation/onboarding/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/onboarding/OnBoardingViewModelSplashSourceTest.kt @@ -2,104 +2,81 @@ package com.shifthackz.aisdv1.presentation.onboarding import com.shifthackz.aisdv1.core.common.appbuild.BuildInfoProvider import com.shifthackz.aisdv1.core.common.schedulers.DispatchersProvider -import com.shifthackz.aisdv1.domain.entity.DarkThemeToken -import com.shifthackz.aisdv1.domain.preference.PreferenceManager -import com.shifthackz.aisdv1.domain.usecase.splash.SplashNavigationUseCase import com.shifthackz.aisdv1.core.navigation.LaunchSource import com.shifthackz.aisdv1.core.navigation.router.OnBoardingRouter -import io.mockk.coEvery +import com.shifthackz.aisdv1.domain.entity.DarkThemeToken +import com.shifthackz.aisdv1.domain.entity.backup.BackupStartupStage +import com.shifthackz.aisdv1.domain.preference.PreferenceManager +import com.shifthackz.aisdv1.domain.usecase.backup.SetBackupStartupStageUseCase import io.mockk.every import io.mockk.mockk import io.mockk.verify -import kotlinx.coroutines.CoroutineDispatcher +import kotlinx.coroutines.Dispatchers import kotlinx.coroutines.ExperimentalCoroutinesApi import kotlinx.coroutines.test.StandardTestDispatcher -import kotlinx.coroutines.test.TestScope import kotlinx.coroutines.test.advanceUntilIdle +import kotlinx.coroutines.test.resetMain import kotlinx.coroutines.test.runTest -import org.junit.Before -import org.junit.Ignore +import kotlinx.coroutines.test.setMain +import org.junit.After import org.junit.Test -@Ignore("ToDo: Investigate why sometimes tests fail on remote worker due to race-conditions.") @OptIn(ExperimentalCoroutinesApi::class) class OnBoardingViewModelSplashSourceTest { + private val router = mockk(relaxed = true) + private val preferences = mockk(relaxed = true) { + every { designDarkThemeToken } returns DarkThemeToken.FRAPPE.toString() + } + private val stage = mockk(relaxed = true) - private val stubRouter = mockk(relaxed = true) - private val stubSplashNavigationUseCase = mockk() - private val stubPreferenceManager = mockk() - private val stubBuildInfoProvider = mockk() - - @Before - fun initialize() { - every { - stubPreferenceManager::designDarkThemeToken.get() - } returns DarkThemeToken.FRAPPE.toString() - - every { - stubPreferenceManager::onBoardingComplete.set(any()) - } returns Unit - - every { - stubBuildInfoProvider.toString() - } returns "" + @After + fun tearDown() { + Dispatchers.resetMain() } @Test - fun `given on boarding view model splash source, received Navigate intent from splash, expected navigation processed`() = + fun `given first launch onboarding, user completes onboarding, expected durable invitation and no old loader navigation`() = runTest { // Given - - coEvery { - stubSplashNavigationUseCase() - } returns SplashNavigationUseCase.Action.LAUNCH_HOME + val dispatcher = StandardTestDispatcher(testScheduler) + Dispatchers.setMain(dispatcher) + val viewModel = OnBoardingViewModel( + mockk(relaxed = true), + LaunchSource.SPLASH, + mockk { every { io } returns dispatcher; every { immediate } returns dispatcher }, + router, + preferences, + BuildInfoProvider.stub, + stage + ) // When - val viewModel = createViewModel(LaunchSource.SPLASH) - viewModel.processIntent(OnBoardingIntent.Navigate) advanceUntilIdle() - // Then - verify { - stubRouter.navigateToPostOnBoardingConfigLoader() - } - + verify { stage(BackupStartupStage.INVITATION); router.navigateToBackupWelcome() } + verify(exactly = 0) { router.navigateBack() } } @Test - fun `given on boarding view model splash source, received Navigate intent from settings, expected navigateBack processed`() = + fun `given settings onboarding, user completes walkthrough, expected return without first launch invitation`() = runTest { // Given - - val viewModel = createViewModel(LaunchSource.SETTINGS) - + val dispatcher = StandardTestDispatcher(testScheduler) + Dispatchers.setMain(dispatcher) + val viewModel = OnBoardingViewModel( + mockk(relaxed = true), + LaunchSource.SETTINGS, + mockk { every { io } returns dispatcher; every { immediate } returns dispatcher }, + router, + preferences, + BuildInfoProvider.stub, + stage + ) // When viewModel.processIntent(OnBoardingIntent.Navigate) - + advanceUntilIdle() // Then - verify { - stubRouter.navigateBack() - } - + verify { router.navigateBack() } + verify(exactly = 0) { stage(any()) } } - - private fun TestScope.createViewModel( - source: LaunchSource, - ): OnBoardingViewModel { - val dispatcher = StandardTestDispatcher(testScheduler) - val dispatchersProvider = object : DispatchersProvider { - override val io: CoroutineDispatcher = dispatcher - override val ui: CoroutineDispatcher = dispatcher - override val immediate: CoroutineDispatcher = dispatcher - } - return OnBoardingViewModel( - diagnostics = mockk(relaxed = true), - launchSource = source, - dispatchersProvider = dispatchersProvider, - router = stubRouter, - splashNavigationUseCase = stubSplashNavigationUseCase, - preferenceManager = stubPreferenceManager, - buildInfoProvider = stubBuildInfoProvider, - ) - } } diff --git a/presentation/onboarding/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/onboarding/OnBoardingViewModel.kt b/presentation/onboarding/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/onboarding/OnBoardingViewModel.kt index faf6e2540..c6f9d0e3e 100644 --- a/presentation/onboarding/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/onboarding/OnBoardingViewModel.kt +++ b/presentation/onboarding/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/onboarding/OnBoardingViewModel.kt @@ -7,25 +7,25 @@ import com.shifthackz.aisdv1.core.common.schedulers.DispatchersProvider import com.shifthackz.aisdv1.core.mvi.diagnostics.UiDiagnostics import com.shifthackz.aisdv1.core.mvi.BaseMviViewModel import com.shifthackz.aisdv1.core.mvi.EmptyEffect +import com.shifthackz.aisdv1.domain.entity.backup.BackupStartupStage +import com.shifthackz.aisdv1.domain.usecase.backup.SetBackupStartupStageUseCase import com.shifthackz.aisdv1.domain.entity.DarkThemeToken import com.shifthackz.aisdv1.domain.preference.PreferenceManager -import com.shifthackz.aisdv1.domain.usecase.splash.SplashNavigationUseCase import com.shifthackz.aisdv1.core.navigation.LaunchSource import com.shifthackz.aisdv1.core.navigation.router.OnBoardingRouter -import com.shifthackz.aisdv1.presentation.onboarding.navigation.postOnBoardingNavigation import kotlinx.coroutines.withContext /** - * Initializes onboarding previews from saved appearance and advances to the correct post-onboarding route. + * Initializes onboarding previews and replaces first-launch completion with the restore invitation. * Completion is persisted before navigation; a settings launch returns to the caller, while first launch - * rechecks configuration off the UI dispatcher. + * persists recovery progression off the UI dispatcher before navigating. * * @param diagnostics Optional bounded observer for MVI state transitions. * @param launchSource Distinguishes first-launch completion from revisiting onboarding through settings. * @param dispatchersProvider Runs configuration checks on IO and publishes navigation on the UI dispatcher. * @param router Receives setup, loader or back navigation after completion. - * @param splashNavigationUseCase Reassesses saved configuration after first-launch onboarding. - * @param preferenceManager Supplies preview appearance and stores the completed-onboarding flag. + * @param setBackupStartupStage Persists the fresh-install restore invitation before onboarding is consumed. + * @param preferenceManager Supplies saved preview appearance; the checked startup transition owns onboarding completion. * @param buildInfoProvider Supplies the version displayed in the appearance preview. * * @author Dmitriy Moroz @@ -35,9 +35,9 @@ class OnBoardingViewModel( val launchSource: LaunchSource, private val dispatchersProvider: DispatchersProvider, private val router: OnBoardingRouter, - private val splashNavigationUseCase: SplashNavigationUseCase, private val preferenceManager: PreferenceManager, private val buildInfoProvider: BuildInfoProvider, + private val setBackupStartupStage: SetBackupStartupStageUseCase, ) : BaseMviViewModel( diagnostics = diagnostics, diagnosticScreen = NavigationDestination.ON_BOARDING.asDiagnosticScreen(), @@ -62,16 +62,10 @@ class OnBoardingViewModel( } private fun navigate() { - preferenceManager.onBoardingComplete = true when (launchSource) { LaunchSource.SPLASH -> launch(dispatchersProvider.io) { - runCatching { splashNavigationUseCase() } - .onSuccess { action -> - withContext(dispatchersProvider.immediate) { - router.postOnBoardingNavigation(action) - } - } - .onFailure { } + setBackupStartupStage(BackupStartupStage.INVITATION) + withContext(dispatchersProvider.immediate) { router.navigateToBackupWelcome() } } LaunchSource.SETTINGS -> router.navigateBack() diff --git a/presentation/onboarding/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/onboarding/di/OnboardingViewModelModule.kt b/presentation/onboarding/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/onboarding/di/OnboardingViewModelModule.kt index f539ace76..88e8ec089 100644 --- a/presentation/onboarding/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/onboarding/di/OnboardingViewModelModule.kt +++ b/presentation/onboarding/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/onboarding/di/OnboardingViewModelModule.kt @@ -17,7 +17,7 @@ val onboardingViewModelModule = module { launchSource = launchSource, dispatchersProvider = get(), router = router, - splashNavigationUseCase = get(), + setBackupStartupStage = get(), preferenceManager = get(), buildInfoProvider = get(), ) diff --git a/presentation/onboarding/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/onboarding/navigation/OnBoardingNavigation.kt b/presentation/onboarding/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/onboarding/navigation/OnBoardingNavigation.kt deleted file mode 100644 index 17717243e..000000000 --- a/presentation/onboarding/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/onboarding/navigation/OnBoardingNavigation.kt +++ /dev/null @@ -1,20 +0,0 @@ -package com.shifthackz.aisdv1.presentation.onboarding.navigation - -import com.shifthackz.aisdv1.domain.usecase.splash.SplashNavigationUseCase -import com.shifthackz.aisdv1.core.navigation.router.OnBoardingRouter - -/** - * Maps the completed onboarding decision to setup or configuration loading. - * - * @param action Domain launch decision produced after the relevant configuration checks. - * - * @author Dmitriy Moroz - */ -fun OnBoardingRouter.postOnBoardingNavigation( - action: SplashNavigationUseCase.Action, -) = when (action) { - SplashNavigationUseCase.Action.LAUNCH_ONBOARDING, - SplashNavigationUseCase.Action.LAUNCH_SERVER_SETUP -> navigateToServerSetupAfterOnBoarding() - - SplashNavigationUseCase.Action.LAUNCH_HOME -> navigateToPostOnBoardingConfigLoader() -} diff --git a/presentation/settings/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsViewModelTest.kt b/presentation/settings/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsViewModelTest.kt index 6a37641a3..5fbc5e8ee 100644 --- a/presentation/settings/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsViewModelTest.kt +++ b/presentation/settings/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsViewModelTest.kt @@ -409,6 +409,8 @@ private object TestBuildInfoProvider : BuildInfoProvider { } private class TestSettingsRouter : SettingsRouter { + override fun navigateToBackup() = Unit + var serverSetupSource: LaunchSource? = null var storageUsageOpened = false var networkUsageOpened = false diff --git a/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsContentTypes.kt b/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsContentTypes.kt index 133428fcc..ff8204cc8 100644 --- a/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsContentTypes.kt +++ b/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsContentTypes.kt @@ -38,6 +38,7 @@ internal fun SettingsListItem.contentType(): SettingsContentType = when (this) { SettingsListItem.VERSION -> SettingsContentType.FOOTER SettingsListItem.CONFIGURATION, + SettingsListItem.BACKUP, SettingsListItem.BENCHMARK, SettingsListItem.CREDITS, SettingsListItem.CONNECTION_TIMEOUT, diff --git a/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsIntent.kt b/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsIntent.kt index cdeef8813..15e2391fd 100644 --- a/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsIntent.kt +++ b/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsIntent.kt @@ -20,6 +20,9 @@ sealed interface SettingsIntent : MviIntent { */ data object NavigateConfiguration : SettingsIntent + /** Opens portable selective backup and restore. @author Dmitriy Moroz */ + data object NavigateBackup : SettingsIntent + /** * Opens the generation waiting-limit picker. * @@ -174,6 +177,7 @@ sealed interface SettingsIntent : MviIntent { data class DarkTheme(override val flag: Boolean) : UpdateFlag } + data class NewColorToken(val token: ColorToken) : SettingsIntent data class NewDarkThemeToken(val token: DarkThemeToken) : SettingsIntent diff --git a/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsListItem.kt b/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsListItem.kt index b25f725a7..55c59dd1d 100644 --- a/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsListItem.kt +++ b/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsListItem.kt @@ -9,6 +9,7 @@ package com.shifthackz.aisdv1.presentation.settings internal enum class SettingsListItem { SERVER_HEADER, CONFIGURATION, + BACKUP, BENCHMARK, CREDITS, CONNECTION_TIMEOUT, diff --git a/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsListItems.kt b/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsListItems.kt index 43c7d15e8..4526c62da 100644 --- a/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsListItems.kt +++ b/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsListItems.kt @@ -23,6 +23,7 @@ internal fun settingsListItems( if (!state.onBoardingDemo) { add(SettingsListItem.SERVER_HEADER) add(SettingsListItem.CONFIGURATION) + add(SettingsListItem.BACKUP) add(SettingsListItem.BENCHMARK) if (state.showStabilityAiCredits) add(SettingsListItem.CREDITS) if (state.showNetworkTimeoutSettings) { diff --git a/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsViewModel.kt b/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsViewModel.kt index 61d3f4887..051732b38 100644 --- a/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsViewModel.kt +++ b/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/SettingsViewModel.kt @@ -214,6 +214,8 @@ class SettingsViewModel( it.copy(screenModal = SettingsModal.None) } + SettingsIntent.NavigateBackup -> router.navigateToBackup() + SettingsIntent.NavigateConfiguration -> router.navigateToServerSetup( LaunchSource.SETTINGS, ) diff --git a/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/content/SettingsContent.kt b/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/content/SettingsContent.kt index 3bc8a17eb..50369bb77 100644 --- a/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/content/SettingsContent.kt +++ b/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/content/SettingsContent.kt @@ -66,6 +66,7 @@ internal fun ContentSettingsState( when (row) { SettingsListItem.SERVER_HEADER, SettingsListItem.CONFIGURATION, + SettingsListItem.BACKUP, SettingsListItem.BENCHMARK, SettingsListItem.CREDITS, SettingsListItem.CONNECTION_TIMEOUT, diff --git a/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/section/SettingsServerSection.kt b/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/section/SettingsServerSection.kt index 73d3a302e..ec0978958 100644 --- a/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/section/SettingsServerSection.kt +++ b/presentation/settings/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/settings/section/SettingsServerSection.kt @@ -1,5 +1,6 @@ package com.shifthackz.aisdv1.presentation.settings.section +import androidx.compose.material.icons.filled.Backup import androidx.compose.material.icons.Icons import androidx.compose.material.icons.filled.AccountTree import androidx.compose.material.icons.filled.AutoFixNormal @@ -80,6 +81,16 @@ internal fun SettingsServerSection( ) } + SettingsListItem.BACKUP -> { + SettingsItem( + modifier = itemModifier, + loading = isLoading, + startIcon = Icons.Default.Backup, + text = text("backup_title"), + onClick = { processIntent(SettingsIntent.NavigateBackup) }, + ) + } + SettingsListItem.BENCHMARK -> { SettingsItem( modifier = itemModifier, diff --git a/presentation/splash/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/splash/navigation/SplashNavigation.kt b/presentation/splash/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/splash/navigation/SplashNavigation.kt index d9a90f6a5..f12b87b91 100644 --- a/presentation/splash/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/splash/navigation/SplashNavigation.kt +++ b/presentation/splash/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/splash/navigation/SplashNavigation.kt @@ -14,6 +14,9 @@ fun SplashRouter.postSplashNavigation( action: SplashNavigationUseCase.Action, ) { when (action) { + SplashNavigationUseCase.Action.LAUNCH_BACKUP_WELCOME -> navigateToBackupWelcome() + SplashNavigationUseCase.Action.LAUNCH_INITIAL_RESTORE -> navigateToInitialRestore() + SplashNavigationUseCase.Action.LAUNCH_BACKUP_RESTORE -> navigateToBackupRestore() SplashNavigationUseCase.Action.LAUNCH_ONBOARDING -> navigateToOnBoardingFromSplash() SplashNavigationUseCase.Action.LAUNCH_SERVER_SETUP -> navigateToServerSetupFromSplash() SplashNavigationUseCase.Action.LAUNCH_HOME -> navigateToPostSplashConfigLoader() diff --git a/settings.gradle.kts b/settings.gradle.kts index 3030d06a6..1e85c78b5 100755 --- a/settings.gradle.kts +++ b/settings.gradle.kts @@ -35,6 +35,7 @@ val modules = listOf( ":demo", ":domain", ":feature:auth", + ":feature:backup", ":feature:openai-oauth", ":feature:benchmark", ":feature:bonsai", @@ -47,6 +48,7 @@ val modules = listOf( ":network", ":presentation:app", ":presentation:benchmark", + ":presentation:backup", ":presentation:components", ":presentation:configuration", ":presentation:debug", diff --git a/storage/schemas/com.shifthackz.aisdv1.storage.db.persistent.PersistentDatabase/14.json b/storage/schemas/com.shifthackz.aisdv1.storage.db.persistent.PersistentDatabase/14.json new file mode 100644 index 000000000..16ff7a3f1 --- /dev/null +++ b/storage/schemas/com.shifthackz.aisdv1.storage.db.persistent.PersistentDatabase/14.json @@ -0,0 +1,551 @@ +{ + "formatVersion": 1, + "database": { + "version": 14, + "identityHash": "3631519f530e6340c0c1728a9cfeedd4", + "entities": [ + { + "tableName": "generation_results", + "createSql": "CREATE TABLE IF NOT EXISTS `${TABLE_NAME}` (`id` INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL, `image_base_64` TEXT NOT NULL, `original_image_base_64` TEXT NOT NULL, `created_at` INTEGER NOT NULL, `generation_type` TEXT NOT NULL, `prompt` TEXT NOT NULL, `negative_prompt` TEXT NOT NULL, `width` INTEGER NOT NULL, `height` INTEGER NOT NULL, `sampling_steps` INTEGER NOT NULL, `cfg_scale` REAL NOT NULL, `restore_faces` INTEGER NOT NULL, `sampler` TEXT NOT NULL, `seed` TEXT NOT NULL, `sub_seed` TEXT NOT NULL DEFAULT '', `sub_seed_strength` REAL NOT NULL DEFAULT 0.0, `denoising_strength` REAL NOT NULL DEFAULT 0.0, `hidden` INTEGER NOT NULL DEFAULT 0, `liked` INTEGER NOT NULL DEFAULT 0, `model_name` TEXT NOT NULL DEFAULT '', `image_revision` TEXT NOT NULL DEFAULT '')", + "fields": [ + { + "fieldPath": "id", + "columnName": "id", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "imageBase64", + "columnName": "image_base_64", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "originalImageBase64", + "columnName": "original_image_base_64", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "createdAt", + "columnName": "created_at", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "generationType", + "columnName": "generation_type", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "prompt", + "columnName": "prompt", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "negativePrompt", + "columnName": "negative_prompt", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "width", + "columnName": "width", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "height", + "columnName": "height", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "samplingSteps", + "columnName": "sampling_steps", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "cfgScale", + "columnName": "cfg_scale", + "affinity": "REAL", + "notNull": true + }, + { + "fieldPath": "restoreFaces", + "columnName": "restore_faces", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "sampler", + "columnName": "sampler", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "seed", + "columnName": "seed", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "subSeed", + "columnName": "sub_seed", + "affinity": "TEXT", + "notNull": true, + "defaultValue": "''" + }, + { + "fieldPath": "subSeedStrength", + "columnName": "sub_seed_strength", + "affinity": "REAL", + "notNull": true, + "defaultValue": "0.0" + }, + { + "fieldPath": "denoisingStrength", + "columnName": "denoising_strength", + "affinity": "REAL", + "notNull": true, + "defaultValue": "0.0" + }, + { + "fieldPath": "hidden", + "columnName": "hidden", + "affinity": "INTEGER", + "notNull": true, + "defaultValue": "0" + }, + { + "fieldPath": "liked", + "columnName": "liked", + "affinity": "INTEGER", + "notNull": true, + "defaultValue": "0" + }, + { + "fieldPath": "modelName", + "columnName": "model_name", + "affinity": "TEXT", + "notNull": true, + "defaultValue": "''" + }, + { + "fieldPath": "imageRevision", + "columnName": "image_revision", + "affinity": "TEXT", + "notNull": true, + "defaultValue": "''" + } + ], + "primaryKey": { + "autoGenerate": true, + "columnNames": ["id"] + }, + "indices": [ + { + "name": "index_generation_results_created_at", + "unique": false, + "columnNames": ["created_at"], + "orders": [], + "createSql": "CREATE INDEX IF NOT EXISTS `index_generation_results_created_at` ON `${TABLE_NAME}` (`created_at`)" + } + ] + }, + { + "tableName": "local_models", + "createSql": "CREATE TABLE IF NOT EXISTS `${TABLE_NAME}` (`id` TEXT NOT NULL, `type` TEXT NOT NULL DEFAULT 'onnx', `name` TEXT NOT NULL, `size` TEXT NOT NULL, `sources` TEXT NOT NULL, PRIMARY KEY(`id`))", + "fields": [ + { + "fieldPath": "id", + "columnName": "id", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "type", + "columnName": "type", + "affinity": "TEXT", + "notNull": true, + "defaultValue": "'onnx'" + }, + { + "fieldPath": "name", + "columnName": "name", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "size", + "columnName": "size", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "sources", + "columnName": "sources", + "affinity": "TEXT", + "notNull": true + } + ], + "primaryKey": { + "autoGenerate": false, + "columnNames": ["id"] + } + }, + { + "tableName": "hugging_face_models", + "createSql": "CREATE TABLE IF NOT EXISTS `${TABLE_NAME}` (`id` TEXT NOT NULL, `name` TEXT NOT NULL, `alias` TEXT NOT NULL, `source` TEXT NOT NULL, PRIMARY KEY(`id`))", + "fields": [ + { + "fieldPath": "id", + "columnName": "id", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "name", + "columnName": "name", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "alias", + "columnName": "alias", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "source", + "columnName": "source", + "affinity": "TEXT", + "notNull": true + } + ], + "primaryKey": { + "autoGenerate": false, + "columnNames": ["id"] + } + }, + { + "tableName": "supporters", + "createSql": "CREATE TABLE IF NOT EXISTS `${TABLE_NAME}` (`id` INTEGER NOT NULL, `name` TEXT NOT NULL, `date` INTEGER NOT NULL, `message` TEXT NOT NULL, PRIMARY KEY(`id`))", + "fields": [ + { + "fieldPath": "id", + "columnName": "id", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "name", + "columnName": "name", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "date", + "columnName": "date", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "message", + "columnName": "message", + "affinity": "TEXT", + "notNull": true + } + ], + "primaryKey": { + "autoGenerate": false, + "columnNames": ["id"] + } + }, + { + "tableName": "benchmark_result", + "createSql": "CREATE TABLE IF NOT EXISTS `${TABLE_NAME}` (`id` INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL, `created_at` INTEGER NOT NULL, `platform` TEXT NOT NULL, `manufacturer` TEXT NOT NULL, `model` TEXT NOT NULL, `os_version` TEXT NOT NULL, `cpu_name` TEXT NOT NULL, `cpu_cores` INTEGER NOT NULL, `gpu_name` TEXT NOT NULL, `total_ram_mb` INTEGER NOT NULL, `available_ram_mb` INTEGER NOT NULL, `total_vram_mb` INTEGER NOT NULL, `available_vram_mb` INTEGER NOT NULL, `accelerators` TEXT NOT NULL, `cpu_score` INTEGER NOT NULL, `memory_score` INTEGER NOT NULL, `accelerator_score` INTEGER NOT NULL, `total_score` INTEGER NOT NULL, `estimated_time_seconds` INTEGER NOT NULL, `recommended_width` INTEGER NOT NULL, `recommended_height` INTEGER NOT NULL, `recommended_steps` INTEGER NOT NULL, `recommended_cfg` REAL NOT NULL, `recommended_batch` INTEGER NOT NULL, `recommended_providers` TEXT NOT NULL, `recommended_background` INTEGER NOT NULL, `recommended_backend` TEXT NOT NULL, `notes` TEXT NOT NULL)", + "fields": [ + { + "fieldPath": "id", + "columnName": "id", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "createdAt", + "columnName": "created_at", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "platform", + "columnName": "platform", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "manufacturer", + "columnName": "manufacturer", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "model", + "columnName": "model", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "osVersion", + "columnName": "os_version", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "cpuName", + "columnName": "cpu_name", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "cpuCores", + "columnName": "cpu_cores", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "gpuName", + "columnName": "gpu_name", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "totalRamMb", + "columnName": "total_ram_mb", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "availableRamMb", + "columnName": "available_ram_mb", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "totalVramMb", + "columnName": "total_vram_mb", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "availableVramMb", + "columnName": "available_vram_mb", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "accelerators", + "columnName": "accelerators", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "cpuScore", + "columnName": "cpu_score", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "memoryScore", + "columnName": "memory_score", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "acceleratorScore", + "columnName": "accelerator_score", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "totalScore", + "columnName": "total_score", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "estimatedTimeSeconds", + "columnName": "estimated_time_seconds", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "recommendedWidth", + "columnName": "recommended_width", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "recommendedHeight", + "columnName": "recommended_height", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "recommendedSteps", + "columnName": "recommended_steps", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "recommendedCfg", + "columnName": "recommended_cfg", + "affinity": "REAL", + "notNull": true + }, + { + "fieldPath": "recommendedBatch", + "columnName": "recommended_batch", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "recommendedProviders", + "columnName": "recommended_providers", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "recommendedBackground", + "columnName": "recommended_background", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "recommendedBackend", + "columnName": "recommended_backend", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "notes", + "columnName": "notes", + "affinity": "TEXT", + "notNull": true + } + ], + "primaryKey": { + "autoGenerate": true, + "columnNames": ["id"] + }, + "indices": [ + { + "name": "index_benchmark_result_created_at", + "unique": false, + "columnNames": ["created_at"], + "orders": [], + "createSql": "CREATE INDEX IF NOT EXISTS `index_benchmark_result_created_at` ON `${TABLE_NAME}` (`created_at`)" + } + ] + }, + { + "tableName": "network_usage", + "createSql": "CREATE TABLE IF NOT EXISTS `${TABLE_NAME}` (`category` TEXT NOT NULL, `bytes` INTEGER NOT NULL, PRIMARY KEY(`category`))", + "fields": [ + { + "fieldPath": "category", + "columnName": "category", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "bytes", + "columnName": "bytes", + "affinity": "INTEGER", + "notNull": true + } + ], + "primaryKey": { + "autoGenerate": false, + "columnNames": ["category"] + } + }, + { + "tableName": "restore_sessions", + "createSql": "CREATE TABLE IF NOT EXISTS `${TABLE_NAME}` (`id` TEXT NOT NULL, `archiveHandle` TEXT NOT NULL, `selection` TEXT NOT NULL, `isComplete` INTEGER NOT NULL, PRIMARY KEY(`id`))", + "fields": [ + { + "fieldPath": "id", + "columnName": "id", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "archiveHandle", + "columnName": "archiveHandle", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "selection", + "columnName": "selection", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "isComplete", + "columnName": "isComplete", + "affinity": "INTEGER", + "notNull": true + } + ], + "primaryKey": { + "autoGenerate": false, + "columnNames": ["id"] + } + }, + { + "tableName": "restore_sections", + "createSql": "CREATE TABLE IF NOT EXISTS `${TABLE_NAME}` (`sessionId` TEXT NOT NULL, `category` TEXT NOT NULL, `importedCount` INTEGER NOT NULL, `skippedCount` INTEGER NOT NULL, PRIMARY KEY(`sessionId`, `category`))", + "fields": [ + { + "fieldPath": "sessionId", + "columnName": "sessionId", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "category", + "columnName": "category", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "importedCount", + "columnName": "importedCount", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "skippedCount", + "columnName": "skippedCount", + "affinity": "INTEGER", + "notNull": true + } + ], + "primaryKey": { + "autoGenerate": false, + "columnNames": ["sessionId", "category"] + } + } + ], + "setupQueries": [ + "CREATE TABLE IF NOT EXISTS room_master_table (id INTEGER PRIMARY KEY,identity_hash TEXT)", + "INSERT OR REPLACE INTO room_master_table (id,identity_hash) VALUES(42, '3631519f530e6340c0c1728a9cfeedd4')" + ] + } +} diff --git a/storage/schemas/com.shifthackz.aisdv1.storage.db.persistent.PersistentDatabase/15.json b/storage/schemas/com.shifthackz.aisdv1.storage.db.persistent.PersistentDatabase/15.json new file mode 100644 index 000000000..3df1ebd68 --- /dev/null +++ b/storage/schemas/com.shifthackz.aisdv1.storage.db.persistent.PersistentDatabase/15.json @@ -0,0 +1,565 @@ +{ + "formatVersion": 1, + "database": { + "version": 15, + "identityHash": "a2342fba7f3aff7e4a2c55e30c1f2094", + "entities": [ + { + "tableName": "generation_results", + "createSql": "CREATE TABLE IF NOT EXISTS `${TABLE_NAME}` (`id` INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL, `image_base_64` TEXT NOT NULL, `original_image_base_64` TEXT NOT NULL, `created_at` INTEGER NOT NULL, `generation_type` TEXT NOT NULL, `prompt` TEXT NOT NULL, `negative_prompt` TEXT NOT NULL, `width` INTEGER NOT NULL, `height` INTEGER NOT NULL, `sampling_steps` INTEGER NOT NULL, `cfg_scale` REAL NOT NULL, `restore_faces` INTEGER NOT NULL, `sampler` TEXT NOT NULL, `seed` TEXT NOT NULL, `sub_seed` TEXT NOT NULL DEFAULT '', `sub_seed_strength` REAL NOT NULL DEFAULT 0.0, `denoising_strength` REAL NOT NULL DEFAULT 0.0, `hidden` INTEGER NOT NULL DEFAULT 0, `liked` INTEGER NOT NULL DEFAULT 0, `model_name` TEXT NOT NULL DEFAULT '', `image_revision` TEXT NOT NULL DEFAULT '')", + "fields": [ + { + "fieldPath": "id", + "columnName": "id", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "imageBase64", + "columnName": "image_base_64", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "originalImageBase64", + "columnName": "original_image_base_64", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "createdAt", + "columnName": "created_at", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "generationType", + "columnName": "generation_type", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "prompt", + "columnName": "prompt", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "negativePrompt", + "columnName": "negative_prompt", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "width", + "columnName": "width", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "height", + "columnName": "height", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "samplingSteps", + "columnName": "sampling_steps", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "cfgScale", + "columnName": "cfg_scale", + "affinity": "REAL", + "notNull": true + }, + { + "fieldPath": "restoreFaces", + "columnName": "restore_faces", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "sampler", + "columnName": "sampler", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "seed", + "columnName": "seed", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "subSeed", + "columnName": "sub_seed", + "affinity": "TEXT", + "notNull": true, + "defaultValue": "''" + }, + { + "fieldPath": "subSeedStrength", + "columnName": "sub_seed_strength", + "affinity": "REAL", + "notNull": true, + "defaultValue": "0.0" + }, + { + "fieldPath": "denoisingStrength", + "columnName": "denoising_strength", + "affinity": "REAL", + "notNull": true, + "defaultValue": "0.0" + }, + { + "fieldPath": "hidden", + "columnName": "hidden", + "affinity": "INTEGER", + "notNull": true, + "defaultValue": "0" + }, + { + "fieldPath": "liked", + "columnName": "liked", + "affinity": "INTEGER", + "notNull": true, + "defaultValue": "0" + }, + { + "fieldPath": "modelName", + "columnName": "model_name", + "affinity": "TEXT", + "notNull": true, + "defaultValue": "''" + }, + { + "fieldPath": "imageRevision", + "columnName": "image_revision", + "affinity": "TEXT", + "notNull": true, + "defaultValue": "''" + } + ], + "primaryKey": { + "autoGenerate": true, + "columnNames": ["id"] + }, + "indices": [ + { + "name": "index_generation_results_created_at", + "unique": false, + "columnNames": ["created_at"], + "orders": [], + "createSql": "CREATE INDEX IF NOT EXISTS `index_generation_results_created_at` ON `${TABLE_NAME}` (`created_at`)" + } + ] + }, + { + "tableName": "local_models", + "createSql": "CREATE TABLE IF NOT EXISTS `${TABLE_NAME}` (`id` TEXT NOT NULL, `type` TEXT NOT NULL DEFAULT 'onnx', `name` TEXT NOT NULL, `size` TEXT NOT NULL, `sources` TEXT NOT NULL, PRIMARY KEY(`id`))", + "fields": [ + { + "fieldPath": "id", + "columnName": "id", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "type", + "columnName": "type", + "affinity": "TEXT", + "notNull": true, + "defaultValue": "'onnx'" + }, + { + "fieldPath": "name", + "columnName": "name", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "size", + "columnName": "size", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "sources", + "columnName": "sources", + "affinity": "TEXT", + "notNull": true + } + ], + "primaryKey": { + "autoGenerate": false, + "columnNames": ["id"] + } + }, + { + "tableName": "hugging_face_models", + "createSql": "CREATE TABLE IF NOT EXISTS `${TABLE_NAME}` (`id` TEXT NOT NULL, `name` TEXT NOT NULL, `alias` TEXT NOT NULL, `source` TEXT NOT NULL, PRIMARY KEY(`id`))", + "fields": [ + { + "fieldPath": "id", + "columnName": "id", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "name", + "columnName": "name", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "alias", + "columnName": "alias", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "source", + "columnName": "source", + "affinity": "TEXT", + "notNull": true + } + ], + "primaryKey": { + "autoGenerate": false, + "columnNames": ["id"] + } + }, + { + "tableName": "supporters", + "createSql": "CREATE TABLE IF NOT EXISTS `${TABLE_NAME}` (`id` INTEGER NOT NULL, `name` TEXT NOT NULL, `date` INTEGER NOT NULL, `message` TEXT NOT NULL, PRIMARY KEY(`id`))", + "fields": [ + { + "fieldPath": "id", + "columnName": "id", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "name", + "columnName": "name", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "date", + "columnName": "date", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "message", + "columnName": "message", + "affinity": "TEXT", + "notNull": true + } + ], + "primaryKey": { + "autoGenerate": false, + "columnNames": ["id"] + } + }, + { + "tableName": "benchmark_result", + "createSql": "CREATE TABLE IF NOT EXISTS `${TABLE_NAME}` (`id` INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL, `created_at` INTEGER NOT NULL, `platform` TEXT NOT NULL, `manufacturer` TEXT NOT NULL, `model` TEXT NOT NULL, `os_version` TEXT NOT NULL, `cpu_name` TEXT NOT NULL, `cpu_cores` INTEGER NOT NULL, `gpu_name` TEXT NOT NULL, `total_ram_mb` INTEGER NOT NULL, `available_ram_mb` INTEGER NOT NULL, `total_vram_mb` INTEGER NOT NULL, `available_vram_mb` INTEGER NOT NULL, `accelerators` TEXT NOT NULL, `cpu_score` INTEGER NOT NULL, `memory_score` INTEGER NOT NULL, `accelerator_score` INTEGER NOT NULL, `total_score` INTEGER NOT NULL, `estimated_time_seconds` INTEGER NOT NULL, `recommended_width` INTEGER NOT NULL, `recommended_height` INTEGER NOT NULL, `recommended_steps` INTEGER NOT NULL, `recommended_cfg` REAL NOT NULL, `recommended_batch` INTEGER NOT NULL, `recommended_providers` TEXT NOT NULL, `recommended_background` INTEGER NOT NULL, `recommended_backend` TEXT NOT NULL, `notes` TEXT NOT NULL)", + "fields": [ + { + "fieldPath": "id", + "columnName": "id", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "createdAt", + "columnName": "created_at", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "platform", + "columnName": "platform", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "manufacturer", + "columnName": "manufacturer", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "model", + "columnName": "model", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "osVersion", + "columnName": "os_version", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "cpuName", + "columnName": "cpu_name", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "cpuCores", + "columnName": "cpu_cores", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "gpuName", + "columnName": "gpu_name", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "totalRamMb", + "columnName": "total_ram_mb", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "availableRamMb", + "columnName": "available_ram_mb", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "totalVramMb", + "columnName": "total_vram_mb", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "availableVramMb", + "columnName": "available_vram_mb", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "accelerators", + "columnName": "accelerators", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "cpuScore", + "columnName": "cpu_score", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "memoryScore", + "columnName": "memory_score", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "acceleratorScore", + "columnName": "accelerator_score", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "totalScore", + "columnName": "total_score", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "estimatedTimeSeconds", + "columnName": "estimated_time_seconds", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "recommendedWidth", + "columnName": "recommended_width", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "recommendedHeight", + "columnName": "recommended_height", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "recommendedSteps", + "columnName": "recommended_steps", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "recommendedCfg", + "columnName": "recommended_cfg", + "affinity": "REAL", + "notNull": true + }, + { + "fieldPath": "recommendedBatch", + "columnName": "recommended_batch", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "recommendedProviders", + "columnName": "recommended_providers", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "recommendedBackground", + "columnName": "recommended_background", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "recommendedBackend", + "columnName": "recommended_backend", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "notes", + "columnName": "notes", + "affinity": "TEXT", + "notNull": true + } + ], + "primaryKey": { + "autoGenerate": true, + "columnNames": ["id"] + }, + "indices": [ + { + "name": "index_benchmark_result_created_at", + "unique": false, + "columnNames": ["created_at"], + "orders": [], + "createSql": "CREATE INDEX IF NOT EXISTS `index_benchmark_result_created_at` ON `${TABLE_NAME}` (`created_at`)" + } + ] + }, + { + "tableName": "network_usage", + "createSql": "CREATE TABLE IF NOT EXISTS `${TABLE_NAME}` (`category` TEXT NOT NULL, `bytes` INTEGER NOT NULL, PRIMARY KEY(`category`))", + "fields": [ + { + "fieldPath": "category", + "columnName": "category", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "bytes", + "columnName": "bytes", + "affinity": "INTEGER", + "notNull": true + } + ], + "primaryKey": { + "autoGenerate": false, + "columnNames": ["category"] + } + }, + { + "tableName": "restore_sessions", + "createSql": "CREATE TABLE IF NOT EXISTS `${TABLE_NAME}` (`id` TEXT NOT NULL, `archiveHandle` TEXT NOT NULL, `selection` TEXT NOT NULL, `isComplete` INTEGER NOT NULL, `requiresConfiguration` INTEGER NOT NULL DEFAULT 0, PRIMARY KEY(`id`))", + "fields": [ + { + "fieldPath": "id", + "columnName": "id", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "archiveHandle", + "columnName": "archiveHandle", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "selection", + "columnName": "selection", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "isComplete", + "columnName": "isComplete", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "requiresConfiguration", + "columnName": "requiresConfiguration", + "affinity": "INTEGER", + "notNull": true, + "defaultValue": "0" + } + ], + "primaryKey": { + "autoGenerate": false, + "columnNames": ["id"] + } + }, + { + "tableName": "restore_sections", + "createSql": "CREATE TABLE IF NOT EXISTS `${TABLE_NAME}` (`sessionId` TEXT NOT NULL, `category` TEXT NOT NULL, `importedCount` INTEGER NOT NULL, `skippedCount` INTEGER NOT NULL, `retainedCredentialProviders` TEXT NOT NULL DEFAULT '', PRIMARY KEY(`sessionId`, `category`))", + "fields": [ + { + "fieldPath": "sessionId", + "columnName": "sessionId", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "category", + "columnName": "category", + "affinity": "TEXT", + "notNull": true + }, + { + "fieldPath": "importedCount", + "columnName": "importedCount", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "skippedCount", + "columnName": "skippedCount", + "affinity": "INTEGER", + "notNull": true + }, + { + "fieldPath": "retainedCredentialProviders", + "columnName": "retainedCredentialProviders", + "affinity": "TEXT", + "notNull": true, + "defaultValue": "''" + } + ], + "primaryKey": { + "autoGenerate": false, + "columnNames": ["sessionId", "category"] + } + } + ], + "setupQueries": [ + "CREATE TABLE IF NOT EXISTS room_master_table (id INTEGER PRIMARY KEY,identity_hash TEXT)", + "INSERT OR REPLACE INTO room_master_table (id,identity_hash) VALUES(42, 'a2342fba7f3aff7e4a2c55e30c1f2094')" + ] + } +} diff --git a/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/PersistentDatabase.kt b/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/PersistentDatabase.kt index 5eb5321c2..1137e620b 100644 --- a/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/PersistentDatabase.kt +++ b/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/PersistentDatabase.kt @@ -1,5 +1,8 @@ package com.shifthackz.aisdv1.storage.db.persistent +import com.shifthackz.aisdv1.storage.db.persistent.entity.RestoreSessionEntity +import com.shifthackz.aisdv1.storage.db.persistent.entity.RestoreSectionEntity +import com.shifthackz.aisdv1.storage.db.persistent.dao.RestoreSessionDao import androidx.room.AutoMigration import androidx.room.ConstructedBy import androidx.room.Database @@ -26,7 +29,7 @@ import com.shifthackz.aisdv1.storage.db.persistent.entity.SupporterEntity /** * Main Room database containing generated images, downloaded models, and app statistics. * - * Schema version 13 adds an opaque image revision so thumbnail caches invalidate on replacement. + * Schema version 15 retains first-launch restore handoffs and typed omission metadata across interruptions. * * @author Dmitriy Moroz */ @@ -40,8 +43,12 @@ import com.shifthackz.aisdv1.storage.db.persistent.entity.SupporterEntity SupporterEntity::class, BenchmarkResultEntity::class, NetworkUsageEntity::class, + RestoreSessionEntity::class, + RestoreSectionEntity::class, ], autoMigrations = [ + AutoMigration(from = 13, to = 14), + AutoMigration(from = 14, to = 15), /** * Added 3 fields to [GenerationResultEntity]: * - [GenerationResultContract.SUB_SEED] @@ -125,41 +132,41 @@ import com.shifthackz.aisdv1.storage.db.persistent.entity.SupporterEntity @ConstructedBy(PersistentDatabaseConstructor::class) internal abstract class PersistentDatabase : RoomDatabase() { /** - * Executes the `generationResultDao` step in the SDAI storage layer. + * Reads and mutates saved gallery images and their metadata. * - * @return Result produced by `generationResultDao`. + * @return The corresponding persistent table access owner. * @author Dmitriy Moroz */ abstract fun generationResultDao(): GenerationResultDao /** - * Executes the `localModelDao` step in the SDAI storage layer. + * Tracks downloaded local model records without changing user-managed sources. * - * @return Result produced by `localModelDao`. + * @return The corresponding persistent table access owner. * @author Dmitriy Moroz */ abstract fun localModelDao(): LocalModelDao /** - * Executes the `huggingFaceModelDao` step in the SDAI storage layer. + * Reads saved Hugging Face model catalog records. * - * @return Result produced by `huggingFaceModelDao`. + * @return The corresponding persistent table access owner. * @author Dmitriy Moroz */ abstract fun huggingFaceModelDao(): HuggingFaceModelDao /** - * Executes the `supporterDao` step in the SDAI storage layer. + * Reads cached supporter records. * - * @return Result produced by `supporterDao`. + * @return The corresponding persistent table access owner. * @author Dmitriy Moroz */ abstract fun supporterDao(): SupporterDao /** - * Executes the `benchmarkResultDao` step in the SDAI storage layer. + * Reads device-specific benchmark history. * - * @return Result produced by `benchmarkResultDao`. + * @return The corresponding persistent table access owner. * @author Dmitriy Moroz */ abstract fun benchmarkResultDao(): BenchmarkResultDao @@ -172,38 +179,44 @@ internal abstract class PersistentDatabase : RoomDatabase() { abstract fun networkUsageDao(): NetworkUsageDao /** - * Provides the `companion object` singleton used by the SDAI storage layer. + * Stable database filename and current migration target. * * @author Dmitriy Moroz */ + /** + * Returns durable restore intent and category-commit records. + * @author Dmitriy Moroz + */ + abstract fun restoreSessionDao(): RestoreSessionDao + companion object { /** - * Exposes the `DB_NAME` value used by the SDAI storage layer. + * Installed database filename; preserve it across schema upgrades. * * @author Dmitriy Moroz */ const val DB_NAME = "ai_sd_v1_storage_db" /** - * Exposes the `DB_VERSION` value used by the SDAI storage layer. + * Schema target including durable restore session and section ledgers. * * @author Dmitriy Moroz */ - const val DB_VERSION = 13 + const val DB_VERSION = 15 } } /** - * Provides the `PersistentDatabaseConstructor` singleton used by the SDAI storage layer. + * Constructs native Room implementations for each supported target. * * @author Dmitriy Moroz */ @Suppress("KotlinNoActualForExpect") internal expect object PersistentDatabaseConstructor : RoomDatabaseConstructor { /** - * Executes the `initialize` step in the SDAI storage layer. + * Creates the platform Room database implementation generated from this schema. * - * @return Result produced by `initialize`. + * @return Constructed persistent database owner. * @author Dmitriy Moroz */ override fun initialize(): PersistentDatabase diff --git a/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/dao/GenerationResultDao.kt b/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/dao/GenerationResultDao.kt index d031bd0aa..3917aaa8e 100644 --- a/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/dao/GenerationResultDao.kt +++ b/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/dao/GenerationResultDao.kt @@ -11,39 +11,48 @@ import com.shifthackz.aisdv1.storage.db.persistent.entity.GenerationResultPrevie import kotlinx.coroutines.flow.Flow /** - * Defines the `GenerationResultDao` contract for the SDAI storage layer. + * Reads paged gallery metadata and persists complete image rows; backup imports must use fresh IDs. * * @author Dmitriy Moroz */ @Dao interface GenerationResultDao { + /** + * Advances through a stable backup snapshot by primary key without repeated OFFSET scans. + * @param afterId Exclusive ID cursor from the previous page, or zero for the first page. + * @param limit Maximum number of full image rows held at once. + * @author Dmitriy Moroz + */ + @Query("SELECT * FROM generation_results WHERE id > :afterId ORDER BY id LIMIT :limit") + suspend fun queryBackupPage(afterId: Long, limit: Int): List + /** - * Executes the `query` step in the SDAI storage layer. + * Reads all gallery rows, including hidden generation history. * - * @return Result produced by `query`. + * @return Matching saved rows or generated local identity, as described by the operation. * @author Dmitriy Moroz */ @Query("SELECT * FROM ${GenerationResultContract.TABLE} ORDER BY ${GenerationResultContract.CREATED_AT} DESC, ${GenerationResultContract.ID} DESC") suspend fun query(): List /** - * Executes the `queryPage` step in the SDAI storage layer. + * Reads one full-image page ordered by creation time and ID. * - * @param limit limit value consumed by the API. - * @param offset offset value consumed by the API. - * @return Result produced by `queryPage`. + * @param limit Maximum rows held in one page. + * @param offset Number of prior ordered rows to skip. + * @return Matching saved rows or generated local identity, as described by the operation. * @author Dmitriy Moroz */ @Query("SELECT * FROM ${GenerationResultContract.TABLE} ORDER BY ${GenerationResultContract.CREATED_AT} DESC, ${GenerationResultContract.ID} DESC LIMIT :limit OFFSET :offset ") suspend fun queryPage(limit: Int, offset: Int): List /** - * Executes the `queryPagePreview` step in the SDAI storage layer. + * Reads one preview-only page without full image payloads. * - * @param limit limit value consumed by the API. - * @param offset offset value consumed by the API. - * @return Result produced by `queryPagePreview`. + * @param limit Maximum rows held in one page. + * @param offset Number of prior ordered rows to skip. + * @return Matching saved rows or generated local identity, as described by the operation. * @author Dmitriy Moroz */ @Query( @@ -61,22 +70,22 @@ interface GenerationResultDao { suspend fun queryPagePreview(limit: Int, offset: Int): List /** - * Loads SDAI data through `observePage`. + * Observes a full-image gallery page after Room invalidations. * - * @param limit limit value consumed by the API. - * @param offset offset value consumed by the API. - * @return Result produced by `observePage`. + * @param limit Maximum rows held in one page. + * @param offset Number of prior ordered rows to skip. + * @return Matching saved rows or generated local identity, as described by the operation. * @author Dmitriy Moroz */ @Query("SELECT * FROM ${GenerationResultContract.TABLE} ORDER BY ${GenerationResultContract.CREATED_AT} DESC, ${GenerationResultContract.ID} DESC LIMIT :limit OFFSET :offset ") fun observePage(limit: Int, offset: Int): Flow> /** - * Loads SDAI data through `observePagePreview`. + * Observes a preview-only page after Room invalidations. * - * @param limit limit value consumed by the API. - * @param offset offset value consumed by the API. - * @return Result produced by `observePagePreview`. + * @param limit Maximum rows held in one page. + * @param offset Number of prior ordered rows to skip. + * @return Matching saved rows or generated local identity, as described by the operation. * @author Dmitriy Moroz */ @Query( @@ -94,93 +103,93 @@ interface GenerationResultDao { fun observePagePreview(limit: Int, offset: Int): Flow> /** - * Loads SDAI data through `observeCount`. + * Observes the current total number of persisted generation rows. * - * @return Result produced by `observeCount`. + * @return Matching saved rows or generated local identity, as described by the operation. * @author Dmitriy Moroz */ @Query("SELECT COUNT(*) FROM ${GenerationResultContract.TABLE}") fun observeCount(): Flow /** - * Executes the `queryIds` step in the SDAI storage layer. + * Reads IDs of all saved generation rows. * - * @return Result produced by `queryIds`. + * @return Matching saved rows or generated local identity, as described by the operation. * @author Dmitriy Moroz */ @Query("SELECT ${GenerationResultContract.ID} FROM ${GenerationResultContract.TABLE} ORDER BY ${GenerationResultContract.CREATED_AT} DESC, ${GenerationResultContract.ID} DESC") suspend fun queryIds(): List /** - * Executes the `queryById` step in the SDAI storage layer. + * Reads one complete saved image row by local identity. * - * @param id identifier of the target entity. - * @return Result produced by `queryById`. + * @param id Local persisted row identity. + * @return Matching saved rows or generated local identity, as described by the operation. * @author Dmitriy Moroz */ @Query("SELECT * FROM ${GenerationResultContract.TABLE} WHERE ${GenerationResultContract.ID} = :id LIMIT 1") suspend fun queryById(id: Long): GenerationResultEntity /** - * Executes the `queryByIdList` step in the SDAI storage layer. + * Reads complete saved rows for explicit local identities. * - * @param idList id list value consumed by the API. - * @return Result produced by `queryByIdList`. + * @param idList Explicit local row identities to read or update. + * @return Matching saved rows or generated local identity, as described by the operation. * @author Dmitriy Moroz */ @Query("SELECT * FROM ${GenerationResultContract.TABLE} WHERE ${GenerationResultContract.ID} IN (:idList)") suspend fun queryByIdList(idList: List): List /** - * Performs the SDAI side effect handled by `updateHiddenByIdList`. + * Changes history visibility without replacing image content. * - * @param idList id list value consumed by the API. - * @param hidden hidden value consumed by the API. + * @param idList Explicit local row identities to read or update. + * @param hidden Whether selected rows appear only in generation history. * @author Dmitriy Moroz */ @Query("UPDATE ${GenerationResultContract.TABLE} SET ${GenerationResultContract.HIDDEN} = :hidden WHERE ${GenerationResultContract.ID} IN (:idList)") suspend fun updateHiddenByIdList(idList: List, hidden: Boolean) /** - * Performs the SDAI side effect handled by `updateLikedByIdList`. + * Changes favorite flags without replacing image content. * - * @param idList id list value consumed by the API. - * @param liked liked value consumed by the API. + * @param idList Explicit local row identities to read or update. + * @param liked Whether selected rows are marked as favorites. * @author Dmitriy Moroz */ @Query("UPDATE ${GenerationResultContract.TABLE} SET ${GenerationResultContract.LIKED} = :liked WHERE ${GenerationResultContract.ID} IN (:idList)") suspend fun updateLikedByIdList(idList: List, liked: Boolean) /** - * Performs the SDAI side effect handled by `insert`. + * Inserts a complete gallery row; nonzero conflicting IDs replace existing rows. * - * @param item item value consumed by the API. - * @return Result produced by `insert`. + * @param item Full image row; use ID zero for additive backup import. + * @return Matching saved rows or generated local identity, as described by the operation. * @author Dmitriy Moroz */ @Insert(onConflict = OnConflictStrategy.REPLACE) suspend fun insert(item: GenerationResultEntity): Long /** - * Performs the SDAI side effect handled by `deleteById`. + * Removes one saved row by local identity. * - * @param id identifier of the target entity. + * @param id Local persisted row identity. * @author Dmitriy Moroz */ @Query("DELETE FROM ${GenerationResultContract.TABLE} WHERE ${GenerationResultContract.ID} = :id") suspend fun deleteById(id: Long) /** - * Performs the SDAI side effect handled by `deleteByIdList`. + * Removes only the explicitly selected saved rows. * - * @param idList id list value consumed by the API. + * @param idList Explicit local row identities to read or update. * @author Dmitriy Moroz */ @Query("DELETE FROM ${GenerationResultContract.TABLE} WHERE ${GenerationResultContract.ID} IN (:idList)") suspend fun deleteByIdList(idList: List) /** - * Performs the SDAI side effect handled by `deleteAll`. + * Removes every saved gallery and hidden history row. * * @author Dmitriy Moroz */ diff --git a/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/dao/RestoreSessionDao.kt b/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/dao/RestoreSessionDao.kt new file mode 100644 index 000000000..be0797291 --- /dev/null +++ b/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/dao/RestoreSessionDao.kt @@ -0,0 +1,78 @@ +package com.shifthackz.aisdv1.storage.db.persistent.dao + +import androidx.room.Dao +import androidx.room.Insert +import androidx.room.OnConflictStrategy +import androidx.room.Query +import com.shifthackz.aisdv1.storage.db.persistent.entity.RestoreSessionEntity +import com.shifthackz.aisdv1.storage.db.persistent.entity.RestoreSectionEntity + +/** + * Persists restore intent and committed categories without serializing application secrets. + * @author Dmitriy Moroz + */ +@Dao +interface RestoreSessionDao { + /** + * Returns unfinished restore intents before normal application startup publication. + * @author Dmitriy Moroz + */ + @Query("SELECT * FROM restore_sessions WHERE isComplete = 0 OR requiresConfiguration = 1") + suspend fun pending(): List + + /** + * Loads exact operation intent, refusing to silently reuse IDs for different imports. + * @param id Restore session ID. + * @author Dmitriy Moroz + */ + @Query("SELECT * FROM restore_sessions WHERE id = :id") + suspend fun get(id: String): RestoreSessionEntity? + + /** + * Records one new restore intent. Reused session IDs are rejected. + * @param session Nonsecret archive and selection binding. + * @author Dmitriy Moroz + */ + @Insert(onConflict = OnConflictStrategy.ABORT) + suspend fun insert(session: RestoreSessionEntity) + + /** + * Reads categories already applied by this operation. + * @param sessionId Restore session ID. + * @author Dmitriy Moroz + */ + @Query("SELECT category FROM restore_sections WHERE sessionId = :sessionId") + suspend fun completed(sessionId: String): List + + /** + * Loads committed counts for accurate reports after process recovery. + * @param sessionId Restore session ID. + * @author Dmitriy Moroz + */ + @Query("SELECT * FROM restore_sections WHERE sessionId = :sessionId") + suspend fun results(sessionId: String): List + + /** + * Marks a category applied in the same transaction as its additive data. + * @param section Committed category and owning operation. + * @author Dmitriy Moroz + */ + @Insert(onConflict = OnConflictStrategy.ABORT) + suspend fun mark(section: RestoreSectionEntity) + + /** + * Completes an operation after all selected sections have committed. + * @param id Restore session ID. + * @author Dmitriy Moroz + */ + @Query("UPDATE restore_sessions SET isComplete = 1 WHERE id = :id") + suspend fun finish(id: String) + + /** + * Acknowledges configuration only after its startup stage was checked durably. + * @param id Restore session whose first-launch handoff has been persisted. + * @author Dmitriy Moroz + */ + @Query("UPDATE restore_sessions SET requiresConfiguration = 0 WHERE id = :id") + suspend fun acknowledgeConfiguration(id: String) +} diff --git a/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/entity/RestoreSectionEntity.kt b/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/entity/RestoreSectionEntity.kt new file mode 100644 index 000000000..b6d3a513f --- /dev/null +++ b/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/entity/RestoreSectionEntity.kt @@ -0,0 +1,22 @@ +package com.shifthackz.aisdv1.storage.db.persistent.entity + +import androidx.room.ColumnInfo +import androidx.room.Entity + +/** + * Committed-section ledger. Gallery/statistics write this row in their data transaction. + * @param sessionId Owning restore session. + * @param category Stable completed section ID. + * @param importedCount Number of destination records durably added or applied. + * @param skippedCount Number of unsupported entries omitted from this committed category. + * @param retainedCredentialProviders Comma-separated stable provider IDs whose shared credentials were preserved. + * @author Dmitriy Moroz + */ +@Entity(tableName = "restore_sections", primaryKeys = ["sessionId", "category"]) +data class RestoreSectionEntity( + val sessionId: String, + val category: String, + val importedCount: Long = 0, + val skippedCount: Long = 0, + @ColumnInfo(defaultValue = "''") val retainedCredentialProviders: String = "" +) diff --git a/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/entity/RestoreSessionEntity.kt b/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/entity/RestoreSessionEntity.kt new file mode 100644 index 000000000..55928dcc0 --- /dev/null +++ b/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/entity/RestoreSessionEntity.kt @@ -0,0 +1,23 @@ +package com.shifthackz.aisdv1.storage.db.persistent.entity + +import androidx.room.ColumnInfo +import androidx.room.Entity +import androidx.room.PrimaryKey + +/** + * Durable restore identity containing only private archive and selection references, never secret values. + * @param id Unique restore session, separate from archive identity. + * @param archiveHandle App-owned staged archive basename. + * @param selection Selected category/provider IDs encoded as JSON. + * @param isComplete Whether every selected category has a terminal committed result. + * @param requiresConfiguration Whether the checked configuration handoff still needs acknowledgement. + * @author Dmitriy Moroz + */ +@Entity(tableName = "restore_sessions") +data class RestoreSessionEntity( + @PrimaryKey val id: String, + val archiveHandle: String, + val selection: String, + val isComplete: Boolean = false, + @ColumnInfo(defaultValue = "0") val requiresConfiguration: Boolean = false, +) diff --git a/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/di/PersistentDatabaseModule.kt b/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/di/PersistentDatabaseModule.kt index 02ec17297..dc9edaee0 100644 --- a/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/di/PersistentDatabaseModule.kt +++ b/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/di/PersistentDatabaseModule.kt @@ -5,6 +5,8 @@ import androidx.sqlite.driver.bundled.BundledSQLiteDriver import com.shifthackz.aisdv1.storage.db.persistent.PersistentDatabase import kotlinx.coroutines.Dispatchers import org.koin.core.module.Module +import com.shifthackz.aisdv1.storage.gateway.BackupStorage +import com.shifthackz.aisdv1.storage.gateway.RoomBackupStorage import org.koin.dsl.module /** @@ -22,6 +24,7 @@ expect val persistentDatabasePlatformModule: Module * @author Dmitriy Moroz */ val persistentDatabaseModule = module { + single { RoomBackupStorage(get()) } includes(persistentDatabasePlatformModule) single { getPersistentDatabase(builder = get()) diff --git a/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/gateway/BackupStorage.kt b/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/gateway/BackupStorage.kt new file mode 100644 index 000000000..4f6f8ec78 --- /dev/null +++ b/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/gateway/BackupStorage.kt @@ -0,0 +1,43 @@ +package com.shifthackz.aisdv1.storage.gateway + +import com.shifthackz.aisdv1.storage.db.persistent.dao.GenerationResultDao +import com.shifthackz.aisdv1.storage.db.persistent.dao.NetworkUsageDao +import com.shifthackz.aisdv1.storage.db.persistent.dao.RestoreSessionDao + +/** + * Storage transaction boundary used by backup implementation without exposing the Room database owner. + * @author Dmitriy Moroz + */ +interface BackupStorage { + /** + * Reads a consistent gallery/statistics snapshot through the shared reader connection. + * @param block Bounded paged reads performed in one transaction. + * @author Dmitriy Moroz + */ + suspend fun readSnapshot(block: suspend () -> T): T + + /** + * Commits additive user data and its category ledger together. + * @param block Data writes and section marker belonging to one category. + * @author Dmitriy Moroz + */ + suspend fun writeTransaction(block: suspend () -> T): T + + /** + * Returns paged gallery persistence without generation-save export side effects. + * @author Dmitriy Moroz + */ + fun generationResultDao(): GenerationResultDao + + /** + * Returns atomic durable network byte buckets. + * @author Dmitriy Moroz + */ + fun networkUsageDao(): NetworkUsageDao + + /** + * Returns nonsecret restore session and committed-section persistence. + * @author Dmitriy Moroz + */ + fun restoreSessionDao(): RestoreSessionDao +} diff --git a/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/gateway/RoomBackupStorage.kt b/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/gateway/RoomBackupStorage.kt new file mode 100644 index 000000000..41d43ee16 --- /dev/null +++ b/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/gateway/RoomBackupStorage.kt @@ -0,0 +1,24 @@ +package com.shifthackz.aisdv1.storage.gateway + +import androidx.room.useReaderConnection +import androidx.room.useWriterConnection +import androidx.room.deferredTransaction +import androidx.room.immediateTransaction +import com.shifthackz.aisdv1.storage.db.persistent.PersistentDatabase + +/** + * Keeps Room connection ownership inside storage while backup uses the common transaction contract. + * @param database Shared persistent Room owner; never exposed to consuming modules. + * @author Dmitriy Moroz + */ +internal class RoomBackupStorage(private val database: PersistentDatabase) : BackupStorage { + override suspend fun readSnapshot(block: suspend () -> T): T = + database.useReaderConnection { it.deferredTransaction { block() } } + + override suspend fun writeTransaction(block: suspend () -> T): T = + database.useWriterConnection { it.immediateTransaction { block() } } + + override fun generationResultDao() = database.generationResultDao() + override fun networkUsageDao() = database.networkUsageDao() + override fun restoreSessionDao() = database.restoreSessionDao() +} From f4c7de98b4e803170818b264aae92493ea780781 Mon Sep 17 00:00:00 2001 From: ShiftHackZ Date: Thu, 19 Nov 2026 14:12:21 +0200 Subject: [PATCH 2/3] Polish backup flows and prevent duplicate gallery restores --- .../domain/entity/backup/BackupInspection.kt | 2 + .../backup/io/BackupFileStore.android.kt | 20 ++ .../restore/BackupImageFingerprintTest.kt | 128 +++++++++ .../restore/RoomBackupRestoreWriterTest.kt | 229 ++++++++++++++- .../archive/DefaultBackupArchiveStore.kt | 9 +- .../aisdv1/feature/backup/di/BackupModule.kt | 7 +- .../feature/backup/io/BackupFileStore.kt | 18 +- .../backup/restore/BackupImageFingerprint.kt | 16 ++ .../backup/restore/BackupRestoreWriter.kt | 5 +- .../restore/DefaultBackupImageFingerprint.kt | 90 ++++++ .../backup/restore/RoomBackupRestoreWriter.kt | 60 +++- .../feature/backup/io/BackupFileStore.ios.kt | 3 + presentation/backup/build.gradle.kts | 6 + .../backup/BackupViewModelTest.kt | 111 +++++++- .../drawable/backup_welcome.png | Bin 0 -> 913628 bytes .../presentation/backup/BackupIntent.kt | 6 + .../presentation/backup/BackupPageContent.kt | 37 +++ .../presentation/backup/BackupScreen.kt | 260 ++++++++---------- .../aisdv1/presentation/backup/BackupState.kt | 2 + .../presentation/backup/BackupViewModel.kt | 42 ++- .../backup/component/BackupArchiveCard.kt | 66 +++++ .../backup/component/BackupSelectionList.kt | 68 +++-- .../backup/create/CreateBackupScreen.kt | 4 +- .../backup/dialog/BackupDialogs.kt | 83 ++++++ .../backup/dialog/BackupResultText.kt | 29 ++ .../backup/restore/RestoreBackupScreen.kt | 32 +-- .../backup/welcome/RestoreWelcomeScreen.kt | 95 ++++--- .../widget/action/PrimaryActionButton.kt | 32 +++ .../widget/action/ScreenActionBar.kt | 40 +++ .../widget/action/SecondaryActionButton.kt | 32 +++ .../setup/ServerSetupCustomSelectionTest.kt | 69 +++++ .../component/LocalModelDownloadAction.kt | 3 +- .../setup/component/OpenAiOAuthActionBar.kt | 9 +- .../setup/component/ServerSetupWidgets.kt | 24 +- .../setup/component/SetupActionBar.kt | 87 ------ .../setup/content/ServerSetupContent.kt | 8 +- .../db/persistent/dao/GenerationResultDao.kt | 41 ++- .../persistent/entity/RestoreSectionEntity.kt | 2 +- 38 files changed, 1401 insertions(+), 374 deletions(-) create mode 100644 feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupImageFingerprintTest.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupImageFingerprint.kt create mode 100644 feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupImageFingerprint.kt create mode 100644 presentation/backup/src/commonMain/composeResources/drawable/backup_welcome.png create mode 100644 presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupPageContent.kt create mode 100644 presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/component/BackupArchiveCard.kt create mode 100644 presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/dialog/BackupDialogs.kt create mode 100644 presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/dialog/BackupResultText.kt create mode 100644 presentation/components/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/components/widget/action/PrimaryActionButton.kt create mode 100644 presentation/components/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/components/widget/action/ScreenActionBar.kt create mode 100644 presentation/components/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/components/widget/action/SecondaryActionButton.kt delete mode 100644 presentation/configuration/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/component/SetupActionBar.kt diff --git a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupInspection.kt b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupInspection.kt index 1edad334f..5c5f20c21 100644 --- a/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupInspection.kt +++ b/domain/src/commonMain/kotlin/com/shifthackz/aisdv1/domain/entity/backup/BackupInspection.kt @@ -11,6 +11,7 @@ package com.shifthackz.aisdv1.domain.entity.backup * @param providers Supported provider children present in the archive. * @param skippedCount Number of unsupported section, provider or field entries. * @param filename User-facing original filename, excluding its storage path. + * @param sourceLocation Native source path or provider document reference for display; never an archive payload field. * @author Dmitriy Moroz */ data class BackupInspection( @@ -22,4 +23,5 @@ data class BackupInspection( val providers: Set, val skippedCount: Int = 0, val filename: String = "", + val sourceLocation: String = "", ) diff --git a/feature/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.android.kt b/feature/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.android.kt index 1ff5dc3df..8e55c74fa 100644 --- a/feature/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.android.kt +++ b/feature/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.android.kt @@ -2,7 +2,9 @@ package com.shifthackz.aisdv1.feature.backup.io import android.content.Context import android.net.Uri +import android.os.Environment import android.os.StatFs +import android.provider.DocumentsContract import android.provider.OpenableColumns import java.util.UUID import java.io.File @@ -41,6 +43,24 @@ internal class AndroidBackupFileStore(private val context: Context) : BackupFile } ?: "SDAI.sdaibackup" } + override fun documentLocation(document: String): String { + val uri = Uri.parse(document) + if (uri.scheme == "file") return uri.path.orEmpty() + if (uri.authority == "com.android.externalstorage.documents" && DocumentsContract.isDocumentUri( + context, + uri + ) + ) { + val id = DocumentsContract.getDocumentId(uri) + if (id.startsWith("primary:")) { + return Environment.getExternalStorageDirectory().absolutePath + "/" + id.substringAfter( + ':' + ) + } + } + return Uri.decode(uri.buildUpon().clearQuery().fragment(null).build().toString()) + } + override fun newId(): String = UUID.randomUUID().toString() override fun openDocument(document: String) = checkNotNull(context.contentResolver.openInputStream(Uri.parse(document))).source().buffer() diff --git a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupImageFingerprintTest.kt b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupImageFingerprintTest.kt new file mode 100644 index 000000000..37c2118f8 --- /dev/null +++ b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupImageFingerprintTest.kt @@ -0,0 +1,128 @@ +package com.shifthackz.aisdv1.feature.backup.restore + +import kotlinx.coroutines.CancellationException +import kotlinx.coroutines.test.runTest +import org.junit.Assert.assertEquals +import org.junit.Assert.assertNotEquals +import org.junit.Assert.assertNull +import org.junit.Assert.assertTrue +import org.junit.Test +import kotlin.io.encoding.Base64 +import kotlin.io.encoding.ExperimentalEncodingApi + +@OptIn(ExperimentalEncodingApi::class) +class BackupImageFingerprintTest { + private val fingerprint = DefaultBackupImageFingerprint() + + @Test + fun `given same encoded image, Base64 alphabet whitespace padding and chunk sizes differ, expected identical fingerprint`() = + runTest { + // Given + val text = Base64.encode(byteArrayOf(1, 2, 3, -5, -1)) + val variant = text.trimEnd('=').replace('+', '-').replace('/', '_').chunked(2) + .joinToString(" \n\u2003") + + // When + val expected = identify(text, 65536) + val actual = identify(variant, 1) + + // Then + assertTrue(expected != null) + assertEquals(expected, actual) + } + + @Test + fun `given image content changes by one byte, fingerprints are read in bounded chunks, expected different identity`() = + runTest { + // Given + val first = Base64.encode(ByteArray(200000) { (it % 251).toByte() }) + val second = Base64.encode(ByteArray(200000) { ((it + 1) % 251).toByte() }) + + // When + val firstHash = identify(first, 65536) + val secondHash = identify(second, 7) + + // Then + assertNotEquals(firstHash, secondHash) + } + + @Test + fun `given malformed saved Base64, padding appears before trailing content, expected no identity`() = + runTest { + // Given + val text = "AQ==AQ==" + + // When + val identity = identify(text, 3) + + // Then + assertNull(identity) + } + + @Test + fun `given saved image is absent or empty, duplicate scan requests its content, expected no identity`() = + runTest { + // Given + val empty = " \n\t" + + // When + val missing = fingerprint { _, _ -> null } + val blank = identify(empty, 1) + + // Then + assertNull(missing) + assertNull(blank) + } + + @Test + fun `given duplicate scan source fails, content reader raises storage error, expected failure propagated`() = + runTest { + // Given + val failure = IllegalStateException("storage unavailable") + var caught: Throwable? = null + + // When + try { + fingerprint { _, _ -> throw failure } + } catch (error: IllegalStateException) { + caught = error + } + + // Then + assertEquals(failure, caught) + } + + @Test + fun `given duplicate scan is canceled, reader propagates cancellation, expected cancellation retained`() = + runTest { + // Given + val failure = CancellationException("cancel") + var caught: Throwable? = null + + // When + try { + fingerprint { _, _ -> throw failure } + } catch (error: CancellationException) { + caught = error + } + + // Then + assertEquals(failure, caught) + } + + /** + * Feeds text at controlled boundaries to exercise Base64 groups and multibyte UTF8 whitespace split across reads. + * @param text Encoded image text, including supported presentation whitespace. + * @param chunkSize Maximum UTF8 bytes returned per read, never exceeding the production request. + * @author Dmitriy Moroz + */ + private suspend fun identify(text: String, chunkSize: Int): String? { + val bytes = text.encodeToByteArray() + return fingerprint { offset, maxBytes -> + if (offset >= bytes.size) byteArrayOf() else bytes.copyOfRange( + offset.toInt(), + minOf(offset + minOf(chunkSize, maxBytes), bytes.size.toLong()).toInt() + ) + } + } +} diff --git a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriterTest.kt b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriterTest.kt index bcf6de82d..e825f50db 100644 --- a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriterTest.kt +++ b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriterTest.kt @@ -1,5 +1,6 @@ package com.shifthackz.aisdv1.feature.backup.restore +import com.shifthackz.aisdv1.domain.entity.backup.BackupImageBudget import com.shifthackz.aisdv1.domain.entity.backup.BackupProgress import com.shifthackz.aisdv1.feature.backup.archive.StagedBackup import com.shifthackz.aisdv1.feature.backup.codec.BackupArchiveCodec @@ -7,9 +8,13 @@ import com.shifthackz.aisdv1.feature.backup.codec.BackupManifest import com.shifthackz.aisdv1.feature.backup.codec.BackupSection import com.shifthackz.aisdv1.feature.backup.codec.GalleryBackupCodec import com.shifthackz.aisdv1.feature.backup.io.BackupFileStore +import com.shifthackz.aisdv1.storage.db.persistent.dao.GenerationResultDao +import com.shifthackz.aisdv1.storage.db.persistent.entity.GenerationResultEntity +import com.shifthackz.aisdv1.storage.db.persistent.entity.RestoreSectionEntity import com.shifthackz.aisdv1.storage.db.persistent.dao.RestoreSessionDao import com.shifthackz.aisdv1.storage.gateway.BackupStorage import io.mockk.coEvery +import io.mockk.coVerify import io.mockk.every import io.mockk.mockk import kotlinx.coroutines.test.runTest @@ -21,11 +26,15 @@ import org.junit.Assert.assertTrue import org.junit.Test class RoomBackupRestoreWriterTest { + private val budget = BackupImageBudget(24 * 1024 * 1024, 16_777_216L, 128L * 1024 * 1024, 256) private val database = mockk() private val ledger = mockk(relaxed = true) private val codec = mockk() private val gallery = mockk() private val files = mockk { every { newId() } returns "revision" } + private val savedImages = mockk { + coEvery { queryImageIdsAfter(any(), any()) } returns emptyList() + } private val archive = StagedBackup( "handle", "/private/archive".toPath(), @@ -51,6 +60,7 @@ class RoomBackupRestoreWriterTest { runTest { // Given every { database.restoreSessionDao() } returns ledger + every { database.generationResultDao() } returns savedImages coEvery { ledger.completed(any()) } returns emptyList() every { codec.openSection(any(), any(), any()) } answers { Buffer() } every { gallery.read(any(), any()) } returns null @@ -58,7 +68,15 @@ class RoomBackupRestoreWriterTest { firstArg Unit>()() throw IllegalStateException("commit failed") } - val writer = RoomBackupRestoreWriter(database, codec, gallery, files, Json) + val writer = RoomBackupRestoreWriter( + database, + codec, + gallery, + files, + Json, + DefaultBackupImageFingerprint(), + budget + ) val progress = mutableListOf() var hasFailed = false // When @@ -77,6 +95,7 @@ class RoomBackupRestoreWriterTest { runTest { // Given every { database.restoreSessionDao() } returns ledger + every { database.generationResultDao() } returns savedImages coEvery { ledger.completed(any()) } returns emptyList() every { codec.openSection(any(), any(), any()) } answers { Buffer() } every { gallery.read(any(), any()) } returns null @@ -85,7 +104,15 @@ class RoomBackupRestoreWriterTest { firstArg Unit>()() hasCommitted = true } - val writer = RoomBackupRestoreWriter(database, codec, gallery, files, Json) + val writer = RoomBackupRestoreWriter( + database, + codec, + gallery, + files, + Json, + DefaultBackupImageFingerprint(), + budget + ) val progress = mutableListOf() // When writer.gallery("session", archive) { assertTrue(hasCommitted); progress += it } @@ -93,4 +120,202 @@ class RoomBackupRestoreWriterTest { assertEquals(1, progress.size) assertEquals(0L, progress.single().completed) } + + @Test + fun `given existing hidden gallery image, backup has same bytes with different metadata, expected existing row preserved and import skipped`() = + runTest { + // Given + val existing = row("AQIDBA==", id = 71, isHidden = true) + val incoming = + existing.copy(id = 0, prompt = "different prompt", liked = false, hidden = false) + val rows = mutableListOf(existing) + val outcomes = mutableListOf() + configureGallery(rows, outcomes) + every { gallery.read(any(), any()) } returns incoming + val writer = RoomBackupRestoreWriter( + database, + codec, + gallery, + files, + Json, + DefaultBackupImageFingerprint(), + budget + ) + + // When + writer.gallery("fresh-session", archive) {} + + // Then + assertEquals(listOf(existing), rows) + assertEquals(0L, outcomes.single().importedCount) + assertEquals(1L, outcomes.single().skippedCount) + coVerify(exactly = 0) { savedImages.insert(any()) } + } + + @Test + fun `given gallery backup restored once, same backup is restored as new session, expected gallery size unchanged`() = + runTest { + // Given + val rows = mutableListOf() + val outcomes = mutableListOf() + configureGallery(rows, outcomes) + every { gallery.read(any(), any()) } answers { row("AQIDBA==") } + val writer = RoomBackupRestoreWriter( + database, + codec, + gallery, + files, + Json, + DefaultBackupImageFingerprint(), + budget + ) + writer.gallery("first-session", archive) {} + + // When + writer.gallery("second-session", archive) {} + + // Then + assertEquals(1, rows.size) + assertEquals(listOf(1L, 0L), outcomes.map { it.importedCount }) + assertEquals(listOf(0L, 1L), outcomes.map { it.skippedCount }) + coVerify(exactly = 1) { savedImages.insert(any()) } + } + + @Test + fun `given archive contains duplicate outputs, restore reaches later copy, expected one fresh gallery row and one skipped entry`() = + runTest { + // Given + val rows = mutableListOf() + val outcomes = mutableListOf() + configureGallery(rows, outcomes) + every { gallery.read(any(), any()) } returnsMany listOf( + row("AQIDBA=="), + row("AQIDBA==").copy(prompt = "another metadata row") + ) + val doubled = + archive.copy(manifest = archive.manifest.copy(sections = archive.manifest.sections.map { + it.copy(itemCount = 2) + })) + val writer = RoomBackupRestoreWriter( + database, + codec, + gallery, + files, + Json, + DefaultBackupImageFingerprint(), + budget + ) + + // When + writer.gallery("session", doubled) {} + + // Then + assertEquals(1, rows.size) + assertEquals(1L, outcomes.single().importedCount) + assertEquals(1L, outcomes.single().skippedCount) + } + + @Test + fun `given existing gallery, backup contains distinct output bytes, expected new row added beside original`() = + runTest { + // Given + val existing = row("AQIDBA==", id = 71) + val rows = mutableListOf(existing) + val outcomes = mutableListOf() + configureGallery(rows, outcomes) + every { gallery.read(any(), any()) } returns row("AQIDBQ==") + val writer = RoomBackupRestoreWriter( + database, + codec, + gallery, + files, + Json, + DefaultBackupImageFingerprint(), + budget + ) + + // When + writer.gallery("session", archive) {} + + // Then + assertEquals(2, rows.size) + assertEquals(existing, rows.first()) + assertEquals(1L, outcomes.single().importedCount) + assertEquals(0L, outcomes.single().skippedCount) + } + + @Test + fun `given oversized wrapped Base64 representation, backup contains same admissible image, expected fallback detects duplicate`() = + runTest { + // Given + val rows = mutableListOf(row("AQID\nBA==", id = 71)) + val outcomes = mutableListOf() + configureGallery(rows, outcomes) + every { gallery.read(any(), any()) } returns row("AQIDBA==") + val writer = RoomBackupRestoreWriter( + database, codec, gallery, files, Json, + DefaultBackupImageFingerprint(), budget.copy(maxEncodedBytes = 4) + ) + + // When + writer.gallery("session", archive) {} + + // Then + assertEquals(1, rows.size) + assertEquals(0L, outcomes.single().importedCount) + assertEquals(1L, outcomes.single().skippedCount) + coVerify(atLeast = 1) { savedImages.queryImageChunk(71, any(), any()) } + } + + /** + * Supplies the production writer with a paged image store and an observed commit ledger. + * @param rows Mutable persisted rows; fresh insert identities are assigned independently of the archive. + * @param outcomes Committed category reports recorded by the fake transaction boundary. + * @author Dmitriy Moroz + */ + private fun configureGallery( + rows: MutableList, + outcomes: MutableList + ) { + every { database.restoreSessionDao() } returns ledger + every { database.generationResultDao() } returns savedImages + coEvery { ledger.completed(any()) } returns emptyList() + coEvery { ledger.mark(any()) } answers { outcomes += firstArg() } + every { codec.openSection(any(), any(), any()) } answers { Buffer() } + coEvery { database.writeTransaction(any()) } coAnswers { firstArg Unit>()() } + coEvery { savedImages.queryImageIdsAfter(any(), any()) } answers { + val afterId = firstArg() + rows.filter { it.id > afterId }.sortedBy { it.id }.take(secondArg()).map { it.id } + } + coEvery { savedImages.queryImageTextForFingerprint(any(), any()) } answers { + rows.single { it.id == firstArg() }.imageBase64.takeIf { it.encodeToByteArray().size <= secondArg() } + } + coEvery { savedImages.queryImageChunk(any(), any(), any()) } answers { + val text = rows.single { it.id == firstArg() }.imageBase64.encodeToByteArray() + val start = secondArg().toInt() - 1 + if (start >= text.size) byteArrayOf() else text.copyOfRange( + start, + minOf(text.size, start + thirdArg()) + ) + } + coEvery { savedImages.insert(any()) } answers { + rows += firstArg().copy(id = (rows.maxOfOrNull { it.id } + ?: 0) + 1) + rows.last().id + } + } + + /** + * Builds gallery rows with different output-byte identities while keeping generation metadata usable. + * @param image Output Base64 content used by the duplicate-checking unit under test. + * @param id Existing identity, or zero for an archive-decoded row. + * @param isHidden Whether the existing image belongs only to generation history. + * @author Dmitriy Moroz + */ + private fun row(image: String, id: Long = 0, isHidden: Boolean = false) = + GenerationResultEntity( + id, image, "", 100, "txt2img", "prompt", "negative", 1, 1, 20, 7.5f, + false, "Euler", "42", "9", 0.25f, 0.5f, isHidden, true, "model", "revision", + ) + } diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupArchiveStore.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupArchiveStore.kt index cc72d861b..8a55bc4ce 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupArchiveStore.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupArchiveStore.kt @@ -195,6 +195,9 @@ internal class DefaultBackupArchiveStore( val target = directory / ARCHIVE val displayName = files.documentName(document).take(512) FileSystem.SYSTEM.sink(directory / "name").buffer().use { it.writeUtf8(displayName) } + val sourceLocation = files.documentLocation(document).take(2048) + FileSystem.SYSTEM.sink(directory / "location").buffer() + .use { it.writeUtf8(sourceLocation) } files.openDocument(document).use { source -> FileSystem.SYSTEM.sink(target).buffer().use { sink -> val buffer = Buffer() @@ -298,7 +301,11 @@ internal class DefaultBackupArchiveStore( entries, preferences.providers.keys, skipped, - filename + filename, + sourceLocation = (archive.path.parent!! / "location").let { location -> + if (FileSystem.SYSTEM.exists(location)) FileSystem.SYSTEM.source(location).buffer() + .use { it.readUtf8() } else "" + }, ) } diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/di/BackupModule.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/di/BackupModule.kt index 5efe4ba15..7431e90f6 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/di/BackupModule.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/di/BackupModule.kt @@ -14,6 +14,8 @@ import com.shifthackz.aisdv1.feature.backup.restore.BackupProviderPlanner import com.shifthackz.aisdv1.feature.backup.restore.DefaultBackupProviderPlanner import com.shifthackz.aisdv1.feature.backup.restore.BackupRestoreGuard import com.shifthackz.aisdv1.feature.backup.restore.DefaultBackupRestoreGuard +import com.shifthackz.aisdv1.feature.backup.restore.BackupImageFingerprint +import com.shifthackz.aisdv1.feature.backup.restore.DefaultBackupImageFingerprint import com.shifthackz.aisdv1.feature.backup.restore.BackupRestoreWriter import com.shifthackz.aisdv1.feature.backup.restore.RoomBackupRestoreWriter import com.shifthackz.aisdv1.feature.backup.restore.BackupSessionCodec @@ -83,13 +85,16 @@ val backupModule = module { single { DefaultBackupRestoreGuard() } single { DefaultBackupProviderPlanner(get()) } single { DefaultBackupSessionCodec(get(named("backupJson"))) } + single { DefaultBackupImageFingerprint() } single { RoomBackupRestoreWriter( get(), get(), get(), get(), - get(named("backupJson")) + get(named("backupJson")), + get(), + get(), ) } single { DefaultBackupStagingCleaner(get(), get(), get()) } diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.kt index 9ef58a1d4..c80b558bc 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.kt @@ -24,10 +24,7 @@ internal interface BackupFileStore { * @author Dmitriy Moroz */ fun documentPath(reference: String): Path - /** - * Returns a fresh UUID used only for private staging, sessions or imported revisions. - * @author Dmitriy Moroz - */ + /** * Reads only the display filename of a selected source, never its full storage path. * @param document Native user-selected source reference. @@ -35,7 +32,18 @@ internal interface BackupFileStore { */ fun documentName(document: String): String - /** Returns a fresh UUID for app-owned staging, sessions or imported image revisions. @author Dmitriy Moroz */ + /** + * Describes the selected source for display without inventing a filesystem path for cloud providers. + * @param document Read-granted native source reference selected by the user. + * @return Available native path or a document-provider reference with query/fragment removed. + * @author Dmitriy Moroz + */ + fun documentLocation(document: String): String + + /** + * Returns a fresh UUID for app-owned staging, sessions or imported image revisions. + * @author Dmitriy Moroz + */ fun newId(): String /** diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupImageFingerprint.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupImageFingerprint.kt new file mode 100644 index 000000000..698c54b3f --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupImageFingerprint.kt @@ -0,0 +1,16 @@ +package com.shifthackz.aisdv1.feature.backup.restore + +/** + * Identifies exact encoded image bytes independently of Base64 alphabet, whitespace, padding or gallery metadata. + * @author Dmitriy Moroz + */ +internal fun interface BackupImageFingerprint { + /** + * Streams bounded Base64 text into a SHA-256 identity without decoding image pixels. + * Invalid or absent existing image text has no identity; storage failures and cancellation propagate. + * @param readChunk Reads sequentially at most the requested UTF8 bytes at an increasing zero-based byte offset; empty means EOF, null means absent. + * @return Encoded-image byte identity, or null for missing, empty or malformed Base64. + * @author Dmitriy Moroz + */ + suspend operator fun invoke(readChunk: suspend (offset: Long, maxBytes: Int) -> ByteArray?): String? +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupRestoreWriter.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupRestoreWriter.kt index 18a2fbd61..8fcded8bc 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupRestoreWriter.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/BackupRestoreWriter.kt @@ -4,12 +4,13 @@ import com.shifthackz.aisdv1.feature.backup.archive.StagedBackup import com.shifthackz.aisdv1.domain.entity.backup.BackupProgress /** - * Strict additive Room writes; each category and its ledger marker commit together. + * Strict additive Room writes; exact gallery duplicates are skipped and each category commits with its ledger marker. * @author Dmitriy Moroz */ internal interface BackupRestoreWriter { /** - * Allocates fresh IDs and imports gallery rows with their section marker in one Room transaction. + * Allocates fresh IDs only for output images absent from gallery/history and earlier archive rows. + * Existing metadata, favorites and visibility remain unchanged; imports and skipped counts commit atomically. * @param sessionId Stable restore retry identity. * @param archive Validated immutable staged archive. * @param progress Processed-row progress; completion is acknowledged only after commit. diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupImageFingerprint.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupImageFingerprint.kt new file mode 100644 index 000000000..31a6910e6 --- /dev/null +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupImageFingerprint.kt @@ -0,0 +1,90 @@ +package com.shifthackz.aisdv1.feature.backup.restore + +import kotlinx.coroutines.currentCoroutineContext +import kotlinx.coroutines.ensureActive +import okio.Buffer +import okio.HashingSink +import okio.blackholeSink +import okio.buffer +import okio.use +import kotlin.io.encoding.Base64 +import kotlin.io.encoding.Base64.PaddingOption + +/** + * Hashes decoded Base64 chunks so alternate valid text representations still identify the same saved image. + * At most one 64KiB UTF8 chunk and its decoded bytes are held in addition to the caller's data. + * @author Dmitriy Moroz + */ +internal class DefaultBackupImageFingerprint : BackupImageFingerprint { + + override suspend fun invoke(readChunk: suspend (Long, Int) -> ByteArray?): String? { + val hashing = HashingSink.sha256(blackholeSink()) + var hasBytes = false + hashing.buffer().use { sink -> + var offset = 0L + var pending = "" + val utf8 = Buffer() + while (true) { + currentCoroutineContext().ensureActive() + val chunk = readChunk(offset, CHUNK_BYTES) ?: return null + if (chunk.isEmpty()) { + if (!utf8.exhausted()) return null + break + } + offset += chunk.size + utf8.write(chunk) + val normalized = buildString(pending.length + chunk.size) { + append(pending) + while (!utf8.exhausted()) { + val lead = utf8[0].toInt() and 0xff + val byteCount = when { + lead < 0x80 -> 1 + lead and 0xe0 == 0xc0 -> 2 + lead and 0xf0 == 0xe0 -> 3 + lead and 0xf8 == 0xf0 -> 4 + else -> return null + } + if (utf8.size < byteCount) break + val codePoint = utf8.readUtf8CodePoint() + if (codePoint > Char.MAX_VALUE.code) return null + val character = codePoint.toChar() + if (!character.isWhitespace()) append( + when (character) { + '-' -> '+' + '_' -> '/' + else -> character + } + ) + } + } + // Retain the final quartet until EOF; padding is valid only at the end of the whole image. + val completeChars = ((normalized.length - 4).coerceAtLeast(0) / 4) * 4 + val complete = normalized.substring(0, completeChars) + if ('=' in complete) return null + val decoded = decode(complete) ?: return null + sink.write(decoded) + hasBytes = hasBytes || decoded.isNotEmpty() + pending = normalized.substring(completeChars) + } + val decoded = decode(pending) ?: return null + sink.write(decoded) + hasBytes = hasBytes || decoded.isNotEmpty() + } + return hashing.hash.hex().takeIf { hasBytes } + } + + /** + * Treats malformed image text as unidentifiable without masking storage or cancellation failures. + * @param value Complete Base64 quartets or the final optionally padded group. + * @author Dmitriy Moroz + */ + private fun decode(value: String): ByteArray? = try { + Base64.Default.withPadding(PaddingOption.PRESENT_OPTIONAL).decode(value) + } catch (_: IllegalArgumentException) { + null + } + + private companion object { + const val CHUNK_BYTES = 65536 + } +} diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriter.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriter.kt index a14283e98..e38675f1d 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriter.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriter.kt @@ -2,6 +2,7 @@ package com.shifthackz.aisdv1.feature.backup.restore import okio.use import com.shifthackz.aisdv1.domain.entity.NetworkUsageBucket +import com.shifthackz.aisdv1.domain.entity.backup.BackupImageBudget import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory import com.shifthackz.aisdv1.domain.entity.backup.BackupProgress import com.shifthackz.aisdv1.feature.backup.archive.StagedBackup @@ -15,12 +16,14 @@ import kotlinx.coroutines.ensureActive import kotlinx.serialization.json.Json /** - * Imports directly into Room, avoiding generation-save auto-export and preserving all existing rows. + * Imports unique output images directly into Room, preserving existing rows and avoiding generation-save auto-export. * @param database Destination database and category commit ledger. * @param codec Validated length-delimited section reader. * @param galleryCodec Per-image metadata and binary image decoder. * @param files Fresh imported image revision identities. * @param json Typed network counter decoder. + * @param fingerprint Streams saved output-image identities for exact duplicate suppression. + * @param budget Admits one ordinary image text before hashing; oversized legacy representations use chunked reads. * @author Dmitriy Moroz */ internal class RoomBackupRestoreWriter( @@ -29,6 +32,8 @@ internal class RoomBackupRestoreWriter( private val galleryCodec: GalleryBackupCodec, private val files: BackupFileStore, private val json: Json, + private val fingerprint: BackupImageFingerprint, + private val budget: BackupImageBudget, ) : BackupRestoreWriter { override suspend fun gallery( sessionId: String, @@ -41,6 +46,18 @@ internal class RoomBackupRestoreWriter( if ("gallery" in database.restoreSessionDao() .completed(sessionId) ) return@writeTransaction + val knownImages = mutableSetOf() + val gallery = database.generationResultDao() + var afterId = 0L + while (true) { + currentCoroutineContext().ensureActive() + val ids = gallery.queryImageIdsAfter(afterId, 128) + if (ids.isEmpty()) break + ids.forEach { id -> + existingImageFingerprint(id)?.let(knownImages::add) + } + afterId = ids.last() + } var count = 0L var skipped = 0L codec.openSection(archive.path, archive.manifest, "gallery").use { source -> @@ -49,8 +66,13 @@ internal class RoomBackupRestoreWriter( currentCoroutineContext().ensureActive() val row = galleryCodec.read(source, files.newId()) if (row == null) skipped++ else { - database.generationResultDao().insert(row) - count++ + val identity = checkNotNull(imageFingerprint(row.imageBase64)) { + "Validated backup image has invalid Base64" + } + if (knownImages.add(identity)) { + gallery.insert(row) + count++ + } else skipped++ } index++ } @@ -71,6 +93,38 @@ internal class RoomBackupRestoreWriter( } } + /** + * Reads ordinary images once; exceptionally long wrapped text retains the exact-comparison fallback. + * @param id Existing gallery/history identity inside the category transaction. + * @author Dmitriy Moroz + */ + private suspend fun existingImageFingerprint(id: Long): String? { + val gallery = database.generationResultDao() + val maxTextBytes = ((budget.maxEncodedBytes.toLong() + 2) / 3) * 4 + val text = gallery.queryImageTextForFingerprint(id, maxTextBytes) + return if (text != null) imageFingerprint(text) else { + fingerprint { offset, maxBytes -> gallery.queryImageChunk(id, offset + 1, maxBytes) } + } + } + + /** + * Encodes an admitted string into small UTF8 chunks without allocating another full-image byte array. + * @param text Existing admitted image or canonical Base64 returned by the validated archive decoder. + * @author Dmitriy Moroz + */ + private suspend fun imageFingerprint(text: String): String? { + var characterOffset = 0 + var byteOffset = 0L + return fingerprint { offset, maxBytes -> + check(offset == byteOffset) { "Image fingerprint reader must advance sequentially" } + val end = minOf(text.length, characterOffset + maxOf(1, maxBytes / 4)) + val bytes = text.substring(characterOffset, end).encodeToByteArray() + characterOffset = end + byteOffset += bytes.size + bytes + } + } + override suspend fun network(sessionId: String, archive: StagedBackup) { val values = codec.openSection(archive.path, archive.manifest, "network").use { source -> val counters = json.decodeFromString>(codec.readJson(source)) diff --git a/feature/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.ios.kt b/feature/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.ios.kt index d06262b57..c58ff45c4 100644 --- a/feature/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.ios.kt +++ b/feature/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.ios.kt @@ -31,6 +31,9 @@ internal class IosBackupFileStore : BackupFileStore { override fun documentName(document: String): String = NSURL.URLWithString(document)?.lastPathComponent ?: "SDAI.sdaibackup" + override fun documentLocation(document: String): String = + documentPath(document).toString() + override fun newId(): String = NSUUID().UUIDString override fun openDocument(document: String) = FileSystem.SYSTEM.source(checkNotNull(NSURL.URLWithString(document)?.path).toPath()) diff --git a/presentation/backup/build.gradle.kts b/presentation/backup/build.gradle.kts index 3a04b3360..a34ef374e 100644 --- a/presentation/backup/build.gradle.kts +++ b/presentation/backup/build.gradle.kts @@ -2,6 +2,10 @@ plugins { alias(libs.plugins.generic.kmp.compose) } +compose.resources { + packageOfResClass = "com.shifthackz.aisdv1.presentation.backup.generated.resources" +} + android { namespace = "com.shifthackz.aisdv1.presentation.backup" testOptions.unitTests { @@ -24,8 +28,10 @@ kotlin { implementation(project(":domain")) implementation(project(":presentation:components")) implementation(compose.runtime) + implementation(compose.components.resources) implementation(compose.ui) implementation(compose.foundation) + implementation(compose.animation) implementation(compose.material3) implementation(compose.materialIconsExtended) implementation(libs.androidx.lifecycle.compose) diff --git a/presentation/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupViewModelTest.kt b/presentation/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupViewModelTest.kt index 3b84434a0..03fbf7981 100644 --- a/presentation/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupViewModelTest.kt +++ b/presentation/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupViewModelTest.kt @@ -32,6 +32,7 @@ import io.mockk.mockk import io.mockk.verify import kotlinx.coroutines.Dispatchers import kotlinx.coroutines.ExperimentalCoroutinesApi +import kotlinx.coroutines.test.UnconfinedTestDispatcher import kotlinx.coroutines.test.StandardTestDispatcher import kotlinx.coroutines.test.TestScope import kotlinx.coroutines.test.advanceUntilIdle @@ -78,8 +79,14 @@ class BackupViewModelTest { Dispatchers.resetMain() } - private fun TestScope.viewModel(mode: BackupScreenMode = BackupScreenMode.SETTINGS): BackupViewModel { - val dispatcher = StandardTestDispatcher(testScheduler) + private fun TestScope.viewModel( + mode: BackupScreenMode = BackupScreenMode.SETTINGS, + shouldUseImmediateDispatcher: Boolean = false, + ): BackupViewModel { + val dispatcher = + if (shouldUseImmediateDispatcher) UnconfinedTestDispatcher(testScheduler) else StandardTestDispatcher( + testScheduler + ) Dispatchers.setMain(dispatcher) coEvery { pending() } returns null coEvery { inventory() } returns summary @@ -228,7 +235,7 @@ class BackupViewModelTest { } @Test - fun `given first launch restore, selected sections succeed, expected restored setup flow`() = + fun `given first launch restore, user acknowledges successful result, expected restored setup flow`() = runTest { // Given val vm = viewModel(BackupScreenMode.FIRST_LAUNCH) @@ -242,15 +249,111 @@ class BackupViewModelTest { advanceUntilIdle() vm.processIntent(BackupIntent.DocumentSelected("content://backup")) advanceUntilIdle() - // When vm.processIntent(BackupIntent.Submit) advanceUntilIdle() + assertTrue(vm.state.value.isFeedbackVisible) + verify(exactly = 0) { router.navigateToInitialConfiguration() } + // When + vm.processIntent(BackupIntent.DismissFeedback) + advanceUntilIdle() // Then verify { startup(BackupStartupStage.CONFIGURATION); router.navigateToInitialConfiguration() } coVerify { discard(summary.handle) } verify(exactly = 0) { router.navigateBack() } } + @Test + fun `given retained failed export, screen initializes on immediate dispatcher, expected failure feedback retained`() = + runTest { + // Given + exportState.value = BackupExportOperation( + BackupExportStatus.FAILED, + BackupExport("source", "name", "handle") + ) + + // When + val vm = viewModel(shouldUseImmediateDispatcher = true) + advanceUntilIdle() + + // Then + assertTrue(vm.state.value.hasError) + assertTrue(vm.state.value.isFeedbackVisible) + assertFalse(vm.state.value.isBusy) + vm.onRouteDisposed() + } + + @Test + fun `given retained canceled export, screen initializes on immediate dispatcher, expected cancellation feedback retained`() = + runTest { + // Given + exportState.value = BackupExportOperation( + BackupExportStatus.CANCELED, + BackupExport("source", "name", "handle") + ) + + // When + val vm = viewModel(shouldUseImmediateDispatcher = true) + advanceUntilIdle() + + // Then + assertTrue(vm.state.value.hasCanceled) + assertTrue(vm.state.value.isFeedbackVisible) + assertFalse(vm.state.value.isBusy) + vm.onRouteDisposed() + } + + @Test + fun `given failed backup inspection, user acknowledges error, expected file selection remains available`() = + runTest { + // Given + val vm = viewModel() + coEvery { inspect(any(), any()) } throws IllegalArgumentException("Invalid archive") + advanceUntilIdle() + vm.processIntent(BackupIntent.DocumentSelected("content://invalid")) + advanceUntilIdle() + assertTrue(vm.state.value.isFeedbackVisible) + assertTrue(vm.state.value.hasError) + + // When + vm.processIntent(BackupIntent.DismissFeedback) + advanceUntilIdle() + + // Then + assertFalse(vm.state.value.isFeedbackVisible) + assertFalse(vm.state.value.isBusy) + assertNull(vm.state.value.restore.inspection) + verify(exactly = 0) { router.navigateBack(); router.navigateToInitialConfiguration() } + vm.onRouteDisposed() + } + + @Test + fun `given partial restore result, user acknowledges failure, expected journal selection retained for retry`() = + runTest { + // Given + val vm = viewModel() + coEvery { inspect(any(), any()) } returns summary + val result = BackupRestoreResult.Finished(setOf(BackupCategory.GALLERY), 0, true) + coEvery { restore(any(), any()) } returns result + advanceUntilIdle() + vm.processIntent(BackupIntent.SelectTab(true)) + vm.processIntent(BackupIntent.DocumentSelected("content://backup")) + advanceUntilIdle() + vm.processIntent(BackupIntent.Submit) + advanceUntilIdle() + + // When + vm.processIntent(BackupIntent.DismissFeedback) + advanceUntilIdle() + + // Then + assertFalse(vm.state.value.isFeedbackVisible) + assertEquals(result, vm.state.value.result) + assertTrue(vm.state.value.hasPendingSession) + assertTrue(vm.state.value.isRestoreSelectionLocked) + coVerify(exactly = 0) { discard(any()) } + vm.onRouteDisposed() + } + @Test fun `given inspected backup with custom selection, next picker is canceled, expected original file and choices retained`() = runTest { diff --git a/presentation/backup/src/commonMain/composeResources/drawable/backup_welcome.png b/presentation/backup/src/commonMain/composeResources/drawable/backup_welcome.png new file mode 100644 index 0000000000000000000000000000000000000000..d10c0c17b596f8749c945471113db7f358b2b047 GIT binary patch literal 913628 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%0A3>O=iR`^TZ*kJ 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�VaN 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℘Zbn0ODsr@7OF)UbD96 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

;(hkD1w%(3+E1=rJnZ*b8&;is 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 z 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≤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 Unit, + modifier: Modifier = Modifier, +) { + Column(modifier.fillMaxSize().verticalScroll(rememberScrollState()).padding(16.dp)) { + if (isRestore) RestoreBackupScreen(page, isEnabled, canEditSelection, processIntent) + else CreateBackupScreen(page, isEnabled && canEditSelection, processIntent) + } +} diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupScreen.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupScreen.kt index 71d216328..943276011 100644 --- a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupScreen.kt +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupScreen.kt @@ -1,21 +1,14 @@ package com.shifthackz.aisdv1.presentation.backup -import androidx.compose.foundation.layout.WindowInsets import androidx.compose.foundation.layout.Column -import androidx.compose.foundation.layout.Row -import androidx.compose.foundation.layout.Spacer import androidx.compose.foundation.layout.fillMaxSize import androidx.compose.foundation.layout.fillMaxWidth import androidx.compose.foundation.layout.padding -import androidx.compose.foundation.layout.safeDrawingPadding -import androidx.compose.foundation.layout.size -import androidx.compose.foundation.rememberScrollState -import androidx.compose.foundation.verticalScroll +import androidx.compose.foundation.pager.HorizontalPager +import androidx.compose.foundation.pager.rememberPagerState import androidx.compose.material.icons.Icons -import androidx.compose.material.icons.automirrored.filled.ArrowBack -import androidx.compose.material3.AlertDialog -import androidx.compose.material3.Button -import androidx.compose.material3.CircularProgressIndicator +import androidx.compose.material.icons.automirrored.outlined.ArrowBack +import androidx.compose.material3.CenterAlignedTopAppBar import androidx.compose.material3.ExperimentalMaterial3Api import androidx.compose.material3.Icon import androidx.compose.material3.IconButton @@ -24,22 +17,24 @@ import androidx.compose.material3.Scaffold import androidx.compose.material3.Tab import androidx.compose.material3.TabRow import androidx.compose.material3.Text -import androidx.compose.material3.TextButton -import androidx.compose.material3.TopAppBar import androidx.compose.runtime.Composable +import androidx.compose.runtime.LaunchedEffect +import androidx.compose.runtime.getValue +import androidx.compose.runtime.rememberUpdatedState +import androidx.compose.runtime.snapshotFlow import androidx.compose.ui.Modifier -import androidx.compose.ui.unit.dp import com.shifthackz.aisdv1.core.localization.Localization -import com.shifthackz.aisdv1.domain.entity.backup.BackupRestoreNotice -import com.shifthackz.aisdv1.presentation.backup.component.providerName -import com.shifthackz.aisdv1.presentation.backup.create.CreateBackupScreen -import com.shifthackz.aisdv1.presentation.backup.restore.RestoreBackupScreen +import com.shifthackz.aisdv1.presentation.backup.dialog.BackupDialogs import com.shifthackz.aisdv1.presentation.backup.welcome.RestoreWelcomeScreen +import com.shifthackz.aisdv1.presentation.components.theme.global.persistentTopAppBarWindowInsets +import com.shifthackz.aisdv1.presentation.components.widget.action.PrimaryActionButton +import com.shifthackz.aisdv1.presentation.components.widget.action.ScreenActionBar +import kotlinx.coroutines.flow.drop /** - * Stateless backup host; dedicated create/restore content remains reusable across launch contexts. - * @param mode Normal tabs or first-launch recovery chrome. - * @param state Current nonsecret screen state. + * Hosts reusable backup content with configuration-aligned chrome and operation dialogs. + * @param mode Settings tabs or first-launch recovery context. + * @param state Nonsecret inventory, selection and operation feedback. * @param processIntent Caller-owned MVI event sink. * @param modifier Root screen placement. * @author Dmitriy Moroz @@ -50,150 +45,119 @@ fun BackupScreen( mode: BackupScreenMode, state: BackupState, processIntent: (BackupIntent) -> Unit, - modifier: Modifier = Modifier + modifier: Modifier = Modifier, ) { val isEnabled = !state.isBusy && !state.isPicking && !state.isExporting if (mode == BackupScreenMode.WELCOME) { RestoreWelcomeScreen( - isEnabled, - state.hasError, - { processIntent(BackupIntent.BeginInitialRestore) }, - { processIntent(BackupIntent.Continue) }, - modifier + isEnabled = isEnabled, + onRestore = { processIntent(BackupIntent.BeginInitialRestore) }, + onContinue = { processIntent(BackupIntent.Continue) }, + modifier = modifier, ) - return - } - val page = if (state.isRestoreTab) state.restore else state.create - Scaffold(modifier.safeDrawingPadding(), topBar = { - TopAppBar( - windowInsets = WindowInsets(0, 0, 0, 0), - title = { Text(Localization.string("backup_title")) }, - navigationIcon = { - IconButton( - onClick = { processIntent(BackupIntent.NavigateBack) }, - enabled = isEnabled - ) { - Icon(Icons.AutoMirrored.Filled.ArrowBack, Localization.string("action_back")) - } - }) - }, bottomBar = { - Column(Modifier.fillMaxWidth().padding(horizontal = 24.dp, vertical = 16.dp)) { - if (state.isBusy || state.isExporting) { - Row { - CircularProgressIndicator(Modifier.size(24.dp)); Spacer(Modifier.size(12.dp)); Text( - Localization.string("backup_working") - ) - } - state.progress?.let { progress -> - Text( - if (progress.total > 0) "${progress.completed} / ${progress.total}" else progress.completed.toString(), - style = MaterialTheme.typography.bodySmall - ) - } - TextButton(onClick = { processIntent(BackupIntent.CancelWork) }) { - Text( - Localization.string( - "backup_cancel" - ) - ) - } - } else { - val isFinished = - if (state.isRestoreTab) state.result?.hasFailed == false else state.hasExported - Button( - onClick = { processIntent(if (isFinished) BackupIntent.NavigateBack else BackupIntent.Submit) }, - enabled = isEnabled && (isFinished || page.selection.categories.isNotEmpty()), - modifier = Modifier.fillMaxWidth() - ) { - Text(Localization.string(if (isFinished) "backup_done" else if (state.isRestoreTab) "backup_restore" else "backup_create")) - } + } else { + val page = if (state.isRestoreTab) state.restore else state.create + val pager = rememberPagerState(initialPage = if (state.isRestoreTab) 1 else 0) { 2 } + val isRestoreSelected by rememberUpdatedState(state.isRestoreTab) + val selectedPage = if (state.isRestoreTab) 1 else 0 + val hasSettledPage = mode != BackupScreenMode.SETTINGS || + (!pager.isScrollInProgress && pager.currentPage == selectedPage && pager.currentPageOffsetFraction == 0f) + LaunchedEffect(state.isRestoreTab) { + if (mode == BackupScreenMode.SETTINGS) { + pager.animateScrollToPage(selectedPage) } } - }) { padding -> - Column(Modifier.padding(padding)) { - if (mode == BackupScreenMode.SETTINGS) TabRow(selectedTabIndex = if (state.isRestoreTab) 1 else 0) { - Tab( - selected = !state.isRestoreTab, - onClick = { processIntent(BackupIntent.SelectTab(false)) }, - enabled = isEnabled, - text = { Text(Localization.string("backup_create_tab")) }) - Tab( - selected = state.isRestoreTab, - onClick = { processIntent(BackupIntent.SelectTab(true)) }, - enabled = isEnabled, - text = { Text(Localization.string("backup_restore_tab")) }) - } - Column(Modifier.fillMaxSize().verticalScroll(rememberScrollState()).padding(24.dp)) { - if (state.hasError) Text( - Localization.string("backup_error"), - color = MaterialTheme.colorScheme.error - ) - if (state.hasCanceled) Text( - Localization.string("backup_canceled"), - style = MaterialTheme.typography.bodyMedium - ) - if (state.hasExported && !state.isRestoreTab) Text( - Localization.string("backup_exported"), - color = MaterialTheme.colorScheme.primary - ) - state.result?.let { result -> - Text( - Localization.string(if (result.hasFailed) "backup_partial" else "backup_restored"), - style = MaterialTheme.typography.titleMedium - ) - result.importedCounts.forEach { (category, count) -> Text(Localization.string("backup_category_" + category.key) + ": " + count) } - result.notices.forEach { notice -> - when (notice) { - is BackupRestoreNotice.SharedCredentialsRetained -> Text( - Localization.string( - "backup_shared_credentials_retained", - notice.providers.joinToString(", ", transform = ::providerName) - ) - ) - } - } - if (result.skippedCount > 0) Text( - Localization.string( - "backup_skipped", - result.skippedCount + LaunchedEffect(pager) { + if (mode == BackupScreenMode.SETTINGS) { + snapshotFlow { pager.settledPage }.drop(1).collect { settledPage -> + val shouldRestore = settledPage == 1 + if (shouldRestore != isRestoreSelected) processIntent( + BackupIntent.SelectTab( + shouldRestore ) ) } - if (state.isRestoreTab) RestoreBackupScreen( - page, - isEnabled, - !state.isRestoreSelectionLocked, - processIntent - ) - else CreateBackupScreen(page, isEnabled && !state.hasPendingExport, processIntent) } } - } - state.conflict?.let { conflict -> - AlertDialog( - onDismissRequest = { processIntent(BackupIntent.DismissConflict) }, - title = { Text(Localization.string("backup_conflict_title")) }, - text = { - Text( - Localization.string( - "backup_conflict_description", - conflict.providers.joinToString(", ", transform = ::providerName) - ) + val isFinished = + if (state.isRestoreTab) state.result?.hasFailed == false else state.hasExported + Scaffold( + modifier = modifier, + topBar = { + CenterAlignedTopAppBar( + title = { + Text( + Localization.string("backup_title"), + style = MaterialTheme.typography.headlineMedium + ) + }, + navigationIcon = { + IconButton( + onClick = { processIntent(BackupIntent.NavigateBack) }, + enabled = isEnabled + ) { + Icon( + Icons.AutoMirrored.Outlined.ArrowBack, + Localization.string("action_back") + ) + } + }, + windowInsets = persistentTopAppBarWindowInsets(), ) }, - confirmButton = { - TextButton(onClick = { processIntent(BackupIntent.ConfirmProviderReplacement) }) { - Text( - Localization.string("backup_replace_providers") - ) + bottomBar = { + ScreenActionBar { + PrimaryActionButton( + onClick = { processIntent(if (isFinished) BackupIntent.NavigateBack else BackupIntent.Submit) }, + isEnabled = isEnabled && hasSettledPage && (isFinished || page.selection.categories.isNotEmpty()), + ) { + Text(Localization.string(if (isFinished) "backup_done" else if (state.isRestoreTab) "backup_restore" else "backup_create")) + } } }, - dismissButton = { - TextButton(onClick = { processIntent(BackupIntent.DismissConflict) }) { - Text( - Localization.string("backup_cancel") + ) { padding -> + Column(Modifier.padding(padding).fillMaxSize()) { + if (mode == BackupScreenMode.SETTINGS) { + TabRow(selectedTabIndex = selectedPage) { + Tab( + selected = !state.isRestoreTab, + onClick = { processIntent(BackupIntent.SelectTab(false)) }, + enabled = isEnabled, + text = { Text(Localization.string("backup_create_tab")) }, + ) + Tab( + selected = state.isRestoreTab, + onClick = { processIntent(BackupIntent.SelectTab(true)) }, + enabled = isEnabled, + text = { Text(Localization.string("backup_restore_tab")) }, + ) + } + HorizontalPager( + state = pager, + modifier = Modifier.weight(1f).fillMaxWidth(), + userScrollEnabled = isEnabled, + key = { it }, + ) { pageIndex -> + val isRestorePage = pageIndex == 1 + BackupPageContent( + isRestore = isRestorePage, + page = if (isRestorePage) state.restore else state.create, + isEnabled = isEnabled && hasSettledPage, + canEditSelection = if (isRestorePage) !state.isRestoreSelectionLocked else !state.hasPendingExport, + processIntent = processIntent, + ) + } + } else { + BackupPageContent( + isRestore = true, + page = state.restore, + isEnabled = isEnabled, + canEditSelection = !state.isRestoreSelectionLocked, + processIntent = processIntent, ) } - }) + } + } } + BackupDialogs(state, processIntent) } diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupState.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupState.kt index 314d4d946..385caacb0 100644 --- a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupState.kt +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupState.kt @@ -16,6 +16,7 @@ import com.shifthackz.aisdv1.domain.entity.backup.BackupRestoreResult * @param progress Current bounded work stage. * @param conflict Named provider conflicts and opaque consent fingerprint. * @param result Durable completion report, including partial failure. + * @param isFeedbackVisible Whether the current completion, cancellation or failure still needs acknowledgement. * @param hasError Whether the last operation failed before a completion report. * @param hasCanceled Whether the user canceled active work. * @param hasExported Whether native document export actually completed. @@ -34,6 +35,7 @@ data class BackupState( val progress: BackupProgress? = null, val conflict: BackupRestoreResult.Conflict? = null, val result: BackupRestoreResult.Finished? = null, + val isFeedbackVisible: Boolean = false, val hasError: Boolean = false, val hasCanceled: Boolean = false, val hasExported: Boolean = false, diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupViewModel.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupViewModel.kt index 7808a3822..415d68372 100644 --- a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupViewModel.kt +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupViewModel.kt @@ -90,13 +90,18 @@ class BackupViewModel( hasExported = export.status == BackupExportStatus.COMPLETE, hasCanceled = it.hasCanceled || export.status == BackupExportStatus.CANCELED, hasError = it.hasError || export.status == BackupExportStatus.FAILED, + isFeedbackVisible = it.isFeedbackVisible || export.status in setOf( + BackupExportStatus.COMPLETE, + BackupExportStatus.FAILED, + BackupExportStatus.CANCELED, + ), ) } } } init { - if (mode != BackupScreenMode.WELCOME) runOperation { + if (mode != BackupScreenMode.WELCOME) runOperation(shouldClearFeedback = false) { val recovery = loadPending() if (recovery != null) { restoreRequest = recovery.request @@ -148,7 +153,8 @@ class BackupViewModel( isRestoreTab = intent.isRestore, result = null, hasError = false, - hasCanceled = false + hasCanceled = false, + isFeedbackVisible = false, ) } @@ -195,6 +201,12 @@ class BackupViewModel( } } + BackupIntent.DismissFeedback -> if (canInteract()) { + if (mode == BackupScreenMode.FIRST_LAUNCH && currentState.result?.hasFailed == false) { + leave() + } else updateState { it.copy(isFeedbackVisible = false) } + } + is BackupIntent.ExportFinished -> completeExport(intent) } } @@ -265,15 +277,10 @@ class BackupViewModel( updateState { it.copy( result = result, - hasPendingSession = result.hasFailed + hasPendingSession = result.hasFailed, + isFeedbackVisible = true, ) } - if (!result.hasFailed && mode == BackupScreenMode.FIRST_LAUNCH) { - setStartupStage(BackupStartupStage.CONFIGURATION) - discardBackup(inspection.handle) - restoreRequest = null - withContext(dispatchers.immediate) { router.navigateToInitialConfiguration() } - } } } } @@ -326,13 +333,20 @@ class BackupViewModel( } } - private fun runOperation(block: suspend () -> Unit) { + /** + * Serializes bounded work and publishes cancellable loading plus acknowledged failure feedback. + * @param shouldClearFeedback Whether a new user operation replaces the prior feedback; startup keeps durable export completion. + * @param block Work run on IO with state publication through the MVI owner. + * @author Dmitriy Moroz + */ + private fun runOperation(shouldClearFeedback: Boolean = true, block: suspend () -> Unit) { if (operation?.isActive == true) return updateState { it.copy( isBusy = true, - hasError = false, - hasCanceled = false, + hasError = if (shouldClearFeedback) false else it.hasError, + hasCanceled = if (shouldClearFeedback) false else it.hasCanceled, + isFeedbackVisible = if (shouldClearFeedback) false else it.isFeedbackVisible, progress = null ) } @@ -340,10 +354,10 @@ class BackupViewModel( try { block() } catch (cancelled: CancellationException) { - updateState { it.copy(hasCanceled = true) } + updateState { it.copy(hasCanceled = true, isFeedbackVisible = true) } throw cancelled } catch (_: Exception) { - updateState { it.copy(hasError = true) } + updateState { it.copy(hasError = true, isFeedbackVisible = true) } } finally { updateState { it.copy(isBusy = false, progress = null) } } diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/component/BackupArchiveCard.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/component/BackupArchiveCard.kt new file mode 100644 index 000000000..8da307dbb --- /dev/null +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/component/BackupArchiveCard.kt @@ -0,0 +1,66 @@ +package com.shifthackz.aisdv1.presentation.backup.component + +import androidx.compose.foundation.layout.Arrangement +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Row +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.layout.size +import androidx.compose.material.icons.Icons +import androidx.compose.material.icons.outlined.Description +import androidx.compose.material3.Icon +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.OutlinedCard +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.ui.Modifier +import androidx.compose.ui.unit.dp +import com.shifthackz.aisdv1.core.localization.Localization +import com.shifthackz.aisdv1.domain.entity.backup.BackupInspection +import com.shifthackz.aisdv1.presentation.backup.platform.formatBackupCreatedAt + +/** + * Groups the selected archive identity, available source location and creation details before restore choices. + * @param archive Validated summary with no provider credentials or decoded image data. + * @param modifier Card placement within the scrolling restore content. + * @author Dmitriy Moroz + */ +@Composable +internal fun BackupArchiveCard(archive: BackupInspection, modifier: Modifier = Modifier) { + OutlinedCard(modifier.fillMaxWidth()) { + Row(Modifier.padding(16.dp), horizontalArrangement = Arrangement.spacedBy(16.dp)) { + Icon( + Icons.Outlined.Description, + contentDescription = null, + modifier = Modifier.size(24.dp) + ) + Column(Modifier.weight(1f), verticalArrangement = Arrangement.spacedBy(8.dp)) { + Text(archive.filename, style = MaterialTheme.typography.titleMedium) + if (archive.sourceLocation.isNotEmpty()) { + Text( + archive.sourceLocation, + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + } + Text( + Localization.string( + "backup_archive_details", + archive.appVersion, + archive.sourcePlatform + ), + style = MaterialTheme.typography.labelMedium, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + Text( + Localization.string( + "backup_created_at", + formatBackupCreatedAt(archive.createdAt) + ), + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + } + } + } +} diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/component/BackupSelectionList.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/component/BackupSelectionList.kt index fcf74874d..df0da8cdb 100644 --- a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/component/BackupSelectionList.kt +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/component/BackupSelectionList.kt @@ -1,5 +1,11 @@ package com.shifthackz.aisdv1.presentation.backup.component +import androidx.compose.animation.AnimatedVisibility +import androidx.compose.animation.expandVertically +import androidx.compose.animation.fadeIn +import androidx.compose.animation.fadeOut +import androidx.compose.animation.shrinkVertically +import androidx.compose.foundation.layout.Arrangement import androidx.compose.foundation.layout.Column import androidx.compose.foundation.layout.Row import androidx.compose.foundation.layout.Spacer @@ -47,14 +53,14 @@ internal fun BackupSelectionList( processIntent: (BackupIntent) -> Unit, modifier: Modifier = Modifier ) { - Column(modifier) { + Column(modifier, verticalArrangement = Arrangement.spacedBy(8.dp)) { state.inspection?.entries?.forEach { entry -> val category = entry.category val isSelected = category in state.selection.categories val hasSomeProviders = category == BackupCategory.PROVIDERS && state.selection.providers.isNotEmpty() val hasAllProviders = state.selection.providers.containsAll(state.inspection.providers) - Card(Modifier.fillMaxWidth().padding(vertical = 6.dp)) { + Card(Modifier.fillMaxWidth()) { Row( Modifier.fillMaxWidth().then( if (category == BackupCategory.PROVIDERS) Modifier.triStateToggleable( @@ -113,24 +119,46 @@ internal fun BackupSelectionList( ) } } - if (category == BackupCategory.PROVIDERS && state.areProvidersExpanded) { - state.inspection.providers.sorted().forEach { provider -> - Row( - Modifier.fillMaxWidth().heightIn(min = 48.dp).toggleable( - value = provider in state.selection.providers, - enabled = isEnabled && entry.isAvailable, - role = Role.Checkbox, - onValueChange = { processIntent(BackupIntent.ToggleProvider(provider)) }, - ).padding(start = 44.dp, end = 16.dp, top = 8.dp, bottom = 8.dp), - verticalAlignment = Alignment.CenterVertically - ) { - Checkbox( - checked = provider in state.selection.providers, - onCheckedChange = null, - enabled = isEnabled && entry.isAvailable - ) - Spacer(Modifier.size(12.dp)) - Text(providerName(provider), style = MaterialTheme.typography.bodyLarge) + if (category == BackupCategory.PROVIDERS) { + AnimatedVisibility( + visible = state.areProvidersExpanded, + enter = expandVertically() + fadeIn(), + exit = shrinkVertically() + fadeOut(), + ) { + Column { + state.inspection.providers.sorted().forEach { provider -> + Row( + Modifier.fillMaxWidth().heightIn(min = 48.dp).toggleable( + value = provider in state.selection.providers, + enabled = isEnabled && entry.isAvailable, + role = Role.Checkbox, + onValueChange = { + processIntent( + BackupIntent.ToggleProvider( + provider + ) + ) + }, + ).padding( + start = 44.dp, + end = 16.dp, + top = 8.dp, + bottom = 8.dp + ), + verticalAlignment = Alignment.CenterVertically + ) { + Checkbox( + checked = provider in state.selection.providers, + onCheckedChange = null, + enabled = isEnabled && entry.isAvailable + ) + Spacer(Modifier.size(12.dp)) + Text( + providerName(provider), + style = MaterialTheme.typography.bodyLarge + ) + } + } } } } diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/create/CreateBackupScreen.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/create/CreateBackupScreen.kt index 71e3afcf4..d06613bac 100644 --- a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/create/CreateBackupScreen.kt +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/create/CreateBackupScreen.kt @@ -1,10 +1,12 @@ package com.shifthackz.aisdv1.presentation.backup.create +import androidx.compose.foundation.layout.Arrangement import androidx.compose.foundation.layout.Column import androidx.compose.material3.MaterialTheme import androidx.compose.material3.Text import androidx.compose.runtime.Composable import androidx.compose.ui.Modifier +import androidx.compose.ui.unit.dp import com.shifthackz.aisdv1.core.localization.Localization import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory import com.shifthackz.aisdv1.presentation.backup.BackupPageState @@ -26,7 +28,7 @@ internal fun CreateBackupScreen( processIntent: (BackupIntent) -> Unit, modifier: Modifier = Modifier ) { - Column(modifier) { + Column(modifier, verticalArrangement = Arrangement.spacedBy(16.dp)) { Text( Localization.string("backup_create_description"), style = MaterialTheme.typography.bodyLarge diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/dialog/BackupDialogs.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/dialog/BackupDialogs.kt new file mode 100644 index 000000000..42626833e --- /dev/null +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/dialog/BackupDialogs.kt @@ -0,0 +1,83 @@ +package com.shifthackz.aisdv1.presentation.backup.dialog + +import androidx.compose.runtime.Composable +import com.shifthackz.aisdv1.core.localization.Localization +import com.shifthackz.aisdv1.core.model.asUiText +import com.shifthackz.aisdv1.presentation.backup.BackupIntent +import com.shifthackz.aisdv1.presentation.backup.BackupState +import com.shifthackz.aisdv1.presentation.backup.component.providerName +import com.shifthackz.aisdv1.presentation.components.widget.dialog.DecisionInteractiveDialogContent +import com.shifthackz.aisdv1.presentation.components.widget.dialog.ErrorDialog +import com.shifthackz.aisdv1.presentation.components.widget.dialog.InfoDialog +import com.shifthackz.aisdv1.presentation.components.widget.dialog.ProgressDialog +import com.shifthackz.aisdv1.presentation.components.widget.dialog.ProgressDialogCancelButton + +/** + * Presents exclusive progress, provider-consent and acknowledged result feedback using shared app dialogs. + * @param state Nonsecret operation state; completed restore data stays available after acknowledgement. + * @param processIntent Cancellation, conflict consent and acknowledgement event sink. + * @author Dmitriy Moroz + */ +@Composable +internal fun BackupDialogs(state: BackupState, processIntent: (BackupIntent) -> Unit) { + val dismiss = { processIntent(BackupIntent.DismissFeedback) } + when { + state.isBusy || state.isExporting -> { + val status = state.progress?.let { progress -> + val category = + progress.category?.let { Localization.string("backup_category_" + it.key) } + val count = + if (progress.total > 0) "${progress.completed} / ${progress.total}" else progress.completed.toString() + listOfNotNull(category, count).joinToString(" · ") + } ?: Localization.string("backup_working") + ProgressDialog( + title = Localization.string("backup_title").asUiText(), + subTitle = status.asUiText(), + canDismiss = false, + ) { + ProgressDialogCancelButton(onClick = { processIntent(BackupIntent.CancelWork) }) + } + } + + state.conflict != null -> DecisionInteractiveDialogContent( + title = Localization.string("backup_conflict_title"), + text = Localization.string( + "backup_conflict_description", + state.conflict.providers.joinToString(", ", transform = ::providerName) + ), + confirmActionText = Localization.string("backup_replace_providers"), + dismissActionText = Localization.string("backup_cancel"), + onConfirmAction = { processIntent(BackupIntent.ConfirmProviderReplacement) }, + onDismissRequest = { processIntent(BackupIntent.DismissConflict) }, + ) + + state.isFeedbackVisible -> when { + state.hasCanceled -> InfoDialog( + Localization.string("backup_title").asUiText(), + Localization.string("backup_canceled").asUiText(), + dismiss, + ) + + state.hasError -> ErrorDialog(Localization.string("backup_error").asUiText(), dismiss) + state.result != null -> { + val result = state.result + if (result.hasFailed) { + ErrorDialog(backupResultText(result).asUiText(), dismiss) + } else { + InfoDialog( + Localization.string("backup_restored").asUiText(), + backupResultText(result).asUiText(), + dismiss + ) + } + } + + state.hasExported -> InfoDialog( + Localization.string("backup_title").asUiText(), + Localization.string("backup_exported").asUiText(), + dismiss, + ) + + } + } +} diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/dialog/BackupResultText.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/dialog/BackupResultText.kt new file mode 100644 index 000000000..f0fbf4d0b --- /dev/null +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/dialog/BackupResultText.kt @@ -0,0 +1,29 @@ +package com.shifthackz.aisdv1.presentation.backup.dialog + +import com.shifthackz.aisdv1.core.localization.Localization +import com.shifthackz.aisdv1.domain.entity.backup.BackupRestoreNotice +import com.shifthackz.aisdv1.domain.entity.backup.BackupRestoreResult +import com.shifthackz.aisdv1.presentation.backup.component.providerName + +/** + * Formats the committed category counts and skipped-data notices for the shared result dialog. + * @param result Durable outcome of the submitted restore session. + * @author Dmitriy Moroz + */ +internal fun backupResultText(result: BackupRestoreResult.Finished): String = buildList { + if (result.hasFailed) add(Localization.string("backup_partial")) + result.importedCounts.forEach { (category, count) -> + add(Localization.string("backup_category_" + category.key) + ": " + count) + } + result.notices.forEach { notice -> + when (notice) { + is BackupRestoreNotice.SharedCredentialsRetained -> add( + Localization.string( + "backup_shared_credentials_retained", + notice.providers.joinToString(", ", transform = ::providerName), + ) + ) + } + } + if (result.skippedCount > 0) add(Localization.string("backup_skipped", result.skippedCount)) +}.joinToString("\n\n") diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/restore/RestoreBackupScreen.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/restore/RestoreBackupScreen.kt index 0d62d6cf9..b1ec613af 100644 --- a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/restore/RestoreBackupScreen.kt +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/restore/RestoreBackupScreen.kt @@ -1,5 +1,8 @@ package com.shifthackz.aisdv1.presentation.backup.restore +import androidx.compose.foundation.layout.Box +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.heightIn import androidx.compose.foundation.layout.Column import androidx.compose.foundation.layout.Spacer import androidx.compose.foundation.layout.height @@ -7,12 +10,13 @@ import androidx.compose.material3.MaterialTheme import androidx.compose.material3.OutlinedButton import androidx.compose.material3.Text import androidx.compose.runtime.Composable +import androidx.compose.ui.Alignment import androidx.compose.ui.Modifier import androidx.compose.ui.unit.dp -import com.shifthackz.aisdv1.presentation.backup.platform.formatBackupCreatedAt import com.shifthackz.aisdv1.core.localization.Localization import com.shifthackz.aisdv1.presentation.backup.BackupPageState import com.shifthackz.aisdv1.presentation.backup.BackupIntent +import com.shifthackz.aisdv1.presentation.backup.component.BackupArchiveCard import com.shifthackz.aisdv1.presentation.backup.component.BackupSelectionList /** @@ -38,31 +42,25 @@ internal fun RestoreBackupScreen( style = MaterialTheme.typography.bodyLarge ) Spacer(Modifier.height(16.dp)) - OutlinedButton( - onClick = { processIntent(BackupIntent.ChooseFile) }, - enabled = isEnabled - ) { Text(Localization.string("backup_choose_file")) } + Box(Modifier.fillMaxWidth(), contentAlignment = Alignment.Center) { + OutlinedButton( + onClick = { processIntent(BackupIntent.ChooseFile) }, + enabled = isEnabled, + modifier = Modifier.heightIn(min = 48.dp), + ) { Text(Localization.string("backup_choose_file")) } + } state.inspection?.let { archive -> Spacer(Modifier.height(16.dp)) - Text(archive.filename, style = MaterialTheme.typography.titleMedium) - Text( - Localization.string( - "backup_archive_details", - archive.appVersion, - archive.sourcePlatform - ), style = MaterialTheme.typography.titleSmall - ) - Text( - Localization.string("backup_created_at", formatBackupCreatedAt(archive.createdAt)), - style = MaterialTheme.typography.bodySmall - ) + BackupArchiveCard(archive) if (archive.skippedCount > 0) Text( Localization.string( "backup_skipped", archive.skippedCount ), color = MaterialTheme.colorScheme.onSurfaceVariant ) + Spacer(Modifier.height(16.dp)) BackupSelectionList(state, isEnabled && canEditSelection, processIntent) + Spacer(Modifier.height(16.dp)) Text( Localization.string("backup_secrets_warning"), style = MaterialTheme.typography.bodySmall, diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/welcome/RestoreWelcomeScreen.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/welcome/RestoreWelcomeScreen.kt index 201b84cad..d6c66f01e 100644 --- a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/welcome/RestoreWelcomeScreen.kt +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/welcome/RestoreWelcomeScreen.kt @@ -1,85 +1,98 @@ package com.shifthackz.aisdv1.presentation.backup.welcome +import androidx.compose.foundation.Image +import androidx.compose.foundation.background import androidx.compose.foundation.layout.Arrangement import androidx.compose.foundation.layout.Column import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.aspectRatio import androidx.compose.foundation.layout.fillMaxSize import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.height import androidx.compose.foundation.layout.padding -import androidx.compose.foundation.layout.safeDrawingPadding -import androidx.compose.foundation.layout.size +import androidx.compose.foundation.layout.widthIn +import androidx.compose.foundation.layout.windowInsetsPadding import androidx.compose.foundation.rememberScrollState import androidx.compose.foundation.verticalScroll -import androidx.compose.material.icons.Icons -import androidx.compose.material.icons.outlined.Restore -import androidx.compose.material3.Button -import androidx.compose.material3.Icon import androidx.compose.material3.MaterialTheme -import androidx.compose.material3.OutlinedButton +import androidx.compose.material3.Scaffold import androidx.compose.material3.Text import androidx.compose.runtime.Composable import androidx.compose.ui.Alignment import androidx.compose.ui.Modifier +import androidx.compose.ui.text.style.TextAlign import androidx.compose.ui.unit.dp import com.shifthackz.aisdv1.core.localization.Localization +import com.shifthackz.aisdv1.presentation.backup.generated.resources.Res +import com.shifthackz.aisdv1.presentation.backup.generated.resources.backup_welcome +import com.shifthackz.aisdv1.presentation.components.theme.global.persistentTopAppBarWindowInsets +import com.shifthackz.aisdv1.presentation.components.widget.action.PrimaryActionButton +import com.shifthackz.aisdv1.presentation.components.widget.action.ScreenActionBar +import com.shifthackz.aisdv1.presentation.components.widget.action.SecondaryActionButton +import org.jetbrains.compose.resources.painterResource /** - * First-launch invitation with two bottom actions and no path back to onboarding. + * Invites first-launch recovery with branded artwork and the same pinned action geometry as setup. * @param isEnabled Whether a durable navigation transition can start. - * @param hasError Whether checked startup progression failed and can be retried. * @param onRestore Opens restore-only recovery. - * @param onContinue Continues through provider setup toward home. + * @param onContinue Continues through mandatory provider setup. * @param modifier Root full-screen layout. * @author Dmitriy Moroz */ @Composable internal fun RestoreWelcomeScreen( isEnabled: Boolean, - hasError: Boolean, onRestore: () -> Unit, onContinue: () -> Unit, - modifier: Modifier = Modifier + modifier: Modifier = Modifier, ) { - Column( - modifier.fillMaxSize().safeDrawingPadding().padding(24.dp), - horizontalAlignment = Alignment.CenterHorizontally - ) { + Scaffold( + modifier = modifier, + containerColor = MaterialTheme.colorScheme.surface, + topBar = { + Spacer( + Modifier.fillMaxWidth().background(MaterialTheme.colorScheme.surface) + .windowInsetsPadding(persistentTopAppBarWindowInsets()) + ) + }, + bottomBar = { + ScreenActionBar(containerColor = MaterialTheme.colorScheme.surface) { + SecondaryActionButton(onClick = onContinue, isEnabled = isEnabled) { + Text(Localization.string("backup_continue")) + } + PrimaryActionButton(onClick = onRestore, isEnabled = isEnabled) { + Text(Localization.string("backup_restore_from_file")) + } + } + }, + ) { padding -> Column( - Modifier.weight(1f).verticalScroll(rememberScrollState()), + modifier = Modifier.padding(padding).fillMaxSize() + .verticalScroll(rememberScrollState()) + .padding(horizontal = 16.dp, vertical = 24.dp), verticalArrangement = Arrangement.Center, - horizontalAlignment = Alignment.CenterHorizontally + horizontalAlignment = Alignment.CenterHorizontally, ) { - Icon( - Icons.Outlined.Restore, - null, - Modifier.size(96.dp), - tint = MaterialTheme.colorScheme.primary + Image( + painter = painterResource(Res.drawable.backup_welcome), + contentDescription = null, + modifier = Modifier.widthIn(max = 320.dp).fillMaxWidth().aspectRatio(1.25f), ) - Spacer(Modifier.size(32.dp)) + Spacer(Modifier.height(24.dp)) Text( Localization.string("backup_welcome_title"), - style = MaterialTheme.typography.headlineLarge + modifier = Modifier.widthIn(max = 480.dp), + style = MaterialTheme.typography.headlineMedium, + textAlign = TextAlign.Center, ) - Spacer(Modifier.size(16.dp)) + Spacer(Modifier.height(16.dp)) Text( Localization.string("backup_welcome_description"), + modifier = Modifier.widthIn(max = 480.dp), style = MaterialTheme.typography.bodyLarge, - color = MaterialTheme.colorScheme.onSurfaceVariant - ) - } - if (hasError) Text( - Localization.string("backup_error"), - color = MaterialTheme.colorScheme.error - ) - Button(onClick = onRestore, enabled = isEnabled, modifier = Modifier.fillMaxWidth()) { - Text( - Localization.string("backup_restore_from_file") + color = MaterialTheme.colorScheme.onSurfaceVariant, + textAlign = TextAlign.Center, ) } - OutlinedButton( - onClick = onContinue, - enabled = isEnabled, - modifier = Modifier.fillMaxWidth() - ) { Text(Localization.string("backup_continue")) } } } diff --git a/presentation/components/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/components/widget/action/PrimaryActionButton.kt b/presentation/components/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/components/widget/action/PrimaryActionButton.kt new file mode 100644 index 000000000..cdb3bd084 --- /dev/null +++ b/presentation/components/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/components/widget/action/PrimaryActionButton.kt @@ -0,0 +1,32 @@ +package com.shifthackz.aisdv1.presentation.components.widget.action + +import androidx.compose.foundation.layout.RowScope +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.heightIn +import androidx.compose.material3.Button +import androidx.compose.runtime.Composable +import androidx.compose.ui.Modifier +import androidx.compose.ui.unit.dp + +/** + * Uses the same full-width primary button geometry for Next, Connect, Setup and OAuth actions. + * @param onClick Dispatches the selected action. + * @param modifier Layout modifiers applied before the common button dimensions. + * @param isEnabled Whether this action is currently available. + * @param content Visible label and optional decorative icon. + * @author Dmitriy Moroz + */ +@Composable +fun PrimaryActionButton( + onClick: () -> Unit, + modifier: Modifier = Modifier, + isEnabled: Boolean = true, + content: @Composable RowScope.() -> Unit, +) { + Button( + onClick = onClick, + modifier = modifier.fillMaxWidth().heightIn(min = 48.dp), + enabled = isEnabled, + content = content + ) +} diff --git a/presentation/components/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/components/widget/action/ScreenActionBar.kt b/presentation/components/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/components/widget/action/ScreenActionBar.kt new file mode 100644 index 000000000..d8c8b6ba3 --- /dev/null +++ b/presentation/components/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/components/widget/action/ScreenActionBar.kt @@ -0,0 +1,40 @@ +package com.shifthackz.aisdv1.presentation.components.widget.action + +import androidx.compose.foundation.background +import androidx.compose.foundation.layout.Arrangement +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.ColumnScope +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.layout.windowInsetsPadding +import androidx.compose.material3.MaterialTheme +import androidx.compose.runtime.Composable +import androidx.compose.ui.Modifier +import androidx.compose.ui.graphics.Color +import androidx.compose.ui.unit.dp +import com.shifthackz.aisdv1.presentation.components.theme.global.persistentBottomBarWindowInsets + +/** + * Gives every setup provider identical horizontal margins, action spacing and bottom safe-area padding. + * @param modifier Bounds applied to the pinned action column. + * @param containerColor Screen surface extended behind the actions and bottom safe area. + * @param verticalArrangement Spacing between actions; animated actions may own their collapsing gap. + * @param content Primary and secondary actions, in display order. + * @author Dmitriy Moroz + */ +@Composable +fun ScreenActionBar( + modifier: Modifier = Modifier, + containerColor: Color = MaterialTheme.colorScheme.background, + verticalArrangement: Arrangement.Vertical = Arrangement.spacedBy(8.dp), + content: @Composable ColumnScope.() -> Unit, +) { + Column( + modifier = modifier.fillMaxWidth() + .background(containerColor) + .windowInsetsPadding(persistentBottomBarWindowInsets()) + .padding(start = 16.dp, end = 16.dp, top = 8.dp, bottom = 16.dp), + verticalArrangement = verticalArrangement, + content = content, + ) +} diff --git a/presentation/components/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/components/widget/action/SecondaryActionButton.kt b/presentation/components/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/components/widget/action/SecondaryActionButton.kt new file mode 100644 index 000000000..1a1bcf514 --- /dev/null +++ b/presentation/components/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/components/widget/action/SecondaryActionButton.kt @@ -0,0 +1,32 @@ +package com.shifthackz.aisdv1.presentation.components.widget.action + +import androidx.compose.foundation.layout.RowScope +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.heightIn +import androidx.compose.material3.OutlinedButton +import androidx.compose.runtime.Composable +import androidx.compose.ui.Modifier +import androidx.compose.ui.unit.dp + +/** + * Matches primary action dimensions while retaining the outlined treatment for secondary operations. + * @param onClick Dispatches the selected action. + * @param modifier Layout modifiers applied before the common button dimensions. + * @param isEnabled Whether this action is currently available. + * @param content Visible label and optional decorative icon. + * @author Dmitriy Moroz + */ +@Composable +fun SecondaryActionButton( + onClick: () -> Unit, + modifier: Modifier = Modifier, + isEnabled: Boolean = true, + content: @Composable RowScope.() -> Unit, +) { + OutlinedButton( + onClick = onClick, + modifier = modifier.fillMaxWidth().heightIn(min = 48.dp), + enabled = isEnabled, + content = content + ) +} diff --git a/presentation/configuration/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/ServerSetupCustomSelectionTest.kt b/presentation/configuration/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/ServerSetupCustomSelectionTest.kt index 7bcf903ba..a58ce7b54 100644 --- a/presentation/configuration/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/ServerSetupCustomSelectionTest.kt +++ b/presentation/configuration/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/ServerSetupCustomSelectionTest.kt @@ -2,6 +2,7 @@ package com.shifthackz.aisdv1.presentation.configuration.setup import com.shifthackz.aisdv1.domain.entity.LocalAiModel import com.shifthackz.aisdv1.domain.entity.ServerSource +import com.shifthackz.aisdv1.presentation.configuration.setup.component.mainButtonEnabled import org.junit.Assert.assertEquals import org.junit.Test import org.junit.runner.RunWith @@ -55,6 +56,74 @@ class ServerSetupCustomSelectionTest( assertEquals(true, refreshed.catalogModels(custom.type).single().selected) } + @Test + fun `given custom model enabled, user selects undownloaded catalog model, expected setup disabled`() { + // Given + val catalog = custom.copy(id = "catalog-model", selected = false, downloaded = false) + val initial = ServerSetupState(mode = source, step = ServerSetupState.Step.CONFIGURE) + .withCatalogResult(custom.type, listOf(custom, catalog), LocalCatalogStatus.READY) + .withAllowCustomModel(true) + + // When + val selected = initial.withSelectedLocalModel( + initial.catalogModels(custom.type).first { it.id == catalog.id }) + + // Then + assertEquals(true, selected.localCustomModel) + assertEquals( + true, + selected.catalogModels(custom.type).first { it.id == catalog.id }.selected + ) + assertEquals(false, selected.mainButtonEnabled) + } + + @Test + fun `given custom model enabled, user selects downloaded catalog model, expected setup enabled`() { + // Given + val catalog = custom.copy(id = "catalog-model", selected = false, downloaded = true) + val initial = ServerSetupState(mode = source, step = ServerSetupState.Step.CONFIGURE) + .withCatalogResult(custom.type, listOf(custom, catalog), LocalCatalogStatus.READY) + .withAllowCustomModel(true) + + // When + val selected = initial.withSelectedLocalModel( + initial.catalogModels(custom.type).first { it.id == catalog.id }) + + // Then + assertEquals(true, selected.mainButtonEnabled) + } + + @Test + fun `given custom model enabled, user selects custom entry, expected setup enabled without catalog download`() { + // Given + val initial = ServerSetupState(mode = source, step = ServerSetupState.Step.CONFIGURE) + .withCatalogResult( + custom.type, + listOf(custom.copy(downloaded = false)), + LocalCatalogStatus.READY + ) + + // When + val selected = initial.withAllowCustomModel(true) + + // Then + assertEquals(true, selected.mainButtonEnabled) + } + + @Test + fun `given custom model disabled, no model is selected, expected setup disabled`() { + // Given + val initial = ServerSetupState(mode = source, step = ServerSetupState.Step.CONFIGURE) + .withCatalogResult(custom.type, listOf(custom), LocalCatalogStatus.READY) + .withAllowCustomModel(true) + + // When + val selected = initial.withAllowCustomModel(false) + + // Then + assertEquals(false, selected.mainButtonEnabled) + } + companion object { /** * Selects provider forms that expose the shared standard custom-model switch. diff --git a/presentation/configuration/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/component/LocalModelDownloadAction.kt b/presentation/configuration/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/component/LocalModelDownloadAction.kt index 6685a238e..a0ddc2277 100644 --- a/presentation/configuration/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/component/LocalModelDownloadAction.kt +++ b/presentation/configuration/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/component/LocalModelDownloadAction.kt @@ -1,5 +1,6 @@ package com.shifthackz.aisdv1.presentation.configuration.setup.component +import com.shifthackz.aisdv1.presentation.components.widget.action.SecondaryActionButton import androidx.compose.animation.AnimatedVisibility import androidx.compose.animation.expandVertically import androidx.compose.animation.fadeIn @@ -48,7 +49,7 @@ internal fun LocalModelDownloadAction( exit = shrinkVertically() + fadeOut(), ) { Column { - SetupSecondaryAction( + SecondaryActionButton( isEnabled = action.isEnabled, onClick = { processIntent(if (isCurrentBatch) ServerSetupIntent.CancelModelDownloads else ServerSetupIntent.DownloadAllModels) }, ) { diff --git a/presentation/configuration/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/component/OpenAiOAuthActionBar.kt b/presentation/configuration/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/component/OpenAiOAuthActionBar.kt index 2cf095fa0..ead384cd0 100644 --- a/presentation/configuration/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/component/OpenAiOAuthActionBar.kt +++ b/presentation/configuration/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/component/OpenAiOAuthActionBar.kt @@ -1,5 +1,8 @@ package com.shifthackz.aisdv1.presentation.configuration.setup.component +import com.shifthackz.aisdv1.presentation.components.widget.action.SecondaryActionButton +import com.shifthackz.aisdv1.presentation.components.widget.action.PrimaryActionButton +import com.shifthackz.aisdv1.presentation.components.widget.action.ScreenActionBar import androidx.compose.material3.MaterialTheme import androidx.compose.material3.Text import androidx.compose.runtime.Composable @@ -29,7 +32,7 @@ internal fun OpenAiOAuthActionBar( processIntent: (ServerSetupIntent) -> Unit, modifier: Modifier = Modifier, ) { - SetupActionBar(modifier = modifier) { + ScreenActionBar(modifier = modifier) { when (state.openAiOAuthPhase) { OpenAiOAuthSetupPhase.SIGNED_OUT -> OAuthPrimaryAction( label = Localization.string("open_ai_oauth_login"), @@ -91,7 +94,7 @@ private fun OAuthPrimaryAction( isEnabled: Boolean = true, onClick: () -> Unit, ) { - SetupPrimaryAction( + PrimaryActionButton( modifier = modifier, isEnabled = isEnabled, onClick = onClick, @@ -115,7 +118,7 @@ private fun OAuthSecondaryAction( onClick: () -> Unit, modifier: Modifier = Modifier, ) { - SetupSecondaryAction( + SecondaryActionButton( modifier = modifier, onClick = onClick, ) { diff --git a/presentation/configuration/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/component/ServerSetupWidgets.kt b/presentation/configuration/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/component/ServerSetupWidgets.kt index b977a077a..b14faf4b7 100644 --- a/presentation/configuration/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/component/ServerSetupWidgets.kt +++ b/presentation/configuration/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/component/ServerSetupWidgets.kt @@ -330,6 +330,11 @@ internal fun ServerSetupState.ValidationError.message( ServerSetupState.ValidationError.InvalidUrl -> Localization.string("error_invalid_url") } +/** + * Enables setup only for the selected usable model; allowing custom paths does not bypass catalog downloads. + * Authorization recovery and provider-specific account requirements remain authoritative. + * @author Dmitriy Moroz + */ internal val ServerSetupState.mainButtonEnabled: Boolean get() = when { isAuthorizationStorageBusy -> false @@ -340,15 +345,12 @@ internal val ServerSetupState.mainButtonEnabled: Boolean ServerSetupState.Step.SOURCE -> true ServerSetupState.Step.CONFIGURE -> when (mode) { ServerSource.OPEN_AI_OAUTH -> openAiOAuthAccount != null && !openAiOAuthBusy - ServerSource.LOCAL_MNN -> isLocalMnnCustomModel || localMnnModels.any { it.selected && it.downloaded } - ServerSource.LOCAL_MICROSOFT_ONNX -> localOnnxCustomModel || - localOnnxModels.any { it.selected && it.downloaded } - - ServerSource.LOCAL_GOOGLE_MEDIA_PIPE -> localMediaPipeCustomModel || - localMediaPipeModels.any { it.selected && it.downloaded } - - ServerSource.LOCAL_STABLE_DIFFUSION_CPP -> localSdxlCustomModel || - localSdxlModels.any { it.selected && it.downloaded } + ServerSource.LOCAL_MNN, + ServerSource.LOCAL_MICROSOFT_ONNX, + ServerSource.LOCAL_GOOGLE_MEDIA_PIPE, + ServerSource.LOCAL_STABLE_DIFFUSION_CPP -> localModels.any { model -> + model.selected && if (model.isCustom) localCustomModel else model.downloaded + } ServerSource.LOCAL_APPLE_CORE_ML -> localCoreMlModels.any { model -> model.selected && @@ -367,6 +369,10 @@ internal val ServerSetupState.mainButtonEnabled: Boolean } } +/** + * Identifies the platform-neutral custom entry, whose source files are selected separately from catalog downloads. + * @author Dmitriy Moroz + */ internal val ServerSetupState.LocalModel.isCustom: Boolean get() = id == LocalAiModel.CustomOnnx.id || id == LocalAiModel.CustomMediaPipe.id || diff --git a/presentation/configuration/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/component/SetupActionBar.kt b/presentation/configuration/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/component/SetupActionBar.kt deleted file mode 100644 index 52f6cf9a3..000000000 --- a/presentation/configuration/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/component/SetupActionBar.kt +++ /dev/null @@ -1,87 +0,0 @@ -package com.shifthackz.aisdv1.presentation.configuration.setup.component - -import androidx.compose.foundation.background -import androidx.compose.foundation.layout.Arrangement -import androidx.compose.foundation.layout.Column -import androidx.compose.foundation.layout.ColumnScope -import androidx.compose.foundation.layout.RowScope -import androidx.compose.foundation.layout.fillMaxWidth -import androidx.compose.foundation.layout.heightIn -import androidx.compose.foundation.layout.padding -import androidx.compose.foundation.layout.windowInsetsPadding -import androidx.compose.material3.Button -import androidx.compose.material3.MaterialTheme -import androidx.compose.material3.OutlinedButton -import androidx.compose.runtime.Composable -import androidx.compose.ui.Modifier -import androidx.compose.ui.unit.dp -import com.shifthackz.aisdv1.presentation.components.theme.global.persistentBottomBarWindowInsets - -/** - * Gives every setup provider identical horizontal margins, action spacing and bottom safe-area padding. - * @param modifier Bounds applied to the pinned action column. - * @param verticalArrangement Spacing between actions; animated actions may own their collapsing gap. - * @param content Primary and secondary actions, in display order. - * @author Dmitriy Moroz - */ -@Composable -internal fun SetupActionBar( - modifier: Modifier = Modifier, - verticalArrangement: Arrangement.Vertical = Arrangement.spacedBy(8.dp), - content: @Composable ColumnScope.() -> Unit, -) { - Column( - modifier = modifier.fillMaxWidth() - .background(MaterialTheme.colorScheme.background) - .windowInsetsPadding(persistentBottomBarWindowInsets()) - .padding(start = 16.dp, end = 16.dp, top = 8.dp, bottom = 16.dp), - verticalArrangement = verticalArrangement, - content = content, - ) -} - -/** - * Uses the same full-width primary button geometry for Next, Connect, Setup and OAuth actions. - * @param onClick Dispatches the selected action. - * @param modifier Layout modifiers applied before the common button dimensions. - * @param isEnabled Whether this action is currently available. - * @param content Visible label and optional decorative icon. - * @author Dmitriy Moroz - */ -@Composable -internal fun SetupPrimaryAction( - onClick: () -> Unit, - modifier: Modifier = Modifier, - isEnabled: Boolean = true, - content: @Composable RowScope.() -> Unit, -) { - Button( - onClick = onClick, - modifier = modifier.fillMaxWidth().heightIn(min = 48.dp), - enabled = isEnabled, - content = content - ) -} - -/** - * Matches primary action dimensions while retaining the outlined treatment for secondary operations. - * @param onClick Dispatches the selected action. - * @param modifier Layout modifiers applied before the common button dimensions. - * @param isEnabled Whether this action is currently available. - * @param content Visible label and optional decorative icon. - * @author Dmitriy Moroz - */ -@Composable -internal fun SetupSecondaryAction( - onClick: () -> Unit, - modifier: Modifier = Modifier, - isEnabled: Boolean = true, - content: @Composable RowScope.() -> Unit, -) { - OutlinedButton( - onClick = onClick, - modifier = modifier.fillMaxWidth().heightIn(min = 48.dp), - enabled = isEnabled, - content = content - ) -} diff --git a/presentation/configuration/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/content/ServerSetupContent.kt b/presentation/configuration/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/content/ServerSetupContent.kt index 1bd67e3b4..3e8c11b1e 100644 --- a/presentation/configuration/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/content/ServerSetupContent.kt +++ b/presentation/configuration/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/configuration/setup/content/ServerSetupContent.kt @@ -2,6 +2,8 @@ package com.shifthackz.aisdv1.presentation.configuration.setup.content +import com.shifthackz.aisdv1.presentation.components.widget.action.PrimaryActionButton +import com.shifthackz.aisdv1.presentation.components.widget.action.ScreenActionBar import androidx.compose.foundation.layout.Arrangement import androidx.compose.foundation.layout.Box import androidx.compose.foundation.layout.Column @@ -25,8 +27,6 @@ import androidx.compose.runtime.LaunchedEffect import androidx.compose.ui.Modifier import androidx.compose.ui.graphics.RectangleShape import com.shifthackz.aisdv1.presentation.configuration.setup.component.LocalModelDownloadAction -import com.shifthackz.aisdv1.presentation.configuration.setup.component.SetupActionBar -import com.shifthackz.aisdv1.presentation.configuration.setup.component.SetupPrimaryAction import com.shifthackz.aisdv1.presentation.configuration.setup.localCatalogType import com.shifthackz.aisdv1.domain.entity.ServerSource import com.shifthackz.aisdv1.presentation.configuration.setup.component.ConfigurationStepBar @@ -108,11 +108,11 @@ fun ServerSetupContent( processIntent = processIntent ) } else { - SetupActionBar(verticalArrangement = Arrangement.Top) { + ScreenActionBar(verticalArrangement = Arrangement.Top) { if (state.step == ServerSetupState.Step.CONFIGURE && state.mode.localCatalogType != null) { LocalModelDownloadAction(state, processIntent) } - SetupPrimaryAction( + PrimaryActionButton( isEnabled = !state.loadingConfiguration && state.mainButtonEnabled, onClick = { processIntent(ServerSetupIntent.MainButtonClick) }, ) { diff --git a/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/dao/GenerationResultDao.kt b/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/dao/GenerationResultDao.kt index 3917aaa8e..f239c21fc 100644 --- a/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/dao/GenerationResultDao.kt +++ b/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/dao/GenerationResultDao.kt @@ -27,10 +27,40 @@ interface GenerationResultDao { suspend fun queryBackupPage(afterId: Long, limit: Int): List + /** + * Pages every saved image identity, including hidden history, without materializing image payloads. + * @param afterId Exclusive primary-key cursor, or zero for the first page. + * @param limit Maximum IDs read for duplicate checking at once. + * @author Dmitriy Moroz + */ + @Query("SELECT id FROM generation_results WHERE id > :afterId ORDER BY id LIMIT :limit") + suspend fun queryImageIdsAfter(afterId: Long, limit: Int): List + + /** + * Admits one output-only image string before materialization for a single-pass duplicate check. + * @param id Saved gallery or hidden-history identity. + * @param maxBytes Maximum stored UTF8 bytes allowed in the admitted text. + * @return Base64 text, or null for an oversized representation or missing row. + * @author Dmitriy Moroz + */ + @Query("SELECT image_base_64 FROM generation_results WHERE id = :id AND length(CAST(image_base_64 AS BLOB)) <= :maxBytes") + suspend fun queryImageTextForFingerprint(id: Long, maxBytes: Long): String? + + /** + * Reads a bounded Kotlin chunk from an oversized legacy representation. + * Used only when the single-read admission rejects the text; SQLite may materialize its value natively. + * @param id Saved gallery or hidden-history identity. + * @param offset One-based byte position in the stored UTF8 Base64 representation. + * @param maxBytes Maximum UTF8 bytes materialized in the result; BLOB slicing avoids repeated text-prefix scans. + * @return Image text bytes, an empty array at EOF, or null if the row no longer exists. + * @author Dmitriy Moroz + */ + @Query("SELECT substr(CAST(image_base_64 AS BLOB), :offset, :maxBytes) FROM generation_results WHERE id = :id") + suspend fun queryImageChunk(id: Long, offset: Long, maxBytes: Int): ByteArray? + /** * Reads all gallery rows, including hidden generation history. * - * @return Matching saved rows or generated local identity, as described by the operation. * @author Dmitriy Moroz */ @Query("SELECT * FROM ${GenerationResultContract.TABLE} ORDER BY ${GenerationResultContract.CREATED_AT} DESC, ${GenerationResultContract.ID} DESC") @@ -41,7 +71,6 @@ interface GenerationResultDao { * * @param limit Maximum rows held in one page. * @param offset Number of prior ordered rows to skip. - * @return Matching saved rows or generated local identity, as described by the operation. * @author Dmitriy Moroz */ @Query("SELECT * FROM ${GenerationResultContract.TABLE} ORDER BY ${GenerationResultContract.CREATED_AT} DESC, ${GenerationResultContract.ID} DESC LIMIT :limit OFFSET :offset ") @@ -52,7 +81,6 @@ interface GenerationResultDao { * * @param limit Maximum rows held in one page. * @param offset Number of prior ordered rows to skip. - * @return Matching saved rows or generated local identity, as described by the operation. * @author Dmitriy Moroz */ @Query( @@ -74,7 +102,6 @@ interface GenerationResultDao { * * @param limit Maximum rows held in one page. * @param offset Number of prior ordered rows to skip. - * @return Matching saved rows or generated local identity, as described by the operation. * @author Dmitriy Moroz */ @Query("SELECT * FROM ${GenerationResultContract.TABLE} ORDER BY ${GenerationResultContract.CREATED_AT} DESC, ${GenerationResultContract.ID} DESC LIMIT :limit OFFSET :offset ") @@ -85,7 +112,6 @@ interface GenerationResultDao { * * @param limit Maximum rows held in one page. * @param offset Number of prior ordered rows to skip. - * @return Matching saved rows or generated local identity, as described by the operation. * @author Dmitriy Moroz */ @Query( @@ -105,7 +131,6 @@ interface GenerationResultDao { /** * Observes the current total number of persisted generation rows. * - * @return Matching saved rows or generated local identity, as described by the operation. * @author Dmitriy Moroz */ @Query("SELECT COUNT(*) FROM ${GenerationResultContract.TABLE}") @@ -114,7 +139,6 @@ interface GenerationResultDao { /** * Reads IDs of all saved generation rows. * - * @return Matching saved rows or generated local identity, as described by the operation. * @author Dmitriy Moroz */ @Query("SELECT ${GenerationResultContract.ID} FROM ${GenerationResultContract.TABLE} ORDER BY ${GenerationResultContract.CREATED_AT} DESC, ${GenerationResultContract.ID} DESC") @@ -124,7 +148,6 @@ interface GenerationResultDao { * Reads one complete saved image row by local identity. * * @param id Local persisted row identity. - * @return Matching saved rows or generated local identity, as described by the operation. * @author Dmitriy Moroz */ @Query("SELECT * FROM ${GenerationResultContract.TABLE} WHERE ${GenerationResultContract.ID} = :id LIMIT 1") @@ -134,7 +157,6 @@ interface GenerationResultDao { * Reads complete saved rows for explicit local identities. * * @param idList Explicit local row identities to read or update. - * @return Matching saved rows or generated local identity, as described by the operation. * @author Dmitriy Moroz */ @Query("SELECT * FROM ${GenerationResultContract.TABLE} WHERE ${GenerationResultContract.ID} IN (:idList)") @@ -164,7 +186,6 @@ interface GenerationResultDao { * Inserts a complete gallery row; nonzero conflicting IDs replace existing rows. * * @param item Full image row; use ID zero for additive backup import. - * @return Matching saved rows or generated local identity, as described by the operation. * @author Dmitriy Moroz */ @Insert(onConflict = OnConflictStrategy.REPLACE) diff --git a/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/entity/RestoreSectionEntity.kt b/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/entity/RestoreSectionEntity.kt index b6d3a513f..f767b4679 100644 --- a/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/entity/RestoreSectionEntity.kt +++ b/storage/src/commonMain/kotlin/com/shifthackz/aisdv1/storage/db/persistent/entity/RestoreSectionEntity.kt @@ -8,7 +8,7 @@ import androidx.room.Entity * @param sessionId Owning restore session. * @param category Stable completed section ID. * @param importedCount Number of destination records durably added or applied. - * @param skippedCount Number of unsupported entries omitted from this committed category. + * @param skippedCount Number of duplicate or unsupported entries omitted from this committed category. * @param retainedCredentialProviders Comma-separated stable provider IDs whose shared credentials were preserved. * @author Dmitriy Moroz */ From 3d44d0c09984b4395534e0a3619194f321d0a226 Mon Sep 17 00:00:00 2001 From: ShiftHackZ Date: Thu, 19 Nov 2026 14:45:18 +0200 Subject: [PATCH 3/3] Expand backup regression coverage and refine tab interactions --- .../backup/BackupExportStateStoreImplTest.kt | 70 +++++ .../BackupPreferencesGatewayImplTest.kt | 165 ++++++++++++ .../backup/io/BackupFileStore.android.kt | 2 + .../archive/BackupArchiveCreationTest.kt | 221 ++++++++++++++++ .../backup/archive/BackupArchiveFixture.kt | 174 ++++++++++++ .../archive/BackupArchiveInspectionTest.kt | 246 +++++++++++++++++ .../archive/BackupArchiveTransportTest.kt | 135 ++++++++++ .../DefaultBackupExportCoordinatorTest.kt | 134 ++++++++++ .../restore/NetworkBackupRestoreWriterTest.kt | 248 ++++++++++++++++++ .../restore/RoomBackupRestoreWriterTest.kt | 62 +++++ .../usecase/RestoreBackupUseCaseImplTest.kt | 166 +++++++++++- .../archive/DefaultBackupArchiveStore.kt | 6 +- .../archive/DefaultBackupStagingCleaner.kt | 1 + .../backup/codec/BinaryBackupArchiveCodec.kt | 3 +- .../backup/codec/BoundedBackupSource.kt | 2 + .../codec/DefaultBackupPreferencesCodec.kt | 1 + .../backup/codec/DefaultGalleryBackupCodec.kt | 1 + .../restore/DefaultBackupProviderPlanner.kt | 1 + .../restore/DefaultBackupRestoreGuard.kt | 1 + .../restore/DefaultBackupSessionCodec.kt | 1 + .../backup/restore/RoomBackupRestoreWriter.kt | 1 + .../usecase/CancelBackupExportUseCaseImpl.kt | 2 +- .../CompleteBackupExportUseCaseImpl.kt | 1 + .../backup/usecase/CreateBackupUseCaseImpl.kt | 1 + .../usecase/DiscardBackupUseCaseImpl.kt | 1 + .../usecase/DismissBackupExportUseCaseImpl.kt | 1 + .../backup/usecase/ExportBackupUseCaseImpl.kt | 2 +- .../GetBackupStartupStageUseCaseImpl.kt | 1 + .../GetPendingBackupExportUseCaseImpl.kt | 1 + .../usecase/InspectBackupUseCaseImpl.kt | 1 + .../usecase/LoadBackupInventoryUseCaseImpl.kt | 1 + .../usecase/LoadPendingBackupUseCaseImpl.kt | 1 + .../usecase/ObserveBackupExportUseCaseImpl.kt | 1 + .../usecase/RestoreBackupUseCaseImpl.kt | 1 + .../SetBackupStartupStageUseCaseImpl.kt | 1 + .../feature/backup/io/BackupFileStore.ios.kt | 2 + .../backup/BackupPagerInteractionTest.kt | 89 +++++++ .../backup/BackupViewModelTest.kt | 195 ++++++++++++++ .../presentation/backup/BackupPageContent.kt | 7 +- .../backup/BackupPagerInteraction.kt | 17 ++ .../presentation/backup/BackupScreen.kt | 18 +- 41 files changed, 1971 insertions(+), 14 deletions(-) create mode 100644 feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupArchiveCreationTest.kt create mode 100644 feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupArchiveFixture.kt create mode 100644 feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupArchiveInspectionTest.kt create mode 100644 feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupArchiveTransportTest.kt create mode 100644 feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/NetworkBackupRestoreWriterTest.kt create mode 100644 presentation/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupPagerInteractionTest.kt create mode 100644 presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupPagerInteraction.kt diff --git a/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupExportStateStoreImplTest.kt b/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupExportStateStoreImplTest.kt index 68a269bb6..4007fed14 100644 --- a/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupExportStateStoreImplTest.kt +++ b/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupExportStateStoreImplTest.kt @@ -9,6 +9,7 @@ import io.mockk.verify import org.junit.Assert.assertEquals import org.junit.Assert.assertNull import org.junit.Assert.assertThrows +import org.junit.Assert.assertTrue import org.junit.Test class BackupExportStateStoreImplTest { @@ -66,4 +67,73 @@ class BackupExportStateStoreImplTest { // Then assertEquals("Unsupported pending export state", error.message) } + + @Test + fun `given transient export stages, durable write is requested, expected rejection before persistence`() { + // Given + val stages = listOf(BackupExportStatus.NONE, BackupExportStatus.PROCESSING) + // When + val failures = stages.map { + runCatching { + records.write( + BackupExportIntent( + "handle", + "backup", + it + ) + ) + }.exceptionOrNull() + } + // Then + assertTrue(failures.all { it?.message == "Invalid durable export stage" }) + verify(exactly = 0) { store.putStringDurably(any(), any()) } + } + + @Test + fun `given missing source identity, durable export write is requested, expected rejection without storage changes`() { + // Given + val intents = listOf(BackupExportIntent("", "backup"), BackupExportIntent("handle", " ")) + // When + val failures = intents.map { runCatching { records.write(it) }.exceptionOrNull() } + // Then + assertTrue(failures.all { it?.message == "Missing pending export identity" }) + verify(exactly = 0) { store.putStringDurably(any(), any()) } + } + + @Test + fun `given copying state without destination, durable write is requested, expected explicit rejection`() { + // Given + val intent = BackupExportIntent("handle", "backup", BackupExportStatus.COPYING) + // When + val failure = runCatching { records.write(intent) }.exceptionOrNull() + // Then + assertEquals("Missing pending export destination", failure?.message) + verify(exactly = 0) { store.putStringDurably(any(), any()) } + } + + @Test + fun `given corrupted durable JSON, startup reads operation, expected failure without silent record clearing`() { + // Given + raw = "not JSON" + // When + val failure = runCatching { records.read() }.exceptionOrNull() + // Then + assertTrue(failure != null) + assertEquals("not JSON", raw) + verify(exactly = 0) { store.putStringDurably(any(), any()) } + } + + @Test + fun `given retained pending export, checked clear fails, expected failure propagated and association retained`() { + // Given + val intent = BackupExportIntent("handle", "backup") + records.write(intent) + val failure = IllegalStateException("cannot clear") + every { store.putStringDurably("pending_export", "") } throws failure + // When + val caught = runCatching { records.clear() }.exceptionOrNull() + // Then + assertTrue(failure === caught) + assertEquals(intent, records.read()) + } } diff --git a/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupPreferencesGatewayImplTest.kt b/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupPreferencesGatewayImplTest.kt index d29e582dd..19142cc6f 100644 --- a/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupPreferencesGatewayImplTest.kt +++ b/data/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/data/preference/backup/BackupPreferencesGatewayImplTest.kt @@ -258,4 +258,169 @@ class BackupPreferencesGatewayImplTest { ) } + @Test + fun `given invalid numeric form defaults, compatibility filtering runs, expected nonfinite negative and zero steps skipped`() { + // Given + val invalidValues = listOf("NaN", "Infinity", "-1", "not-a-number") + // When + val filtered = invalidValues.map { text -> + gateway.filterSupported( + BackupPreferences( + emptyMap(), + mapOf( + "textToImageCfg" to BackupValue.Text(text), + "imageToImageSteps" to BackupValue.Integer(0) + ) + ) + ) + } + // Then + assertTrue(filtered.all { it.settings.isEmpty() }) + } + + @Test + fun `given zero guidance and positive sampling steps, compatibility filtering runs, expected valid boundary values retained`() { + // Given + val settings = mapOf( + "imageToImageCfg" to BackupValue.Text("0"), + "textToImageSteps" to BackupValue.Integer(1) + ) + // When + val supported = gateway.filterSupported(BackupPreferences(emptyMap(), settings)) + // Then + assertEquals(settings, supported.settings) + } + + @Test + fun `given unknown theme language and grid values, compatibility filtering runs, expected unsupported options skipped`() { + // Given + val settings = mapOf( + "colorToken" to BackupValue.Text("future"), + "darkToken" to BackupValue.Text("future"), + "language" to BackupValue.Text("future"), + "galleryGrid" to BackupValue.Integer(-1) + ) + // When + val supported = gateway.filterSupported(BackupPreferences(emptyMap(), settings)) + // Then + assertTrue(supported.settings.isEmpty()) + } + + @Test + fun `given malformed flag and integer fields, compatibility filtering runs, expected explicit type rejection`() { + // Given + val malformed = + listOf("autoSave" to BackupValue.Text("true"), "galleryGrid" to BackupValue.Flag(true)) + // When + val failures = malformed.map { (key, value) -> + runCatching { + gateway.filterSupported( + BackupPreferences( + emptyMap(), + mapOf(key to value) + ) + ) + }.exceptionOrNull() + } + // Then + assertTrue(failures.all { it is IllegalArgumentException && it.message == "Invalid portable preference type" }) + } + + @Test + fun `given selected provider already matches restored fields, backup applies, expected selection revision unchanged`() { + // Given + strings["key_provider_selection_state"] = "custom|41" + strings["key_server_url"] = "https://same" + // When + gateway.writeProviders( + mapOf("custom" to mapOf("serverUrl" to BackupValue.Text("https://same"))), + null + ) + // Then + assertEquals("custom|41", strings["key_provider_selection_state"]) + } + + @Test + fun `given exhausted provider revision, backup changes selected provider, expected failure before durable write`() { + // Given + strings["key_provider_selection_state"] = "custom|${Long.MAX_VALUE}" + // When + val failure = runCatching { + gateway.writeProviders( + mapOf( + "custom" to mapOf( + "serverUrl" to BackupValue.Text("https://new") + ) + ), null + ) + }.exceptionOrNull() + // Then + assertEquals("Provider revision exhausted", failure?.message) + verify(exactly = 0) { store.putConfigurationDurably(any(), any()) } + } + + @Test + fun `given selected provider authorization reassociation, backup fields match, expected revision advances with checked association`() { + // Given + strings["key_provider_selection_state"] = "custom|41" + strings["key_server_url"] = "https://same" + // When + gateway.writeProviders( + mapOf("custom" to mapOf("serverUrl" to BackupValue.Text("https://same"))), + "new-association" + ) + // Then + assertEquals("custom|42", strings["key_provider_selection_state"]) + assertEquals("new-association", strings["key_authorization_commit_id"]) + } + + @Test + fun `given mixed portable settings, selective restore writes batch, expected only known typed settings persisted`() { + // Given + val values = mapOf( + "language" to BackupValue.Text("de"), + "autoSave" to BackupValue.Flag(false), + "textToImageSteps" to BackupValue.Integer(30), + "removed" to BackupValue.Text("ignored") + ) + // When + gateway.writeSettings(values) + // Then + verify { + store.putSettingsDurably( + mapOf("key_language_code" to "de"), + mapOf("key_ai_auto_save" to false), + mapOf("key_text_to_image_sampling_steps" to 30) + ) + } + verify(exactly = 0) { store.putConfigurationDurably(any(), any()) } + } + + @Test + fun `given checked settings persistence failure, restore writes batch, expected original failure propagated`() { + // Given + val failure = IllegalStateException("disk unavailable") + every { store.putSettingsDurably(any(), any(), any()) } throws failure + // When + val caught = + runCatching { gateway.writeSettings(mapOf("autoSave" to BackupValue.Flag(true))) }.exceptionOrNull() + // Then + assertTrue(failure === caught) + verify(exactly = 0) { + store.putBoolean(any(), any()); store.putInt( + any(), + any() + ); store.putString(any(), any()) + } + } + + @Test + fun `given no pending checked write, recovery is requested, expected no invalidation categories`() { + // Given + every { store.retryPendingWrite() } returns false + // When + val recovered = gateway.recoverPendingWrite() + // Then + assertTrue(recovered.isEmpty()) + } } diff --git a/feature/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.android.kt b/feature/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.android.kt index 8e55c74fa..90161ed8c 100644 --- a/feature/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.android.kt +++ b/feature/backup/src/androidMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.android.kt @@ -21,6 +21,7 @@ import okio.sink */ internal class AndroidBackupFileStore(private val context: Context) : BackupFileStore { override val root: Path get() = context.filesDir.resolve("backup").absolutePath.toPath() + override fun documentReference(path: Path): String = Uri.fromFile(File(path.toString())).toString() @@ -62,6 +63,7 @@ internal class AndroidBackupFileStore(private val context: Context) : BackupFile } override fun newId(): String = UUID.randomUUID().toString() + override fun openDocument(document: String) = checkNotNull(context.contentResolver.openInputStream(Uri.parse(document))).source().buffer() diff --git a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupArchiveCreationTest.kt b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupArchiveCreationTest.kt new file mode 100644 index 000000000..9ceeb83df --- /dev/null +++ b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupArchiveCreationTest.kt @@ -0,0 +1,221 @@ +package com.shifthackz.aisdv1.feature.backup.archive + +import com.shifthackz.aisdv1.domain.entity.NetworkUsageBucket +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory +import com.shifthackz.aisdv1.domain.entity.backup.BackupPreferences +import com.shifthackz.aisdv1.domain.entity.backup.BackupSelection +import com.shifthackz.aisdv1.domain.entity.backup.BackupValue +import com.shifthackz.aisdv1.domain.feature.auth.AuthorizationCredentials +import com.shifthackz.aisdv1.storage.db.persistent.entity.NetworkUsageEntity +import io.mockk.coEvery +import io.mockk.coVerify +import io.mockk.verify +import kotlinx.coroutines.CancellationException +import kotlinx.coroutines.test.runTest +import okio.FileSystem +import okio.Path.Companion.toPath +import org.junit.Assert.assertEquals +import org.junit.Assert.assertSame +import org.junit.Assert.assertTrue +import org.junit.Before +import org.junit.Rule +import org.junit.Test +import org.junit.rules.TemporaryFolder + +class BackupArchiveCreationTest { + @get:Rule + val temporary = TemporaryFolder() + private lateinit var fixture: BackupArchiveFixture + + @Before + fun setup() { + fixture = BackupArchiveFixture(temporary.newFolder("private").absolutePath.toPath()) + } + + @Test + fun `given settings backup, archive is created, expected only selected settings section and no auth read`() = + runTest { + // Given + val selection = BackupSelection(setOf(BackupCategory.SETTINGS)) + // When + val export = fixture.store.create(selection) {} + val staged = fixture.store.staged(export.handle) + // Then + assertEquals(listOf("settings"), staged.manifest.sections.map { it.id }) + assertEquals(123L, staged.manifest.createdAt) + assertEquals(fixture.snapshot.settings, fixture.store.preferences(staged).settings) + assertEquals(export, fixture.store.preparedExport(export.handle, export.filename)) + assertEquals( + listOf("archive.sdaibackup"), + FileSystem.SYSTEM.list(staged.path.parent!!).map { it.name }) + coVerify(exactly = 0) { fixture.authorization.getAuthorizationCredentials() } + coVerify(exactly = 1) { fixture.staging.prepare() } + } + + @Test + fun `given provider backup, one provider selected, expected its portable credentials without other providers`() = + runTest { + // Given + fixture.snapshot = BackupPreferences( + mapOf( + "custom" to mapOf("serverUrl" to BackupValue.Text("https://host")), + "swarm_ui" to mapOf("serverUrl" to BackupValue.Text("https://other")), + "removed" to emptyMap() + ), emptyMap() + ) + coEvery { fixture.authorization.getAuthorizationCredentials() } returns AuthorizationCredentials.HttpBasic( + "name", + "password" + ) + // When + val export = fixture.store.create( + BackupSelection( + setOf(BackupCategory.PROVIDERS), + setOf("custom") + ) + ) {} + val restored = fixture.store.preferences(fixture.store.staged(export.handle)) + // Then + assertEquals(setOf("custom"), restored.providers.keys) + assertEquals( + BackupValue.Text("name"), + restored.providers.getValue("custom")["basicLogin"] + ) + assertEquals( + BackupValue.Text("password"), + restored.providers.getValue("custom")["basicPassword"] + ) + assertTrue(restored.settings.isEmpty()) + } + + @Test + fun `given empty provider selection, create is requested, expected rejection and private partial cleanup`() = + runTest { + // Given + val selection = BackupSelection(setOf(BackupCategory.PROVIDERS)) + // When + val failure = runCatching { fixture.store.create(selection) {} }.exceptionOrNull() + // Then + assertTrue(failure is IllegalArgumentException) + assertTrue(FileSystem.SYSTEM.list(fixture.root).isEmpty()) + } + + @Test + fun `given no selected categories, create is requested, expected rejection before staging allocation`() = + runTest { + // Given + val selection = BackupSelection(emptySet()) + // When + val failure = runCatching { fixture.store.create(selection) {} }.exceptionOrNull() + // Then + assertTrue(failure is IllegalArgumentException) + verify(exactly = 0) { fixture.files.newId() } + assertTrue(FileSystem.SYSTEM.list(fixture.root).isEmpty()) + } + + @Test + fun `given supported and removed network buckets, snapshot is exported, expected only portable counters`() = + runTest { + // Given + val key = NetworkUsageBucket.entries.first().key + fixture.counters = + listOf(NetworkUsageEntity(key, 100), NetworkUsageEntity("removed", 200)) + // When + val export = fixture.store.create(BackupSelection(setOf(BackupCategory.NETWORK))) {} + val staged = fixture.store.staged(export.handle) + val text = fixture.codec.openSection(staged.path, staged.manifest, "network") + .use(fixture.codec::readJson) + // Then + assertEquals("{\"$key\":100}", text) + assertEquals(1L, staged.manifest.sections.single().itemCount) + } + + @Test + fun `given invalid negative saved counter, backup is created, expected failure and no remaining partial files`() = + runTest { + // Given + fixture.counters = + listOf(NetworkUsageEntity(NetworkUsageBucket.entries.first().key, -1)) + // When + val failure = + runCatching { fixture.store.create(BackupSelection(setOf(BackupCategory.NETWORK))) {} }.exceptionOrNull() + // Then + assertTrue(failure is IllegalArgumentException) + assertTrue(FileSystem.SYSTEM.list(fixture.root).isEmpty()) + } + + @Test + fun `given snapshot read cancellation, backup creation is interrupted, expected original cancellation and partial cleanup`() = + runTest { + // Given + val cancellation = CancellationException("canceled snapshot") + coEvery { fixture.database.readSnapshot(any()) } throws cancellation + // When + val failure = + runCatching { fixture.store.create(BackupSelection(setOf(BackupCategory.SETTINGS))) {} }.exceptionOrNull() + // Then + assertSame(cancellation, failure) + assertTrue(FileSystem.SYSTEM.list(fixture.root).isEmpty()) + } + + @Test + fun `given inventory with no gallery or network, selectable entries are loaded, expected zero categories disabled and no secrets read`() = + runTest { + // Given + fixture.snapshot = fixture.snapshot.copy(providers = mapOf("removed" to emptyMap())) + // When + val inventory = fixture.store.inventory() + // Then + assertTrue(inventory.providers.isEmpty()) + assertEquals( + setOf(BackupCategory.SETTINGS), + inventory.entries.filter { it.isAvailable }.map { it.category }.toSet() + ) + coVerify(exactly = 0) { fixture.authorization.getAuthorizationCredentials() } + } + + @Test + fun `given sparse gallery identities, selected gallery is exported, expected every row and metadata in stable order`() = + runTest { + // Given + val earlier = fixture.row(5).copy( + prompt = "first image", seed = "5", generationType = "img2img", + originalImageBase64 = "iVBORw0KGgoAAAAB", + ) + val later = fixture.row(71).copy(prompt = "second image", seed = "71") + fixture.rows = listOf(later, earlier) + val progress = mutableListOf() + // When + val export = + fixture.store.create(BackupSelection(setOf(BackupCategory.GALLERY))) { progress += it.completed } + val staged = fixture.store.staged(export.handle) + val restored = + fixture.codec.openSection(staged.path, staged.manifest, "gallery").use { source -> + List(2) { fixture.galleryCodec.read(source, "new-revision") } + } + // Then + assertEquals(listOf(1L, 2L), progress) + assertEquals(2L, staged.manifest.sections.single().itemCount) + assertEquals( + listOf( + earlier.copy(id = 0, imageRevision = "new-revision"), + later.copy(id = 0, imageRevision = "new-revision") + ), restored + ) + } + + @Test + fun `given gallery backup in progress, user cancels after first image, expected partial archive removed and gallery unchanged`() = + runTest { + // Given + fixture.rows = listOf(fixture.row(5), fixture.row(71)) + val cancellation = CancellationException("cancel gallery copy") + // When + val failure = + runCatching { fixture.store.create(BackupSelection(setOf(BackupCategory.GALLERY))) { throw cancellation } }.exceptionOrNull() + // Then + assertSame(cancellation, failure) + assertTrue(FileSystem.SYSTEM.list(fixture.root).isEmpty()) + assertEquals(listOf(5L, 71L), fixture.rows.map { it.id }) + } +} diff --git a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupArchiveFixture.kt b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupArchiveFixture.kt new file mode 100644 index 000000000..7a9cbf285 --- /dev/null +++ b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupArchiveFixture.kt @@ -0,0 +1,174 @@ +package com.shifthackz.aisdv1.feature.backup.archive + +import com.shifthackz.aisdv1.core.common.appbuild.BuildInfoProvider +import com.shifthackz.aisdv1.core.common.time.TimeProvider +import com.shifthackz.aisdv1.domain.entity.backup.BackupPreferences +import com.shifthackz.aisdv1.domain.entity.backup.BackupValue +import com.shifthackz.aisdv1.domain.entity.backup.BackupImageBudget +import com.shifthackz.aisdv1.domain.feature.auth.AuthorizationCredentials +import com.shifthackz.aisdv1.domain.feature.auth.AuthorizationStore +import com.shifthackz.aisdv1.domain.gateway.ProviderSelectionGuard +import com.shifthackz.aisdv1.domain.gateway.backup.BackupPreferencesGateway +import com.shifthackz.aisdv1.domain.gateway.backup.BackupImageValidator +import com.shifthackz.aisdv1.feature.backup.codec.BinaryBackupArchiveCodec +import com.shifthackz.aisdv1.feature.backup.codec.BackupManifest +import com.shifthackz.aisdv1.feature.backup.codec.BackupSection +import com.shifthackz.aisdv1.feature.backup.codec.DefaultBackupPreferencesCodec +import com.shifthackz.aisdv1.feature.backup.codec.DefaultGalleryBackupCodec +import com.shifthackz.aisdv1.feature.backup.io.BackupFileStore +import com.shifthackz.aisdv1.storage.db.persistent.dao.GenerationResultDao +import com.shifthackz.aisdv1.storage.db.persistent.dao.NetworkUsageDao +import com.shifthackz.aisdv1.storage.db.persistent.entity.GenerationResultEntity +import com.shifthackz.aisdv1.storage.db.persistent.entity.NetworkUsageEntity +import com.shifthackz.aisdv1.storage.gateway.BackupStorage +import io.mockk.coEvery +import io.mockk.every +import io.mockk.mockk +import kotlinx.coroutines.flow.flowOf +import kotlinx.serialization.json.Json +import okio.FileSystem +import okio.Path +import okio.Path.Companion.toPath +import okio.buffer + +/** + * Exercises real archive framing, codecs and private files with isolated persistence/transport collaborators. + * @param root Private temporary directory owned by one unit-test case. + * @author Dmitriy Moroz + */ +internal class BackupArchiveFixture(val root: Path) { + val json = Json { encodeDefaults = true; ignoreUnknownKeys = true } + val codec = BinaryBackupArchiveCodec(json) + val fields = DefaultBackupPreferencesCodec(json) + val preferences = mockk() + val authorization = mockk() + val images = mockk() + val network = mockk() + val database = mockk() + val staging = mockk(relaxed = true) + val files = mockk() + var snapshot = BackupPreferences(emptyMap(), mapOf("autoSave" to BackupValue.Flag(true))) + var rows = emptyList() + var counters = emptyList() + var displayName = "selected.sdaibackup" + var location = "/Downloads/selected.sdaibackup" + private var nextId = 1 + + init { + FileSystem.SYSTEM.createDirectories(root) + every { files.root } returns root + every { files.newId() } answers { + "00000000-0000-0000-0000-${ + (nextId++).toString().padStart(12, '0') + }" + } + every { files.documentReference(any()) } answers { "file://${firstArg()}" } + every { files.documentPath(any()) } answers { + firstArg().removePrefix("file://").toPath() + } + every { files.documentName(any()) } answers { displayName } + every { files.documentLocation(any()) } answers { location } + every { files.openDocument(any()) } answers { + FileSystem.SYSTEM.source( + firstArg().removePrefix( + "file://" + ).toPath() + ).buffer() + } + every { files.writeDocument(any()) } answers { + FileSystem.SYSTEM.sink( + firstArg().removePrefix( + "file://" + ).toPath() + ).buffer() + } + every { files.availableBytes() } returns Long.MAX_VALUE + every { preferences.read() } answers { snapshot } + every { preferences.filterSupported(any()) } answers { firstArg() } + coEvery { authorization.getAuthorizationCredentials() } returns AuthorizationCredentials.None + every { database.generationResultDao() } returns images + every { database.networkUsageDao() } returns network + coEvery { database.readSnapshot(any()) } coAnswers { firstArg Unit>()() } + every { images.observeCount() } answers { flowOf(rows.size) } + coEvery { + images.queryBackupPage( + any(), + any() + ) + } answers { rows.filter { it.id > firstArg() }.sortedBy { it.id }.take(secondArg()) } + coEvery { network.query() } answers { counters } + } + + val galleryCodec = DefaultGalleryBackupCodec( + codec, + json, + mockk(relaxed = true), + BackupImageBudget(1024, 100, 4096, 16) + ) + val store = DefaultBackupArchiveStore( + files, + codec, + galleryCodec, + fields, + database, + preferences, + authorization, + ProviderSelectionGuard(), + BuildInfoProvider.stub, + mockk { every { currentTimeMillis() } returns 123L }, + json, + staging, + ) + + /** + * Creates a checksum-valid archive with one framed JSON section for compatibility/admission cases. + * @param id Stable or future section identifier. + * @param text JSON payload consumed by the section codec. + * @param transform Descriptor mutation for versions or record-count mismatches. + * @author Dmitriy Moroz + */ + suspend fun document( + id: String, + text: String, + transform: (BackupSection) -> BackupSection = { it }, + ): String { + val payload = root.parent!! / "payload" + FileSystem.SYSTEM.sink(payload).buffer().use { codec.writeJson(it, text) } + val section = transform(codec.describe(payload, id, 1)) + val document = root.parent!! / "source.sdaibackup" + codec.write( + document, + BackupManifest("snapshot", 123, "1", "IOS", listOf(section)), + listOf(payload) + ) + return "file://$document" + } + + /** + * Supplies portable gallery metadata; native image validation is isolated by the fixture collaborator. + * @param id Existing row identity, deliberately excluded by the portable codec. + * @author Dmitriy Moroz + */ + fun row(id: Long) = GenerationResultEntity( + id, "iVBORw0KGgoAAAAA", "", 100, "txt2img", "prompt", "negative", 1, 1, 0, 7.5f, + false, "Euler", "42", "9", 0.25f, 0.5f, true, true, "model", "old-revision", + ) + + /** + * Writes one valid gallery record while allowing an inconsistent declared count for admission testing. + * @param declaredCount Number of gallery records advertised in the checked manifest. + * @author Dmitriy Moroz + */ + suspend fun galleryDocument(declaredCount: Long): String { + val payload = root.parent!! / "gallery-payload" + FileSystem.SYSTEM.sink(payload).buffer().use { galleryCodec.write(it, row(71)) } + val section = codec.describe(payload, "gallery", declaredCount) + val document = root.parent!! / "gallery-source.sdaibackup" + codec.write( + document, + BackupManifest("snapshot", 123, "1", "IOS", listOf(section)), + listOf(payload) + ) + return "file://$document" + } +} diff --git a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupArchiveInspectionTest.kt b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupArchiveInspectionTest.kt new file mode 100644 index 000000000..bec444c5c --- /dev/null +++ b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupArchiveInspectionTest.kt @@ -0,0 +1,246 @@ +package com.shifthackz.aisdv1.feature.backup.archive + +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory +import com.shifthackz.aisdv1.domain.entity.backup.BackupPreferences +import com.shifthackz.aisdv1.domain.entity.backup.BackupSelection +import com.shifthackz.aisdv1.domain.entity.backup.BackupValue +import io.mockk.every +import kotlinx.coroutines.CancellationException +import kotlinx.coroutines.test.runTest +import okio.FileSystem +import okio.Path.Companion.toPath +import org.junit.Assert.assertEquals +import org.junit.Assert.assertFalse +import org.junit.Assert.assertSame +import org.junit.Assert.assertTrue +import org.junit.Before +import org.junit.Rule +import org.junit.Test +import org.junit.rules.TemporaryFolder + +class BackupArchiveInspectionTest { + @get:Rule + val temporary = TemporaryFolder() + private lateinit var fixture: BackupArchiveFixture + + @Before + fun setup() { + fixture = BackupArchiveFixture(temporary.newFolder("private").absolutePath.toPath()) + } + + @Test + fun `given selected backup, inspection completes, expected private immutable copy and source details retained`() = + runTest { + // Given + val source = + fixture.document("settings", fixture.fields.encode(fixture.snapshot.settings)) + val progress = mutableListOf() + // When + val inspection = fixture.store.inspect(source) { progress += it.completed } + val staged = fixture.store.staged(inspection.handle) + // Then + assertEquals("selected.sdaibackup", inspection.filename) + assertEquals(fixture.location, inspection.sourceLocation) + assertEquals( + setOf(BackupCategory.SETTINGS), + inspection.entries.filter { it.isAvailable }.map { it.category }.toSet() + ) + assertTrue( + staged.path.toFile().readBytes() + .contentEquals(source.removePrefix("file://").toPath().toFile().readBytes()) + ) + assertTrue(progress.last() > 0) + assertEquals(0, inspection.skippedCount) + } + + @Test + fun `given long document labels, backup is selected, expected bounded persisted name and location`() = + runTest { + // Given + fixture.displayName = "n".repeat(600) + fixture.location = "p".repeat(3000) + val source = fixture.document("settings", "{}") + // When + val inspection = fixture.store.inspect(source) {} + // Then + assertEquals(512, inspection.filename.length) + assertEquals(2048, inspection.sourceLocation.length) + } + + @Test + fun `given old staged archive without display metadata, summary is recovered, expected safe fallback labels`() = + runTest { + // Given + val export = fixture.store.create(BackupSelection(setOf(BackupCategory.SETTINGS))) {} + // When + val inspection = fixture.store.summary(fixture.store.staged(export.handle)) + // Then + assertEquals("SDAI.sdaibackup", inspection.filename) + assertEquals("", inspection.sourceLocation) + } + + @Test + fun `given newer unknown section, compatible container is inspected, expected section skipped without decoding`() = + runTest { + // Given + val source = fixture.document("future_feature", "not JSON") + // When + val inspection = fixture.store.inspect(source) {} + // Then + assertTrue(inspection.entries.isEmpty()) + assertEquals(1, inspection.skippedCount) + } + + @Test + fun `given gallery requires newer reader, archive is inspected, expected unavailable gallery without reading unsupported payload`() = + runTest { + // Given + val source = + fixture.document("gallery", "future bytes") { it.copy(requiredReaderVersion = 2) } + // When + val inspection = fixture.store.inspect(source) {} + // Then + assertFalse(inspection.entries.single().isAvailable) + assertEquals(1, inspection.skippedCount) + } + + @Test + fun `given network uses future codec, archive is inspected, expected unavailable section without decoding`() = + runTest { + // Given + val source = fixture.document("network", "future bytes") { it.copy(codec = "future") } + // When + val inspection = fixture.store.inspect(source) {} + // Then + assertFalse(inspection.entries.single().isAvailable) + assertEquals(1, inspection.skippedCount) + } + + @Test + fun `given removed provider and field, compatible fields are filtered, expected supported values and skipped count`() = + runTest { + // Given + val source = fixture.document( + "providers", + fixture.fields.encodeProviders( + mapOf( + "custom" to mapOf( + "serverUrl" to BackupValue.Text( + "host" + ), "removed" to BackupValue.Text("old") + ), "future" to mapOf("token" to BackupValue.Text("old")) + ) + ) + ) + every { fixture.preferences.filterSupported(any()) } answers { + val value = firstArg() + value.copy(providers = value.providers.mapValues { (_, fields) -> fields.filterKeys { it == "serverUrl" } }) + } + // When + val inspection = fixture.store.inspect(source) {} + // Then + assertEquals(setOf("custom"), inspection.providers) + assertEquals(2, inspection.skippedCount) + } + + @Test + fun `given unsupported setting, compatibility filter removes it, expected skipped item and disabled empty category`() = + runTest { + // Given + val source = fixture.document( + "settings", + fixture.fields.encode(mapOf("removed" to BackupValue.Flag(true))) + ) + every { fixture.preferences.filterSupported(any()) } returns BackupPreferences( + emptyMap(), + emptyMap() + ) + // When + val inspection = fixture.store.inspect(source) {} + // Then + assertFalse(inspection.entries.single().isAvailable) + assertEquals(2, inspection.skippedCount) + } + + @Test + fun `given insufficient private space, source is selected, expected failure with staging removed and external source preserved`() = + runTest { + // Given + val source = fixture.document("settings", "{}") + every { fixture.files.availableBytes() } returns 1 + // When + val failure = runCatching { fixture.store.inspect(source) {} }.exceptionOrNull() + // Then + assertEquals("Not enough storage for backup", failure?.message) + assertTrue(FileSystem.SYSTEM.list(fixture.root).isEmpty()) + assertTrue(FileSystem.SYSTEM.exists(source.removePrefix("file://").toPath())) + } + + @Test + fun `given document transport error, import starts, expected same failure and no partial staging`() = + runTest { + // Given + val failure = IllegalStateException("document permission expired") + every { fixture.files.openDocument(any()) } throws failure + // When + val caught = + runCatching { fixture.store.inspect("content://provider/document") {} }.exceptionOrNull() + // Then + assertSame(failure, caught) + assertTrue(FileSystem.SYSTEM.list(fixture.root).isEmpty()) + } + + @Test + fun `given import progress cancellation, staging copy is interrupted, expected same cancellation and source preserved`() = + runTest { + // Given + val source = fixture.document("settings", "{}") + val cancellation = CancellationException("user canceled") + // When + val failure = + runCatching { fixture.store.inspect(source) { throw cancellation } }.exceptionOrNull() + // Then + assertSame(cancellation, failure) + assertTrue(FileSystem.SYSTEM.list(fixture.root).isEmpty()) + assertTrue(FileSystem.SYSTEM.exists(source.removePrefix("file://").toPath())) + } + + @Test + fun `given negative network bytes, selected archive is inspected, expected rejection before restoration`() = + runTest { + // Given + val source = fixture.document("network", "{\"inference\":-1}") + // When + val failure = runCatching { fixture.store.inspect(source) {} }.exceptionOrNull() + // Then + assertTrue(failure is IllegalArgumentException) + assertTrue(FileSystem.SYSTEM.list(fixture.root).isEmpty()) + } + + @Test + fun `given gallery record count exceeds payload, archive is inspected, expected rejection and staging cleanup`() = + runTest { + // Given + val source = fixture.galleryDocument(declaredCount = 2) + // When + val failure = runCatching { fixture.store.inspect(source) {} }.exceptionOrNull() + // Then + assertTrue(failure != null) + assertTrue(FileSystem.SYSTEM.list(fixture.root).isEmpty()) + } + + @Test + fun `given valid gallery archive, inspection reads each image, expected progress matches declared count`() = + runTest { + // Given + val source = fixture.galleryDocument(declaredCount = 1) + val validated = mutableListOf() + // When + val inspection = + fixture.store.inspect(source) { if (it.category == BackupCategory.GALLERY) validated += it.completed } + // Then + assertEquals(listOf(1L), validated) + assertEquals(BackupCategory.GALLERY, inspection.entries.single().category) + assertTrue(inspection.entries.single().isAvailable) + } +} diff --git a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupArchiveTransportTest.kt b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupArchiveTransportTest.kt new file mode 100644 index 000000000..38cc1c2d2 --- /dev/null +++ b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/archive/BackupArchiveTransportTest.kt @@ -0,0 +1,135 @@ +package com.shifthackz.aisdv1.feature.backup.archive + +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory +import com.shifthackz.aisdv1.domain.entity.backup.BackupSelection +import io.mockk.every +import kotlinx.coroutines.CancellationException +import kotlinx.coroutines.test.runTest +import okio.FileSystem +import okio.Path.Companion.toPath +import org.junit.Assert.assertEquals +import org.junit.Assert.assertSame +import org.junit.Assert.assertTrue +import org.junit.Before +import org.junit.Rule +import org.junit.Test +import org.junit.rules.TemporaryFolder + +class BackupArchiveTransportTest { + @get:Rule + val temporary = TemporaryFolder() + private lateinit var fixture: BackupArchiveFixture + + @Before + fun setup() { + fixture = BackupArchiveFixture(temporary.newFolder("private").absolutePath.toPath()) + } + + @Test + fun `given staged backup, destination is selected, expected exact archive bytes copied and source retained`() = + runTest { + // Given + val export = fixture.store.create(BackupSelection(setOf(BackupCategory.SETTINGS))) {} + val destination = temporary.newFile().toPath() + // When + fixture.store.export(export.document, "file://$destination") + // Then + assertTrue( + destination.toFile().readBytes() + .contentEquals(fixture.files.documentPath(export.document).toFile().readBytes()) + ) + assertEquals(export.handle, fixture.store.staged(export.handle).handle) + } + + @Test + fun `given destination permission failure, export is requested, expected failure propagated and staged source retained`() = + runTest { + // Given + val export = fixture.store.create(BackupSelection(setOf(BackupCategory.SETTINGS))) {} + val failure = IllegalStateException("cannot write destination") + every { fixture.files.writeDocument(any()) } throws failure + // When + val caught = runCatching { + fixture.store.export( + export.document, + "destination" + ) + }.exceptionOrNull() + // Then + assertSame(failure, caught) + assertEquals(export.handle, fixture.store.staged(export.handle).handle) + } + + @Test + fun `given export destination cancellation, copy is requested, expected cancellation propagated and source retained`() = + runTest { + // Given + val export = fixture.store.create(BackupSelection(setOf(BackupCategory.SETTINGS))) {} + val cancellation = CancellationException("canceled") + every { fixture.files.writeDocument(any()) } throws cancellation + // When + val failure = runCatching { + fixture.store.export( + export.document, + "destination" + ) + }.exceptionOrNull() + // Then + assertSame(cancellation, failure) + assertTrue(FileSystem.SYSTEM.exists(fixture.files.documentPath(export.document))) + } + + @Test + fun `given archive outside app staging, export is requested, expected rejection without destination mutation`() = + runTest { + // Given + val external = temporary.newFile("archive.sdaibackup").apply { writeText("external") } + val destination = temporary.newFile().apply { writeText("untouched") } + // When + val failure = runCatching { + fixture.store.export( + "file://${external.absolutePath}", + "file://${destination.absolutePath}" + ) + }.exceptionOrNull() + // Then + assertTrue(failure is IllegalArgumentException) + assertEquals("untouched", destination.readText()) + assertEquals("external", external.readText()) + } + + @Test + fun `given staged backup URL, user discards operation, expected only private staging removed`() = + runTest { + // Given + val export = fixture.store.create(BackupSelection(setOf(BackupCategory.SETTINGS))) {} + val external = temporary.newFile("source").apply { writeText("keep") } + // When + fixture.store.discard(export.document) + // Then + assertTrue(FileSystem.SYSTEM.list(fixture.root).isEmpty()) + assertEquals("keep", external.readText()) + } + + @Test + fun `given invalid traversal handle, staging cleanup is requested, expected external files untouched`() { + // Given + val external = temporary.newFile("source").apply { writeText("keep") } + // When + val failure = runCatching { fixture.store.discard("../source") }.exceptionOrNull() + // Then + assertTrue(failure is IllegalArgumentException) + assertEquals("keep", external.readText()) + } + + @Test + fun `given missing staged archive, pending export is recovered, expected explicit failure`() { + // Given + val handle = "00000000-0000-0000-0000-000000000099" + // When + val failure = + runCatching { fixture.store.preparedExport(handle, "backup") }.exceptionOrNull() + // Then + assertEquals("Pending backup source is unavailable", failure?.message) + } +} diff --git a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/export/DefaultBackupExportCoordinatorTest.kt b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/export/DefaultBackupExportCoordinatorTest.kt index 81a3fd418..49a527edb 100644 --- a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/export/DefaultBackupExportCoordinatorTest.kt +++ b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/export/DefaultBackupExportCoordinatorTest.kt @@ -5,6 +5,8 @@ import com.shifthackz.aisdv1.domain.entity.backup.BackupExport import com.shifthackz.aisdv1.domain.entity.backup.BackupExportCompletion import com.shifthackz.aisdv1.domain.entity.backup.BackupExportIntent import com.shifthackz.aisdv1.domain.entity.backup.BackupExportStatus +import com.shifthackz.aisdv1.domain.entity.backup.BackupCategory +import com.shifthackz.aisdv1.domain.entity.backup.BackupSelection import com.shifthackz.aisdv1.domain.gateway.backup.BackupExportStateStore import com.shifthackz.aisdv1.domain.usecase.backup.ExportBackupUseCase import com.shifthackz.aisdv1.feature.backup.archive.BackupArchiveStore @@ -22,6 +24,7 @@ import kotlinx.coroutines.test.runCurrent import kotlinx.coroutines.test.runTest import org.junit.Assert.assertEquals import org.junit.Assert.assertNull +import org.junit.Assert.assertTrue import org.junit.Test @OptIn(ExperimentalCoroutinesApi::class) @@ -226,4 +229,135 @@ class DefaultBackupExportCoordinatorTest { owner.close() } + @Test + fun `given no pending export, preparation runs, expected archive created and durable association before picker`() = + runTest { + // Given + val owner = coordinator() + val selection = BackupSelection(setOf(BackupCategory.SETTINGS)) + coEvery { archives.create(selection, any()) } returns backup + // When + val result = owner.prepare(selection) {} + // Then + assertEquals(backup, result) + assertEquals(BackupExportIntent(backup.handle, backup.filename), stored) + assertEquals(BackupExportStatus.READY, owner.observe().value.status) + coVerify(exactly = 1) { archives.create(selection, any()) } + owner.close() + } + + @Test + fun `given retained pending export, preparation repeats after recreation, expected same source without new archive`() = + runTest { + // Given + stored = BackupExportIntent(backup.handle, backup.filename) + val owner = coordinator() + // When + val result = owner.prepare(BackupSelection(setOf(BackupCategory.SETTINGS))) {} + // Then + assertEquals(backup, result) + coVerify(exactly = 0) { archives.create(any(), any()) } + owner.close() + } + + @Test + fun `given created source, durable association write fails, expected source retained and original error propagated`() = + runTest { + // Given + val owner = coordinator() + advanceUntilIdle() + coEvery { archives.create(any(), any()) } returns backup + val failure = IllegalStateException("checked write failed") + every { records.write(any()) } throws failure + // When + val caught = + runCatching { owner.prepare(BackupSelection(setOf(BackupCategory.SETTINGS))) {} }.exceptionOrNull() + // Then + assertTrue(caught is IllegalStateException) + assertEquals(failure.message, caught?.message) + verify(exactly = 0) { archives.discard(any()); records.clear() } + owner.close() + } + + @Test + fun `given native platform copied archive, completion callback arrives, expected durable success without another copy`() = + runTest { + // Given + stored = BackupExportIntent(backup.handle, backup.filename) + val owner = coordinator() + // When + owner.submit(BackupExportCompletion.NativeCompleted(backup.handle)) + advanceUntilIdle() + // Then + assertEquals(BackupExportStatus.COMPLETE, stored?.status) + assertEquals(BackupExportStatus.COMPLETE, owner.observe().value.status) + coVerify(exactly = 0) { export(any(), any()) } + owner.close() + } + + @Test + fun `given owned source, picker returns blank destination, expected failure and retained source`() = + runTest { + // Given + stored = BackupExportIntent(backup.handle, backup.filename) + val owner = coordinator() + // When + owner.submit(BackupExportCompletion.DestinationSelected(" ", backup.handle)) + advanceUntilIdle() + // Then + assertEquals(BackupExportStatus.FAILED, owner.observe().value.status) + assertEquals(backup.handle, stored?.handle) + coVerify(exactly = 0) { export(any(), any()) } + verify(exactly = 0) { archives.discard(any()) } + owner.close() + } + + @Test + fun `given completed export, stale cancellation for same handle arrives, expected durable success preserved`() = + runTest { + // Given + stored = BackupExportIntent(backup.handle, backup.filename, BackupExportStatus.COMPLETE) + val owner = coordinator() + // When + owner.submit(BackupExportCompletion.Canceled(backup.handle)) + advanceUntilIdle() + // Then + assertEquals(BackupExportStatus.COMPLETE, stored?.status) + assertEquals(BackupExportStatus.COMPLETE, owner.observe().value.status) + verify(exactly = 0) { archives.discard(any()); records.clear() } + owner.close() + } + + @Test + fun `given pending source, checked clear fails during dismissal, expected source preserved for recovery`() = + runTest { + // Given + stored = BackupExportIntent(backup.handle, backup.filename) + val owner = coordinator() + advanceUntilIdle() + val failure = IllegalStateException("clear failed") + every { records.clear() } throws failure + // When + val caught = runCatching { owner.dismiss() }.exceptionOrNull() + // Then + assertTrue(caught is IllegalStateException) + assertEquals(failure.message, caught?.message) + assertEquals(backup.handle, stored?.handle) + verify(exactly = 0) { archives.discard(any()) } + owner.close() + } + + @Test + fun `given durable operation storage unreadable, coordinator initializes, expected visible failure without deleting source`() = + runTest { + // Given + val owner = coordinator() + every { records.recoverPendingWrite() } throws IllegalStateException("untrusted checked state") + // When + advanceUntilIdle() + // Then + assertEquals(BackupExportStatus.FAILED, owner.observe().value.status) + verify(exactly = 0) { records.clear(); archives.discard(any()) } + owner.close() + } } diff --git a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/NetworkBackupRestoreWriterTest.kt b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/NetworkBackupRestoreWriterTest.kt new file mode 100644 index 000000000..ce37d4723 --- /dev/null +++ b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/NetworkBackupRestoreWriterTest.kt @@ -0,0 +1,248 @@ +package com.shifthackz.aisdv1.feature.backup.restore + +import com.shifthackz.aisdv1.domain.entity.NetworkUsageBucket +import com.shifthackz.aisdv1.domain.entity.backup.BackupImageBudget +import com.shifthackz.aisdv1.feature.backup.archive.StagedBackup +import com.shifthackz.aisdv1.feature.backup.codec.BackupManifest +import com.shifthackz.aisdv1.feature.backup.codec.BinaryBackupArchiveCodec +import com.shifthackz.aisdv1.storage.db.persistent.dao.NetworkUsageDao +import com.shifthackz.aisdv1.storage.db.persistent.dao.RestoreSessionDao +import com.shifthackz.aisdv1.storage.db.persistent.entity.NetworkUsageEntity +import com.shifthackz.aisdv1.storage.db.persistent.entity.RestoreSectionEntity +import com.shifthackz.aisdv1.storage.gateway.BackupStorage +import io.mockk.coEvery +import io.mockk.coVerify +import io.mockk.every +import io.mockk.mockk +import kotlinx.coroutines.CancellationException +import kotlinx.coroutines.test.runTest +import kotlinx.serialization.encodeToString +import kotlinx.serialization.json.Json +import okio.FileSystem +import okio.Path.Companion.toPath +import okio.buffer +import org.junit.Assert.assertEquals +import org.junit.Assert.assertSame +import org.junit.Assert.assertTrue +import org.junit.Before +import org.junit.Rule +import org.junit.Test +import org.junit.rules.TemporaryFolder + +class NetworkBackupRestoreWriterTest { + @get:Rule + val temporary = TemporaryFolder() + private val json = Json { encodeDefaults = true } + private val codec = BinaryBackupArchiveCodec(json) + private val database = mockk() + private val network = mockk(relaxed = true) + private val ledger = mockk(relaxed = true) + private val firstBucket = NetworkUsageBucket.entries[0].key + private val secondBucket = NetworkUsageBucket.entries[1].key + private val writer = RoomBackupRestoreWriter( + database, + codec, + mockk(), + mockk(), + json, + DefaultBackupImageFingerprint(), + BackupImageBudget(1024, 100, 4096, 16) + ) + + @Before + fun setup() { + every { database.networkUsageDao() } returns network + every { database.restoreSessionDao() } returns ledger + coEvery { database.writeTransaction(any()) } coAnswers { firstArg Unit>()() } + coEvery { ledger.completed(any()) } returns emptyList() + coEvery { network.query() } returns emptyList() + } + + /** + * Builds real framing around network counters without involving native document transport. + * @param values Incoming typed network buckets, including future bucket names in compatibility cases. + * @param hasTrailingData Whether an extra byte follows the declared JSON record. + * @author Dmitriy Moroz + */ + private suspend fun archive( + values: Map, + hasTrailingData: Boolean = false + ): StagedBackup { + val payload = temporary.newFile().absolutePath.toPath() + FileSystem.SYSTEM.sink(payload).buffer().use { + codec.writeJson(it, json.encodeToString(values)) + if (hasTrailingData) it.writeByte(1) + } + val manifest = BackupManifest( + "snapshot", + 1, + "1", + "ANDROID", + listOf(codec.describe(payload, "network", values.size.toLong())) + ) + val path = temporary.newFile().absolutePath.toPath() + codec.write(path, manifest, listOf(payload)) + return StagedBackup("handle", path, manifest) + } + + @Test + fun `given existing traffic bucket, backup contains additional bytes, expected additive write with category ledger`() = + runTest { + // Given + coEvery { network.query() } returns listOf(NetworkUsageEntity(firstBucket, 100)) + val archive = archive(mapOf(firstBucket to 25, secondBucket to 50)) + // When + writer.network("session", archive) + // Then + coVerify(exactly = 1) { + network.addBytes( + firstBucket, + 25 + ); network.addBytes(secondBucket, 50) + } + coVerify { ledger.mark(RestoreSectionEntity("session", "network", 2, 0)) } + } + + @Test + fun `given future traffic bucket, restore runs, expected unknown bucket skipped and known bytes added`() = + runTest { + // Given + val archive = archive(mapOf(firstBucket to 10, "future" to Long.MAX_VALUE)) + // When + writer.network("session", archive) + // Then + coVerify { + network.addBytes( + firstBucket, + 10 + ); ledger.mark(RestoreSectionEntity("session", "network", 1, 1)) + } + coVerify(exactly = 0) { network.addBytes("future", any()) } + } + + @Test + fun `given committed network category, same session retries, expected no repeated counter writes`() = + runTest { + // Given + val archive = archive(mapOf(firstBucket to 10)) + coEvery { ledger.completed("session") } returns listOf("network") + // When + writer.network("session", archive) + // Then + coVerify(exactly = 0) { + network.query(); network.addBytes( + any(), + any() + ); ledger.mark(any()) + } + } + + @Test + fun `given maximum resulting counter, valid boundary restore runs, expected exact final increment allowed`() = + runTest { + // Given + val archive = archive(mapOf(firstBucket to 1)) + coEvery { network.query() } returns listOf( + NetworkUsageEntity( + firstBucket, + Long.MAX_VALUE - 1 + ) + ) + // When + writer.network("session", archive) + // Then + coVerify { network.addBytes(firstBucket, 1); ledger.mark(any()) } + } + + @Test + fun `given individual counter overflow, restore runs, expected rejection before any counter or ledger write`() = + runTest { + // Given + val archive = archive(mapOf(firstBucket to 1)) + coEvery { network.query() } returns listOf( + NetworkUsageEntity( + firstBucket, + Long.MAX_VALUE + ) + ) + // When + val failure = runCatching { writer.network("session", archive) }.exceptionOrNull() + // Then + assertEquals("Network counter overflow", failure?.message) + coVerify(exactly = 0) { network.addBytes(any(), any()); ledger.mark(any()) } + } + + @Test + fun `given aggregate overflow across valid buckets, restore runs, expected rejection before first write`() = + runTest { + // Given + val archive = archive(mapOf(secondBucket to 1)) + coEvery { network.query() } returns listOf( + NetworkUsageEntity( + firstBucket, + Long.MAX_VALUE + ) + ) + // When + val failure = runCatching { writer.network("session", archive) }.exceptionOrNull() + // Then + assertEquals("Network total overflow", failure?.message) + coVerify(exactly = 0) { network.addBytes(any(), any()); ledger.mark(any()) } + } + + @Test + fun `given negative archived counter, restore runs, expected rejection before transaction mutations`() = + runTest { + // Given + val archive = archive(mapOf(firstBucket to -1)) + // When + val failure = runCatching { writer.network("session", archive) }.exceptionOrNull() + // Then + assertTrue(failure is IllegalArgumentException) + coVerify(exactly = 0) { + database.writeTransaction(any()); network.addBytes( + any(), + any() + ); ledger.mark(any()) + } + } + + @Test + fun `given invalid existing counter, restore runs, expected rejection preserving stored data`() = + runTest { + // Given + val archive = archive(mapOf(firstBucket to 1)) + coEvery { network.query() } returns listOf(NetworkUsageEntity(firstBucket, -1)) + // When + val failure = runCatching { writer.network("session", archive) }.exceptionOrNull() + // Then + assertEquals("Network counter overflow", failure?.message) + coVerify(exactly = 0) { network.addBytes(any(), any()); ledger.mark(any()) } + } + + @Test + fun `given unexpected network payload suffix, restore runs, expected rejection without counter changes`() = + runTest { + // Given + val archive = archive(mapOf(firstBucket to 1), hasTrailingData = true) + // When + val failure = runCatching { writer.network("session", archive) }.exceptionOrNull() + // Then + assertEquals("Invalid network counter", failure?.message) + coVerify(exactly = 0) { network.addBytes(any(), any()); ledger.mark(any()) } + } + + @Test + fun `given network storage cancellation, restore reads current buckets, expected original cancellation and no completion marker`() = + runTest { + // Given + val archive = archive(mapOf(firstBucket to 1)) + val cancellation = CancellationException("storage canceled") + coEvery { network.query() } throws cancellation + // When + val failure = runCatching { writer.network("session", archive) }.exceptionOrNull() + // Then + assertSame(cancellation, failure) + coVerify(exactly = 0) { network.addBytes(any(), any()); ledger.mark(any()) } + } +} diff --git a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriterTest.kt b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriterTest.kt index e825f50db..41c5e35c9 100644 --- a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriterTest.kt +++ b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriterTest.kt @@ -267,6 +267,68 @@ class RoomBackupRestoreWriterTest { coVerify(atLeast = 1) { savedImages.queryImageChunk(71, any(), any()) } } + @Test + fun `given gallery spans multiple identity pages, duplicate exists after first page, expected image skipped without altering stored rows`() = + runTest { + // Given + val rows = + (1L..130L).map { id -> row(if (id == 130L) "AQIDBA==" else "AQIDBQ==", id = id) } + .toMutableList() + val original = rows.toList() + val outcomes = mutableListOf() + configureGallery(rows, outcomes) + every { gallery.read(any(), any()) } returns row("AQIDBA==") + val writer = RoomBackupRestoreWriter( + database, + codec, + gallery, + files, + Json, + DefaultBackupImageFingerprint(), + budget + ) + // When + writer.gallery("session", archive) {} + // Then + assertEquals(original, rows) + assertEquals(1L, outcomes.single().skippedCount) + assertEquals(0L, outcomes.single().importedCount) + coVerify { savedImages.queryImageIdsAfter(128, 128) } + coVerify(exactly = 0) { savedImages.insert(any()) } + } + + @Test + fun `given gallery category already committed, session retries, expected no gallery scan or duplicate insertion`() = + runTest { + // Given + val rows = mutableListOf(row("AQIDBA==", id = 71)) + val outcomes = mutableListOf() + configureGallery(rows, outcomes) + coEvery { ledger.completed("session") } returns listOf("gallery") + val writer = RoomBackupRestoreWriter( + database, + codec, + gallery, + files, + Json, + DefaultBackupImageFingerprint(), + budget + ) + val progress = mutableListOf() + // When + writer.gallery("session", archive, progress::add) + // Then + assertEquals(1, rows.size) + assertTrue(outcomes.isEmpty()) + assertTrue(progress.isEmpty()) + coVerify(exactly = 0) { + savedImages.queryImageIdsAfter( + any(), + any() + ); savedImages.insert(any()); ledger.mark(any()) + } + } + /** * Supplies the production writer with a paged image store and an observed commit ledger. * @param rows Mutable persisted rows; fresh insert identities are assigned independently of the archive. diff --git a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/RestoreBackupUseCaseImplTest.kt b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/RestoreBackupUseCaseImplTest.kt index c0e072925..4e3589ba4 100644 --- a/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/RestoreBackupUseCaseImplTest.kt +++ b/feature/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/RestoreBackupUseCaseImplTest.kt @@ -260,7 +260,7 @@ class RestoreBackupUseCaseImplTest { } @Test - fun `given completed additive import, explicit new restore session starts, expected data added again`() = + fun `given completed restore, explicit new session starts, expected category writers evaluate independent request`() = runTest { // Given useCase(request) {} @@ -380,4 +380,168 @@ class RestoreBackupUseCaseImplTest { assertFalse(intents.getValue(request.sessionId).isComplete) } + @Test + fun `given invalid session identity, restore is requested, expected rejection before archive access`() = + runTest { + // Given + val invalid = request.copy(sessionId = "../invalid") + // When + val failure = runCatching { useCase(invalid) {} }.exceptionOrNull() + // Then + assertEquals("Invalid restore session", failure?.message) + coVerify(exactly = 0) { archives.staged(any()); ledger.insert(any()) } + } + + @Test + fun `given empty category selection, restore is requested, expected rejection without mutation`() = + runTest { + // Given + val invalid = request.copy(selection = BackupSelection(emptySet())) + // When + val failure = runCatching { useCase(invalid) {} }.exceptionOrNull() + // Then + assertEquals("Select restore data", failure?.message) + coVerify(exactly = 0) { ledger.insert(any()); writer.gallery(any(), any(), any()) } + } + + @Test + fun `given unavailable selected category, restore is requested, expected rejection before intent creation`() = + runTest { + // Given + every { archives.summary(archive) } returns summary.copy(entries = summary.entries.map { + it.copy( + isAvailable = false + ) + }) + // When + val failure = runCatching { useCase(request) {} }.exceptionOrNull() + // Then + assertEquals("Unavailable backup section", failure?.message) + coVerify(exactly = 0) { ledger.insert(any()) } + } + + @Test + fun `given unknown selected provider, restore is requested, expected rejection without preference mutation`() = + runTest { + // Given + val invalid = request.copy( + selection = BackupSelection( + setOf(BackupCategory.PROVIDERS), + setOf("removed") + ) + ) + // When + val failure = runCatching { useCase(invalid) {} }.exceptionOrNull() + // Then + assertEquals("Unavailable backup provider", failure?.message) + coVerify(exactly = 0) { preferences.writeProviders(any(), any()); ledger.insert(any()) } + } + + @Test + fun `given background generation is active, restore is requested, expected failure before writes or journal creation`() = + runTest { + // Given + every { work.hasActiveTasks() } returns true + // When + val failure = runCatching { useCase(request) {} }.exceptionOrNull() + // Then + assertEquals("Wait for generation to finish before restoring", failure?.message) + coVerify(exactly = 0) { + ledger.insert(any()); writer.gallery( + any(), + any(), + any() + ); preferences.writeSettings(any()) + } + } + + @Test + fun `given another pending session, new restore is requested, expected failure preserving original operation`() = + runTest { + // Given + intents["other"] = + RestoreSessionEntity("other", "retained", sessions.encode(request.selection)) + // When + val failure = runCatching { useCase(request) {} }.exceptionOrNull() + // Then + assertEquals("Finish or cancel the pending restore first", failure?.message) + coVerify(exactly = 0) { ledger.insert(any()); writer.gallery(any(), any(), any()) } + assertEquals(setOf("other"), intents.keys) + } + + @Test + fun `given session bound to another archive, restore reuses its identity, expected failure without reapplying data`() = + runTest { + // Given + intents[request.sessionId] = RestoreSessionEntity( + request.sessionId, + "different-handle", + sessions.encode(request.selection) + ) + // When + val failure = runCatching { useCase(request) {} }.exceptionOrNull() + // Then + assertEquals("Restore session belongs to another request", failure?.message) + coVerify(exactly = 0) { + writer.gallery(any(), any(), any()); writer.network( + any(), + any() + ) + } + } + + @Test + fun `given session bound to original selection, retry changes categories, expected rejection before writes`() = + runTest { + // Given + intents[request.sessionId] = RestoreSessionEntity( + request.sessionId, + request.handle, + sessions.encode(request.selection) + ) + val changed = request.copy(selection = BackupSelection(setOf(BackupCategory.SETTINGS))) + // When + val failure = runCatching { useCase(changed) {} }.exceptionOrNull() + // Then + assertEquals("Restore session belongs to another request", failure?.message) + coVerify(exactly = 0) { preferences.writeSettings(any()); ledger.finish(any()) } + } + + @Test + fun `given skipped gallery rows, category commits, expected imported and skipped counts from ledger`() = + runTest { + // Given + coEvery { writer.gallery(any(), any(), any()) } coAnswers { + ledger.mark(RestoreSectionEntity(firstArg(), "gallery", 2, 7)) + } + // When + val result = useCase(request) {} as BackupRestoreResult.Finished + // Then + assertEquals(2L, result.importedCounts[BackupCategory.GALLERY]) + assertEquals(7, result.skippedCount) + assertFalse(result.hasFailed) + coVerify { ledger.finish(request.sessionId) } + } + + @Test + fun `given settings write fails, restore includes gallery, expected partial failure and later categories untouched`() = + runTest { + // Given + val selected = request.copy( + selection = BackupSelection( + setOf( + BackupCategory.SETTINGS, + BackupCategory.GALLERY + ) + ) + ) + coEvery { preferences.writeSettings(any()) } throws IllegalStateException("checked write failed") + // When + val result = useCase(selected) {} as BackupRestoreResult.Finished + // Then + assertTrue(result.hasFailed) + assertTrue(result.completed.isEmpty()) + coVerify(exactly = 0) { writer.gallery(any(), any(), any()); ledger.finish(any()) } + assertFalse(intents.getValue(request.sessionId).isComplete) + } } diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupArchiveStore.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupArchiveStore.kt index 8a55bc4ce..7526c870b 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupArchiveStore.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupArchiveStore.kt @@ -33,6 +33,7 @@ import kotlinx.serialization.json.Json import okio.Buffer import okio.FileSystem import okio.Path +import okio.SYSTEM import okio.buffer /** @@ -65,6 +66,7 @@ internal class DefaultBackupArchiveStore( private val json: Json, private val staging: BackupStagingCleaner, ) : BackupArchiveStore { + override fun preparedExport(handle: String, filename: String): BackupExport { val path = directory(handle) / ARCHIVE check(FileSystem.SYSTEM.exists(path)) { "Pending backup source is unavailable" } @@ -148,10 +150,10 @@ internal class DefaultBackupArchiveStore( galleryCodec.write(sink, row) offset++ afterId = row.id - progress(BackupProgress(BackupCategory.GALLERY, offset.toLong(), 0)) + progress(BackupProgress(BackupCategory.GALLERY, offset, 0)) } } - offset.toLong() + offset } payload(BackupCategory.NETWORK) { path -> val values = database.networkUsageDao().query() diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupStagingCleaner.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupStagingCleaner.kt index f2653874a..2e80d32b5 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupStagingCleaner.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/archive/DefaultBackupStagingCleaner.kt @@ -9,6 +9,7 @@ import kotlinx.coroutines.sync.Mutex import kotlinx.coroutines.sync.withLock import okio.FileSystem import okio.Path +import okio.SYSTEM /** * Cleans only generated directories under the app-owned backup root before new operations are admitted. diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BinaryBackupArchiveCodec.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BinaryBackupArchiveCodec.kt index afba9d85d..3e94e9dcd 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BinaryBackupArchiveCodec.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BinaryBackupArchiveCodec.kt @@ -3,7 +3,6 @@ package com.shifthackz.aisdv1.feature.backup.codec import okio.use import kotlinx.coroutines.currentCoroutineContext import kotlinx.coroutines.ensureActive -import kotlinx.serialization.encodeToString import kotlinx.serialization.json.Json import okio.blackholeSink import okio.Buffer @@ -13,6 +12,7 @@ import okio.FileSystem import okio.HashingSink import okio.HashingSource import okio.Path +import okio.SYSTEM import okio.buffer /** @@ -21,6 +21,7 @@ import okio.buffer * @author Dmitriy Moroz */ internal class BinaryBackupArchiveCodec(private val json: Json) : BackupArchiveCodec { + override suspend fun write(path: Path, manifest: BackupManifest, payloads: List) { val bytes = json.encodeToString(manifest).encodeToByteArray() require(bytes.size <= MAX_METADATA) { "Backup manifest is too large" } diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BoundedBackupSource.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BoundedBackupSource.kt index deb69969a..6cad6633a 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BoundedBackupSource.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/BoundedBackupSource.kt @@ -12,6 +12,7 @@ import okio.Timeout */ internal class BoundedBackupSource(private val source: Source, private var remaining: Long) : Source { + override fun read(sink: Buffer, byteCount: Long): Long { require(byteCount >= 0) if (remaining == 0L) return -1 @@ -22,5 +23,6 @@ internal class BoundedBackupSource(private val source: Source, private var remai } override fun timeout(): Timeout = source.timeout() + override fun close() = source.close() } diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/DefaultBackupPreferencesCodec.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/DefaultBackupPreferencesCodec.kt index f577bc819..b1d745fbd 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/DefaultBackupPreferencesCodec.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/DefaultBackupPreferencesCodec.kt @@ -13,6 +13,7 @@ import kotlinx.serialization.json.intOrNull * @author Dmitriy Moroz */ internal class DefaultBackupPreferencesCodec(private val json: Json) : BackupPreferencesCodec { + override fun encode(values: Map): String = JsonObject(values.mapValues { (_, value) -> when (value) { diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/DefaultGalleryBackupCodec.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/DefaultGalleryBackupCodec.kt index bf93f1404..8baa0a213 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/DefaultGalleryBackupCodec.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/codec/DefaultGalleryBackupCodec.kt @@ -26,6 +26,7 @@ internal class DefaultGalleryBackupCodec( private val imageValidator: BackupImageValidator, private val budget: BackupImageBudget, ) : GalleryBackupCodec { + override fun write(sink: BufferedSink, row: GenerationResultEntity) { val record = GalleryBackupRecord( createdAt = row.createdAt, diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupProviderPlanner.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupProviderPlanner.kt index deb4ec8e5..168233d2c 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupProviderPlanner.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupProviderPlanner.kt @@ -14,6 +14,7 @@ import okio.ByteString.Companion.encodeUtf8 */ internal class DefaultBackupProviderPlanner(private val codec: BackupPreferencesCodec) : BackupProviderPlanner { + override fun plan( current: BackupPreferences, incoming: BackupPreferences, diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupRestoreGuard.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupRestoreGuard.kt index ede073c30..c0f21b5e8 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupRestoreGuard.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupRestoreGuard.kt @@ -9,5 +9,6 @@ import kotlinx.coroutines.sync.withLock */ internal class DefaultBackupRestoreGuard : BackupRestoreGuard { private val mutex = Mutex() + override suspend fun exclusive(block: suspend () -> T): T = mutex.withLock { block() } } diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupSessionCodec.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupSessionCodec.kt index ac42d73ba..69f2ef127 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupSessionCodec.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/DefaultBackupSessionCodec.kt @@ -11,6 +11,7 @@ import kotlinx.serialization.json.Json * @author Dmitriy Moroz */ internal class DefaultBackupSessionCodec(private val json: Json) : BackupSessionCodec { + override fun encode(selection: BackupSelection): String = json.encodeToString( mapOf( "categories" to selection.categories.map { it.key }.sorted(), diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriter.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriter.kt index e38675f1d..d738415a8 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriter.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/restore/RoomBackupRestoreWriter.kt @@ -35,6 +35,7 @@ internal class RoomBackupRestoreWriter( private val fingerprint: BackupImageFingerprint, private val budget: BackupImageBudget, ) : BackupRestoreWriter { + override suspend fun gallery( sessionId: String, archive: StagedBackup, diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CancelBackupExportUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CancelBackupExportUseCaseImpl.kt index 9c3b74ecf..30bb8ac00 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CancelBackupExportUseCaseImpl.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CancelBackupExportUseCaseImpl.kt @@ -3,7 +3,6 @@ package com.shifthackz.aisdv1.feature.backup.usecase import com.shifthackz.aisdv1.domain.usecase.backup.CancelBackupExportUseCase import com.shifthackz.aisdv1.feature.backup.export.BackupExportCoordinator - /** * Interrupts active destination copying while retaining a durable source for an explicit retry. * @param coordinator Owns durable export association independently from screen lifetimes. @@ -11,5 +10,6 @@ import com.shifthackz.aisdv1.feature.backup.export.BackupExportCoordinator */ internal class CancelBackupExportUseCaseImpl(private val coordinator: BackupExportCoordinator) : CancelBackupExportUseCase { + override fun invoke(): Unit = coordinator.cancel() } diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CompleteBackupExportUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CompleteBackupExportUseCaseImpl.kt index 322b72f45..e54864c43 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CompleteBackupExportUseCaseImpl.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CompleteBackupExportUseCaseImpl.kt @@ -11,5 +11,6 @@ import com.shifthackz.aisdv1.domain.entity.backup.BackupExportCompletion */ internal class CompleteBackupExportUseCaseImpl(private val coordinator: BackupExportCoordinator) : CompleteBackupExportUseCase { + override fun invoke(completion: BackupExportCompletion): Unit = coordinator.submit(completion) } diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CreateBackupUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CreateBackupUseCaseImpl.kt index f656739e6..8384bb11d 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CreateBackupUseCaseImpl.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/CreateBackupUseCaseImpl.kt @@ -18,6 +18,7 @@ internal class CreateBackupUseCaseImpl( private val coordinator: BackupExportCoordinator, private val dispatchers: DispatchersProvider ) : CreateBackupUseCase { + override suspend operator fun invoke( selection: BackupSelection, onProgress: (BackupProgress) -> Unit diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/DiscardBackupUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/DiscardBackupUseCaseImpl.kt index f3fbf940e..c7bc5ac41 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/DiscardBackupUseCaseImpl.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/DiscardBackupUseCaseImpl.kt @@ -42,6 +42,7 @@ internal class DiscardBackupUseCaseImpl( private val sessions: BackupSessionCodec, private val changes: BackupChangesGateway, ) : DiscardBackupUseCase { + override suspend fun invoke(handle: String) = withContext(dispatchers.io) { restoreGuard.exclusive { val pending = diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/DismissBackupExportUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/DismissBackupExportUseCaseImpl.kt index 1020beea3..8cf7bafae 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/DismissBackupExportUseCaseImpl.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/DismissBackupExportUseCaseImpl.kt @@ -10,5 +10,6 @@ import com.shifthackz.aisdv1.feature.backup.export.BackupExportCoordinator */ internal class DismissBackupExportUseCaseImpl(private val coordinator: BackupExportCoordinator) : DismissBackupExportUseCase { + override suspend fun invoke() = coordinator.dismiss() } diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/ExportBackupUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/ExportBackupUseCaseImpl.kt index d21cae7fd..cce7c407f 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/ExportBackupUseCaseImpl.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/ExportBackupUseCaseImpl.kt @@ -1,6 +1,5 @@ package com.shifthackz.aisdv1.feature.backup.usecase - import com.shifthackz.aisdv1.domain.usecase.backup.ExportBackupUseCase import com.shifthackz.aisdv1.feature.backup.archive.BackupArchiveStore import com.shifthackz.aisdv1.core.common.schedulers.DispatchersProvider @@ -16,6 +15,7 @@ internal class ExportBackupUseCaseImpl( private val archives: BackupArchiveStore, private val dispatchers: DispatchersProvider ) : ExportBackupUseCase { + override suspend operator fun invoke(document: String, destination: String): Unit = withContext(dispatchers.io) { archives.export(document, destination) } } diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/GetBackupStartupStageUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/GetBackupStartupStageUseCaseImpl.kt index 3c72aee53..cb052d71a 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/GetBackupStartupStageUseCaseImpl.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/GetBackupStartupStageUseCaseImpl.kt @@ -11,5 +11,6 @@ import com.shifthackz.aisdv1.domain.usecase.backup.GetBackupStartupStageUseCase */ internal class GetBackupStartupStageUseCaseImpl(private val preferences: BackupPreferencesGateway) : GetBackupStartupStageUseCase { + override operator fun invoke(): BackupStartupStage = preferences.readStartupStage() } diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/GetPendingBackupExportUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/GetPendingBackupExportUseCaseImpl.kt index 1cc2ccc82..067375fbb 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/GetPendingBackupExportUseCaseImpl.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/GetPendingBackupExportUseCaseImpl.kt @@ -15,6 +15,7 @@ internal class GetPendingBackupExportUseCaseImpl( private val records: BackupExportStateStore, private val dispatchers: DispatchersProvider ) : GetPendingBackupExportUseCase { + override suspend fun invoke(): Boolean = withContext(dispatchers.io) { records.recoverPendingWrite() records.read() != null diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/InspectBackupUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/InspectBackupUseCaseImpl.kt index 6e42dbc70..00e8d6169 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/InspectBackupUseCaseImpl.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/InspectBackupUseCaseImpl.kt @@ -17,6 +17,7 @@ internal class InspectBackupUseCaseImpl( private val archives: BackupArchiveStore, private val dispatchers: DispatchersProvider ) : InspectBackupUseCase { + override suspend operator fun invoke( document: String, onProgress: (BackupProgress) -> Unit diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/LoadBackupInventoryUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/LoadBackupInventoryUseCaseImpl.kt index ee1f136bb..7698d05f0 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/LoadBackupInventoryUseCaseImpl.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/LoadBackupInventoryUseCaseImpl.kt @@ -16,6 +16,7 @@ internal class LoadBackupInventoryUseCaseImpl( private val archives: BackupArchiveStore, private val dispatchers: DispatchersProvider ) : LoadBackupInventoryUseCase { + override suspend operator fun invoke(): BackupInspection = withContext(dispatchers.io) { archives.inventory() } } diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/LoadPendingBackupUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/LoadPendingBackupUseCaseImpl.kt index 6ddb96d18..4652b5736 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/LoadPendingBackupUseCaseImpl.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/LoadPendingBackupUseCaseImpl.kt @@ -44,6 +44,7 @@ internal class LoadPendingBackupUseCaseImpl( private val staging: BackupStagingCleaner, private val changes: BackupChangesGateway, ) : LoadPendingBackupUseCase { + override suspend fun invoke(): BackupRecovery? = withContext(dispatchers.io) { staging.prepare() val pending = diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/ObserveBackupExportUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/ObserveBackupExportUseCaseImpl.kt index 354da9468..fada94e6d 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/ObserveBackupExportUseCaseImpl.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/ObserveBackupExportUseCaseImpl.kt @@ -12,5 +12,6 @@ import com.shifthackz.aisdv1.domain.entity.backup.BackupExportOperation */ internal class ObserveBackupExportUseCaseImpl(private val coordinator: BackupExportCoordinator) : ObserveBackupExportUseCase { + override fun invoke(): StateFlow = coordinator.observe() } diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/RestoreBackupUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/RestoreBackupUseCaseImpl.kt index 514064651..7cf70161b 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/RestoreBackupUseCaseImpl.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/RestoreBackupUseCaseImpl.kt @@ -63,6 +63,7 @@ internal class RestoreBackupUseCaseImpl( private val generationGate: GenerationRestoreGate, private val dispatchers: DispatchersProvider, ) : RestoreBackupUseCase { + override suspend fun invoke( request: BackupRestoreRequest, onProgress: (BackupProgress) -> Unit diff --git a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/SetBackupStartupStageUseCaseImpl.kt b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/SetBackupStartupStageUseCaseImpl.kt index e33cc013a..aa1fddc90 100644 --- a/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/SetBackupStartupStageUseCaseImpl.kt +++ b/feature/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/feature/backup/usecase/SetBackupStartupStageUseCaseImpl.kt @@ -11,6 +11,7 @@ import com.shifthackz.aisdv1.domain.usecase.backup.SetBackupStartupStageUseCase */ internal class SetBackupStartupStageUseCaseImpl(private val preferences: BackupPreferencesGateway) : SetBackupStartupStageUseCase { + override operator fun invoke(stage: BackupStartupStage) { if (stage.ordinal < preferences.readStartupStage().ordinal) return preferences.writeStartupStage(stage) diff --git a/feature/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.ios.kt b/feature/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.ios.kt index c58ff45c4..4b90b0538 100644 --- a/feature/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.ios.kt +++ b/feature/backup/src/iosMain/kotlin/com/shifthackz/aisdv1/feature/backup/io/BackupFileStore.ios.kt @@ -19,6 +19,7 @@ import kotlinx.cinterop.ExperimentalForeignApi @OptIn(ExperimentalForeignApi::class) internal class IosBackupFileStore : BackupFileStore { override val root: Path get() = (NSHomeDirectory() + "/Library/Application Support/backup").toPath() + override fun documentReference(path: Path): String = NSURL.fileURLWithPath(path.toString()).absoluteString!! @@ -35,6 +36,7 @@ internal class IosBackupFileStore : BackupFileStore { documentPath(document).toString() override fun newId(): String = NSUUID().UUIDString + override fun openDocument(document: String) = FileSystem.SYSTEM.source(checkNotNull(NSURL.URLWithString(document)?.path).toPath()) .buffer() diff --git a/presentation/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupPagerInteractionTest.kt b/presentation/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupPagerInteractionTest.kt new file mode 100644 index 000000000..03aae0bc3 --- /dev/null +++ b/presentation/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupPagerInteractionTest.kt @@ -0,0 +1,89 @@ +package com.shifthackz.aisdv1.presentation.backup + +import org.junit.Assert.assertFalse +import org.junit.Assert.assertTrue +import org.junit.Test + +class BackupPagerInteractionTest { + @Test + fun `given create page, vertical scroll has no horizontal displacement, expected action remains available`() { + // Given + val selectedPage = 0 + // When + val canInteract = canInteractWithBackupPage(selectedPage, 0, 0f) + // Then + assertTrue(canInteract) + } + + @Test + fun `given create page, incidental swipe stays below forty percent, expected action remains available`() { + // Given + val offsets = listOf(0.001f, 0.1f, 0.3999f) + // When + val availability = offsets.map { canInteractWithBackupPage(0, 0, it) } + // Then + assertTrue(availability.all { it }) + } + + @Test + fun `given create page, swipe reaches forty percent, expected action pauses`() { + // Given + val offset = 0.4f + // When + val canInteract = canInteractWithBackupPage(0, 0, offset) + // Then + assertFalse(canInteract) + } + + @Test + fun `given create page still selected, nearest page flips during swipe, expected original action stays paused`() { + // Given + val newNearestPage = 1 + // When + val canInteract = canInteractWithBackupPage(0, newNearestPage, -0.49f) + // Then + assertFalse(canInteract) + } + + @Test + fun `given restore page, reverse swipe stays below forty percent, expected action remains available`() { + // Given + val offsets = listOf(-0.001f, -0.1f, -0.3999f) + // When + val availability = offsets.map { canInteractWithBackupPage(1, 1, it) } + // Then + assertTrue(availability.all { it }) + } + + @Test + fun `given restore page, reverse swipe reaches forty percent, expected action pauses`() { + // Given + val offset = -0.4f + // When + val canInteract = canInteractWithBackupPage(1, 1, offset) + // Then + assertFalse(canInteract) + } + + @Test + fun `given restore page still selected, nearest page flips on reverse swipe, expected original action stays paused`() { + // Given + val newNearestPage = 0 + // When + val canInteract = canInteractWithBackupPage(1, newNearestPage, 0.49f) + // Then + assertFalse(canInteract) + } + + @Test + fun `given restore tab chosen, animation approaches selected page, expected action returns inside forty percent`() { + // Given + val selectedPage = 1 + // When + val isPaused = !canInteractWithBackupPage(selectedPage, 0, 0f) + val canInteract = canInteractWithBackupPage(selectedPage, 1, -0.3f) + // Then + assertTrue(isPaused) + assertTrue(canInteract) + } +} diff --git a/presentation/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupViewModelTest.kt b/presentation/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupViewModelTest.kt index 03fbf7981..b55ddedcf 100644 --- a/presentation/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupViewModelTest.kt +++ b/presentation/backup/src/androidUnitTest/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupViewModelTest.kt @@ -7,6 +7,8 @@ import com.shifthackz.aisdv1.domain.entity.backup.BackupEntry import com.shifthackz.aisdv1.domain.entity.backup.BackupExport import com.shifthackz.aisdv1.domain.entity.backup.BackupInspection import com.shifthackz.aisdv1.domain.entity.backup.BackupRestoreResult +import com.shifthackz.aisdv1.domain.entity.backup.BackupRestoreRequest +import com.shifthackz.aisdv1.domain.entity.backup.BackupProgress import com.shifthackz.aisdv1.domain.entity.backup.BackupStartupStage import com.shifthackz.aisdv1.domain.usecase.backup.CreateBackupUseCase import com.shifthackz.aisdv1.domain.usecase.backup.InspectBackupUseCase @@ -486,4 +488,197 @@ class BackupViewModelTest { vm.onRouteDisposed() } + @Test + fun `given provider child choices, last child is unchecked then another selected, expected parent category follows child selection`() = + runTest { + // Given + val vm = viewModel() + coEvery { inventory() } returns summary.copy( + entries = listOf( + BackupEntry( + BackupCategory.PROVIDERS, + 2 + ) + ), providers = setOf("custom", "swarm_ui") + ) + advanceUntilIdle() + // When + vm.processIntent(BackupIntent.ToggleProvider("custom")) + vm.processIntent(BackupIntent.ToggleProvider("swarm_ui")) + val empty = vm.state.value.create.selection + vm.processIntent(BackupIntent.ToggleProvider("swarm_ui")) + // Then + assertTrue(empty.categories.isEmpty()) + assertTrue(empty.providers.isEmpty()) + assertEquals( + setOf(BackupCategory.PROVIDERS), + vm.state.value.create.selection.categories + ) + assertEquals(setOf("swarm_ui"), vm.state.value.create.selection.providers) + vm.onRouteDisposed() + } + + @Test + fun `given expanded create providers, user collapses then switches tabs, expected independent expansion and retained selection`() = + runTest { + // Given + val vm = viewModel() + advanceUntilIdle() + val original = vm.state.value.create.selection + // When + vm.processIntent(BackupIntent.ToggleProvidersExpanded) + val isCreateExpanded = vm.state.value.create.areProvidersExpanded + vm.processIntent(BackupIntent.SelectTab(true)) + vm.processIntent(BackupIntent.ToggleProvidersExpanded) + vm.processIntent(BackupIntent.SelectTab(false)) + // Then + assertEquals(isCreateExpanded, vm.state.value.create.areProvidersExpanded) + assertEquals(original, vm.state.value.create.selection) + vm.onRouteDisposed() + } + + @Test + fun `given provider replacement conflict, user confirms, expected same session and exact consent fingerprint`() = + runTest { + // Given + val vm = viewModel() + coEvery { inspect(any(), any()) } returns summary + val requests = mutableListOf() + coEvery { restore(any(), any()) } answers { + requests += firstArg() + if (requests.size == 1) BackupRestoreResult.Conflict(setOf("custom"), "revision") + else BackupRestoreResult.Finished(setOf(BackupCategory.GALLERY), 0, false) + } + advanceUntilIdle() + vm.processIntent(BackupIntent.DocumentSelected("source")) + advanceUntilIdle() + vm.processIntent(BackupIntent.Submit) + advanceUntilIdle() + // When + vm.processIntent(BackupIntent.ConfirmProviderReplacement) + advanceUntilIdle() + // Then + assertEquals(2, requests.size) + assertEquals(requests.first().sessionId, requests.last().sessionId) + assertEquals("revision", requests.last().confirmedFingerprint) + assertNull(vm.state.value.conflict) + assertTrue(vm.state.value.isFeedbackVisible) + vm.onRouteDisposed() + } + + @Test + fun `given failed partial restore, user edits then retries, expected original locked selection and session reused`() = + runTest { + // Given + val vm = viewModel() + coEvery { inspect(any(), any()) } returns summary + val requests = mutableListOf() + coEvery { restore(any(), any()) } answers { + requests += firstArg() + BackupRestoreResult.Finished(setOf(BackupCategory.GALLERY), 0, true) + } + advanceUntilIdle() + vm.processIntent(BackupIntent.DocumentSelected("source")) + advanceUntilIdle() + vm.processIntent(BackupIntent.Submit) + advanceUntilIdle() + // When + vm.processIntent(BackupIntent.DismissFeedback) + vm.processIntent(BackupIntent.ToggleCategory(BackupCategory.GALLERY)) + vm.processIntent(BackupIntent.Submit) + advanceUntilIdle() + // Then + assertEquals(2, requests.size) + assertEquals(requests.first(), requests.last()) + assertTrue(vm.state.value.hasPendingSession) + vm.onRouteDisposed() + } + + @Test + fun `given backup creation failure, user submits selected data, expected failure dialog state without picker`() = + runTest { + // Given + val vm = viewModel() + coEvery { create(any(), any()) } throws IllegalStateException("full disk") + advanceUntilIdle() + // When + vm.processIntent(BackupIntent.Submit) + advanceUntilIdle() + // Then + assertTrue(vm.state.value.hasError) + assertTrue(vm.state.value.isFeedbackVisible) + assertFalse(vm.state.value.isPicking) + assertFalse(vm.state.value.isBusy) + assertFalse(vm.state.value.hasExported) + vm.onRouteDisposed() + } + + @Test + fun `given selected valid archive, replacement inspection fails, expected original file and selection retained`() = + runTest { + // Given + val vm = viewModel() + coEvery { inspect("original", any()) } returns summary + coEvery { inspect("invalid", any()) } throws IllegalArgumentException("bad archive") + advanceUntilIdle() + vm.processIntent(BackupIntent.DocumentSelected("original")) + advanceUntilIdle() + vm.processIntent(BackupIntent.ToggleCategory(BackupCategory.GALLERY)) + val original = vm.state.value.restore + // When + vm.processIntent(BackupIntent.DocumentSelected("invalid")) + advanceUntilIdle() + // Then + assertEquals(original, vm.state.value.restore) + assertTrue(vm.state.value.hasError) + coVerify(exactly = 0) { discard(any()) } + vm.onRouteDisposed() + } + + @Test + fun `given running restore, progress is reported then user cancels, expected canceled feedback and cleared busy state`() = + runTest { + // Given + val vm = viewModel() + val running = CompletableDeferred() + coEvery { inspect(any(), any()) } returns summary + coEvery { restore(any(), any()) } coAnswers { + secondArg<(BackupProgress) -> Unit>()(BackupProgress(BackupCategory.GALLERY, 1, 2)) + running.await() + BackupRestoreResult.Finished(emptySet(), 0, false) + } + advanceUntilIdle() + vm.processIntent(BackupIntent.DocumentSelected("source")) + advanceUntilIdle() + vm.processIntent(BackupIntent.Submit) + runCurrent() + assertTrue(vm.state.value.isBusy) + assertEquals(1L, vm.state.value.progress?.completed) + // When + vm.processIntent(BackupIntent.CancelWork) + advanceUntilIdle() + // Then + assertTrue(vm.state.value.hasCanceled) + assertTrue(vm.state.value.isFeedbackVisible) + assertFalse(vm.state.value.isBusy) + assertNull(vm.state.value.progress) + verify { cancelExport() } + vm.onRouteDisposed() + } + + @Test + fun `given first launch invitation, durable stage write fails, expected feedback and no navigation`() = + runTest { + // Given + val vm = viewModel(BackupScreenMode.WELCOME) + every { startup(any()) } throws IllegalStateException("storage unavailable") + // When + vm.processIntent(BackupIntent.BeginInitialRestore) + advanceUntilIdle() + // Then + assertTrue(vm.state.value.hasError) + assertTrue(vm.state.value.isFeedbackVisible) + verify(exactly = 0) { router.navigateToInitialRestore() } + vm.onRouteDisposed() + } } diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupPageContent.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupPageContent.kt index e0fbef274..2969fe0cb 100644 --- a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupPageContent.kt +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupPageContent.kt @@ -10,6 +10,7 @@ import androidx.compose.ui.Modifier import androidx.compose.ui.unit.dp import com.shifthackz.aisdv1.presentation.backup.create.CreateBackupScreen import com.shifthackz.aisdv1.presentation.backup.restore.RestoreBackupScreen +import com.shifthackz.aisdv1.presentation.components.widget.scrollbar.verticalScrollbar /** * Keeps each pager page's vertical scroll independent while reusing dedicated create/restore content. @@ -30,7 +31,11 @@ internal fun BackupPageContent( processIntent: (BackupIntent) -> Unit, modifier: Modifier = Modifier, ) { - Column(modifier.fillMaxSize().verticalScroll(rememberScrollState()).padding(16.dp)) { + val scrollState = rememberScrollState() + Column( + modifier.fillMaxSize().verticalScrollbar(scrollState).verticalScroll(scrollState) + .padding(16.dp) + ) { if (isRestore) RestoreBackupScreen(page, isEnabled, canEditSelection, processIntent) else CreateBackupScreen(page, isEnabled && canEditSelection, processIntent) } diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupPagerInteraction.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupPagerInteraction.kt new file mode 100644 index 000000000..c8a25a430 --- /dev/null +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupPagerInteraction.kt @@ -0,0 +1,17 @@ +package com.shifthackz.aisdv1.presentation.backup + +import kotlin.math.abs + +/** + * Keeps the selected page's actions stable during incidental horizontal movement in a vertical scroll. + * Actions pause once a swipe has moved at least forty percent of one page away from that selection. + * @param selectedPage Page owning the active MVI selection and bottom action. + * @param currentPage Pager's nearest page; this changes halfway through a swipe. + * @param currentPageOffsetFraction Signed displacement from the nearest page in page-width units. + * @author Dmitriy Moroz + */ +internal fun canInteractWithBackupPage( + selectedPage: Int, + currentPage: Int, + currentPageOffsetFraction: Float, +): Boolean = abs(currentPage - selectedPage + currentPageOffsetFraction) < 0.4f diff --git a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupScreen.kt b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupScreen.kt index 943276011..203445de0 100644 --- a/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupScreen.kt +++ b/presentation/backup/src/commonMain/kotlin/com/shifthackz/aisdv1/presentation/backup/BackupScreen.kt @@ -15,7 +15,7 @@ import androidx.compose.material3.IconButton import androidx.compose.material3.MaterialTheme import androidx.compose.material3.Scaffold import androidx.compose.material3.Tab -import androidx.compose.material3.TabRow +import androidx.compose.material3.SecondaryTabRow import androidx.compose.material3.Text import androidx.compose.runtime.Composable import androidx.compose.runtime.LaunchedEffect @@ -60,9 +60,10 @@ fun BackupScreen( val pager = rememberPagerState(initialPage = if (state.isRestoreTab) 1 else 0) { 2 } val isRestoreSelected by rememberUpdatedState(state.isRestoreTab) val selectedPage = if (state.isRestoreTab) 1 else 0 - val hasSettledPage = mode != BackupScreenMode.SETTINGS || - (!pager.isScrollInProgress && pager.currentPage == selectedPage && pager.currentPageOffsetFraction == 0f) - LaunchedEffect(state.isRestoreTab) { + val canInteractWithPage = mode != BackupScreenMode.SETTINGS || canInteractWithBackupPage( + selectedPage, pager.currentPage, pager.currentPageOffsetFraction + ) + LaunchedEffect(state.isRestoreTab, isEnabled) { if (mode == BackupScreenMode.SETTINGS) { pager.animateScrollToPage(selectedPage) } @@ -109,7 +110,7 @@ fun BackupScreen( ScreenActionBar { PrimaryActionButton( onClick = { processIntent(if (isFinished) BackupIntent.NavigateBack else BackupIntent.Submit) }, - isEnabled = isEnabled && hasSettledPage && (isFinished || page.selection.categories.isNotEmpty()), + isEnabled = isEnabled && canInteractWithPage && (isFinished || page.selection.categories.isNotEmpty()), ) { Text(Localization.string(if (isFinished) "backup_done" else if (state.isRestoreTab) "backup_restore" else "backup_create")) } @@ -118,7 +119,10 @@ fun BackupScreen( ) { padding -> Column(Modifier.padding(padding).fillMaxSize()) { if (mode == BackupScreenMode.SETTINGS) { - TabRow(selectedTabIndex = selectedPage) { + SecondaryTabRow( + selectedTabIndex = selectedPage, + contentColor = MaterialTheme.colorScheme.primary, + ) { Tab( selected = !state.isRestoreTab, onClick = { processIntent(BackupIntent.SelectTab(false)) }, @@ -142,7 +146,7 @@ fun BackupScreen( BackupPageContent( isRestore = isRestorePage, page = if (isRestorePage) state.restore else state.create, - isEnabled = isEnabled && hasSettledPage, + isEnabled = isEnabled && canInteractWithPage && isRestorePage == state.isRestoreTab, canEditSelection = if (isRestorePage) !state.isRestoreSelectionLocked else !state.hasPendingExport, processIntent = processIntent, )

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%0Ac@)!O%?{J5*owZGv1P~w9h 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