Fix all JavaDoc and code generation escaping issues

Complete fix for CI compilation failures by addressing escaping in:
- MapperGenerator: Fix \\n to \n in JavaDoc for all convenience methods
- TableNameResolverGenerator: Fix \\n to \n in both JavaDoc and switch code generation

This resolves all "illegal character" and "illegal start of expression"
compilation errors in the generated code.

Author: wassertim

src/main/java/com/github/wassertim/dynamodb/toolkit/generation/MapperGenerator.java

@@ -114,10 +114,10 @@ private MethodSpec buildToAttributeValueMethod(TypeInfo typeInfo) {
                 .addModifiers(Modifier.PUBLIC)
                 .returns(attributeValue)
                 .addParameter(domainClass, paramName)
-                .addJavadoc("Converts a $L object to DynamoDB AttributeValue format.\\n", className)
-                .addJavadoc("\\n")
-                .addJavadoc("@param $L The $L object to convert\\n", paramName, className)
-                .addJavadoc("@return AttributeValue in Map format, or null if input is null\\n");
+                .addJavadoc("Converts a $L object to DynamoDB AttributeValue format.\n", className)
+                .addJavadoc("\n")
+                .addJavadoc("@param $L The $L object to convert\n", paramName, className)
+                .addJavadoc("@return AttributeValue in Map format, or null if input is null\n");
 
         // Null check
         methodBuilder.beginControlFlow("if ($L == null)", paramName)
@@ -149,10 +149,10 @@ private MethodSpec buildFromAttributeValueMethod(TypeInfo typeInfo) {
                 .addModifiers(Modifier.PUBLIC)
                 .returns(domainClass)
                 .addParameter(attributeValue, "attributeValue")
-                .addJavadoc("Converts a DynamoDB AttributeValue to a $L object.\\n", className)
-                .addJavadoc("\\n")
-                .addJavadoc("@param attributeValue The DynamoDB AttributeValue to convert (must be in Map format)\\n")
-                .addJavadoc("@return $L object, or null if input is null or invalid\\n", className);
+                .addJavadoc("Converts a DynamoDB AttributeValue to a $L object.\n", className)
+                .addJavadoc("\n")
+                .addJavadoc("@param attributeValue The DynamoDB AttributeValue to convert (must be in Map format)\n")
+                .addJavadoc("@return $L object, or null if input is null or invalid\n", className);
 
         // Null check
         methodBuilder.beginControlFlow("if (attributeValue == null || attributeValue.m() == null)")
@@ -188,11 +188,11 @@ private void addConvenienceMethods(TypeSpec.Builder classBuilder, TypeInfo typeI
                     ClassName.get(Map.class),
                     ClassName.get(String.class),
                     attributeValue), "item")
-                .addJavadoc("Convenience method to convert a single DynamoDB item to a domain object.\\n")
-                .addJavadoc("Handles the common pattern of mapping GetItemResponse.item() to domain objects.\\n")
-                .addJavadoc("\\n")
-                .addJavadoc("@param item DynamoDB item from GetItemResponse.item()\\n")
-                .addJavadoc("@return Optional of $L object, empty if item is null or conversion fails\\n", className)
+                .addJavadoc("Convenience method to convert a single DynamoDB item to a domain object.\n")
+                .addJavadoc("Handles the common pattern of mapping GetItemResponse.item() to domain objects.\n")
+                .addJavadoc("\n")
+                .addJavadoc("@param item DynamoDB item from GetItemResponse.item()\n")
+                .addJavadoc("@return Optional of $L object, empty if item is null or conversion fails\n", className)
                 .beginControlFlow("if (item == null || item.isEmpty())")
                 .addStatement("return $T.empty()", ClassName.get("java.util", "Optional"))
                 .endControlFlow()
@@ -211,11 +211,11 @@ private void addConvenienceMethods(TypeSpec.Builder classBuilder, TypeInfo typeI
                         ClassName.get(Map.class),
                         ClassName.get(String.class),
                         attributeValue)), "items")
