1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
|
// 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 COMPONENTS_AUTOFILL_CORE_BROWSER_PAYMENTS_AMOUNT_EXTRACTION_MANAGER_H_
#define COMPONENTS_AUTOFILL_CORE_BROWSER_PAYMENTS_AMOUNT_EXTRACTION_MANAGER_H_
#include <string>
#include "base/memory/raw_ref.h"
#include "base/memory/weak_ptr.h"
#include "base/time/time.h"
#include "components/autofill/core/browser/field_types.h"
#include "components/autofill/core/common/dense_set.h"
namespace autofill {
class AutofillDriver;
class BrowserAutofillManager;
struct SuggestionsContext;
} // namespace autofill
namespace autofill::payments {
// Owned by `BrowserAutofillManager`. This class manages the flow of the
// checkout amount extraction. The amount extraction flow starts from
// `BrowserAutofillManager`, which will call `AmountExtractionManager` to check
// whether a search should be triggered. If eligible, `AmountExtractionManager`
// will ask the main frame `AutofillDriver` to search for the checkout amount
// from the main frame DOM tree because it's where the final checkout amount
// lives. Since the search may take some time, it does not block credit card
// suggestion from being shown on UI because the IPC call between the browser
// process and renderer process is non-blocking. Once the result is passed back,
// `AmountExtractionManager` will pass the result to `BnplManager` and let it
// check whether this value is eligible for a Buy Now, Pay Later(BNPL) offer. If
// so, a new BNPL chip and the existing credit card suggestions will be shown on
// UI together. If not, it does nothing.
class AmountExtractionManager {
public:
// Enum for all features that require amount extraction.
enum class EligibleFeature {
// Buy now pay later uses the amount extracted by amount extraction to
// determine if the current purchase is eligible for buy now pay later.
kBnpl = 0,
kMaxValue = kBnpl,
};
explicit AmountExtractionManager(BrowserAutofillManager* autofill_manager);
AmountExtractionManager(const AmountExtractionManager& other) = delete;
AmountExtractionManager& operator=(const AmountExtractionManager& other) =
delete;
virtual ~AmountExtractionManager();
// Timeout limit for the amount extraction in millisecond.
static constexpr base::TimeDelta kAmountExtractionWaitTime =
base::Milliseconds(150);
// This function attempts to convert a string representation of a monetary
// value in dollars into a uint64_t by parsing it as a double and multiplying
// the result by 1,000,000. It assumes the input uses a decimal point ('.') as
// the separator for fractional values (not a decimal comma). The function
// only supports English-style monetary representations like $, USD, etc.
// Multiplication by 1,000,000 is done to represent the monetary value in
// micro-units (1 dollar = 1,000,000 micro-units), which is commonly used in
// systems that require high precision for financial calculations.
static std::optional<uint64_t> MaybeParseAmountToMonetaryMicroUnits(
const std::string& amount);
// Returns the set of all eligible features that depend on amount extraction
// result when:
// Autofill is available in the given `SuggestionsContext`;
// Autofill provides non-empty, non-suppressed suggestions;
// The form being interacted with is a credit card form but not the CVC
// field of the credit card form;
// There is a feature that can use amount extraction on the current
// checkout page;
// Amount Extraction feature is enabled;
DenseSet<EligibleFeature> GetEligibleFeatures(
const SuggestionsContext& context,
bool should_suppress_suggestions,
bool has_suggestions,
FieldType field_type) const;
// Trigger the search for the final checkout amount from the DOM of the
// current page.
virtual void TriggerCheckoutAmountExtraction();
void SetSearchRequestPendingForTesting(bool search_request_pending);
bool GetSearchRequestPendingForTesting();
private:
friend class AmountExtractionManagerTest;
// Invoked after the amount extraction process completes.
// `extracted_amount` provides the extracted amount upon success and an
// empty string upon failure. `search_request_start_timestamp` is the time
// when TriggerCheckoutAmountExtraction is called.
virtual void OnCheckoutAmountReceived(
base::TimeTicks search_request_start_timestamp,
const std::string& extracted_amount);
// Checks whether the current amount search has reached the timeout or not.
// If so, cancel the ongoing search.
virtual void OnTimeoutReached();
// Checks eligibility of features depending on amount extraction result, and
// returns the eligible features.
DenseSet<EligibleFeature>
CheckEligibilityForFeaturesRequiringAmountExtraction() const;
// Gets the driver associated with the main frame as the final checkout
// amount is on the main frame.
AutofillDriver* GetMainFrameDriver();
// The owning BrowserAutofillManager.
raw_ref<BrowserAutofillManager> autofill_manager_;
// If true, the metrics for the amount extraction result was already logged
// and should not log again.
bool has_logged_amount_extraction_result_ = false;
// Indicates whether there is an amount search ongoing or not. If set, do not
// trigger the search. It gets reset to false once the search is done. This is
// to avoid re-triggering amount extraction multiple times during an ongoing
// search.
bool search_request_pending_ = false;
base::WeakPtrFactory<AmountExtractionManager> weak_ptr_factory_{this};
};
} // namespace autofill::payments
#endif // COMPONENTS_AUTOFILL_CORE_BROWSER_PAYMENTS_AMOUNT_EXTRACTION_MANAGER_H_
|
