fix(upsert): allow null values in Map-based updates

Map nulls are now preserved so fields can be explicitly cleared.
Entity-based updates still strip nulls via @SbxModel's @JsonInclude.

Author: HansOspina

README.md

@@ -17,7 +17,7 @@ Java 21+ client for SBX Cloud APIs. Spring Boot 3.x compatible.
 <dependency>
     <groupId>com.github.socobox</groupId>
     <artifactId>sbxcloud-lib-java</artifactId>
-    <version>v0.0.15</version>
+    <version>v0.0.16</version>
 </dependency>
 ```
 
@@ -29,7 +29,7 @@ repositories {
 }
 
 dependencies {
-    implementation 'com.github.socobox:sbxcloud-lib-java:v0.0.15'
+    implementation 'com.github.socobox:sbxcloud-lib-java:v0.0.16'
 }
 ```
 

src/main/java/com/sbxcloud/sbx/annotation/SbxModel.java

@@ -2,6 +2,7 @@
 
 import com.fasterxml.jackson.annotation.JacksonAnnotationsInside;
 import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
 import com.fasterxml.jackson.databind.annotation.JsonNaming;
 import com.sbxcloud.sbx.jackson.SbxNamingStrategy;
 
@@ -48,6 +49,7 @@
 @JacksonAnnotationsInside
 @JsonNaming(SbxNamingStrategy.class)
 @JsonIgnoreProperties(ignoreUnknown = true)
+@JsonInclude(JsonInclude.Include.NON_NULL)
 public @interface SbxModel {
     /**
      * The SBX row_model name.

src/main/java/com/sbxcloud/sbx/client/SBXService.java

@@ -916,25 +916,22 @@ private <T> SBXResponse<T> upsert(String endpoint, String model, List<Map<String
     /**
      * Cleans a row for create/update:
      * - Removes _META/meta (read-only)
-     * - Removes null values (allows partial updates)
+     * <p>
+     * Null values are preserved so fields can be explicitly cleared.
+     * For entity-based updates, nulls are already stripped by @SbxModel's
+     * {@code @JsonInclude(NON_NULL)} during entity-to-Map conversion.
      */
     private Map<String, Object> cleanForUpsert(Map<String, Object> row) {
         var cleaned = new LinkedHashMap<String, Object>();
         for (var entry : row.entrySet()) {
             String key = entry.getKey();
-            Object value = entry.getValue();
 
             // Skip meta fields (read-only)
             if ("_META".equals(key) || "meta".equals(key)) {
                 continue;
             }
 
-            // Skip null values (allows partial updates)
-            if (value == null) {
-                continue;
-            }
-
-            cleaned.put(key, value);
+            cleaned.put(key, entry.getValue());
         }
         return cleaned;
     }

src/main/java/com/sbxcloud/sbx/model/SBXUpsertRequest.java

@@ -9,7 +9,7 @@
 /**
  * Request payload for create/update operations.
  */
-@JsonInclude(JsonInclude.Include.NON_NULL)
+@JsonInclude(JsonInclude.Include.ALWAYS)
 public record SBXUpsertRequest(
         @JsonProperty("row_model") String rowModel,
         String domain,