// 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 CONTENT_PUBLIC_BROWSER_WEBID_AUTOFILL_SOURCE_H_
#define CONTENT_PUBLIC_BROWSER_WEBID_AUTOFILL_SOURCE_H_

#include "base/functional/callback.h"
#include "content/public/browser/page.h"
#include "content/public/browser/webid/identity_request_account.h"
#include "url/gurl.h"

using IdentityRequestAccountPtr =
    scoped_refptr<content::IdentityRequestAccount>;

namespace content::webid {

// A data source for autofill, used to (a) augment it with suggestions coming
// from federated accounts and (b) handle when the suggestion gets selected.
class AutofillSource {
 public:
  // For 3P logins the identity provider needs to issue a federated
  // token such as ID token, access token etc. to complete the flow. This
  // callback is triggered when the browser receives such a token or when
  // an error occurs (e.g. the user cancels the request, the website aborts
  // the request or the IdP's server fails to produce a token), with the
  // parameter passed to the callback indicating a successful response or not.
  using OnFederatedTokenReceivedCallback = base::OnceCallback<void(bool)>;

  AutofillSource() = default;
  virtual ~AutofillSource() = default;

  // Generates autofill suggestions from identity credential requests.
  virtual const std::optional<std::vector<IdentityRequestAccountPtr>>
  GetAutofillSuggestions() const = 0;
  // This is called when a suggestion from an identity credential conditional
  // request was accepted. e.g. a user has selected the suggestion from the
  // autofill dropdown UI.
  // `show_modal` determines whether the acceptance of the suggestion is
  // sufficient permission to return a result or if extra dialogs need to be
  // shown to the user.
  // The `callback` will be called when a federated token is
  // received. Once it's called, the autofill dropdown will be hidden.
  virtual void NotifyAutofillSuggestionAccepted(
      const GURL& idp,
      const std::string& account_id,
      bool show_modal,
      OnFederatedTokenReceivedCallback callback) = 0;

  // Returns the a data source for autofill if there is a pending conditional
  // FedCM requests. Returns null otherwise.
  CONTENT_EXPORT static AutofillSource* FromPage(content::Page& page);
};

}  // namespace content::webid

#endif  // CONTENT_PUBLIC_BROWSER_WEBID_AUTOFILL_SOURCE_H_