chromium/third_party/blink/public/common/interest_group/ad_auction_currencies.h

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

#ifndef THIRD_PARTY_BLINK_PUBLIC_COMMON_INTEREST_GROUP_AD_AUCTION_CURRENCIES_H_
#define THIRD_PARTY_BLINK_PUBLIC_COMMON_INTEREST_GROUP_AD_AUCTION_CURRENCIES_H_

#include <optional>
#include <string>

#include "base/check.h"
#include "third_party/blink/public/common/common_export.h"

namespace blink {

// True if the currency code is in format FLEDGE expects.
// Does not accept kUnspecifiedAdCurrency.
BLINK_COMMON_EXPORT bool IsValidAdCurrencyCode(const std::string& input);

// A wrapper type for currency codes used in FLEDGE auctions.
class BLINK_COMMON_EXPORT AdCurrency { … };

// Returns true if `actual` currency should be accepted under expectation
// `expected; this can happen if they match or if any of them is unspecified.
BLINK_COMMON_EXPORT bool VerifyAdCurrencyCode(
    const std::optional<AdCurrency>& expected,
    const std::optional<AdCurrency>& actual);

// Magical value to denote that a party in the auction didn't specify
// currency value or expectation.  It can't be provided directly, but it's meant
// to be human-readable.
BLINK_COMMON_EXPORT extern const char* const kUnspecifiedAdCurrency;

// Converts a maybe-unspecified ad currency into a form suitable for JS strings
// or error messages --- e.g. unspecified value gets expanded out to
// kUnspecifiedAdCurrency for readability.
BLINK_COMMON_EXPORT std::string PrintableAdCurrency(
    const std::optional<AdCurrency>& currency);

}  // namespace blink

#endif  // THIRD_PARTY_BLINK_PUBLIC_COMMON_INTEREST_GROUP_AD_AUCTION_CURRENCIES_H_