feat: add decode options for stricter field and type validation, explicit None handling (#970)

Includes benchmarks, examples, stricter error handling, and new tests for decoding controls.

Author: ziflex

pkg/sdk/conversion_bench_test.go

@@ -64,6 +64,30 @@ func BenchmarkDecodeNested(b *testing.B) {
 	}
 }
 
+func BenchmarkDecodeNestedStrict(b *testing.B) {
+	input, err := sdk.Encode(b.Context(), benchmarkInput)
+	if err != nil {
+		b.Fatal(err)
+	}
+
+	options := []sdk.DecodeOption{
+		sdk.RequireType(runtime.TypeMap),
+		sdk.OnlyFields("name", "address", "tags"),
+		sdk.DisallowUnknownFields(),
+		sdk.DisallowNoneValues(),
+	}
+
+	b.ReportAllocs()
+	b.ResetTimer()
+
+	for b.Loop() {
+		var output benchmarkUser
+		if err := sdk.Decode(b.Context(), input, &output, options...); err != nil {
+			b.Fatal(err)
+		}
+	}
+}
+
 func BenchmarkTypedBinder(b *testing.B) {
 	left := runtime.NewString("value")
 	right := runtime.NewInt(42)

pkg/sdk/conversion_path.go

@@ -43,6 +43,10 @@ func (path *conversionPath) Restore(mark int) {
 	path.data = path.data[:mark]
 }
 
+func (path conversionPath) IsRoot() bool {
+	return len(path.data) == 1
+}
+
 func (path conversionPath) String() string {
 	return string(path.data)
 }