Expose capacity property on StashBuffer (#28739)

akka-actor-typed-tests/src/test/scala/akka/actor/typed/scaladsl/StashBufferSpec.scala

@@ -241,5 +241,11 @@ class StashBufferSpec extends AnyWordSpec with Matchers with LogCapturing {
       intercept[IllegalArgumentException](stash.unstashAll(Behaviors.unhandled))
     }
 
+    "answer thruthfully about its capacity" in {
+      val capacity = 42
+      val stash = StashBuffer[String](context, capacity)
+
+      stash.capacity should ===(capacity)
+    }
   }
 }

akka-actor-typed/src/main/mima-filters/2.6.3.backwards.excludes/pr-28739-expose-stashbuffer-capacity.excludes

@@ -0,0 +1,4 @@
+# https://github.com/akka/akka/pull/28739#issuecomment-602527515
+# StashBuffer trait is not meant to be extended by external users, and is marked as such with a @DoNotInherit
+ProblemFilters.exclude[ReversedMissingMethodProblem]("akka.actor.typed.javadsl.StashBuffer.capacity")
+ProblemFilters.exclude[ReversedMissingMethodProblem]("akka.actor.typed.scaladsl.StashBuffer.capacity")

akka-actor-typed/src/main/scala/akka/actor/typed/javadsl/StashBuffer.scala

@@ -42,6 +42,13 @@ import akka.japi.function.Procedure
    */
   def size: Int
 
+  /**
+   * What is the capacity of this buffer.
+   *
+   * @return the capacity of this buffer
+   */
+  def capacity: Int
+
   /**
    * @return `true` if no more messages can be added, i.e. size equals the capacity of the stash buffer
    */

akka-actor-typed/src/main/scala/akka/actor/typed/scaladsl/StashBuffer.scala

@@ -55,6 +55,13 @@ import akka.annotation.{ DoNotInherit, InternalApi }
    */
   def size: Int
 
+  /**
+   * What is the capacity of this buffer.
+   *
+   * @return the capacity of this buffer
+   */
+  def capacity: Int
+
   /**
    * @return `true` if no more messages can be added, i.e. size equals the capacity of the stash buffer
    */