Add categorizable code to Error.GenericError

stream-result/api/android/stream-result.api

@@ -3,16 +3,23 @@ public abstract class io/getstream/result/Error {
 }
 
 public final class io/getstream/result/Error$GenericError : io/getstream/result/Error {
+	public static final field Companion Lio/getstream/result/Error$GenericError$Companion;
+	public static final field UNCATEGORIZED I
 	public fun <init> (Ljava/lang/String;)V
+	public fun <init> (Ljava/lang/String;I)V
 	public final fun component1 ()Ljava/lang/String;
 	public final fun copy (Ljava/lang/String;)Lio/getstream/result/Error$GenericError;
 	public static synthetic fun copy$default (Lio/getstream/result/Error$GenericError;Ljava/lang/String;ILjava/lang/Object;)Lio/getstream/result/Error$GenericError;
 	public fun equals (Ljava/lang/Object;)Z
+	public final fun getCode ()I
 	public fun getMessage ()Ljava/lang/String;
 	public fun hashCode ()I
 	public fun toString ()Ljava/lang/String;
 }
 
+public final class io/getstream/result/Error$GenericError$Companion {
+}
+
 public final class io/getstream/result/Error$NetworkError : io/getstream/result/Error {
 	public static final field Companion Lio/getstream/result/Error$NetworkError$Companion;
 	public static final field UNKNOWN_STATUS_CODE I

stream-result/api/jvm/stream-result.api

@@ -3,16 +3,23 @@ public abstract class io/getstream/result/Error {
 }
 
 public final class io/getstream/result/Error$GenericError : io/getstream/result/Error {
+	public static final field Companion Lio/getstream/result/Error$GenericError$Companion;
+	public static final field UNCATEGORIZED I
 	public fun <init> (Ljava/lang/String;)V
+	public fun <init> (Ljava/lang/String;I)V
 	public final fun component1 ()Ljava/lang/String;
 	public final fun copy (Ljava/lang/String;)Lio/getstream/result/Error$GenericError;
 	public static synthetic fun copy$default (Lio/getstream/result/Error$GenericError;Ljava/lang/String;ILjava/lang/Object;)Lio/getstream/result/Error$GenericError;
 	public fun equals (Ljava/lang/Object;)Z
+	public final fun getCode ()I
 	public fun getMessage ()Ljava/lang/String;
 	public fun hashCode ()I
 	public fun toString ()Ljava/lang/String;
 }
 
+public final class io/getstream/result/Error$GenericError$Companion {
+}
+
 public final class io/getstream/result/Error$NetworkError : io/getstream/result/Error {
 	public static final field Companion Lio/getstream/result/Error$NetworkError$Companion;
 	public static final field UNKNOWN_STATUS_CODE I

stream-result/src/commonMain/kotlin/io/getstream/result/Error.kt

@@ -30,7 +30,59 @@ public sealed class Error {
    *
    * @param message The message describing the error.
    */
-  public data class GenericError(override val message: String) : Error()
+  public data class GenericError(override val message: String) : Error() {
+
+    /**
+     * A stable, machine-readable code categorizing the error, or [UNCATEGORIZED] when it has not
+     * been categorized. Read it to branch on the kind of error without matching [message].
+     *
+     * Populated by the SDK at construction via the secondary constructor; immutable afterwards.
+     *
+     * [code] is included in this type's [equals]/[hashCode]/[toString] (implemented manually,
+     * since it is not a primary-constructor property). It is still NOT carried by the generated
+     * [copy] — a copied instance resets to [UNCATEGORIZED]; use [copyWithMessage], which preserves
+     * it.
+     */
+    public var code: Int = UNCATEGORIZED
+      private set
+
+    /**
+     * @param message The message describing the error.
+     * @param code A stable, machine-readable [code] categorizing the error.
+     */
+    public constructor(message: String, code: Int) : this(message) {
+      this.code = code
+    }
+
+    @StreamHandsOff(
+      "'code' is declared in the class body, not the primary constructor, so the generated" +
+        " equals/hashCode/toString would ignore it; they are implemented manually to include it."
+    )
+    override fun equals(other: Any?): Boolean {
+      if (this === other) return true
+      if (other == null || this::class != other::class) return false
+
+      other as GenericError
+      return message == other.message && code == other.code
+    }
+
+    @StreamHandsOff(
+      "'code' is declared in the class body, not the primary constructor, so the generated" +
+        " equals/hashCode/toString would ignore it; they are implemented manually to include it."
+    )
+    override fun hashCode(): Int {
+      return 31 * message.hashCode() + code
+    }
+
+    override fun toString(): String {
+      return "GenericError(message=$message, code=$code)"
+    }
+
+    public companion object {
+      /** Default [code] value, meaning the error has not been categorized. */
+      public const val UNCATEGORIZED: Int = 0
+    }
+  }
 
   /**
    * An error that contains a message and cause.
@@ -124,7 +176,7 @@ public sealed class Error {
  */
 public fun Error.copyWithMessage(message: String): Error {
   return when (this) {
-    is Error.GenericError -> this.copy(message = message)
+    is Error.GenericError -> Error.GenericError(message = message, code = code)
     is Error.NetworkError -> this.copy(message = message)
     is Error.ThrowableError -> this.copy(message = message)
   }