// Copyright 2026 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_ENTERPRISE_BROWSER_REPORTING_PREF_URL_LIST_MATCHER_H_
#define COMPONENTS_ENTERPRISE_BROWSER_REPORTING_PREF_URL_LIST_MATCHER_H_

#include <memory>
#include <optional>
#include <string>
#include <vector>

#include "base/containers/flat_map.h"
#include "base/memory/raw_ptr.h"
#include "components/prefs/pref_change_registrar.h"
#include "components/prefs/pref_service.h"
#include "components/url_matcher/url_matcher.h"
#include "components/url_matcher/url_util.h"

class GURL;

namespace enterprise_reporting {

// Matches URLs against a list of patterns from a PrefService list.
//
// Pattern matching rules:
// - Patterns are strings from the PrefService list specified by `pref_name`.
// - Only the host and path components of the patterns are considered. Scheme,
//   port, and query components in the patterns are ignored.
// - Host matching includes subdomains. E.g., "example.com" matches
//   "a.example.com". To match only the exact domain, the pattern must start
//   with a dot, e.g. ".example.com".
// - Path matching is prefix-based. E.g., "example.com/foo" matches
//   "https://example.com/foo" and "https://example.com/foobar".
//
// Tie-breaking for multiple matches:
// 1. Exact host matches (.example.com) beat subdomain matches (example.com)
// 2. The pattern with the longest host string is chosen.
// 3. If host lengths are equal, the pattern with the longest path string is
// chosen.
// 4. If path lengths are equal, the pattern appearing LAST in the
//    pref list is chosen.
//
class PrefURLListMatcher {
 public:
  explicit PrefURLListMatcher(PrefService* pref_service, const char* pref_name);
  PrefURLListMatcher(const PrefURLListMatcher&) = delete;
  PrefURLListMatcher& operator=(const PrefURLListMatcher&) = delete;
  ~PrefURLListMatcher();

  void OnPrefUpdated();

  std::optional<std::string> GetMatchedURL(const GURL& url) const;

 private:
  raw_ptr<PrefService> pref_service_ = nullptr;
  const char* pref_name_ = nullptr;
  PrefChangeRegistrar pref_change_;

  std::unique_ptr<url_matcher::URLMatcher> url_matcher_;
  base::flat_map<base::MatcherStringPattern::ID,
                 url_matcher::util::FilterComponents>
      filters_;

  bool IsHigherPriority(base::MatcherStringPattern::ID lhs,
                        base::MatcherStringPattern::ID rhs) const;
};

}  // namespace enterprise_reporting

#endif  // COMPONENTS_ENTERPRISE_BROWSER_REPORTING_PREF_URL_LIST_MATCHER_H_