/*
* Copyright (c) 2026 Proton AG
*
* This file is part of ProtonVPN.
*
* ProtonVPN is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* ProtonVPN is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with ProtonVPN. If not, see .
*/
using ProtonVPN.Client.Common.Dispatching;
using ProtonVPN.Client.Core.Messages;
using ProtonVPN.Client.Core.Services.Navigation;
using ProtonVPN.Client.Core.Services.TeachingTips;
using ProtonVPN.Client.EventMessaging.Contracts;
using ProtonVPN.Client.Handlers.Bases;
using ProtonVPN.Client.Settings.Contracts;
using ProtonVPN.Common.Core.Extensions;
using ProtonVPN.StatisticalEvents.Contracts;
namespace ProtonVPN.Client.Handlers;
public class ExcludedLocationsTeachingTipHandler : IHandler,
IEventMessageReceiver
{
private static readonly TimeSpan _teachingTipDelay = TimeSpan.FromSeconds(1);
private readonly ISettings _settings;
private readonly IUIThreadDispatcher _uiThreadDispatcher;
private readonly ITeachingTipService _teachingTipService;
private readonly IMainViewNavigator _mainViewNavigator;
private readonly ISettingsViewNavigator _settingsViewNavigator;
private readonly IProductPromptDisplayReporter _productPromptDisplayReporter;
private readonly IProductPromptActionReporter _productPromptActionReporter;
public ExcludedLocationsTeachingTipHandler(
ISettings settings,
IUIThreadDispatcher uiThreadDispatcher,
ITeachingTipService teachingTipService,
IMainViewNavigator mainViewNavigator,
ISettingsViewNavigator settingsViewNavigator,
IProductPromptDisplayReporter productPromptDisplayReporter,
IProductPromptActionReporter productPromptActionReporter)
{
_settings = settings;
_uiThreadDispatcher = uiThreadDispatcher;
_teachingTipService = teachingTipService;
_mainViewNavigator = mainViewNavigator;
_settingsViewNavigator = settingsViewNavigator;
_productPromptDisplayReporter = productPromptDisplayReporter;
_productPromptActionReporter = productPromptActionReporter;
}
public void Receive(HomePageDisplayedAfterLoginMessage message)
{
if (!ShouldShowTeachingTip())
{
return;
}
_uiThreadDispatcher.TryEnqueue(async () =>
{
await Task.Delay(_teachingTipDelay);
if (_teachingTipService.TryShow(TeachingTipKey.ExcludedLocations, OnTeachingTipInvoked, OnTeachingTipDismissed))
{
_settings.WasExcludedLocationsTeachingTipDisplayed = true;
_productPromptDisplayReporter.Report(PromptType.FeatureDiscovery, PromptContext.ConnectionPreferencesTooltip);
}
});
}
private bool ShouldShowTeachingTip()
{
return _settings is
{
WasExcludedLocationsTeachingTipDisplayed: false,
VpnPlan.IsPaid: true,
WasWelcomeOverlayDisplayed: true,
};
}
private void OnTeachingTipInvoked()
{
_productPromptActionReporter.Report(PromptType.FeatureDiscovery, PromptContext.ConnectionPreferencesTooltip, PromptAction.Configure);
NavigateToConnectionPreferencesAsync().FireAndForget();
}
private void OnTeachingTipDismissed()
{
_productPromptActionReporter.Report(PromptType.FeatureDiscovery, PromptContext.ConnectionPreferencesTooltip, PromptAction.Dismiss);
}
private async Task NavigateToConnectionPreferencesAsync()
{
await _mainViewNavigator.NavigateToSettingsViewAsync();
await _settingsViewNavigator.NavigateToConnectionPreferencesSettingsViewAsync();
}
}