/*
 *    Copyright (c) 2025, The OpenThread Authors.
 *    All rights reserved.
 *
 *    Redistribution and use in source and binary forms, with or without
 *    modification, are permitted provided that the following conditions are met:
 *    1. Redistributions of source code must retain the above copyright
 *       notice, this list of conditions and the following disclaimer.
 *    2. Redistributions in binary form must reproduce the above copyright
 *       notice, this list of conditions and the following disclaimer in the
 *       documentation and/or other materials provided with the distribution.
 *    3. Neither the name of the copyright holder nor the
 *       names of its contributors may be used to endorse or promote products
 *       derived from this software without specific prior written permission.
 *
 *    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 *    AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 *    IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 *    ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
 *    LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 *    CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 *    SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 *    INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 *    CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 *    ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 *    POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef TELEMETRY_RETRIEVER_BORDER_AGENT_HPP_
#define TELEMETRY_RETRIEVER_BORDER_AGENT_HPP_

#if OTBR_ENABLE_BORDER_AGENT

#include <utility>
#include <vector>

#include <cstdint>
#include <openthread/history_tracker.h>
#include <openthread/instance.h>

#include "proto/threadnetwork_atoms.pb.h"

namespace otbr {
namespace Android {
namespace TelemetryRetriever {

class BorderAgent
{
public:
    using BorderAgentInfo = ::android::os::statsd::threadnetwork::ThreadnetworkTelemetryDataReported::BorderAgentInfo;
    using BorderAgentEpskcJourneyInfo =
        ::android::os::statsd::threadnetwork::ThreadnetworkTelemetryDataReported::BorderAgentEpskcJourneyInfo;
    using EpskcDeactivatedReason =
        ::android::os::statsd::threadnetwork::ThreadnetworkTelemetryDataReported::EpskcDeactivatedReason;

    // constexpr definitions for EpskcDeactivatedReason
    static constexpr EpskcDeactivatedReason kEpskcDeactivatedReasonLocalClose =
        ::android::os::statsd::threadnetwork::ThreadnetworkTelemetryDataReported::EPSKC_DEACTIVATED_REASON_LOCAL_CLOSE;
    static constexpr EpskcDeactivatedReason kEpskcDeactivatedReasonRemoteClose =
        ::android::os::statsd::threadnetwork::ThreadnetworkTelemetryDataReported::EPSKC_DEACTIVATED_REASON_REMOTE_CLOSE;
    static constexpr EpskcDeactivatedReason kEpskcDeactivatedReasonSessionError = ::android::os::statsd::threadnetwork::
        ThreadnetworkTelemetryDataReported::EPSKC_DEACTIVATED_REASON_SESSION_ERROR;
    static constexpr EpskcDeactivatedReason kEpskcDeactivatedReasonSessionTimeout = ::android::os::statsd::
        threadnetwork::ThreadnetworkTelemetryDataReported::EPSKC_DEACTIVATED_REASON_SESSION_TIMEOUT;
    static constexpr EpskcDeactivatedReason kEpskcDeactivatedReasonMaxAttempts =
        ::android::os::statsd::threadnetwork::ThreadnetworkTelemetryDataReported::EPSKC_DEACTIVATED_REASON_MAX_ATTEMPTS;
    static constexpr EpskcDeactivatedReason kEpskcDeactivatedReasonEpskcTimeout = ::android::os::statsd::threadnetwork::
        ThreadnetworkTelemetryDataReported::EPSKC_DEACTIVATED_REASON_EPSKC_TIMEOUT;
    static constexpr EpskcDeactivatedReason kEpskcDeactivatedReasonUnknown =
        ::android::os::statsd::threadnetwork::ThreadnetworkTelemetryDataReported::EPSKC_DEACTIVATED_REASON_UNKNOWN;

    static BorderAgent &GetBorderAgent(otInstance *aInstance);

    void RetrieveEpskcJourneyInfo(BorderAgentInfo *aBorderAgentInfo);

private:
    explicit BorderAgent(otInstance *aInstance);

    bool IsEpskcDeactivationEvent(const otHistoryTrackerBorderAgentEpskcEvent &aEvent);
    std::vector<std::pair<otHistoryTrackerBorderAgentEpskcEvent, uint32_t>> GetUnretrievedEpskcEvents(void);

    otInstance *mInstance;
    uint32_t    mEpskcLastRetrievedTimestamp;
};

} // namespace TelemetryRetriever
} // namespace Android
} // namespace otbr

#endif // OTBR_ENABLE_BORDER_AGENT

#endif // TELEMETRY_RETRIEVER_BORDER_AGENT_HPP_