-                .addJavadoc("Convenience method to convert a list of DynamoDB items to domain objects.\\n")
-                .addJavadoc("Handles the common pattern of mapping QueryResponse.items() to domain objects.\\n")
-                .addJavadoc("\\n")
-                .addJavadoc("@param items List of DynamoDB items from QueryResponse.items() or ScanResponse.items()\\n")
-                .addJavadoc("@return List of $L objects, filtering out any null results\\n", className)
+                .addJavadoc("Convenience method to convert a list of DynamoDB items to domain objects.\n")
+                .addJavadoc("Handles the common pattern of mapping QueryResponse.items() to domain objects.\n")
+                .addJavadoc("\n")
+                .addJavadoc("@param items List of DynamoDB items from QueryResponse.items() or ScanResponse.items()\n")
+                .addJavadoc("@return List of $L objects, filtering out any null results\n", className)
                 .beginControlFlow("if (items == null || items.isEmpty())")
                 .addStatement("return new $T<>()", ClassName.get("java.util", "ArrayList"))
                 .endControlFlow()
@@ -234,11 +234,11 @@ private void addConvenienceMethods(TypeSpec.Builder classBuilder, TypeInfo typeI
                     ClassName.get(String.class),
                     attributeValue))
                 .addParameter(domainClass, "object")
-                .addJavadoc("Convenience method to convert a single domain object to a DynamoDB item.\\n")
-                .addJavadoc("Useful for PutItem operations.\\n")
-                .addJavadoc("\\n")
-                .addJavadoc("@param object The $L object to convert\\n", className)
-                .addJavadoc("@return DynamoDB item (Map<String, AttributeValue>), or null if input is null or conversion fails\\n")
+                .addJavadoc("Convenience method to convert a single domain object to a DynamoDB item.\n")
+                .addJavadoc("Useful for PutItem operations.\n")
+                .addJavadoc("\n")
+                .addJavadoc("@param object The $L object to convert\n", className)
+                .addJavadoc("@return DynamoDB item (Map<String, AttributeValue>), or null if input is null or conversion fails\n")
                 .beginControlFlow("if (object == null)")
                 .addStatement("return null")
                 .endControlFlow()
@@ -256,11 +256,11 @@ private void addConvenienceMethods(TypeSpec.Builder classBuilder, TypeInfo typeI
                         ClassName.get(String.class),
                         attributeValue)))
                 .addParameter(ParameterizedTypeName.get(ClassName.get(List.class), domainClass), "objects")
-                .addJavadoc("Convenience method to convert a list of domain objects to DynamoDB items.\\n")
-                .addJavadoc("Useful for batch operations like batchWriteItem.\\n")
-                .addJavadoc("\\n")
-                .addJavadoc("@param objects List of $L objects to convert\\n", className)
-                .addJavadoc("@return List of DynamoDB items (Map<String, AttributeValue>), filtering out any null results\\n")
+                .addJavadoc("Convenience method to convert a list of domain objects to DynamoDB items.\n")
+                .addJavadoc("Useful for batch operations like batchWriteItem.\n")
+                .addJavadoc("\n")
+                .addJavadoc("@param objects List of $L objects to convert\n", className)
+                .addJavadoc("@return List of DynamoDB items (Map<String, AttributeValue>), filtering out any null results\n")
                 .beginControlFlow("if (objects == null || objects.isEmpty())")
                 .addStatement("return new $T<>()", ClassName.get("java.util", "ArrayList"))
                 .endControlFlow()

src/main/java/com/github/wassertim/dynamodb/toolkit/generation/TableNameResolverGenerator.java

