tls_stream.h

Go to the documentation of this file.

// Copyright 2026 The Symbian SDK Authors.
// Licensed under the Apache License, Version 2.0.
 
#ifndef SYMBIAN_API_CONNECTIVITY_TLS_STREAM_H_
#define SYMBIAN_API_CONNECTIVITY_TLS_STREAM_H_
 
#include <cstddef>
#include <cstdint>
#include <span>
#include <string_view>
 
#include "absl/status/status.h"
#include "absl/status/statusor.h"
#include "absl/time/time.h"
#include "symbian/api/connectivity/tcp_client.h"
#include "symbian/net/byte_stream.h"
 
namespace symbian::api::connectivity {
 
enum class TlsVersion { kTls12, kTls13 };
 
class TlsStream : public net::ByteStream {
 public:
  static absl::StatusOr<TlsStream> Create(std::string_view server_certificate,
                                          std::string_view server_private_key,
                                          std::string_view client_ca_bundle,
                                          TlsVersion version);
 
  TlsStream(TlsStream&& other) noexcept;
  TlsStream& operator=(TlsStream&& other) noexcept;
  TlsStream(const TlsStream&) = delete;
  TlsStream& operator=(const TlsStream&) = delete;
  ~TlsStream();
 
  static absl::StatusOr<TlsStream> Connect(
      TcpClient client, std::string_view hostname, std::string_view ca_bundle,
      TlsVersion version, std::string_view alpn = "http/1.1",
      absl::Time deadline = absl::InfiniteFuture());
  absl::Status SetAlpnProtocol(std::string_view protocol);
  std::string_view negotiated_version() const;
  std::string_view negotiated_protocol() const;
 
  void Close() override { CloseSession(); }
 
  absl::Status Accept(TcpClient&& client,
                      absl::Time deadline = absl::InfiniteFuture());
 
  absl::StatusOr<std::size_t> Read(
      std::span<std::uint8_t> bytes,
      absl::Time deadline = absl::InfiniteFuture()) override;
 
  absl::Status Write(std::span<const std::uint8_t> bytes,
                     absl::Time deadline = absl::InfiniteFuture()) override;
 
  void CloseSession();
 
  bool connected() const;
 
 private:
  struct Impl;
 
  static absl::StatusOr<TlsStream> Initialize(bool server, TlsVersion version);
  absl::Status Handshake(absl::Time deadline);
 
  explicit TlsStream(Impl* impl) : impl_(impl) {}
 
  Impl* impl_ = nullptr;
};
 
}  // namespace symbian::api::connectivity
 
#endif  // SYMBIAN_API_CONNECTIVITY_TLS_STREAM_H_