sword 0.2.1

mod adapter;
mod error;
mod extract;
mod interceptor;

use std::any::{Any, TypeId};
use std::pin::Pin;
use std::sync::Arc;
use sword_core::State;

pub use adapter::*;
pub use error::*;
pub use extract::*;
pub use interceptor::*;

#[derive(Clone, Debug)]
pub enum SocketEventKind {
    Connection,
    Disconnection,
    Message(&'static str),
    Fallback,
}

type SocketCallFn = fn(
    Arc<dyn Any + Send + Sync>,
    SocketContext,
) -> Pin<Box<dyn Future<Output = ()> + Send>>;

/// Metadata for a SocketIO event handler registered via the `#[on]` attribute.
///
/// This struct is used internally by Sword's auto-registration system to:
/// 1. Discover handlers at compile-time via the `inventory` crate
/// 2. Register them on the appropriate socket at runtime
#[derive(Clone)]
pub struct HandlerRegistrar {
    /// TypeId of the adapter for filtering during registration
    pub adapter_type_id: TypeId,

    /// Namespace of this adapter (e.g., "/chat")
    pub namespace: &'static str,

    /// Kind of event this handler responds to
    pub event_kind: SocketEventKind,

    /// Name of the handler method
    pub method_name: &'static str,

    /// Registers the handler on the socket (used for Message/Disconnection/Fallback events).
    pub register_fn: fn(Arc<dyn Any + Send + Sync>, SocketRef),

    /// Executes the handler directly (used for Connection events).
    pub call_fn: SocketCallFn,
}

/// Setup function that initializes a SocketIO adapter at runtime.
pub struct SocketIoHandlerRegistrar {
    pub handler_type_id: TypeId,
    pub handler_type_name: &'static str,

    pub setup_fn: fn(&State),
}

inventory::collect!(HandlerRegistrar);
inventory::collect!(SocketIoHandlerRegistrar);