refactor(api): replace com.fasterxml.jackson with tools.jackson (Jackson 2 to Jackson 3 namespace.) (#7444)

Co-authored-by: Anthony Stirling <77850077+Frooodle@users.noreply.github.com>

app/proprietary/src/main/java/stirling/software/proprietary/cluster/valkey/ValkeyJobStore.java

@@ -17,16 +17,16 @@ import org.springframework.data.redis.core.ScanOptions;
 import org.springframework.data.redis.core.StringRedisTemplate;
 import org.springframework.stereotype.Component;
 
-import com.fasterxml.jackson.core.JsonProcessingException;
-import com.fasterxml.jackson.core.type.TypeReference;
-import com.fasterxml.jackson.databind.ObjectMapper;
-
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 
 import stirling.software.common.cluster.JobStore;
 import stirling.software.common.cluster.JobStoreEntry;
 
+import tools.jackson.core.JacksonException;
+import tools.jackson.core.type.TypeReference;
+import tools.jackson.databind.ObjectMapper;
+
 /**
  * Valkey-backed {@link JobStore}. Each job is one hash; a reverse index maps fileId to jobId.
  *
@@ -265,7 +265,7 @@ public class ValkeyJobStore implements JobStore {
         }
         try {
             return MAPPER.readValue(v.toString(), MAP_STRING);
-        } catch (JsonProcessingException e) {
+        } catch (JacksonException e) {
             log.warn(
                     "JobStore {} field 'resultMeta' is not valid JSON '{}' - treating as empty",
                     key,
@@ -277,7 +277,7 @@ public class ValkeyJobStore implements JobStore {
     private static String writeJson(Object value) {
         try {
             return MAPPER.writeValueAsString(value);
-        } catch (JsonProcessingException e) {
+        } catch (JacksonException e) {
             throw new IllegalStateException("Failed to JSON-serialize JobStore field", e);
         }
     }
@@ -286,7 +286,7 @@ public class ValkeyJobStore implements JobStore {
         try {
             List<String> parsed = MAPPER.readValue(json, LIST_STRING);
             return parsed == null ? new ArrayList<>() : parsed;
-        } catch (JsonProcessingException e) {
+        } catch (JacksonException e) {
             log.warn(
                     "JobStore {} field 'fileIds' is not valid JSON '{}' - treating as empty",
                     key,

app/proprietary/src/main/java/stirling/software/proprietary/storage/converter/JsonMapConverter.java

@@ -3,16 +3,16 @@ package stirling.software.proprietary.storage.converter;
 import java.util.HashMap;
 import java.util.Map;
 
-import com.fasterxml.jackson.core.JsonProcessingException;
-import com.fasterxml.jackson.core.type.TypeReference;
-import com.fasterxml.jackson.databind.JsonNode;
-import com.fasterxml.jackson.databind.ObjectMapper;
-
 import jakarta.persistence.AttributeConverter;
 import jakarta.persistence.Converter;
 
 import lombok.extern.slf4j.Slf4j;
 
+import tools.jackson.core.JacksonException;
+import tools.jackson.core.type.TypeReference;
+import tools.jackson.databind.JsonNode;
+import tools.jackson.databind.ObjectMapper;
+
 /**
  * JPA AttributeConverter for storing Map<String, Object> as JSON in database columns.
  *
@@ -33,7 +33,7 @@ public class JsonMapConverter implements AttributeConverter<Map<String, Object>,
 
         try {
             return objectMapper.writeValueAsString(attribute);
-        } catch (JsonProcessingException e) {
+        } catch (JacksonException e) {
             log.error("Failed to convert map to JSON", e);
             throw new RuntimeException("Failed to convert map to JSON", e);
         }
@@ -48,7 +48,7 @@ public class JsonMapConverter implements AttributeConverter<Map<String, Object>,
         try {
             // Try normal parsing first
             return objectMapper.readValue(dbData, new TypeReference<Map<String, Object>>() {});
-        } catch (JsonProcessingException e) {
+        } catch (JacksonException e) {
             // Fallback: try double-parsing for legacy double-encoded data
             // This handles data that was stored as JSON strings instead of JSON objects
             log.debug("Attempting double-decode fallback for legacy metadata format");
@@ -69,7 +69,7 @@ public class JsonMapConverter implements AttributeConverter<Map<String, Object>,
                     return objectMapper.readValue(
                             node.asText(), new TypeReference<Map<String, Object>>() {});
                 }
-            } catch (JsonProcessingException e2) {
+            } catch (JacksonException e2) {
                 log.error("Failed to parse metadata even with double-decode fallback", e2);
             }
 

app/proprietary/src/main/java/stirling/software/proprietary/workflow/controller/SigningSessionController.java

@@ -20,8 +20,6 @@ import org.springframework.web.bind.annotation.RestController;
 import org.springframework.web.multipart.MultipartFile;
 import org.springframework.web.server.ResponseStatusException;
 
-import com.fasterxml.jackson.databind.ObjectMapper;
-
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.tags.Tag;
 
@@ -44,6 +42,8 @@ import stirling.software.proprietary.workflow.service.CertificateSubmissionValid
 import stirling.software.proprietary.workflow.service.SigningFinalizationService;
 import stirling.software.proprietary.workflow.service.WorkflowSessionService;
 
+import tools.jackson.databind.ObjectMapper;
+
 @Slf4j
 @RestController
 @RequestMapping("/api/v1/security")

app/proprietary/src/main/java/stirling/software/proprietary/workflow/util/WorkflowMapper.java

@@ -4,14 +4,14 @@ import java.util.ArrayList;
 import java.util.List;
 import java.util.Map;
 
-import com.fasterxml.jackson.databind.ObjectMapper;
-
 import stirling.software.proprietary.workflow.dto.ParticipantResponse;
 import stirling.software.proprietary.workflow.dto.WetSignatureMetadata;
 import stirling.software.proprietary.workflow.dto.WorkflowSessionResponse;
 import stirling.software.proprietary.workflow.model.WorkflowParticipant;
 import stirling.software.proprietary.workflow.model.WorkflowSession;
 
+import tools.jackson.databind.ObjectMapper;
+
 /**
  * Utility class for mapping workflow entities to DTOs. Centralizes conversion logic for consistent
  * API responses.

app/saas/src/main/java/stirling/software/saas/ai/controller/AiCreateController.java

@@ -26,8 +26,8 @@ import org.springframework.web.bind.annotation.RestController;
 import org.springframework.web.server.ResponseStatusException;
 import org.springframework.web.servlet.mvc.method.annotation.StreamingResponseBody;
 
-import com.fasterxml.jackson.core.JsonProcessingException;
-import com.fasterxml.jackson.databind.ObjectMapper;
+import tools.jackson.core.JacksonException;
+import tools.jackson.databind.ObjectMapper;
 
 import io.swagger.v3.oas.annotations.Hidden;
 import io.swagger.v3.oas.annotations.tags.Tag;
@@ -167,7 +167,7 @@ public class AiCreateController {
         if (request.constraints() != null) {
             try {
                 constraintsPayload = objectMapper.writeValueAsString(request.constraints());
-            } catch (JsonProcessingException exc) {
+            } catch (JacksonException exc) {
                 throw new ResponseStatusException(
                         HttpStatus.BAD_REQUEST, "Invalid constraints payload", exc);
             }
@@ -202,7 +202,7 @@ public class AiCreateController {
         String payload;
         try {
             payload = objectMapper.writeValueAsString(request.draftSections());
-        } catch (JsonProcessingException exc) {
+        } catch (JacksonException exc) {
             throw new ResponseStatusException(
                     HttpStatus.BAD_REQUEST, "Invalid draft sections payload", exc);
         }
@@ -392,7 +392,7 @@ public class AiCreateController {
                     objectMapper
                             .getTypeFactory()
                             .constructCollectionType(List.class, DraftSection.class));
-        } catch (JsonProcessingException exc) {
+        } catch (JacksonException exc) {
             log.warn("Failed to parse draft sections payload", exc);
             return null;
         }
@@ -408,7 +408,7 @@ public class AiCreateController {
                     objectMapper
                             .getTypeFactory()
                             .constructMapType(Map.class, String.class, Object.class));
-        } catch (JsonProcessingException exc) {
+        } catch (JacksonException exc) {
             log.warn("Failed to parse outline constraints payload", exc);
             return null;
         }

app/saas/src/main/java/stirling/software/saas/ai/controller/AiCreateInternalController.java

@@ -14,8 +14,8 @@ import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 import org.springframework.web.server.ResponseStatusException;
 
-import com.fasterxml.jackson.core.JsonProcessingException;
-import com.fasterxml.jackson.databind.ObjectMapper;
+import tools.jackson.core.JacksonException;
+import tools.jackson.databind.ObjectMapper;
 
 import io.swagger.v3.oas.annotations.Hidden;
 import io.swagger.v3.oas.annotations.tags.Tag;
@@ -61,7 +61,7 @@ public class AiCreateInternalController {
             try {
                 outlineConstraintsPayload =
                         objectMapper.writeValueAsString(request.outlineConstraints());
-            } catch (JsonProcessingException exc) {
+            } catch (JacksonException exc) {
                 throw new ResponseStatusException(
                         HttpStatus.BAD_REQUEST, "Invalid outline constraints payload", exc);
             }
@@ -70,7 +70,7 @@ public class AiCreateInternalController {
         if (request.draftSections() != null) {
             try {
                 draftSectionsPayload = objectMapper.writeValueAsString(request.draftSections());
-            } catch (JsonProcessingException exc) {
+            } catch (JacksonException exc) {
                 throw new ResponseStatusException(
                         HttpStatus.BAD_REQUEST, "Invalid draft sections payload", exc);
             }
@@ -136,7 +136,7 @@ public class AiCreateInternalController {
                             .getTypeFactory()
                             .constructCollectionType(
                                     List.class, AiCreateController.DraftSection.class));
-        } catch (JsonProcessingException exc) {
+        } catch (JacksonException exc) {
             log.warn("Failed to parse draft sections payload", exc);
             return null;
         }
@@ -152,7 +152,7 @@ public class AiCreateInternalController {
                     objectMapper
                             .getTypeFactory()
                             .constructMapType(Map.class, String.class, Object.class));
-        } catch (JsonProcessingException exc) {
+        } catch (JacksonException exc) {
             log.warn("Failed to parse outline constraints payload", exc);
             return null;
         }

app/saas/src/main/java/stirling/software/saas/billing/service/StripeUsageReportingService.java

@@ -12,7 +12,7 @@ import org.springframework.beans.factory.annotation.Value;
 import org.springframework.context.annotation.Profile;
 import org.springframework.stereotype.Service;
 
-import com.fasterxml.jackson.databind.ObjectMapper;
+import tools.jackson.databind.ObjectMapper;
 
 import lombok.extern.slf4j.Slf4j;
 

app/saas/src/main/java/stirling/software/saas/legal/LegalDocumentRegistry.java

@@ -13,8 +13,8 @@ import java.util.regex.Pattern;
 import org.springframework.core.io.ClassPathResource;
 import org.springframework.stereotype.Service;
 
-import com.fasterxml.jackson.databind.JsonNode;
-import com.fasterxml.jackson.databind.ObjectMapper;
+import tools.jackson.databind.JsonNode;
+import tools.jackson.databind.ObjectMapper;
 
 import jakarta.annotation.PostConstruct;
 
@@ -56,28 +56,26 @@ public class LegalDocumentRegistry {
         subprocessorUrl = root.path("subprocessorUrl").asText("");
         eulaUrl = root.path("eulaUrl").asText("");
         JsonNode docs = root.path("documents");
-        docs.fieldNames()
-                .forEachRemaining(
-                        id -> {
-                            JsonNode d = docs.get(id);
-                            List<String> parts =
-                                    objectMapper.convertValue(
-                                            d.path("parts"),
-                                            objectMapper
-                                                    .getTypeFactory()
-                                                    .constructCollectionType(
-                                                            List.class, String.class));
-                            documents.put(
+        docs.forEachEntry(
+                (id, d) -> {
+                    List<String> parts =
+                            objectMapper.convertValue(
+                                    d.path("parts"),
+                                    objectMapper
+                                            .getTypeFactory()
+                                            .constructCollectionType(
+                                                    List.class, String.class));
+                    documents.put(
+                            id,
+                            new LegalDocumentMeta(
                                     id,
-                                    new LegalDocumentMeta(
-                                            id,
-                                            d.path("label").asText(id),
-                                            d.path("displayName").asText(id),
-                                            d.path("version").asText("0"),
-                                            d.path("effectiveDate").asText(""),
-                                            d.path("status").asText("draft"),
-                                            parts == null ? List.of() : parts));
-                        });
+                                    d.path("label").asText(id),
+                                    d.path("displayName").asText(id),
+                                    d.path("version").asText("0"),
+                                    d.path("effectiveDate").asText(""),
+                                    d.path("status").asText("draft"),
+                                    parts == null ? List.of() : parts));
+                });
         log.info("[legal] loaded {} document(s) from {}", documents.size(), MANIFEST);
     }
 

app/saas/src/main/java/stirling/software/saas/payg/entitlement/EntitlementGuard.java

@@ -20,7 +20,7 @@ import org.springframework.stereotype.Component;
 import org.springframework.web.method.HandlerMethod;
 import org.springframework.web.servlet.HandlerInterceptor;
 
-import com.fasterxml.jackson.databind.ObjectMapper;
+import tools.jackson.databind.ObjectMapper;
 
 import io.micrometer.core.instrument.Counter;
 import io.micrometer.core.instrument.MeterRegistry;

app/saas/src/main/java/stirling/software/saas/procurement/api/ProcurementController.java

@@ -18,7 +18,7 @@ import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
-import com.fasterxml.jackson.databind.ObjectMapper;
+import tools.jackson.databind.ObjectMapper;
 
 import io.swagger.v3.oas.annotations.Hidden;
 

app/saas/src/main/java/stirling/software/saas/procurement/legal/AgreementAssembler.java

@@ -10,7 +10,7 @@ import java.util.Map;
 
 import org.springframework.stereotype.Service;
 
-import com.fasterxml.jackson.databind.ObjectMapper;
+import tools.jackson.databind.ObjectMapper;
 
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;

app/saas/src/main/java/stirling/software/saas/procurement/license/KeygenEnterpriseLicenseService.java

@@ -16,8 +16,8 @@ import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
 import org.springframework.context.annotation.Profile;
 import org.springframework.stereotype.Service;
 
-import com.fasterxml.jackson.databind.JsonNode;
-import com.fasterxml.jackson.databind.ObjectMapper;
+import tools.jackson.databind.JsonNode;
+import tools.jackson.databind.ObjectMapper;
 
 import lombok.extern.slf4j.Slf4j;
 

app/saas/src/main/java/stirling/software/saas/procurement/service/ProcurementService.java

@@ -10,8 +10,8 @@ import org.springframework.context.annotation.Profile;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 
-import com.fasterxml.jackson.core.JsonProcessingException;
-import com.fasterxml.jackson.databind.ObjectMapper;
+import tools.jackson.core.JacksonException;
+import tools.jackson.databind.ObjectMapper;
 
 import lombok.extern.slf4j.Slf4j;
 
@@ -707,7 +707,7 @@ public class ProcurementService {
     private String writeLineItems(QuoteBreakdown breakdown) {
         try {
             return OBJECT_MAPPER.writeValueAsString(breakdown.lineItems());
-        } catch (JsonProcessingException e) {
+        } catch (JacksonException e) {
             log.warn("[procurement] failed to serialise line items", e);
             return "[]";
         }

app/saas/src/test/java/stirling/software/saas/payg/entitlement/EntitlementGuardTest.java

@@ -28,8 +28,8 @@ import org.springframework.security.core.context.SecurityContextHolder;
 import org.springframework.security.oauth2.jwt.Jwt;
 import org.springframework.web.method.HandlerMethod;
 
-import com.fasterxml.jackson.databind.JsonNode;
-import com.fasterxml.jackson.databind.ObjectMapper;
+import tools.jackson.databind.JsonNode;
+import tools.jackson.databind.ObjectMapper;
 
 import io.micrometer.core.instrument.MeterRegistry;
 import io.micrometer.core.instrument.simple.SimpleMeterRegistry;