// Copyright 2025 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROME_BROWSER_GLIC_BROWSER_UI_GLIC_NUDGE_CONTROLLER_H_
#define CHROME_BROWSER_GLIC_BROWSER_UI_GLIC_NUDGE_CONTROLLER_H_

#include <optional>
#include <string>

#include "base/functional/callback.h"
#include "base/memory/weak_ptr.h"
#include "ui/base/unowned_user_data/scoped_unowned_user_data.h"

namespace content {
class WebContents;
}  // namespace content

class BrowserWindowInterface;

namespace glic {

// Enumerates the various user action for the Glic nudge.
// GENERATED_JAVA_ENUM_PACKAGE: org.chromium.chrome.browser.glic
enum class GlicNudgeActivity {
  kNudgeShown = 0,
  kNudgeClicked = 1,
  kNudgeDismissed = 2,
  kNudgeNotShownWebContents = 3,
  kNudgeIgnoredActiveTabChanged = 4,
  kNudgeIgnoredNavigation = 5,
  kNudgeNotShownWindowCallToActionUI = 6,
  kNudgeIgnoredOpenedContextualTasksSidePanel = 7,
  kNudgeIgnoredOmniboxContextMenuInteraction = 8,
};

class GlicSplitButtonDelegate;

// Interface for the controller that mediates Glic Nudges.
class GlicNudgeController {
 public:
  DECLARE_USER_DATA(GlicNudgeController);

  static std::unique_ptr<GlicNudgeController> CreateFor(
      BrowserWindowInterface* browser);
  static GlicNudgeController* From(BrowserWindowInterface* browser);

  using GlicNudgeActivityCallback =
      base::RepeatingCallback<void(GlicNudgeActivity)>;

  virtual ~GlicNudgeController();

  virtual void SetHorizontalTabsDelegate(GlicSplitButtonDelegate* delegate) = 0;
  virtual void SetVerticalTabsDelegate(GlicSplitButtonDelegate* delegate) = 0;

  // Updates the `nudge_label` for `web_contents`, if the WebContents is active.
  // The nudge will be removed from `web_contents` if `nudge_label` is empty.
  // `activity` must be supplied iff. `nudge_label` is empty, to identify the
  // reason of nudge removal.
  virtual void UpdateNudgeLabel(content::WebContents* web_contents,
                                const std::string& nudge_label,
                                std::optional<std::string> prompt_suggestion,
                                std::optional<GlicNudgeActivity> activity,
                                GlicNudgeActivityCallback callback) = 0;

  virtual void OnNudgeActivity(GlicNudgeActivity activity) = 0;

  virtual std::optional<std::string> GetPromptSuggestion() = 0;
  virtual void ClearPromptSuggestion() = 0;

  virtual base::WeakPtr<GlicNudgeController> GetWeakPtr() = 0;
};

}  // namespace glic

#endif  // CHROME_BROWSER_GLIC_BROWSER_UI_GLIC_NUDGE_CONTROLLER_H_