fix: replace unwrap/expect in production paths with fallible alternatives

crates/quicproquo-client/src/lib.rs

@@ -67,18 +67,33 @@ impl ClientContext {
     }
 
     /// Set (or replace) the auth credentials.
+    ///
+    /// # Panics
+    /// Panics if the RwLock is poisoned (a thread panicked while holding it).
+    /// A poisoned lock indicates unrecoverable state corruption.
+    #[allow(clippy::expect_used)]
     pub fn set_auth(&self, ctx: ClientAuth) {
         let mut guard = self.auth.write().expect("ClientContext auth lock poisoned");
         *guard = Some(ctx);
     }
 
     /// Read the current auth snapshot (cloned).
+    ///
+    /// # Panics
+    /// Panics if the RwLock is poisoned (a thread panicked while holding it).
+    /// A poisoned lock indicates unrecoverable state corruption.
+    #[allow(clippy::expect_used)]
     pub fn get_auth(&self) -> Option<ClientAuth> {
         let guard = self.auth.read().expect("ClientContext auth lock poisoned");
         guard.clone()
     }
 
     /// Returns true if auth credentials have been set.
+    ///
+    /// # Panics
+    /// Panics if the RwLock is poisoned (a thread panicked while holding it).
+    /// A poisoned lock indicates unrecoverable state corruption.
+    #[allow(clippy::expect_used)]
     pub fn is_authenticated(&self) -> bool {
         let guard = self.auth.read().expect("ClientContext auth lock poisoned");
         guard.is_some()
@@ -151,6 +166,11 @@ impl ClientAuth {
 }
 
 /// Set (or replace) the global auth context.
+///
+/// # Panics
+/// Panics if the RwLock is poisoned (a thread panicked while holding it).
+/// A poisoned lock indicates unrecoverable state corruption.
+#[allow(clippy::expect_used)]
 pub fn init_auth(ctx: ClientAuth) {
     let mut guard = AUTH_CONTEXT.write().expect("AUTH_CONTEXT poisoned");
     *guard = Some(ctx);