feat(logging): add NotifiableError marker for Slack-visible Bugsnag alerts

Unexpected (non-user-caused) errors now carry Bugsnag metadata
(alert.slack_notify) that the Slack integration can filter on,
giving the team visibility into backend/state failures without noise
from user-caused errors like Denied or RateLimited.

Signed-off-by: Brandon McAnsh <git@bmcreations.dev>

Author: bmc08gt

libs/logging/src/main/kotlin/com/getcode/utils/ErrorUtils.kt

@@ -64,7 +64,31 @@ object ErrorUtils {
         ) {
             FirebaseCrashlytics.getInstance().recordException(throwable)
             if (Bugsnag.isStarted()) {
-                Bugsnag.notify(throwable)
+                Bugsnag.notify(throwable) { event ->
+                    val isNotifiable = throwable is NotifiableError
+                            || throwableCause is NotifiableError
+                            || throwableCause !is CodeServerError
+                    if (isNotifiable) {
+                        event.addMetadata("alert", "slack_notify", true)
+                        event.addMetadata("alert", "error_type", throwableCause.javaClass.simpleName)
+                        event.addMetadata("alert", "error_family", throwableCause.javaClass.enclosingClass?.simpleName ?: "Unknown")
+                    }
+                    true
+                }
+            }
+        }
+    }
+
+    fun notifyUnexpected(throwable: Throwable, context: String? = null) {
+        if (!BuildConfig.NOTIFY_ERRORS) return
+        Timber.e(throwable)
+        FirebaseCrashlytics.getInstance().recordException(throwable)
+        if (Bugsnag.isStarted()) {
+            Bugsnag.notify(throwable) { event ->
+                event.addMetadata("alert", "slack_notify", true)
+                event.addMetadata("alert", "error_type", throwable.javaClass.simpleName)
+                context?.let { event.addMetadata("alert", "context", it) }
+                true
             }
         }
     }

libs/logging/src/main/kotlin/com/getcode/utils/NotifiableError.kt

@@ -0,0 +1,7 @@
+package com.getcode.utils
+
+/**
+ * Marker interface for errors representing unexpected failures (not user-caused).
+ * Errors implementing this are tagged in Bugsnag with metadata that triggers Slack notifications.
+ */
+interface NotifiableError

services/flipcash/src/main/kotlin/com/flipcash/services/models/Errors.kt

@@ -1,72 +1,73 @@
 package com.flipcash.services.models
 
 import com.getcode.utils.CodeServerError
