ref(core): Mark internal utils as @ApiStatus.Internal (#6017)

* ref(core): Mark internal utils as @ApiStatus.Internal

SDK utility helpers in io.sentry.util and a few module-local Utils are
plumbing, not public API. Mark them internal so a future major can move
them without implying customer support. Leave intentional public helpers
like CheckInUtils and SentryReactorUtils alone.

Co-Authored-By: Nelson Osacky <nelson.osacky@sentry.io>

* ref(core): Keep LoadClass and TracingUtils public

Exclude these from the Internal pass; git history suggests they were
kept public for hybrid SDK consumption.

---------

Co-authored-by: sentry-junior[bot] <264270552+sentry-junior[bot]@users.noreply.github.com>
Co-authored-by: Nelson Osacky <nelson.osacky@sentry.io>

Author: sentry-junior[bot]

sentry-android-core/src/main/java/io/sentry/android/core/internal/util/NativeEventUtils.java

@@ -7,9 +7,11 @@
 import java.nio.BufferUnderflowException;
 import java.nio.ByteBuffer;
 import java.nio.ByteOrder;
+import org.jetbrains.annotations.ApiStatus;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+@ApiStatus.Internal
 public class NativeEventUtils {
 
   public static byte[] readBytes(final @NotNull InputStream stream) throws IOException {

sentry-jdbc/src/main/java/io/sentry/jdbc/DatabaseUtils.java

@@ -5,9 +5,11 @@
 import io.sentry.util.StringUtils;
 import java.net.URI;
 import java.util.Locale;
+import org.jetbrains.annotations.ApiStatus;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+@ApiStatus.Internal
 public final class DatabaseUtils {
 
   private static final @NotNull DatabaseDetails EMPTY = new DatabaseDetails(null, null);

sentry-opentelemetry/sentry-opentelemetry-core/src/main/java/io/sentry/opentelemetry/OtelSpanUtils.java

@@ -4,9 +4,11 @@
 import io.opentelemetry.api.common.Attributes;
 import io.opentelemetry.sdk.trace.data.SpanData;
 import io.sentry.ISpan;
+import org.jetbrains.annotations.ApiStatus;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+@ApiStatus.Internal
 public final class OtelSpanUtils {
   public static <T> void maybeTransferOtelAttribute(
       final @NotNull SpanData otelSpan,

sentry/src/main/java/io/sentry/util/ClassLoaderUtils.java

@@ -1,8 +1,10 @@
 package io.sentry.util;
 
+import org.jetbrains.annotations.ApiStatus;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+@ApiStatus.Internal
 public final class ClassLoaderUtils {
 
   public static @NotNull ClassLoader classLoaderOrDefault(final @Nullable ClassLoader classLoader) {

sentry/src/main/java/io/sentry/util/DebugMetaPropertiesApplier.java

@@ -5,9 +5,11 @@
 import io.sentry.SentryOptions;
 import java.util.List;
 import java.util.Properties;
+import org.jetbrains.annotations.ApiStatus;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+@ApiStatus.Internal
 public final class DebugMetaPropertiesApplier {
 
   public static @NotNull String DEBUG_META_PROPERTIES_FILENAME = "sentry-debug-meta.properties";

sentry/src/main/java/io/sentry/util/ErrorUtils.java

@@ -10,6 +10,7 @@
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+@ApiStatus.Internal
 public final class ErrorUtils {
 
   /** Checks if an error has been ignored. */

sentry/src/main/java/io/sentry/util/EventProcessorUtils.java

@@ -5,8 +5,10 @@
 import java.util.ArrayList;
 import java.util.List;
 import java.util.concurrent.CopyOnWriteArrayList;
+import org.jetbrains.annotations.ApiStatus;
 import org.jetbrains.annotations.Nullable;
 
+@ApiStatus.Internal
 public final class EventProcessorUtils {
 
   public static List<EventProcessor> unwrap(

sentry/src/main/java/io/sentry/util/LifecycleHelper.java

@@ -1,9 +1,11 @@
 package io.sentry.util;
 
 import io.sentry.ISentryLifecycleToken;
+import org.jetbrains.annotations.ApiStatus;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+@ApiStatus.Internal
 public final class LifecycleHelper {
 
   public static void close(final @Nullable Object tokenObject) {

sentry/src/main/java/io/sentry/util/MapObjectReader.java

@@ -15,9 +15,11 @@
 import java.util.List;
 import java.util.Map;
 import java.util.TimeZone;
+import org.jetbrains.annotations.ApiStatus;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+@ApiStatus.Internal
 @SuppressWarnings("unchecked")
 public final class MapObjectReader implements ObjectReader {
 

sentry/src/main/java/io/sentry/util/ScopesUtil.java

@@ -4,6 +4,7 @@
 import io.sentry.Scopes;
 import io.sentry.ScopesAdapter;
 import io.sentry.Sentry;
+import org.jetbrains.annotations.ApiStatus;
 import org.jetbrains.annotations.Nullable;
 
 /**
@@ -13,6 +14,7 @@
  * <p>It walks up the parents of each scopes instance until it reaches a parent of null. The scopes
  * without a parent are the ones created in Sentry.init.
  */
+@ApiStatus.Internal
 public final class ScopesUtil {
 
   public static void printScopesChain(final @Nullable IScopes scopes) {