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
|
// 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_USER_DATA_IMPORTER_UTILITY_SAFARI_DATA_IMPORT_CLIENT_H_
#define COMPONENTS_USER_DATA_IMPORTER_UTILITY_SAFARI_DATA_IMPORT_CLIENT_H_
#include "base/memory/weak_ptr.h"
#include "base/types/expected.h"
#include "components/password_manager/core/browser/import/import_results.h"
namespace user_data_importer {
enum class ImportPreparationError {
// The import of this data type is blocked by enterprise policy.
kBlockedByPolicy,
};
using CountOrError = base::expected<size_t, ImportPreparationError>;
// Interface for clients (e.g., UIs) which use the SafariDataImporter to
// import user data from Safari.
class SafariDataImportClient {
public:
virtual ~SafariDataImportClient() = default;
// Phase one: parsing data
// Triggered when the import fails entirely, e.g., due to an invalid file.
virtual void OnTotalFailure() = 0;
// Invoked when the number of bookmarks in the input file has been determined.
virtual void OnBookmarksReady(CountOrError result) = 0;
// Invoked when the number of history items in the input file has been
// determined. Unlike other data types, this is an estimate and not an exact
// count. An input file may contain one history file per Safari profile; the
// names of these profiles are passed in `profiles`.
virtual void OnHistoryReady(CountOrError estimated_count) = 0;
// Invoked when the number of passwords in the input file has been determined.
// The results object provides detailed information about passwords with a
// conflict (i.e., those where the user already has a
// different saved password for the same username/URL); the Client must use
// this information to resolve conflicts and continue the import flow.
virtual void OnPasswordsReady(
base::expected<password_manager::ImportResults, ImportPreparationError>
results) = 0;
// Invoked when the number of payment cards in the input file has been
// determined.
virtual void OnPaymentCardsReady(CountOrError result) = 0;
// Phase two: executing import
// Invoked when importing of bookmarks has completed. `count` is the number
// which were successfully imported.
virtual void OnBookmarksImported(size_t count) = 0;
// Invoked when importing of history has completed. `count` is the number of
// entries which were successfully imported.
virtual void OnHistoryImported(size_t count) = 0;
// Invoked when importing of passwords has completed. The results object
// includes detailed information about any errors that were encountered (such
// as a password which did not have a valid URL), which can be used to surface
// a UI with additional details.
virtual void OnPasswordsImported(const password_manager::ImportResults&) = 0;
// Invoked when importing of payment cards has completed. `count` is the
// number which were successfully imported.
virtual void OnPaymentCardsImported(size_t count) = 0;
// Additional required behaviors
// Implementers should hold their own WeakPtrFactory and implement this
// method to vend weak pointers to `self`.
virtual base::WeakPtr<SafariDataImportClient> AsWeakPtr() = 0;
};
} // namespace user_data_importer
#endif // COMPONENTS_USER_DATA_IMPORTER_UTILITY_SAFARI_DATA_IMPORT_CLIENT_H_
|
