// Copyright 2024 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_FACILITATED_PAYMENTS_UI_ANDROID_FACILITATED_PAYMENTS_CONTROLLER_H_
#define CHROME_BROWSER_FACILITATED_PAYMENTS_UI_ANDROID_FACILITATED_PAYMENTS_CONTROLLER_H_

#include <memory>
#include <string_view>

#include "base/android/scoped_java_ref.h"
#include "base/containers/span.h"
#include "base/functional/callback_forward.h"
#include "base/gtest_prod_util.h"
#include "base/time/time.h"
#include "chrome/browser/facilitated_payments/ui/android/facilitated_payments_bottom_sheet_bridge.h"
#include "components/autofill/core/browser/data_model/payments/bank_account.h"
#include "components/autofill/core/browser/data_model/payments/ewallet.h"
#include "components/facilitated_payments/core/browser/account_linking_params.h"
#include "components/facilitated_payments/core/browser/facilitated_payments_app_info_list.h"
#include "components/facilitated_payments/core/browser/payment_link_manager.h"
#include "components/facilitated_payments/core/utils/facilitated_payments_ui_utils.h"

namespace content {
class WebContents;
}

// Controller of the bottom sheet surface for filling facilitated payments
// payment methods on Android. It is responsible for showing the view and
// handling user interactions.
class FacilitatedPaymentsController {
 public:
  explicit FacilitatedPaymentsController(content::WebContents* web_contents);

  FacilitatedPaymentsController(const FacilitatedPaymentsController&) = delete;
  FacilitatedPaymentsController& operator=(
      const FacilitatedPaymentsController&) = delete;

  virtual ~FacilitatedPaymentsController();

  // Returns true if the device is being used in the landscape mode.
  virtual bool IsInLandscapeMode();

  // Shows the PIX FOP selector.
  virtual void Show(
      base::span<const autofill::BankAccount> bank_account_suggestions,
      base::OnceCallback<void(int64_t)> on_payment_account_selected);

  // Shows the payment link FOP selector.
  virtual void ShowForPaymentLink(
      base::span<const autofill::Ewallet> ewallet_suggestions,
      std::unique_ptr<payments::facilitated::FacilitatedPaymentsAppInfoList>
          app_suggestions,
      base::OnceCallback<void(payments::facilitated::SelectedFopData)>
          on_fop_selected);

  // Asks the `view_` to show the progress screen. Virtual for overriding in
  // tests.
  virtual void ShowProgressScreen();

  // Asks the `view_` to show the error screen. Virtual for overriding in tests.
  virtual void ShowErrorScreen();

  // Asks the `view_` to close the bottom sheet. Virtual for overriding in
  // tests.
  virtual void Dismiss();

  // Enables features to listen to `payments::facilitated::UiEvent` using
  // `ui_event_listener`.
  void SetUiEventListener(
      base::RepeatingCallback<void(payments::facilitated::UiEvent)>
          ui_event_listener);

  // Called by the Java view to communicate `payments::facilitated::UiEvent`.
  void OnUiEvent(JNIEnv* env, int32_t event);

  void OnBankAccountSelected(JNIEnv* env, int64_t instrument_id);

  void OnEwalletSelected(JNIEnv* env, int64_t instrument_id);

  void OnPaymentAppSelected(
      JNIEnv* env,
      const base::android::JavaRef<jstring>& package_name,
      const base::android::JavaRef<jstring>& activity_name);

  // Asks the `view_` to show the PIX account linking prompt. Virtual for
  // overriding in tests.
  // TODO(crbug.com/532367369): Deprecate the Pix specific callbacks for account
  // linking.
  virtual void ShowPixAccountLinkingPrompt(
      int strike_count,
      const std::string& account_email,
      base::OnceCallback<void()> on_accepted,
      base::OnceCallback<void()> on_declined);

  // Asks the `view_` to show the Pix account linking success screen. Virtual
  // for overriding in tests.
  virtual void ShowPixAccountLinkingSuccessScreen();

  // Shows the account linking prompt via the Java UI, customized by `params`.
  // Callbacks:
  // - `on_accepted`: User accepts the prompt.
  // - `on_declined`: User declines/cancels the prompt.
  // - `on_dismissed`: Invoked upon dismissal/teardown only if no other action
  // (accept/decline) was taken. Note: Only one prompt can be shown at a time.
  // If another prompt is already showing, the call is gracefully dropped and
  // the `on_dismissed` callback is discarded.
  virtual void ShowAccountLinkingPrompt(
      const payments::facilitated::AccountLinkingParams& params,
      base::OnceCallback<void()> on_accepted,
      base::OnceCallback<void()> on_declined,
      base::OnceCallback<void()> on_dismissed);

  // Asks the `view_` to show the account linking failure notification. Virtual
  // for overriding in tests.
  virtual void ShowAccountLinkingFailureNotification(
      payments::facilitated::FacilitatedPaymentsType fop_type);

  // Called by the Java view to communicate acceptance of Pix account linking
  // prompt.
  void OnPixAccountLinkingPromptAccepted(JNIEnv* env);

  // Called by the Java view to communicate that the Pix account linking prompt
  // was declined.
  void OnPixAccountLinkingPromptDeclined(JNIEnv* env);

  // Called by the Java view when an account linking prompt is shown.
  void OnAccountLinkingPromptShown(JNIEnv* env, int32_t type);

  // Called by the Java view when the user takes an action on the account
  // linking prompt.
  void OnAccountLinkingPromptAction(JNIEnv* env, int32_t type, int32_t action);

  base::android::ScopedJavaLocalRef<jobject> GetJavaObject();

  void SetViewForTesting(
      std::unique_ptr<
          payments::facilitated::FacilitatedPaymentsBottomSheetBridge> view);

 private:
  FRIEND_TEST_ALL_PREFIXES(FacilitatedPaymentsControllerTest, OnDismissed);

  // Clears any native references from the Java view components, and then clears
  // the pointers to the Java objects.
  void ClearJavaViewComponents();

  // Resets the account linking prompt state and safely invokes the dismissed
  // callback (if set).
  void DismissPrompt();

  // View that displays the surface.
  std::unique_ptr<payments::facilitated::FacilitatedPaymentsBottomSheetBridge>
      view_;

  // The corresponding Java FacilitatedPaymentsControllerBridge. This bridge is
  // used to delegate user actions from Java to native.
  base::android::ScopedJavaGlobalRef<jobject> java_object_;

  // Called when user selects the payment account to pay with.
  base::OnceCallback<void(int64_t)> on_payment_account_selected_;

  // Called when an eWallet or payment app is selected.
  base::OnceCallback<void(payments::facilitated::SelectedFopData)>
      on_fop_selected_;

  // Callback used to communicate view events to the feature.
  base::RepeatingCallback<void(payments::facilitated::UiEvent)>
      ui_event_listener_;

  base::OnceCallback<void()> on_pix_account_linking_prompt_accepted_;
  base::OnceCallback<void()> on_pix_account_linking_prompt_declined_;

  bool is_prompt_showing_ = false;
  base::TimeTicks account_linking_prompt_shown_time_;
  base::OnceCallback<void()> on_accepted_callback_;
  base::OnceCallback<void()> on_declined_callback_;
  base::OnceCallback<void()> on_dismissed_callback_;
};

#endif  // CHROME_BROWSER_FACILITATED_PAYMENTS_UI_ANDROID_FACILITATED_PAYMENTS_CONTROLLER_H_