Improve error messages for named params

internal/bloblang/query/params.go

@@ -380,16 +380,25 @@ func (p Params) processNamed(args map[string]interface{}) ([]interface{}, error)
 			return nil, fmt.Errorf("field %v: %w", param.Name, err)
 		}
 	}
+
 	if len(args) > 0 {
 		var unexpected []string
 		for k := range args {
 			unexpected = append(unexpected, k)
 		}
 		sort.Strings(unexpected)
+
+		optionsStr := ""
+		if len(missingParams) == 1 {
+			optionsStr = fmt.Sprintf(", did you mean %v?", missingParams[0])
+		} else if len(missingParams) > 1 {
+			optionsStr = fmt.Sprintf(", expected %v", strings.Join(missingParams, ", "))
+		}
+
 		if len(unexpected) == 1 {
-			return nil, fmt.Errorf("unknown parameter %v", unexpected[0])
+			return nil, fmt.Errorf("unknown parameter %v%v", unexpected[0], optionsStr)
 		}
-		return nil, fmt.Errorf("unknown parameters %v", strings.Join(unexpected, ", "))
+		return nil, fmt.Errorf("unknown parameters %v%v", strings.Join(unexpected, ", "), optionsStr)
 	}
 
 	if len(missingParams) == 1 {

internal/bloblang/query/params_test.go

@@ -300,6 +300,26 @@ func TestParamsNamed(t *testing.T) {
 				"first": "foo", "second": 10, "third": false, "fourth": "bar"},
 			errContains: "unknown parameter fourth",
 		},
+		{
+			name: "typo arg missing field",
+			params: NewParams().
+				Add(ParamString("first", "")).
+				Add(ParamInt64("second", "")).
+				Add(ParamBool("third", "").Default(true)),
+			input: map[string]interface{}{
+				"first": "foo", "seconde": 10, "third": false},
+			errContains: "unknown parameter seconde, did you mean second?",
+		},
+		{
+			name: "typo arg missing fields",
+			params: NewParams().
+				Add(ParamString("first", "")).
+				Add(ParamInt64("second", "")).
+				Add(ParamBool("third", "")),
+			input: map[string]interface{}{
+				"first": "foo", "seconde": 10, "thirde": false},
+			errContains: "unknown parameters seconde, thirde, expected second, third",
+		},
 		{
 			name: "bad type args",
 			params: NewParams().