diagnostics/diag/diag_async_grpc_client_adapter.h

// Copyright 2019 The Chromium OS 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 DIAGNOSTICS_DIAG_DIAG_ASYNC_GRPC_CLIENT_ADAPTER_H_
#define DIAGNOSTICS_DIAG_DIAG_ASYNC_GRPC_CLIENT_ADAPTER_H_

#include <memory>
#include <string>

#include <base/callback.h>

#include "wilco_dtc_supportd.grpc.pb.h"  // NOLINT(build/include)

namespace diagnostics {

// Provides an interface for connecting to and communicating
// with the wilco_dtc_supportd daemon.
class DiagAsyncGrpcClientAdapter {
 public:
  virtual ~DiagAsyncGrpcClientAdapter() = default;

  // Whether or not the DiagAsyncGrpcClientAdapter is currently
  // connected to the wilco_dtc_supportd daemon.
  virtual bool IsConnected() const = 0;

  // Connects to the wilco_dtc_supportd daemon. This method should
  // only be called a single time. The resulting connection
  // lasts for the lifetime of the DiagAsyncGrpcClientAdapter.
  virtual void Connect(const std::string& target_uri) = 0;

  // Gracefully shutdown the connection to the wilco_dtc_supportd
  // daemon.
  virtual void Shutdown(const base::Closure& on_shutdown) = 0;

  // Retrieve a list of routines that the platform supports.
  virtual void GetAvailableRoutines(
      const grpc_api::GetAvailableRoutinesRequest& request,
      base::Callback<void(
          std::unique_ptr<grpc_api::GetAvailableRoutinesResponse> response)>
          callback) = 0;

  // Request that a particular diagnostic routine be run on the platform.
  virtual void RunRoutine(
      const grpc_api::RunRoutineRequest& request,
      base::Callback<void(std::unique_ptr<grpc_api::RunRoutineResponse>)>
          callback) = 0;

  // Get the status of an existing diagnostic routine, or send a command to an
  // existing diagnostic routine.
  virtual void GetRoutineUpdate(
      const grpc_api::GetRoutineUpdateRequest& request,
      base::Callback<void(std::unique_ptr<grpc_api::GetRoutineUpdateResponse>)>
          callback) = 0;
};

}  // namespace diagnostics

#endif  // DIAGNOSTICS_DIAG_DIAG_ASYNC_GRPC_CLIENT_ADAPTER_H_