// This file is auto-generated by alef — DO NOT EDIT.
// alef:hash:4e15143f4af1ae8bafbdb1506ef057da924484c66a19483966333558ad437e75
// To regenerate: alef generate
// To verify freshness: alef verify --exit-code
// Issues & docs: https://github.com/kreuzberg-dev/alef
package dev.kreuzberg;

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.PropertyNamingStrategies;
import com.fasterxml.jackson.annotation.JsonInclude;
import com.fasterxml.jackson.databind.MapperFeature;
import com.fasterxml.jackson.datatype.jdk8.Jdk8Module;

/** Centralized JSON deserialization utility for all DTOs. */
@SuppressWarnings("checkstyle:LineLength")
public final class JsonUtil {
    private static final ObjectMapper MAPPER;

    static {
        MAPPER = new ObjectMapper()
            .registerModule(new Jdk8Module())
            .findAndRegisterModules()
            .setPropertyNamingStrategy(PropertyNamingStrategies.SNAKE_CASE)
            .setSerializationInclusion(JsonInclude.Include.NON_NULL)
            .configure(MapperFeature.ACCEPT_CASE_INSENSITIVE_ENUMS, true);
    }

    private JsonUtil() {
        // Utility class; no instances
    }

    /**
     * Deserialize a JSON string into the given class.
     *
     * @param <T> The target type
     * @param json JSON string with Rust-side field names (snake_case)
     * @param targetClass The class to deserialize into
     * @return The deserialized instance
     * @throws KreuzbergRsException if deserialization fails
     */
    public static <T> T fromJson(final String json, final Class<T> targetClass) throws KreuzbergRsException {
        try {
            return MAPPER.readValue(json, targetClass);
        } catch (Exception e) {
            throw new KreuzbergRsException(
                "Failed to parse " + targetClass.getSimpleName() + " from JSON: " + e.getMessage(),
                e
            );
        }
    }
}