// Copyright 2017 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef SERVICES_PREFERENCES_PUBLIC_CPP_SCOPED_PREF_UPDATE_H_
#define SERVICES_PREFERENCES_PUBLIC_CPP_SCOPED_PREF_UPDATE_H_

#include <memory>
#include <set>
#include <string>
#include <string_view>
#include <vector>

#include "base/memory/raw_ptr.h"

class PrefService;

namespace prefs {

class DictionaryValueUpdate;

// An update to a dictionary value pref.
//
// For example:
//   prefs::ScopedDictionaryPrefUpdate update(pref_service(), kPrefKey);
//   int next_id = 0;
//   update->GetInteger("next_id", &next_id);
//
//   std::unique_ptr<prefs::DictionaryValueUpdate> nested_dictionary;
//   if (!update->GetDictionaryWithoutPathExpansion(url.spec(),
//                                                  &nested_dictionary)) {
//     nested_dictionary = update->SetDictionaryWithoutPathExpansion(
//         url.spec(), std::make_unique<base::DictionaryValue>());
//   }
//
//   nested_dictionary->Set("metadata", std::move(metadata));
//   nested_dictionary->SetInteger("id", next_id++);
//   update->SetInteger("next_id", next_id);
//
class ScopedDictionaryPrefUpdate {
 public:
  ScopedDictionaryPrefUpdate(PrefService* service, std::string_view path);

  ScopedDictionaryPrefUpdate(const ScopedDictionaryPrefUpdate&) = delete;
  ScopedDictionaryPrefUpdate& operator=(const ScopedDictionaryPrefUpdate&) =
      delete;

  // Notifies if necessary.
  virtual ~ScopedDictionaryPrefUpdate();

  // The caller should not keep the returned object or any further objects
  // obtained from it around for any longer than the lifetime of the
  // ScopedDictionaryPrefUpdate.
  virtual std::unique_ptr<DictionaryValueUpdate> Get();

  // The caller should not keep the returned object or any further objects
  // obtained from it around for any longer than the lifetime of the
  // ScopedDictionaryPrefUpdate.
  std::unique_ptr<DictionaryValueUpdate> operator->();

 private:
  void RecordPath(std::vector<std::string> path);

  // Weak pointer.
  // `service_` uses UnprotectedInRelease | DanglingUntriaged for performance
  // reasons (based on analysis of sampling profiler data).
  const raw_ptr<PrefService, UnprotectedInRelease | DanglingUntriaged> service_;
  // Path of the preference being updated.
  const std::string path_;

  // The paths that have been modified.
  std::set<std::vector<std::string>> updated_paths_;
};

}  // namespace prefs

#endif  // SERVICES_PREFERENCES_PUBLIC_CPP_SCOPED_PREF_UPDATE_H_