+import com.getcode.utils.NotifiableError
 
 sealed class LoginError(
     override val message: String? = null,
     override val cause: Throwable? = null
 ) : CodeServerError(message, cause) {
-    class InvalidTimestamp : LoginError("Invalid timestamp")
+    class InvalidTimestamp : LoginError("Invalid timestamp"), NotifiableError
     class Denied : LoginError("Denied")
-    class Unrecognized : LoginError("Unrecognized")
-    data class Other(override val cause: Throwable? = null) : LoginError(message = cause?.message, cause = cause)
+    class Unrecognized : LoginError("Unrecognized"), NotifiableError
+    data class Other(override val cause: Throwable? = null) : LoginError(message = cause?.message, cause = cause), NotifiableError
 }
 
 sealed class RegisterError(
     override val message: String? = null,
     override val cause: Throwable? = null
 ) : CodeServerError(message, cause) {
-    class InvalidSignature : RegisterError("Invalid signature")
+    class InvalidSignature : RegisterError("Invalid signature"), NotifiableError
     class Denied: RegisterError("Denied")
-    class Unrecognized : RegisterError("Unrecognized")
-    data class Other(override val cause: Throwable? = null) : RegisterError(message = cause?.message, cause = cause)
+    class Unrecognized : RegisterError("Unrecognized"), NotifiableError
+    data class Other(override val cause: Throwable? = null) : RegisterError(message = cause?.message, cause = cause), NotifiableError
 }
 
 sealed class GetUserFlagsError(
     override val message: String? = null,
     override val cause: Throwable? = null
 ) : CodeServerError(message, cause) {
-    class Unrecognized : GetUserFlagsError("Unrecognized")
+    class Unrecognized : GetUserFlagsError("Unrecognized"), NotifiableError
     class Denied : GetUserFlagsError("Denied")
-    data class Other(override val cause: Throwable? = null) : GetUserFlagsError(message = cause?.message, cause = cause)
+    data class Other(override val cause: Throwable? = null) : GetUserFlagsError(message = cause?.message, cause = cause), NotifiableError
 }
 
 sealed class PurchaseAckError(
     override val message: String? = null,
     override val cause: Throwable? = null
 ) : CodeServerError(message, cause) {
-    class Unrecognized : PurchaseAckError("Unrecognized")
+    class Unrecognized : PurchaseAckError("Unrecognized"), NotifiableError
     class Denied : PurchaseAckError("Denied")
     class InvalidReceipt: PurchaseAckError("Invalid receipt")
     class InvalidMetadata: PurchaseAckError("Invalid metadata")
-    data class Other(override val cause: Throwable? = null) : PurchaseAckError(message = cause?.message, cause = cause)
+    data class Other(override val cause: Throwable? = null) : PurchaseAckError(message = cause?.message, cause = cause), NotifiableError
 }
 
 sealed class AddTokenError(
     override val message: String? = null,
     override val cause: Throwable? = null
 ) : CodeServerError(message, cause) {
     class InvalidPushToken : AddTokenError("Invalid push token")
-    class Unrecognized : AddTokenError("Unrecognized")
-    data class Other(override val cause: Throwable? = null) : AddTokenError(message = cause?.message, cause = cause)
+    class Unrecognized : AddTokenError("Unrecognized"), NotifiableError
+    data class Other(override val cause: Throwable? = null) : AddTokenError(message = cause?.message, cause = cause), NotifiableError
 }
 
 sealed class DeleteTokenError(
     override val message: String? = null,
     override val cause: Throwable? = null
 ) : CodeServerError(message, cause) {
-    class Unrecognized : DeleteTokenError("Unrecognized")
-    data class Other(override val cause: Throwable? = null) : DeleteTokenError(message = cause?.message, cause = cause)
+    class Unrecognized : DeleteTokenError("Unrecognized"), NotifiableError
+    data class Other(override val cause: Throwable? = null) : DeleteTokenError(message = cause?.message, cause = cause), NotifiableError
 }
 
 sealed class GetActivityFeedMessagesError(
     override val message: String? = null,
     override val cause: Throwable? = null
 ) : CodeServerError(message, cause) {
     class Denied : GetActivityFeedMessagesError("Denied")
-    class Unrecognized : GetActivityFeedMessagesError("Unrecognized")
+    class Unrecognized : GetActivityFeedMessagesError("Unrecognized"), NotifiableError
     class NotFound: GetActivityFeedMessagesError("Not found")
-    data class Other(override val cause: Throwable? = null) : GetActivityFeedMessagesError(message = cause?.message, cause = cause)
+    data class Other(override val cause: Throwable? = null) : GetActivityFeedMessagesError(message = cause?.message, cause = cause), NotifiableError
 }
 
 sealed class CreatePoolError(
@@ -76,25 +77,25 @@ sealed class CreatePoolError(
     class RendezvousExists: CreatePoolError("Rendezvous exists")
     class FundingDestinationExists: CreatePoolError("Funding destination exists")
     class Denied: CreatePoolError("Denied")
-    class Unrecognized : CreatePoolError("Unrecognized")
-    data class Other(override val cause: Throwable? = null) : CreatePoolError(message = cause?.message, cause = cause)
+    class Unrecognized : CreatePoolError("Unrecognized"), NotifiableError
+    data class Other(override val cause: Throwable? = null) : CreatePoolError(message = cause?.message, cause = cause), NotifiableError
 }
 
 sealed class GetPoolError(
     override val message: String? = null,
     override val cause: Throwable? = null
 ): CodeServerError(message, cause) {
     class NotFound: GetPoolError("Not found")
-    class Unrecognized : GetPoolError("Unrecognized")
-    data class Other(override val cause: Throwable? = null) : GetPoolError(message = cause?.message, cause = cause)
+    class Unrecognized : GetPoolError("Unrecognized"), NotifiableError
+    data class Other(override val cause: Throwable? = null) : GetPoolError(message = cause?.message, cause = cause), NotifiableError
 }
 
 sealed class GetPoolPageError(
     override val message: String? = null,
     override val cause: Throwable? = null
 ): CodeServerError(message, cause) {
     class NotFound: GetPoolPageError("Not found")
-    data class Other(override val cause: Throwable? = null) : GetPoolPageError(message = cause?.message, cause = cause)
+    data class Other(override val cause: Throwable? = null) : GetPoolPageError(message = cause?.message, cause = cause), NotifiableError
 }
 
 sealed class PlacePoolBetError(
@@ -106,8 +107,8 @@ sealed class PlacePoolBetError(
     class BetAlreadyMade: PlacePoolBetError("Bet already made")
     class MaxBetsReceived: PlacePoolBetError("Max bets received")
     class BetOutcomeSolidified: PlacePoolBetError("Bet outcome solidified")
-    class Unrecognized : PlacePoolBetError("Unrecognized")
-    data class Other(override val cause: Throwable? = null) : PlacePoolBetError(message = cause?.message, cause = cause)
+    class Unrecognized : PlacePoolBetError("Unrecognized"), NotifiableError
+    data class Other(override val cause: Throwable? = null) : PlacePoolBetError(message = cause?.message, cause = cause), NotifiableError
 }
 
 sealed class ResolvePoolOutcomeError(
@@ -118,8 +119,8 @@ sealed class ResolvePoolOutcomeError(
     class Denied: ResolvePoolOutcomeError("Denied")
     class PoolOpen: ResolvePoolOutcomeError("Pool still open")
     class AlreadyDeclared: ResolvePoolOutcomeError("Different outcome already declared")
-    class Unrecognized : ResolvePoolOutcomeError("Unrecognized")
-    data class Other(override val cause: Throwable? = null) : ResolvePoolOutcomeError(message = cause?.message, cause = cause)
+    class Unrecognized : ResolvePoolOutcomeError("Unrecognized"), NotifiableError
+    data class Other(override val cause: Throwable? = null) : ResolvePoolOutcomeError(message = cause?.message, cause = cause), NotifiableError
 }
 
 sealed class ClosePoolError(
@@ -128,8 +129,8 @@ sealed class ClosePoolError(
 ): CodeServerError(message, cause) {
     class NotFound: ClosePoolError("Not found")
     class Denied: ClosePoolError("Denied")
-    class Unrecognized : ClosePoolError("Unrecognized")
-    data class Other(override val cause: Throwable? = null) : ClosePoolError(message = cause?.message, cause = cause)
+    class Unrecognized : ClosePoolError("Unrecognized"), NotifiableError
+    data class Other(override val cause: Throwable? = null) : ClosePoolError(message = cause?.message, cause = cause), NotifiableError
 }
 
 sealed class GetJwtError(
@@ -141,8 +142,8 @@ sealed class GetJwtError(
     class InvalidApiKey: GetJwtError("Invalid api key")
     class PhoneVerificationRequired: GetJwtError("Phone verification required")
     class EmailVerificationRequired: GetJwtError("Email verification required")
-    class Unrecognized : GetJwtError("Unrecognized")
-    data class Other(override val cause: Throwable? = null) : GetJwtError(message = cause?.message, cause = cause)
+    class Unrecognized : GetJwtError("Unrecognized"), NotifiableError
+    data class Other(override val cause: Throwable? = null) : GetJwtError(message = cause?.message, cause = cause), NotifiableError
 }
 
 sealed class EmailVerificationError(
@@ -154,8 +155,8 @@ sealed class EmailVerificationError(
     class InvalidEmailAddress: EmailVerificationError("Invalid email address")
     class InvalidVerificationCode: EmailVerificationError("Invalid verification code")
     class NoVerification: EmailVerificationError("No verification")
-    class Unrecognized : EmailVerificationError("Unrecognized")
-    data class Other(override val cause: Throwable? = null) : EmailVerificationError(message = cause?.message, cause = cause)
+    class Unrecognized : EmailVerificationError("Unrecognized"), NotifiableError
+    data class Other(override val cause: Throwable? = null) : EmailVerificationError(message = cause?.message, cause = cause), NotifiableError
 }
 
 
@@ -169,17 +170,17 @@ sealed class PhoneVerificationError(
     class UnsupportedPhoneType: PhoneVerificationError("Unsupported phone type")
     class InvalidVerificationCode: PhoneVerificationError("Invalid verification code")
     class NoVerification: PhoneVerificationError("No verification")
-    class Unrecognized : PhoneVerificationError("Unrecognized")
-    data class Other(override val cause: Throwable? = null) : PhoneVerificationError(message = cause?.message, cause = cause)
+    class Unrecognized : PhoneVerificationError("Unrecognized"), NotifiableError
+    data class Other(override val cause: Throwable? = null) : PhoneVerificationError(message = cause?.message, cause = cause), NotifiableError
 }
 
 sealed class GetUserProfileError(
     override val message: String? = null,
     override val cause: Throwable? = null
 ): CodeServerError(message, cause) {
     class NotFound: GetUserProfileError("Not found")
-    class Unrecognized : GetUserProfileError("Unrecognized")
-    data class Other(override val cause: Throwable? = null) : GetUserProfileError(message = cause?.message, cause = cause)
+    class Unrecognized : GetUserProfileError("Unrecognized"), NotifiableError
+    data class Other(override val cause: Throwable? = null) : GetUserProfileError(message = cause?.message, cause = cause), NotifiableError
 }
 
 sealed class SetDisplayNameError(
@@ -188,8 +189,8 @@ sealed class SetDisplayNameError(
 ): CodeServerError(message, cause) {
     class InvalidDisplayName: SetDisplayNameError("Invalid display name")
     class Denied: SetDisplayNameError("Denied")
-    class Unrecognized : SetDisplayNameError("Unrecognized")
-    data class Other(override val cause: Throwable? = null) : SetDisplayNameError(message = cause?.message, cause = cause)
+    class Unrecognized : SetDisplayNameError("Unrecognized"), NotifiableError
+    data class Other(override val cause: Throwable? = null) : SetDisplayNameError(message = cause?.message, cause = cause), NotifiableError
 }
 
 sealed class LinkSocialAccountError(
@@ -199,27 +200,27 @@ sealed class LinkSocialAccountError(
     class InvalidLinkingToken: LinkSocialAccountError("Invalid linking token")
     class ExistingLink: LinkSocialAccountError("Existing link")
     class Denied: LinkSocialAccountError("Denied")
-    class Unrecognized : LinkSocialAccountError("Unrecognized")
-    data class Other(override val cause: Throwable? = null) : LinkSocialAccountError(message = cause?.message, cause = cause)
+    class Unrecognized : LinkSocialAccountError("Unrecognized"), NotifiableError
+    data class Other(override val cause: Throwable? = null) : LinkSocialAccountError(message = cause?.message, cause = cause), NotifiableError
 }
 
 sealed class UnlinkSocialAccountError(
     override val message: String? = null,
     override val cause: Throwable? = null
 ): CodeServerError(message, cause) {
     class Denied: UnlinkSocialAccountError("Denied")
-    class Unrecognized : UnlinkSocialAccountError("Unrecognized")
-    data class Other(override val cause: Throwable? = null) : UnlinkSocialAccountError(message = cause?.message, cause = cause)
+    class Unrecognized : UnlinkSocialAccountError("Unrecognized"), NotifiableError
+    data class Other(override val cause: Throwable? = null) : UnlinkSocialAccountError(message = cause?.message, cause = cause), NotifiableError
 }
 
 sealed class UpdateSettingsError(
     override val message: String? = null,
     override val cause: Throwable? = null
 ): CodeServerError(message, cause) {
     class Denied : UpdateSettingsError("Denied")
-    class Unrecognized : UpdateSettingsError("Unrecognized")
+    class Unrecognized : UpdateSettingsError("Unrecognized"), NotifiableError
     class InvalidLocale : UpdateSettingsError("Invalid locale")
     class InvalidRegion : UpdateSettingsError("Invalid region")
-    data class Other(override val cause: Throwable? = null) : UpdateSettingsError(message = cause?.message, cause = cause)
+    data class Other(override val cause: Throwable? = null) : UpdateSettingsError(message = cause?.message, cause = cause), NotifiableError
 
 }

services/opencode/src/main/kotlin/com/getcode/opencode/controllers/TransactionController.kt

@@ -12,6 +12,7 @@ import com.getcode.opencode.internal.solana.model.SwapId
 import com.getcode.opencode.model.accounts.AccountCluster
 import com.getcode.opencode.model.accounts.GiftCardAccount
 import com.getcode.opencode.model.core.errors.GetIntentMetadataError
+import com.getcode.opencode.model.core.errors.GetLimitsError
 import com.getcode.opencode.model.core.errors.SwapError
 import com.getcode.opencode.model.financial.Distribution
 import com.getcode.opencode.model.financial.Fee

services/opencode/src/main/kotlin/com/getcode/opencode/internal/transactors/GiveBillTransactor.kt

@@ -18,6 +18,7 @@ import com.getcode.opencode.utils.nonce
 import com.getcode.solana.keys.Mint
 import com.getcode.solana.keys.PublicKey
 import com.getcode.utils.CodeServerError
+import com.getcode.utils.NotifiableError
 import com.getcode.utils.TraceType
 import com.getcode.utils.trace
 import kotlinx.coroutines.CoroutineScope
@@ -257,12 +258,12 @@ internal class GiveBillTransactor(
         override val message: String? = null,
         override val cause: Throwable? = null
     ) : CodeServerError(message, cause) {
-        class DuplicateTransferException : GiveTransactorError(message = "Duplicate Transfer")
-        class DestinationSignatureInvalidException : GiveTransactorError(message = "Destination signature invalid")
-        class ExchangeRateExpiredException : GiveTransactorError(message = "Exchange rate expired")
+        class DuplicateTransferException : GiveTransactorError(message = "Duplicate Transfer"), NotifiableError
+        class DestinationSignatureInvalidException : GiveTransactorError(message = "Destination signature invalid"), NotifiableError
+        class ExchangeRateExpiredException : GiveTransactorError(message = "Exchange rate expired"), NotifiableError
         data class Other(
             override val message: String? = null,
             override val cause: Throwable? = null
-        ) : GiveTransactorError(message, cause)
+        ) : GiveTransactorError(message, cause), NotifiableError
     }
 }

services/opencode/src/main/kotlin/com/getcode/opencode/internal/transactors/GrabBillTransactor.kt

@@ -12,6 +12,7 @@ import com.getcode.opencode.model.transactions.TransactionMetadata
 import com.getcode.opencode.providers.TokenMetadataProvider
 import com.getcode.utils.CodeServerError
 import com.getcode.utils.ErrorUtils
+import com.getcode.utils.NotifiableError
 import kotlinx.coroutines.CoroutineScope
 import kotlinx.coroutines.cancel
 
@@ -154,5 +155,5 @@ sealed class GrabTransactorError(
     data class Other(
         override val message: String? = null,
         override val cause: Throwable? = null
-    ) : GrabTransactorError(message, cause)
+    ) : GrabTransactorError(message, cause), NotifiableError
 }

services/opencode/src/main/kotlin/com/getcode/opencode/internal/transactors/ReceiveGiftCardTransactor.kt

@@ -16,6 +16,7 @@ import com.getcode.opencode.model.financial.Token
 import com.getcode.opencode.providers.TokenMetadataProvider
 import com.getcode.utils.CodeServerError
 import com.getcode.utils.ErrorUtils
+import com.getcode.utils.NotifiableError
 import com.getcode.utils.timedTraceSuspend
 
 internal class ReceiveGiftCardTransactor(
@@ -171,13 +172,13 @@ sealed class ReceiveGiftTransactorError(
     class FailedToQuery(
         override val message: String? = null,
         override val cause: Throwable? = null
-    ) : GrabTransactorError(message = message?.let { "Failed to query account - $it" } ?: "Failed to query account")
+    ) : GrabTransactorError(message = message?.let { "Failed to query account - $it" } ?: "Failed to query account"), NotifiableError
     class AlreadyClaimed : GrabTransactorError(message = "Already claimed")
     class UsersGiftCard : GrabTransactorError(message = "User is gift card issuer")
     class Expired : GrabTransactorError(message = "Expired")
 
     data class Other(
         override val message: String? = null,
         override val cause: Throwable? = null
-    ) : GrabTransactorError(message, cause)
+    ) : GrabTransactorError(message, cause), NotifiableError
 }