qinterface 0.6.0

use std::{
    net::SocketAddr,
    sync::{Arc, OnceLock, Weak},
    task::{Context, Poll},
};

use dashmap::DashMap;
use qbase::{
    cid::{ConnectionId, GenUniqueCid, RetireCid},
    error::Error,
    frame::{
        NewConnectionIdFrame, RetireConnectionIdFrame,
        io::{ReceiveFrame, SendFrame},
    },
    net::route::{Link, Pathway},
    packet::GetDcid,
};

use crate::{BindUri, Interface, component::Component};
mod handler;
mod packet;
mod queue;
pub type Way = (BindUri, Pathway, Link);

pub use handler::PacketHandler;
pub use packet::{CipherPacket, PlainPacket};
pub use qbase::packet::Packet;
pub use queue::RcvdPacketQueue;

#[derive(Debug)]
pub struct QuicRouter {
    table: DashMap<Signpost, Arc<RcvdPacketQueue>>,
    on_unrouted: handler::PacketHandler<Packet>,
}

impl QuicRouter {
    pub fn global() -> &'static Arc<Self> {
        static GLOBAL_ROUTER: OnceLock<Arc<QuicRouter>> = OnceLock::new();
        GLOBAL_ROUTER.get_or_init(|| {
            Arc::new(QuicRouter {
                table: DashMap::new(),
                on_unrouted: handler::PacketHandler::drain(),
            })
        })
    }

    pub fn new() -> Self {
        QuicRouter {
            table: DashMap::new(),
            on_unrouted: handler::PacketHandler::drain(),
        }
    }

    // for origin_dcid
    pub fn insert(
        self: &Arc<Self>,
        signpost: Signpost,
        queue: Arc<RcvdPacketQueue>,
    ) -> QuicRouterEntry {
        self.table.insert(signpost, queue.clone());
        QuicRouterEntry {
            signpost,
            queue: Arc::downgrade(&queue),
            router: self.clone(),
        }
    }

    pub fn remove(&self, signpost: &Signpost) {
        self.table.remove(signpost);
    }

    fn find_entry(&self, packet: &Packet, link: &Link) -> Option<Arc<RcvdPacketQueue>> {
        let dcid = match packet {
            Packet::VN(vn) => vn.dcid(),
            Packet::Retry(retry) => retry.dcid(),
            Packet::Data(data_packet) => data_packet.dcid(),
        };

        if !dcid.is_empty() {
            let signpost = Signpost::from(*dcid);
            self.table.get(&signpost).map(|queue| queue.clone())
        } else {
            let signpost = Signpost::from(link.dst);
            self.table.get(&signpost).map(|queue| queue.clone())
        }
    }

    #[allow(clippy::result_large_err)]
    pub async fn try_deliver(&self, packet: Packet, way: Way) -> Result<(), (Packet, Way)> {
        match self.find_entry(&packet, &way.2) {
            Some(rcvd_pkt_q) => {
                rcvd_pkt_q.deliver(packet, way).await;
                Ok(())
            }
            None => Err((packet, way)),
        }
    }

    pub async fn deliver(&self, packet: Packet, way: Way) {
        let rcvd_pkt_q = match self.find_entry(&packet, &way.2) {
            Some(rcvd_pkt_q) => rcvd_pkt_q,
            None => {
                // For packets that cannot be routed, this likely indicates a new connection.
                // In some cases, multiple threads (e.g., A and B) may be waiting for the lock,
                // and both would cause the server to create separate new connections.
                let mut on_unrouted = self.on_unrouted.lock();
                let Some(on_unrouted) = on_unrouted.as_mut() else {
                    // Drain mode, just drop the packet
                    return;
                };
                // Therefore, we retry routing here to allow thread B to route its packet
                // to the connection created by thread A, instead of creating another new connection.
                match self.find_entry(&packet, &way.2) {
                    Some(rcvd_pkt_q) => rcvd_pkt_q,
                    None => {
                        (on_unrouted)(packet, way);
                        return;
                    }
                }
            }
        };
        rcvd_pkt_q.deliver(packet, way).await;
    }

    pub fn on_connectless_packets<S>(&self, sink: S) -> bool
    where
        S: Fn(Packet, Way) + Send + 'static,
    {
        let mut on_unrouted = self.on_unrouted.lock();
        if on_unrouted.is_some() {
            return false;
        }
        *on_unrouted = Some(Box::new(sink));
        true
    }

    pub fn is_connectless_draining(&self) -> bool {
        self.on_unrouted.is_drain()
    }

    pub fn drain_connectless(&self) {
        self.on_unrouted.take();
    }

    pub fn registry_on_issuing_scid<T>(
        self: &Arc<Self>,
        rcvd_pkts_q: Arc<RcvdPacketQueue>,
        issued_cids: T,
    ) -> QuicRouterRegistry<T> {
        QuicRouterRegistry {
            router: self.clone(),
            rcvd_pkts_q,
            issued_cids,
        }
    }
}

