chore(deps): remove useless dashmap dep and improve doc

socketioxide/Cargo.toml

@@ -29,9 +29,6 @@ itoa.workspace = true
 hyper.workspace = true
 pin-project-lite.workspace = true
 
-# Extensions
-dashmap = { version = "5.4.0", optional = true }
-
 # Tracing
 tracing = { workspace = true, optional = true }
 
@@ -41,7 +38,7 @@ state = { version = "0.6.0", optional = true }
 [features]
 v4 = ["engineioxide/v3"]
 tracing = ["dep:tracing", "engineioxide/tracing"]
-extensions = ["dep:dashmap"]
+extensions = []
 state = ["dep:state"]
 
 [dev-dependencies]

socketioxide/src/extensions.rs

@@ -21,7 +21,7 @@ use std::{
 /// TypeMap value
 type AnyVal = Box<dyn Any + Send + Sync>;
 
-/// The `AnyDashMap` is a `HashMap` that uses `TypeId` as keys and `Any` as values.
+/// The [`AnyHashMap`] is a [`HashMap`] that uses `TypeId` as keys and `Any` as values.
 type AnyHashMap = RwLock<HashMap<TypeId, AnyVal, BuildHasherDefault<IdHasher>>>;
 
 // With TypeIds as keys, there's no need to hash them. They are already hashes

socketioxide/src/lib.rs

@@ -247,8 +247,9 @@
 //!
 //! #### Per socket state
 //! You can enable the `extensions` feature and use the [`extensions`](socket::Socket::extensions) field on any socket to manage
-//! the state of each socket. It is backed by a [`dashmap`] so you can safely access it from multiple threads.
-//! Beware that deadlocks can easily occur if you hold a value ref and try to remove it at the same time.
+//! the state of each socket. It is backed by a [`RwLock<HashMap>>`](std::sync::RwLock) so you can safely access it
+//! from multiple threads. However, the value must be [`Clone`] and `'static`.
+//! When calling get, or using the [`Extension`](extract::Extension) extractor, the value will always be cloned.
 //! See the [`extensions`] module doc for more details.
 //!
 //! #### Global state

socketioxide/src/socket.rs

@@ -140,9 +140,9 @@ pub struct Socket<A: Adapter = LocalAdapter> {
 
     /// A type map of protocol extensions.
     /// It can be used to share data through the lifetime of the socket.
-    /// Because it uses a [`DashMap`](dashmap::DashMap) internally, it is thread safe but be careful about deadlocks!
     ///
     /// **Note**: This is note the same data than the `extensions` field on the [`http::Request::extensions()`](http::Request) struct.
+    /// If you want to extract extensions from the http request, you should use the [`HttpExtension`](crate::extract::HttpExtension) extractor.
     #[cfg_attr(docsrs, doc(cfg(feature = "extensions")))]
     #[cfg(feature = "extensions")]
     pub extensions: Extensions,