🚀 Release v0.10.2 - Mutation Input Transformation and Empty String Handling

[evoludigit]

FraiseQL v0.10.2 Release

🎯 Summary

This release adds powerful input transformation capabilities to mutations and improves frontend compatibility with automatic empty string handling.

✨ New Features

1. prepare_input Hook for Mutations (Fixes #75)

Adds an optional prepare_input static method to mutation classes for transforming input data after GraphQL validation but before the PostgreSQL function call.

Use Cases:

• Multi-field transformations (IP + subnet mask → CIDR notation)
• Empty string normalization
• Date format conversions
• Coordinate transformations
• Unit conversions

Example:

@mutation
class CreateNetworkConfig:
    input: NetworkConfigInput
    success: NetworkConfigSuccess
    error: NetworkConfigError

    @staticmethod
    def prepare_input(input_data: dict) -> dict:
        """Transform IP + subnet mask to CIDR notation."""
        ip = input_data.get("ip_address")
        mask = input_data.get("subnet_mask")

        if ip and mask:
            cidr_prefix = {
                "255.255.255.0": 24,
                "255.255.0.0": 16,
            }.get(mask, 32)
            return {"ip_address": f"{ip}/{cidr_prefix}"}
        return input_data

2. Automatic Empty String to NULL Conversion

Frontends commonly send empty strings ("") when users clear text fields. FraiseQL now automatically converts empty strings to None for optional fields.

Behavior:

• Optional fields (notes: str | None): Accept "", convert to None ✅
• Required fields (name: str): Reject "" with validation error ❌

Example:

# Frontend sends:
{ id: "123", notes: "" }

# Database receives:
{ id: "123", notes: null }

📊 Benefits

✅ Clean separation of frontend and backend data formats
✅ No custom resolvers needed for common transformations
✅ Standard frontend form behavior supported
✅ Type safety and data quality maintained
✅ Non-breaking: existing mutations work unchanged

🧪 Test Coverage

• ✅ 3 new prepare_input hook tests
• ✅ 6 new empty string conversion tests
• ✅ All 3,295 existing tests pass (no regressions)

📝 Commits in This Release

• 58dc9a8 ✨ Add prepare_input hook and empty string to NULL conversion for mutations
• c23f5f1 🔖 Bump version to 0.10.2

📚 Documentation

See RELEASE_NOTES_v0.10.2.md for comprehensive documentation.

🔖 Version Information

• Version: 0.10.2
• Tag: v0.10.2
• Previous Version: 0.10.1

🔗 Related Issues

Fixes #75

---

Ready to merge - All tests pass, fully documented, and 100% backward compatible.

[evoludigit]

Closing old PR as part of repository cleanup