Expose find_producer functions

Author: kzhdev

CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file.
 
+## [Unreleased]
+
+### Changed
+- Expose `find_producer()` functions
+- Added Doxygen documentation for the `find_producer()` overloads.
+
 ## [1.0.1] - 2026-06-17
 
 - Renamed canonical header from slick/stream_buffer_multiplexer.h to slick/stream_buffer_multiplexer.hpp. The old .h path is kept as a backward-compatibility shim that re-exports the new header and emits a compiler warning directing users to update their includes.

include/slick/stream_buffer_multiplexer.hpp

@@ -265,6 +265,28 @@ class stream_buffer_multiplexer {
         return shared_queue_->initial_reading_index();
     }
 
+    /**
+     * @brief Find a registered producer by id.
+     * @param producer_id Producer id to look up.
+     * @return Non-owning pointer to the producer, or nullptr if producer_id is unregistered.
+     */
+    producer_buffer* find_producer(uint32_t producer_id) noexcept {
+        return const_cast<producer_buffer*>(std::as_const(*this).find_producer(producer_id));
+    }
+
+    /**
+     * @brief Find a registered producer by id.
+     * @param producer_id Producer id to look up.
+     * @return Non-owning pointer to the producer, or nullptr if producer_id is unregistered.
+     */
+    const producer_buffer* find_producer(uint32_t producer_id) const noexcept {
+        if (producer_id < dense_producers_.size()) {
+            return dense_producers_[producer_id];
+        }
+        auto it = producers_.find(producer_id);
+        return it == producers_.end() ? nullptr : it->second.get();
+    }
+
 private:
     static constexpr size_t dense_lookup_limit_ = 4096;
 
@@ -299,18 +321,6 @@ class stream_buffer_multiplexer {
         return {};
     }
 
-    producer_buffer* find_producer(uint32_t producer_id) noexcept {
-        return const_cast<producer_buffer*>(std::as_const(*this).find_producer(producer_id));
-    }
-
-    const producer_buffer* find_producer(uint32_t producer_id) const noexcept {
-        if (producer_id < dense_producers_.size()) {
-            return dense_producers_[producer_id];
-        }
-        auto it = producers_.find(producer_id);
-        return it == producers_.end() ? nullptr : it->second.get();
-    }
-
     template <typename Cursor>
     multiplex_record read_impl(Cursor& cursor) noexcept {
         for (;;) {