BT-4366 Encoding

[IvanAlfer]

Ticket(s): BT-4366

Problem

Create encoder

Solution

I've created the FaunaEncoder class, which provides static methods to convert Java objects to their corresponding Fauna representations. This class handles standard data types (e.g., String, Integer, Long, Double, LocalDateTime, LocalDate, Boolean, and null), as well as custom objects like Document, DocumentReference, NamedDocument, NamedDocumentReference, Module, and Query. The encoding respects Fauna's reserved tags and ensures that complex objects like lists and maps are correctly translated to Fauna queries.

Result

The FaunaEncoder utility class will centralize all encoding logic. With these changes, we will be able to maintain high data integrity when sending queries to Fauna

Testing

The FaunaEncoderTest suite ensures the correctness of encoding operations. It tests the encoding of basic types, complex objects, and edge cases, such as reserved tag conflicts and deep nesting. The suite also verifies the proper encoding of larger data structures and query interpolations. Special attention is given to the encoding of date and time to ensure timezone-awareness is maintained

---

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

[pnwpedro]

After a quick discussion, this is the plan with this PR. Cc @CLBray

• Break models into separate PR
• Develop plan for dealing with user-defined types first, and ensure that the encoding impl can support them
• PR for encoding primitives
• PR for encoding fauna special types
• PR that adapts Add support for array and object encoding fauna-python#152 requirements into map/array handling
• PR for handling user-defined types