impl Default for QuicRouter {
    fn default() -> Self {
        Self::new()
    }
}

#[derive(Debug, PartialEq, Clone, Copy, Eq, Hash)]
pub struct Signpost {
    cid: ConnectionId,
    peer: Option<SocketAddr>,
}

impl From<ConnectionId> for Signpost {
    fn from(value: ConnectionId) -> Self {
        Self {
            cid: value,
            peer: None,
        }
    }
}

impl From<SocketAddr> for Signpost {
    fn from(value: SocketAddr) -> Self {
        Self {
            cid: ConnectionId::default(),
            peer: Some(value),
        }
    }
}

#[must_use = "When RouterEntry dropped, this will remove the entry from the router table"]
pub struct QuicRouterEntry {
    signpost: Signpost,
    queue: Weak<RcvdPacketQueue>,
    router: Arc<QuicRouter>,
}

impl QuicRouterEntry {
    pub fn signpost(&self) -> Signpost {
        self.signpost
    }

    pub fn remove(&self) {
        self.router
            .table
            .remove_if(&self.signpost, |_, exist_queue| {
                Weak::ptr_eq(&Arc::downgrade(exist_queue), &self.queue)
            });
    }
}

impl Drop for QuicRouterEntry {
    fn drop(&mut self) {
        self.remove();
    }
}

#[derive(Clone)]
pub struct QuicRouterRegistry<TX> {
    router: Arc<QuicRouter>,
    rcvd_pkts_q: Arc<RcvdPacketQueue>,
    issued_cids: TX,
}

impl<T> GenUniqueCid for QuicRouterRegistry<T>
where
    T: Send + Sync + 'static,
{
    fn gen_unique_cid(&self) -> ConnectionId {
        core::iter::from_fn(|| Some(ConnectionId::random_gen_with_mark(8, 0x80, 0x7F)))
            .find(|cid| {
                let signpost = Signpost::from(*cid);
                let entry = self.router.table.entry(signpost);

                if matches!(entry, dashmap::Entry::Occupied(..)) {
                    return false;
                }

                entry.insert(self.rcvd_pkts_q.clone());
                true
            })
            .unwrap()
    }
}

impl<TX> RetireCid for QuicRouterRegistry<TX>
where
    TX: Send + Sync + 'static,
{
    fn retire_cid(&self, cid: ConnectionId) {
        self.router.remove(&Signpost::from(cid));
    }
}

impl<TX> SendFrame<NewConnectionIdFrame> for QuicRouterRegistry<TX>
where
    TX: SendFrame<NewConnectionIdFrame>,
{
    fn send_frame<I: IntoIterator<Item = NewConnectionIdFrame>>(&self, iter: I) {
        self.issued_cids.send_frame(iter);
    }
}

impl<RX> ReceiveFrame<RetireConnectionIdFrame> for QuicRouterRegistry<RX>
where
    RX: ReceiveFrame<RetireConnectionIdFrame, Output = ()>,
{
    type Output = ();

    fn recv_frame(&self, frame: RetireConnectionIdFrame) -> Result<Self::Output, Error> {
        self.issued_cids.recv_frame(frame)
    }
}

#[derive(Debug, Clone)]
pub struct QuicRouterComponent {
    router: Arc<QuicRouter>,
}

impl QuicRouterComponent {
    pub fn new(router: Arc<QuicRouter>) -> Self {
        Self { router }
    }

    pub fn router(&self) -> Arc<QuicRouter> {
        self.router.clone()
    }
}

impl Component for QuicRouterComponent {
    fn reinit(&self, _quic_iface: &Interface) {}

    fn poll_shutdown(&self, cx: &mut Context<'_>) -> Poll<()> {
        _ = cx;
        Poll::Ready(())
    }
}