docs(vrl): add docs for new validate flag in punycode functions (vect…

…ordotdev#19923)

* docs(vrl): add docs for new validate flag in punycode functions

Related: vectordotdev/vrl#709

* Update validate flag description

Co-authored-by: Brett Blue <84536271+brett0000FF@users.noreply.github.com>

---------

Co-authored-by: Brett Blue <84536271+brett0000FF@users.noreply.github.com>
Co-authored-by: Jesse Szwedko <jesse.szwedko@datadoghq.com>

website/cue/reference/remap/functions/decode_punycode.cue

@@ -13,6 +13,13 @@ remap: functions: decode_punycode: {
 			required:    true
 			type: ["string"]
 		},
+		{
+			name:        "validate"
+			description: "If enabled, checks if the input string is a valid domain name."
+			required:    false
+			type: ["boolean"]
+			default: true
+		},
 	]
 	internal_failure_reasons: [
 		"`value` is not valid `punycode`",
@@ -34,5 +41,12 @@ remap: functions: decode_punycode: {
 				"""
 			return: "www.cafe.com"
 		},
+		{
+			title: "Ignore validation"
+			source: """
+				decode_punycode!("xn--8hbb.xn--fiba.xn--8hbf.xn--eib.", validate: false)
+				"""
+			return: "١٠.٦٦.٣٠.٥."
+		},
 	]
 }

website/cue/reference/remap/functions/encode_punycode.cue

@@ -13,6 +13,13 @@ remap: functions: encode_punycode: {
 			required:    true
 			type: ["string"]
 		},
+		{
+			name:        "validate"
+			description: "Whether to validate the input string to check if it is a valid domain name."
+			required:    false
+			type: ["boolean"]
+			default: true
+		},
 	]
 	internal_failure_reasons: [
 		"`value` can not be encoded to `punycode`",
@@ -41,5 +48,12 @@ remap: functions: encode_punycode: {
 				"""
 			return: "www.cafe.com"
 		},
+		{
+			title: "Ignore validation"
+			source: """
+				encode_punycode!("xn--8hbb.xn--fiba.xn--8hbf.xn--eib.", validate: false)
+				"""
+			return: "xn--8hbb.xn--fiba.xn--8hbf.xn--eib."
+		},
 	]
 }