quiche/blind_sign_auth/blind_sign_message_interface.h

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

#ifndef QUICHE_BLIND_SIGN_AUTH_BLIND_SIGN_MESSAGE_INTERFACE_H_
#define QUICHE_BLIND_SIGN_AUTH_BLIND_SIGN_MESSAGE_INTERFACE_H_

#include <optional>
#include <string>

#include "absl/status/statusor.h"
#include "absl/strings/string_view.h"
#include "quiche/blind_sign_auth/blind_sign_message_response.h"
#include "quiche/common/platform/api/quiche_export.h"
#include "quiche/common/quiche_callbacks.h"

namespace quiche {

using BlindSignMessageCallback =
    quiche::SingleUseCallback<void(absl::StatusOr<BlindSignMessageResponse>)>;

enum class BlindSignMessageRequestType {
  kUnknown = 0,
  kGetInitialData,
  kAuthAndSign,
};

// Interface for async requests in BlindSignAuth. Implementers must send a
// request and call the provided callback when the request is complete.
class QUICHE_EXPORT BlindSignMessageInterface {
 public:
  virtual ~BlindSignMessageInterface() = default;
  // Errors must set status_code and body in BlindSignMessageResponse.
  // DoRequest must either be a HTTP POST or an IPC request.
  // Requests do not need cookies and must follow redirects.
  // The implementer must set Content-Type and Accept headers to
  // "application/x-protobuf".
  // DoRequest is async. When the request completes, the implementer must call
  // the provided callback.
  virtual void DoRequest(BlindSignMessageRequestType request_type,
                         std::optional<absl::string_view> authorization_header,
                         const std::string& body,
                         BlindSignMessageCallback callback) = 0;
};

}  // namespace quiche

#endif  // QUICHE_BLIND_SIGN_AUTH_BLIND_SIGN_MESSAGE_INTERFACE_H_