✨ [field] Add a utility to set an optional field to nil if empty

changes/20260318100334.feature

@@ -0,0 +1 @@
+:sparkles: `[field]` Add a utility to set an optional field to nil if empty

utils/field/fields.go

@@ -225,6 +225,11 @@ func ToOptionalOrNilIfEmpty[T any](v T) *T {
 	return ptr.ToOrNilIfEmpty(v)
 }
 
+// NilIfEmpty returns the given pointer unless it is empty and in that case returns nil. It is similar to ToOptionalOrNilIfEmpty but works on reference.
+func NilIfEmpty[T any](v *T) *T {
+	return ptr.NilIfEmpty(v)
+}
+
 // ToOptional returns a pointer to the given field value.
 func ToOptional[T any](v T) *T {
 	return ptr.To[T](v)

utils/field/fields_test.go

@@ -296,6 +296,11 @@ func TestOptionalField(t *testing.T) {
 	}
 }
 
+func TestOptionalField_Nil(t *testing.T) {
+	var test int
+	assert.Nil(t, NilIfEmpty(&test))
+}
+
 func TestEqual(t *testing.T) {
 	type T int
 	assert.True(t, Equal[T](nil, nil))

utils/ptr/pointer.go

@@ -12,10 +12,15 @@ func To[T any](v T) *T {
 // Emptiness is determined via utils/reflection.IsEmpty (e.g. "", whitespace-only strings, 0, false, nil,
 // empty slices/maps, etc.).
 func ToOrNilIfEmpty[T any](v T) *T {
+	return NilIfEmpty(To[T](v))
+}
+
+// NilIfEmpty returns v if v is not considered empty; otherwise it returns nil.
+func NilIfEmpty[T any](v *T) *T {
 	if value.IsEmpty(v) {
 		return nil
 	}
-	return To[T](v)
+	return v
 }
 
 // From returns the value pointed to by v.