Update docs to use Hint object

src/includes/configuration/before-send-fingerprint/java.spring-boot.mdx

@@ -1,12 +1,13 @@
 ```java
 import io.sentry.SentryEvent;
 import io.sentry.SentryOptions;
+import io.sentry.hints.Hint
 import org.springframework.stereotype.Component;
 
 @Component
 public class CustomBeforeSendCallback implements SentryOptions.BeforeSendCallback {
   @Override
-  public SentryEvent execute(SentryEvent event, Object hint) {
+  public SentryEvent execute(SentryEvent event, Hint hint) {
     if (event.getThrowable() instanceof SQLException) {
       event.setFingerprints(Arrays.asList("database-connection-error"));
     }
@@ -18,11 +19,12 @@ public class CustomBeforeSendCallback implements SentryOptions.BeforeSendCallbac
 ```kotlin
 import io.sentry.SentryEvent
 import io.sentry.SentryOptions
+import io.sentry.hints.Hint
 import org.springframework.stereotype.Component
 
 @Component
 class CustomBeforeSendCallback : SentryOptions.BeforeSendCallback {
-  override fun execute(event: SentryEvent, hint: Any?): SentryEvent? {
+  override fun execute(event: SentryEvent, hint: Hint): SentryEvent? {
     if (event.throwable is SQLException) {
       event.fingerprints = listOf("database-connection-error")
     }

src/includes/configuration/before-send-fingerprint/java.spring.mdx

@@ -1,12 +1,13 @@
 ```java
 import io.sentry.SentryEvent;
 import io.sentry.SentryOptions;
+import io.sentry.hints.Hint
 import org.springframework.stereotype.Component;
 
 @Component
 public class CustomBeforeSendCallback implements SentryOptions.BeforeSendCallback {
   @Override
-  public SentryEvent execute(SentryEvent event, Object hint) {
+  public SentryEvent execute(SentryEvent event, Hint hint) {
     if (event.getThrowable() instanceof SQLException) {
       event.setFingerprints(Arrays.asList("database-connection-error"));
     }
@@ -18,11 +19,12 @@ public class CustomBeforeSendCallback implements SentryOptions.BeforeSendCallbac
 ```kotlin
 import io.sentry.SentryEvent
 import io.sentry.SentryOptions
+import io.sentry.hints.Hint
 import org.springframework.stereotype.Component
 
 @Component
 class CustomBeforeSendCallback : SentryOptions.BeforeSendCallback {
-  override fun execute(event: SentryEvent, hint: Any?): SentryEvent? {
+  override fun execute(event: SentryEvent, hint: Hint): SentryEvent? {
     if (event.throwable is SQLException) {
       event.fingerprints = listOf("database-connection-error")
     }

src/includes/configuration/before-send-hint/java.spring-boot.mdx

@@ -1,15 +1,16 @@
-A `BiFunction<SentryEvent, Object, SentryEvent>` can be used to mutate, discard (return null), or return a completely new event.
+A `BiFunction<SentryEvent, Hint, SentryEvent>` can be used to mutate, discard (return null), or return a completely new event.
 
 ```java
 import io.sentry.SentryEvent;
 import io.sentry.SentryOptions;
+import io.sentry.hints.Hint
 import org.springframework.stereotype.Component;
 
 @Component
 public class CustomBeforeSendCallback implements SentryOptions.BeforeSendCallback {
   @Override
-  public SentryEvent execute(SentryEvent event, Object hint) {
-    if (hint instanceof MyHint) {
+  public SentryEvent execute(SentryEvent event, Hint hint) {
+    if (hint.get("my-hint-key") != null) {
       return null;
     } else {
       return event;
@@ -21,12 +22,13 @@ public class CustomBeforeSendCallback implements SentryOptions.BeforeSendCallbac
 ```kotlin
 import io.sentry.SentryEvent
 import io.sentry.SentryOptions
+import io.sentry.hints.Hint
 import org.springframework.stereotype.Component
 
 @Component
 class CustomBeforeSendCallback : SentryOptions.BeforeSendCallback {
-  override fun execute(event: SentryEvent, hint: Any?): SentryEvent? {
-    if (hint is MyHint) {
+  override fun execute(event: SentryEvent, hint: Hint): SentryEvent? {
+    if (hint["my-hint-key"] != null) {
       null
     } else {
       event

src/includes/configuration/before-send-hint/java.spring.mdx

@@ -1,15 +1,16 @@
-A `BiFunction<SentryEvent, Object, SentryEvent>` can be used to mutate, discard (return null), or return a completely new event.
+A `BiFunction<SentryEvent, Hint, SentryEvent>` can be used to mutate, discard (return null), or return a completely new event.
 
 ```java
 import io.sentry.SentryEvent;
 import io.sentry.SentryOptions;
+import io.sentry.hints.Hint
 import org.springframework.stereotype.Component;
 
 @Component
 public class CustomBeforeSendCallback implements SentryOptions.BeforeSendCallback {
   @Override
-  public SentryEvent execute(SentryEvent event, Object hint) {
-    if (hint instanceof MyHint) {
+  public SentryEvent execute(SentryEvent event, Hint hint) {
+    if (hint.get("my-hint-key") != null) {
       return null;
     } else {
       return event;
@@ -21,12 +22,13 @@ public class CustomBeforeSendCallback implements SentryOptions.BeforeSendCallbac
 ```kotlin
 import io.sentry.SentryEvent
 import io.sentry.SentryOptions
+import io.sentry.hints.Hint
 import org.springframework.stereotype.Component
 
 @Component
 class CustomBeforeSendCallback : SentryOptions.BeforeSendCallback {
-  override fun execute(event: SentryEvent, hint: Any?): SentryEvent? {
-    if (hint is MyHint) {
+  override fun execute(event: SentryEvent, hint: Hnt): SentryEvent? {
+    if (hint["my-hint-key"] != null) {
       null
     } else {
       event

src/includes/configuration/before-send/java.spring-boot.mdx

@@ -3,12 +3,13 @@
 ```java
 import io.sentry.SentryEvent;
 import io.sentry.SentryOptions;
+import io.sentry.hints.Hint
 import org.springframework.stereotype.Component;
 
 @Component
 public class CustomBeforeSendCallback implements SentryOptions.BeforeSendCallback {
   @Override
-  public SentryEvent execute(SentryEvent event, Object hint) {
+  public SentryEvent execute(SentryEvent event, Hint hint) {
     // Example: Never send server name in events
     event.setServerName(null);
     return event;
@@ -19,11 +20,12 @@ public class CustomBeforeSendCallback implements SentryOptions.BeforeSendCallbac
 ```kotlin
 import io.sentry.SentryEvent
 import io.sentry.SentryOptions
+import io.sentry.hints.Hint
 import org.springframework.stereotype.Component
 
 @Component
 class CustomBeforeSendCallback : SentryOptions.BeforeSendCallback {
-  override fun execute(event: SentryEvent, hint: Any?): SentryEvent? {
+  override fun execute(event: SentryEvent, hint: Hint): SentryEvent? {
     // Example: Never send server name in events
     event.serverName = null
     return event

src/includes/configuration/before-send/java.spring.mdx

@@ -3,12 +3,13 @@
 ```java
 import io.sentry.SentryEvent;
 import io.sentry.SentryOptions;
+import io.sentry.hints.Hint
 import org.springframework.stereotype.Component;
 
 @Component
 public class CustomBeforeSendCallback implements SentryOptions.BeforeSendCallback {
   @Override
-  public SentryEvent execute(SentryEvent event, Object hint) {
+  public SentryEvent execute(SentryEvent event, Hint hint) {
     // Example: Never send server name in events
     event.setServerName(null);
     return event;
@@ -19,11 +20,12 @@ public class CustomBeforeSendCallback implements SentryOptions.BeforeSendCallbac
 ```kotlin
 import io.sentry.SentryEvent
 import io.sentry.SentryOptions
+import io.sentry.hints.Hint
 import org.springframework.stereotype.Component
 
 @Component
 class CustomBeforeSendCallback : SentryOptions.BeforeSendCallback {
-  override fun execute(event: SentryEvent, hint: Any?): SentryEvent? {
+  override fun execute(event: SentryEvent, hint: Hint): SentryEvent? {
     // Example: Never send server name in events
     event.serverName = null
     return event

src/includes/configuration/config-intro/java.mdx

@@ -25,13 +25,14 @@ public class MyClass {
 ```kotlin {tabTitle:Kotlin}
 import io.sentry.Sentry
 import io.sentry.SentryOptions.BeforeSendCallback
+import io.sentry.hints.Hint
 
 fun main() {
   Sentry.init { options ->
     // your Sentry project/dashboard
     options.dsn = "___PUBLIC_DSN___"
     options.release = "[email protected]+1"
-    options.beforeSend = BeforeSendCallback { event: SentryEvent, hint: Any? ->
+    options.beforeSend = BeforeSendCallback { event: SentryEvent, hint: Hint ->
       // Drop an event altogether:
       if (event.getTag("SomeTag") != null) {
         null

src/platforms/android/configuration/manual-init.mdx

@@ -22,7 +22,7 @@ Or, to completely remove the merging of the `ContentProvider`:
         android:name="io.sentry.android.core.SentryInitProvider"
         android:authorities="${applicationId}.SentryInitProvider"
         tools:node="remove" />
-  
+
     <provider
         android:name="io.sentry.android.core.SentryPerformanceProvider"
         android:authorities="${applicationId}.SentryPerformanceProvider"
@@ -63,6 +63,7 @@ public class SentryApplication extends Application {
 ```kotlin
 import io.sentry.android.core.SentryAndroid
 import io.sentry.SentryOptions.BeforeSendCallback
+import io.sentry.hints.Hint
 import android.app.Application
 
 class SentryApplication : Application() {
@@ -74,7 +75,7 @@ class SentryApplication : Application() {
       // Add a callback that will be used before the event is sent to Sentry.
       // With this callback, you can modify the event or, when returning null, also discard the event.
       options.beforeSend =
-        BeforeSendCallback { event: SentryEvent, hint: Any? ->
+        BeforeSendCallback { event: SentryEvent, hint: Hint ->
           if (SentryLevel.DEBUG == event.level) {
             null
           } else {

src/platforms/android/migration.mdx

@@ -27,7 +27,7 @@ description: "Migrating between versions of Sentry's SDK for Android."
   * `IHandler` is now `MainLooperHandler` only.
 * `ISpan` now has higher precision using the `System#nanoTime` instead of milliseconds.
 
-* Hints changed its type from `Object` to `Map<String, Object>`
+* Hints changed its type from `Object` to `Hint`
 
 _Old_:
 
@@ -252,7 +252,7 @@ _New_:
 
 ```kotlin
 SentryOptions#addEventProcessor(object : EventProcessor {
-    override fun process(event: SentryEvent, hint: Any?): SentryEvent? {
+    override fun process(event: SentryEvent, hint: Hint): SentryEvent? {
         return event
     }
 })

src/platforms/java/guides/spring-boot/advanced-usage.mdx

@@ -28,12 +28,13 @@ Any Spring bean implementing `EventProcessor` will be automatically set on `Sent
 ```java
 import io.sentry.SentryEvent;
 import io.sentry.EventProcessor;
+import io.sentry.hints.Hint
 import org.springframework.stereotype.Component;
 
 @Component
 public class CustomEventProcessor implements EventProcessor {
   @Override
-  public SentryEvent process(SentryEvent event, Object hint) {
+  public SentryEvent process(SentryEvent event, Hint hint) {
     // modify the event or return null to drop it
     return event;
   }
@@ -43,11 +44,12 @@ public class CustomEventProcessor implements EventProcessor {
 ```kotlin
 import io.sentry.SentryEvent
 import io.sentry.EventProcessor
+import io.sentry.hints.Hint
 import org.springframework.stereotype.Component
 
 @Component
 class CustomEventProcessor : EventProcessor {
-  override fun process(event: SentryEvent, hint: Any?): SentryEvent? {
+  override fun process(event: SentryEvent, hint: Hint): SentryEvent? {
     // modify the event or return null to drop it
     return event
   }
@@ -61,12 +63,13 @@ Any Spring bean implementing the `BeforeSendCallback` will be automatically set
 ```java
 import io.sentry.SentryEvent;
 import io.sentry.SentryOptions;
+import io.sentry.hints.Hint
 import org.springframework.stereotype.Component;
 
 @Component
 public class CustomBeforeSendCallback implements SentryOptions.BeforeSendCallback {
   @Override
-  public SentryEvent execute(SentryEvent event, Object hint) {
+  public SentryEvent execute(SentryEvent event, Hint hint) {
     // Example: Never send server name in events
     event.setServerName(null);
     return event;
@@ -77,11 +80,12 @@ public class CustomBeforeSendCallback implements SentryOptions.BeforeSendCallbac
 ```kotlin
 import io.sentry.SentryEvent
 import io.sentry.SentryOptions
+import io.sentry.hints.Hint
 import org.springframework.stereotype.Component
 
 @Component
 class CustomBeforeSendCallback : SentryOptions.BeforeSendCallback {
-  override fun execute(event: SentryEvent, hint: Any?): SentryEvent? {
+  override fun execute(event: SentryEvent, hint: Hint): SentryEvent? {
     // Example: Never send server name in events
     event.serverName = null
     return event
@@ -96,13 +100,14 @@ Any Spring bean implementing the `BeforeBreadcrumbCallback` will be automaticall
 ```java
 import io.sentry.Breadcrumb;
 import io.sentry.SentryOptions;
+import io.sentry.hints.Hint
 import org.springframework.stereotype.Component;
 
 @Component
 public class CustomBeforeBreadcrumbCallback implements SentryOptions.BeforeBreadcrumbCallback {
 
   @Override
-  public Breadcrumb execute(Breadcrumb breadcrumb, Object hint) {
+  public Breadcrumb execute(Breadcrumb breadcrumb, Hint hint) {
     // Don't add breadcrumbs with message containing:
     if (breadcrumb.getMessage() != null
       && breadcrumb.getMessage().contains("bad breadcrumb")) {
@@ -116,11 +121,12 @@ public class CustomBeforeBreadcrumbCallback implements SentryOptions.BeforeBread
 ```kotlin
 import io.sentry.Breadcrumb
 import io.sentry.SentryOptions
+import io.sentry.hints.Hint
 import org.springframework.stereotype.Component
 
 @Component
 class CustomBeforeBreadcrumbCallback : SentryOptions.BeforeBreadcrumbCallback {
-  override fun execute(breadcrumb: Breadcrumb, hint: Any?): Breadcrumb? {
+  override fun execute(breadcrumb: Breadcrumb, hint: Hint): Breadcrumb? {
     // Don't add breadcrumbs with message containing:
     return if (breadcrumb.message?.contains("bad breadcrumb") == true) {
       null

src/platforms/java/migration.mdx

@@ -28,7 +28,7 @@ description: "Learn about migrating from io.sentry:sentry 1.x to io.sentry:sentr
 * `ISpan` now has higher precision using the `System#nanoTime` instead of milliseconds.
 * `TransactionNameProvider` is now an interface and `SpringMvcTransactionNameProvider` is the default implementation.
 
-* Hints changed its type from `Object` to `Map<String, Object>`
+* Hints changed its type from `Object` to `Hint`
 
 _Old_:
 
@@ -77,7 +77,7 @@ _New_:
 
 ```kotlin
 SentryOptions#addEventProcessor(object : EventProcessor {
-    override fun process(event: SentryEvent, hint: Any?): SentryEvent? {
+    override fun process(event: SentryEvent, hint: Hint): SentryEvent? {
         return event
     }
 })