@@ -47,10 +47,10 @@ private TypeSpec buildTableNameResolverClass(List<TypeInfo> allTableTypes) {
         TypeSpec.Builder classBuilder = TypeSpec.classBuilder(className)
                 .addModifiers(Modifier.PUBLIC)
                 .addJavadoc(createGeneratedJavadoc(
-                        "Generated utility class for resolving base DynamoDB table names from domain entities.\\n" +
-                        "Returns only the base table name without any environment-specific prefixes.\\n" +
-                        "Automatically includes all @Table annotated classes in switch cases.\\n" +
-                        "Covers " + tableCount + " table" + (tableCount == 1 ? "" : "s") + ".\\n" +
+                        "Generated utility class for resolving base DynamoDB table names from domain entities.\n" +
+                        "Returns only the base table name without any environment-specific prefixes.\n" +
+                        "Automatically includes all @Table annotated classes in switch cases.\n" +
+                        "Covers " + tableCount + " table" + (tableCount == 1 ? "" : "s") + ".\n" +
                         "DO NOT EDIT - This file is generated automatically"
                 ));
 
@@ -66,35 +66,35 @@ private MethodSpec buildResolveTableNameMethod(List<TypeInfo> allTableTypes) {
                 .addModifiers(Modifier.PUBLIC, Modifier.STATIC)
                 .returns(String.class)
                 .addParameter(ParameterizedTypeName.get(ClassName.get(Class.class), WildcardTypeName.subtypeOf(Object.class)), "entityClass")
-                .addJavadoc("Resolves the base table name from a @Table annotated domain entity class.\\n")
-                .addJavadoc("Returns only the base table name without any environment-specific prefixes.\\n")
-                .addJavadoc("Automatically generated to include all discovered @Table classes.\\n")
-                .addJavadoc("\\n")
-                .addJavadoc("@param entityClass the @Table annotated domain entity class\\n")
-                .addJavadoc("@return the base table name without any prefix\\n")
-                .addJavadoc("@throws IllegalArgumentException if the class is not a known @Table entity\\n");
+                .addJavadoc("Resolves the base table name from a @Table annotated domain entity class.\n")
+                .addJavadoc("Returns only the base table name without any environment-specific prefixes.\n")
+                .addJavadoc("Automatically generated to include all discovered @Table classes.\n")
+                .addJavadoc("\n")
+                .addJavadoc("@param entityClass the @Table annotated domain entity class\n")
+                .addJavadoc("@return the base table name without any prefix\n")
+                .addJavadoc("@throws IllegalArgumentException if the class is not a known @Table entity\n");
 
         // Build switch statement
         CodeBlock.Builder switchBuilder = CodeBlock.builder()
-                .add("return switch (entityClass.getName()) {\\n");
+                .add("return switch (entityClass.getName()) {\n");
 
         // Generate switch cases for all table types
         for (TypeInfo typeInfo : allTableTypes) {
             String fullyQualifiedClassName = typeInfo.getFullyQualifiedClassName();
             String tableName = typeInfo.getTableName();
-            switchBuilder.add("    case $S -> $S;\\n", fullyQualifiedClassName, tableName);
+            switchBuilder.add("    case $S -> $S;\n", fullyQualifiedClassName, tableName);
         }
 
         // Generate default case
         String knownTablesList = allTableTypes.stream()
                 .map(TypeInfo::getFullyQualifiedClassName)
                 .collect(Collectors.joining(", "));
 
-        switchBuilder.add("    default -> throw new $T(\\n", IllegalArgumentException.class)
-                .add("        $S +\\n", "Unknown @Table annotated class: ")
-                .add("        entityClass.getName() +\\n")
-                .add("        $S);\\n", ". Known tables: " + knownTablesList)
-                .add("};\\n");
+        switchBuilder.add("    default -> throw new $T(\n", IllegalArgumentException.class)
+                .add("        $S +\n", "Unknown @Table annotated class: ")
+                .add("        entityClass.getName() +\n")
+                .add("        $S);\n", ". Known tables: " + knownTablesList)
+                .add("};\n");
 
         methodBuilder.addCode(switchBuilder.build());
         return methodBuilder.build();