Summary

• When a GraphQL query returns an array type (e.g. [Type!]) but the Java method declares a single record return type (not List<T>), GraphqlDecoder now automatically unwraps the first element from the array
• This is a common pattern when using limit: 1 to fetch a single result from a query that returns an array type
• If the array is empty, returns null (via Util.emptyValueOf)

Test plan

• Unit test: unwrapsSingleObjectFromArray - single-element array with non-collection return type
• Unit test: unwrapsFirstElementFromMultiElementArray - multi-element array takes first element
• Unit test: returnsNullForEmptyArrayWithSingleType - empty array returns null
• Unit test: preservesArrayWhenReturnTypeIsList - array preserved when return type is List
• Unit test: unwrapsSingleObjectFromArrayWithDelegate - unwrapping works with delegate decoder
• All existing tests continue to pass (32 total)