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
|
// 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 COMPONENTS_PLUS_ADDRESSES_PLUS_ADDRESS_ALLOCATOR_H_
#define COMPONENTS_PLUS_ADDRESSES_PLUS_ADDRESS_ALLOCATOR_H_
#include <optional>
#include "components/plus_addresses/plus_address_types.h"
namespace url {
class Origin;
} // namespace url
namespace plus_addresses {
// An interface for plus address allocation. Implementers may pursue different
// strategies for plus address allocation, e.g. allocation on the fly or
// pre-allocation.
class PlusAddressAllocator {
public:
virtual ~PlusAddressAllocator() = default;
// The maximum number of times that a user can choose to refresh the suggested
// plus address for a domain. The limit need not be persisted to disk and,
// thus, may only be enforced for the lifetime of the browser.
static constexpr int kMaxPlusAddressRefreshesPerOrigin = 10;
enum class AllocationMode {
// The requested plus address should be the first one that's available for
// use.
kAny = 0,
// The requested plus address should be the next one in the preallocation
// queue.
kNewPlusAddress = 1
};
// Attempts to allocate a plus address for `origin`.
virtual void AllocatePlusAddress(const url::Origin& origin,
AllocationMode mode,
PlusAddressRequestCallback callback) = 0;
// Attempts to allocate a plus address for `origin` synchronously. If none is
// available synchronously, it returns `std::nullopt` and does no further
// work.
virtual std::optional<PlusProfile> AllocatePlusAddressSynchronously(
const url::Origin& origin,
AllocationMode mode) = 0;
// Returns whether a plus address for `origin` may be refreshed.
virtual bool IsRefreshingSupported(const url::Origin& origin) const = 0;
// Removes `plus_address` from the allocation pool. Depending on the
// implementation, this may be a no-op.
virtual void RemoveAllocatedPlusAddress(const PlusAddress& plus_address) = 0;
};
} // namespace plus_addresses
#endif // COMPONENTS_PLUS_ADDRESSES_PLUS_ADDRESS_ALLOCATOR_H_
|
