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
|
// 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>
CheckEligiblilityForFeaturesRequiringAmountExtraction() 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_;
// 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_
|
