[data] introduce Environment and improve KyoException

kyo-core/jvm/src/main/scala/kyo/StreamCompression.scala

@@ -11,12 +11,7 @@ import scala.annotation.tailrec
 
 object StreamCompression:
 
-    final class StreamCompressionException(reason: String | Throwable)(using Frame) extends KyoException(
-            message = reason match
-                case string: String => Text(string)
-                case _: Throwable   => null,
-            cause = reason
-        )
+    final class StreamCompressionException(cause: Text | Throwable)(using Frame) extends KyoException("", cause)
 
     enum CompressionLevel(val value: Int) derives CanEqual:
         case Default         extends CompressionLevel(-1)

kyo-data/shared/src/main/scala/kyo/KyoException.scala

@@ -2,17 +2,14 @@ package kyo
 
 import kyo.*
 import kyo.Ansi.*
+import kyo.internal.Environment
 import scala.util.control.NoStackTrace
 
-class KyoException private[kyo] (
-    message: Text | Null = null,
-    cause: Text | Throwable | Null = null
-)(using val frame: Frame) extends Exception(
-        Option(message) match
-            case Some(message) => message.toString;
-            case _             => null,
+class KyoException private[kyo] (message: Text = "", cause: Text | Throwable = "")(using val frame: Frame)
+    extends Exception(
+        message.toString,
         cause match
-            case cause: Throwable => cause;
+            case cause: Throwable => cause
             case _                => null
     ) with NoStackTrace:
 
@@ -27,8 +24,12 @@ class KyoException private[kyo] (
                 case _: Throwable           => Absent
                 case cause: Text @unchecked => Maybe(cause)
 
-        val msg = frame.render(("⚠️ KyoException".red.bold :: Maybe(message).toList ::: detail.toList).map(_.show)*)
-        s"\n$msg\n"
+        if Environment.isDevelopment then
+            val msg = frame.render(("⚠️ KyoException".red.bold :: Maybe(message).toList ::: detail.toList).map(_.show)*)
+            s"\n$msg\n"
+        else
+            detail.map(_.toString).getOrElse(null)
+        end if
     end getMessage
 
 end KyoException

kyo-data/shared/src/main/scala/kyo/internal/Environment.scala

@@ -0,0 +1,37 @@
+package kyo.internal
+
+/** Environment detection utility.
+  *
+  * Provides functionality to detect whether the JVM is running in a development environment. This information is used to control the
+  * verbosity of error messages and debugging information in Kyo's implementations.
+  *
+  * The development mode can be controlled in two ways:
+  *   1. Explicitly via the system property "-Dkyo.development-mode.enable=true"
+  *   2. Automatically by detecting SBT in the classpath
+  * }}}
+  */
+private[kyo] object Environment:
+
+    /** Determines if the execution is a development environment.
+      *
+      * This method checks the following conditions in order:
+      *
+      *   1. If system property "kyo.development-mode.enable" exists:
+      *      - Returns true if the property value is "true" (case insensitive)
+      *      - Returns false if the property value is anything else
+      *   2. If the property doesn't exist:
+      *      - Returns true if SBT is detected in the classpath (contains "org.scala-sbt")
+      *      - Returns false otherwise
+      *
+      * @return
+      *   true if running in a development environment, false otherwise
+      */
+    val isDevelopment: Boolean = inferIsDevelopment()
+
+    private[internal] def inferIsDevelopment(): Boolean =
+        sys.props.get("kyo.development-mode.enable").map(_.toLowerCase) match
+            case Some("true") => true
+            case Some(_)      => false
+            case _            => sys.props.get("java.class.path").exists(_.contains("org.scala-sbt"))
+
+end Environment