pairing.hpp

Go to the documentation of this file.

// (C) Copyright 2025, SECO Mind Srl
//
// SPDX-License-Identifier: Apache-2.0
 
#ifndef ASTARTE_MQTT_PAIRING_H
#define ASTARTE_MQTT_PAIRING_H

 
#include <ada.h>
 
#include <chrono>
#include <format>
#include <string>
#include <string_view>
#include <tuple>
 
#include "astarte_device_sdk/mqtt/errors.hpp"
 
namespace astarte::device::mqtt {

using namespace std::chrono_literals;

class PairingApi {
 public:
  static auto create(std::string_view realm, std::string_view device_id,
                     std::string_view astarte_base_url) -> astarte_tl::expected<PairingApi, Error>;

  [[nodiscard]] auto register_device(std::string_view pairing_token,
                                     std::chrono::milliseconds timeout_ms = 0ms) const
      -> astarte_tl::expected<std::string, Error>;

  [[nodiscard]] auto get_broker_url(std::string_view credential_secret, int timeout_ms = 0) const
      -> astarte_tl::expected<std::string, Error>;

  [[nodiscard]] auto get_device_key_and_certificate(std::string_view credential_secret,
                                                    int timeout_ms = 0) const
      -> astarte_tl::expected<std::tuple<std::string, std::string>, Error>;

  [[nodiscard]] auto device_cert_valid(std::string_view certificate,
                                       std::string_view credential_secret, int timeout_ms = 0) const
      -> astarte_tl::expected<bool, Error>;
 
 private:
  PairingApi(std::string_view realm, std::string_view device_id, ada::url_aggregator pairing_url);

  std::string realm_;
  std::string device_id_;
  ada::url_aggregator pairing_url_;
};

auto create_random_device_id() -> std::string;

auto create_deterministic_device_id(std::string_view namespc, std::string_view unique_data)
    -> astarte_tl::expected<std::string, Error>;
 
}  // namespace astarte::device::mqtt
 
#endif  // ASTARTE_MQTT_PAIRING_H