Introduce exception type for post-release PlaybackEngine usage attempts

This allows for a more robust test as well as easier host-side checks.

Author: stoyicker

player/common/src/main/kotlin/com/tidal/sdk/player/common/PlaybackEngineUsageAfterReleaseException.kt

@@ -0,0 +1,4 @@
+package com.tidal.sdk.player.common
+
+class PlaybackEngineUsageAfterReleaseException :
+    IllegalStateException("Attempted to use a released PlaybackEngine")

player/playback-engine/src/main/kotlin/com/tidal/sdk/player/playbackengine/SingleHandlerPlaybackEngine.kt

@@ -1,6 +1,7 @@
 package com.tidal.sdk.player.playbackengine
 
 import android.os.Handler
+import com.tidal.sdk.player.common.PlaybackEngineUsageAfterReleaseException
 import com.tidal.sdk.player.common.model.AudioQuality
 import com.tidal.sdk.player.common.model.LoudnessNormalizationMode
 import com.tidal.sdk.player.common.model.MediaProduct
@@ -78,8 +79,7 @@ internal class SingleHandlerPlaybackEngine(
 
     private fun postOrThrow(runnable: Runnable) {
         if (!handler.post(runnable)) {
-            val className = SingleHandlerPlaybackEngine::class.simpleName
-            error("Attempt to use a released instance of $className")
+            throw PlaybackEngineUsageAfterReleaseException()
         }
     }
 }

player/playback-engine/src/test/kotlin/com/tidal/sdk/player/playbackengine/ExoPlayerPlaybackEngineTest.kt

@@ -473,6 +473,7 @@ internal class ExoPlayerPlaybackEngineTest {
 
         playbackEngine.release()
 
+        verify(initialExtendedExoPlayer).currentPositionMs
         verify(initialExtendedExoPlayer).release()
         verifyNoMoreInteractions(initialExtendedExoPlayer, looper)
     }

player/src/androidTest/kotlin/com/tidal/sdk/player/playlog/SingleMediaProductPlayLogTest.kt

@@ -18,6 +18,7 @@ import com.tidal.sdk.common.TidalMessage
 import com.tidal.sdk.eventproducer.EventSender
 import com.tidal.sdk.eventproducer.model.ConsentCategory
 import com.tidal.sdk.player.Player
+import com.tidal.sdk.player.common.PlaybackEngineUsageAfterReleaseException
 import com.tidal.sdk.player.common.model.MediaProduct
 import com.tidal.sdk.player.common.model.ProductType
 import com.tidal.sdk.player.events.EventReporterModuleRoot
@@ -163,9 +164,10 @@ internal class SingleMediaProductPlayLogTest(private val mediaProduct: MediaProd
                 player.release()
                 job.join()
             }
-        } catch (alreadyReleasedException: IllegalStateException) {
-            assertThat(alreadyReleasedException.message)
-                .isEqualTo("Attempt to use a released instance of SingleHandlerPlaybackEngine")
+        } catch (throwable: Throwable) {
+            if (throwable !is PlaybackEngineUsageAfterReleaseException) {
+                throw throwable
+            }
         }
         verify(eventSender, atMost(Int.MAX_VALUE))
             .sendEvent(