add complementary accessors

Author: sebastianMindee

src/main/java/com/mindee/parsing/v2/field/ObjectField.java

@@ -62,6 +62,26 @@ public LinkedHashMap<String, ListField> getListFields() {
     return listFields;
   }
 
+  /**
+   * Retrieves all subfields from the {@code fields} map as a {@link LinkedHashMap} of
+   * {@code ObjectField} objects, keyed by their field names.
+   *
+   * @return a {@link LinkedHashMap} containing the field names as keys and their corresponding
+   * {@code ObjectField} objects as values
+   */
+  public LinkedHashMap<String, ObjectField> getObjectFields() {
+    LinkedHashMap<String, ObjectField> objectFields = new LinkedHashMap<>();
+    if (fields != null) {
+      for (String fieldName : fields.keySet()) {
+        DynamicField field = fields.get(fieldName);
+        if (field != null && field.getType() == DynamicField.FieldType.OBJECT_FIELD) {
+          objectFields.put(fieldName, field.getObjectField());
+        }
+      }
+    }
+    return objectFields;
+  }
+
   /**
    * Retrieves a single sub-field from the {@code fields} map as a {@link SimpleField}.
    *
@@ -80,14 +100,14 @@ public SimpleField getSimpleField(String fieldKey) throws IllegalStateException
   }
 
   /**
-   * Retrieves a list sub-field from the {@code fields} map as a {@link SimpleField}.
+   * Retrieves a list sub-field from the {@code fields} map as a {@link ListField}.
    *
    * @param fieldKey the name/key of the field to retrieve
-   * @return the corresponding {@link SimpleField}, or {@code null} if {@code fields} is
+   * @return the corresponding {@link ListField}, or {@code null} if {@code fields} is
    * {@code null}
    * or if no field exists for {@code fieldKey} (depending on {@code fields}' behavior)
    * @throws IllegalStateException if the referenced field exists but is not of type
-   * {@code SIMPLE_FIELD}
+   * {@code LIST_FIELD}
    */
   public ListField getListField(String fieldKey) {
     if (fields == null) {
@@ -96,6 +116,23 @@ public ListField getListField(String fieldKey) {
     return fields.getListField(fieldKey);
   }
 
+  /**
+   * Retrieves an object sub-field from the {@code fields} map as a {@link ObjectField}.
+   *
+   * @param fieldKey the name/key of the field to retrieve
+   * @return the corresponding {@link ObjectField}, or {@code null} if {@code fields} is
+   * {@code null}
+   * or if no field exists for {@code fieldKey} (depending on {@code fields}' behavior)
+   * @throws IllegalStateException if the referenced field exists but is not of type
+   * {@code OBJECT_FIELD}
+   */
+  public ObjectField getObjectField(String fieldKey) {
+    if (fields == null) {
+      return null;
+    }
+    return fields.getObjectField(fieldKey);
+  }
+
   @Override
   public String toString() {
     return "\n" + (fields != null ? fields.toString(1) : "");

src/test/java/com/mindee/parsing/v2/InferenceTest.java

@@ -181,10 +181,12 @@ void deepNestedFields_mustExposeCorrectTypes() throws IOException {
       assertNotNull(root.get("field_object").getObjectField());
 
       ObjectField fieldObject = root.get("field_object").getObjectField();
+      assertNotNull(fieldObject.getObjectField("sub_object_object"));
       InferenceFields lvl1 = fieldObject.getFields();
       assertNotNull(lvl1.get("sub_object_list").getListField());
       assertNotNull(lvl1.get("sub_object_object").getObjectField());
       assertEquals(1, lvl1.get("sub_object_object").getObjectField().getListFields().size());
+      assertEquals(1, lvl1.get("sub_object_object").getObjectField().getObjectFields().size());
       assertEquals(
         1,
         lvl1