components/commerce/core/product_specifications/product_specifications_set.h

// 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_COMMERCE_CORE_PRODUCT_SPECIFICATIONS_PRODUCT_SPECIFICATIONS_SET_H_
#define COMPONENTS_COMMERCE_CORE_PRODUCT_SPECIFICATIONS_PRODUCT_SPECIFICATIONS_SET_H_

#include <vector>

#include "base/observer_list_types.h"
#include "base/time/time.h"
#include "base/uuid.h"
#include "components/sync/protocol/compare_specifics.pb.h"
#include "url/gurl.h"

namespace commerce {

class ProductSpecificationsService;
class ProductSpecificationsSyncBridge;

// Contains a set of product specifications.
class ProductSpecificationsSet {
 public:
  class Observer : public base::CheckedObserver {
   public:
    virtual void OnProductSpecificationsSetAdded(
        const ProductSpecificationsSet& product_specifications_set) {}

    // Invoked when a ProductSpecificationsSet is updated and provides the
    // current and preious values.
    virtual void OnProductSpecificationsSetUpdate(
        const ProductSpecificationsSet& before,
        const ProductSpecificationsSet& after) {}

    virtual void OnProductSpecificationsSetRemoved(const base::Uuid& uuid) {}

   private:
    friend commerce::ProductSpecificationsSyncBridge;

    void OnProductSpecificationsSetRemoved(const std::string& uuid) {
      OnProductSpecificationsSetRemoved(base::Uuid::ParseLowercase(uuid));
    }
  };

  ProductSpecificationsSet(const std::string& uuid,
                           const int64_t creation_time_usec_since_epoch,
                           const int64_t update_time_usec_since_epoch,
                           const std::vector<GURL>& urls,
                           const std::string& name);

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

  ~ProductSpecificationsSet();

  // Unique identifier for the set
  const base::Uuid& uuid() const { return uuid_; }

  // Time the set was created
  const base::Time& creation_time() const { return creation_time_; }

  // Time the set was updated
  const base::Time& update_time() const { return update_time_; }

  // Product urls for each item in the set
  const std::vector<GURL>& urls() const { return urls_; }

  // Name of the set
  const std::string& name() const { return name_; }

 private:
  friend commerce::ProductSpecificationsService;
  friend commerce::ProductSpecificationsSyncBridge;

  static ProductSpecificationsSet FromProto(
      const sync_pb::CompareSpecifics& compare_specifics);

  const base::Uuid uuid_;
  const base::Time creation_time_;
  base::Time update_time_;
  std::vector<GURL> urls_;
  std::string name_;
};

}  // namespace commerce

#endif  // COMPONENTS_COMMERCE_CORE_PRODUCT_SPECIFICATIONS_PRODUCT_SPECIFICATIONS_SET_H_