public:

enum class HangingGetResult {

SUCCESS,

FAIL,

TIMEOUT

};

virtual ~Bridge() { }

// HubClient initialization. "jni" is not stored beyond the "Bind" call,

// but "class_path_lookup" is used throughout the lifetime of this class.

// The caller is responsible for "class_path_lookup" lifetime. "Bind" will

// always fail if called after "Shutdown".

virtual bool Bind(ClassPathLookup* class_path_lookup) = 0;

// Attempts to shutdown all pending requests to the Cloud Debugger backend.

virtual void Shutdown() = 0;

// Registers the debuggee with the controller. Returns true if the request

// was successful. When registration succeeds "is_enabled" will usually be

// set to true (unless the Hub remotely disables the debuglet).

virtual bool RegisterDebuggee(bool* is_enabled) = 0;

// Queries for the list of currently active breakpoints. Returns false if the

// network call failed.

virtual HangingGetResult ListActiveBreakpoints(

std::vector<std::unique_ptr<BreakpointModel>>* breakpoints) = 0;

// Enqueues the next breakpoint update for transmission to the Hub service.

virtual void EnqueueBreakpointUpdate(

std::unique_ptr<BreakpointModel> breakpoint) = 0;

// Attempts transmission of pending breakpoints. "HasPendingMessages"

// can be used to check whether all pending messages have been sent

// successfully.

virtual void TransmitBreakpointUpdates() = 0;

// Checks whether there are still pending messages to be transmitted to the

// Hub service.

virtual bool HasPendingMessages() const = 0;

// Notifies the backend that a canary agent enabled the breakpoint.

virtual bool RegisterBreakpointCanary(const string& breakpoint_id) = 0;

// Approves the breakpoint for a global rollout.

virtual bool ApproveBreakpointCanary(const string& breakpoint_id) = 0;