SDK regeneration

Author: fern-api[bot]

README.md

@@ -1,8 +1,10 @@
-# Lattice SDK Go library
+# Anduril Go Library
 
 ![](https://www.anduril.com/lattice-sdk/)
 
-The Lattice SDK Go library provides convenient access to the Lattice API from Go.
+[![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-Built%20with%20Fern-brightgreen)](https://buildwithfern.com?utm_source=github&utm_medium=github&utm_campaign=readme&utm_source=https%3A%2F%2Fgithub.com%2Fanduril%2Flattice-sdk-go)
+
+The Anduril Go library provides convenient access to the Anduril APIs from Go.
 
 ## Documentation
 
@@ -37,7 +39,7 @@ import (
     client "github.com/anduril/lattice-sdk-go/v2/client"
     option "github.com/anduril/lattice-sdk-go/v2/option"
     context "context"
-    Lattice "github.com/anduril/lattice-sdk-go/v2"
+    v2 "github.com/anduril/lattice-sdk-go/v2"
 )
 
 func do() {
@@ -48,7 +50,7 @@ func do() {
     )
     client.Entities.LongPollEntityEvents(
         context.TODO(),
-        &Lattice.EntityEventRequest{
+        &v2.EntityEventRequest{
             SessionToken: "sessionToken",
         },
     )
@@ -162,3 +164,17 @@ defer cancel()
 
 response, err := client.Entities.LongPollEntityEvents(ctx, ...)
 ```
+
+## Reference
+
+A full reference for this library is available [here](https://github.com/anduril/lattice-sdk-go/blob/HEAD/./reference.md).
+
+## Contributing
+
+While we value open-source contributions to this SDK, this library is generated programmatically.
+Additions made directly to this library would have to be moved over to our generation code,
+otherwise they would be overwritten upon the next generated release. Feel free to open a PR as
+a proof of concept, but know that we will not be able to merge it as-is. We suggest opening
+an issue first to discuss with us!
+
+On the other hand, contributions to the README are always very welcome!

client/client.go

@@ -24,31 +24,81 @@ type QueryEncoder interface {
 	EncodeQueryValues(key string, v *url.Values) error
 }
 
-// QueryValues encodes url.Values from request objects.
-//
-// Note: This type is inspired by Google's query encoding library, but
-// supports far less customization and is tailored to fit this SDK's use case.
-//
-// Ref: https://github.com/google/go-querystring
-func QueryValues(v interface{}) (url.Values, error) {
+// prepareValue handles common validation and unwrapping logic for both functions
+func prepareValue(v interface{}) (reflect.Value, url.Values, error) {
 	values := make(url.Values)
 	val := reflect.ValueOf(v)
 	for val.Kind() == reflect.Ptr {
 		if val.IsNil() {
-			return values, nil
+			return reflect.Value{}, values, nil
 		}
 		val = val.Elem()
 	}
 
 	if v == nil {
-		return values, nil
+		return reflect.Value{}, values, nil
 	}
 
 	if val.Kind() != reflect.Struct {
-		return nil, fmt.Errorf("query: Values() expects struct input. Got %v", val.Kind())
+		return reflect.Value{}, nil, fmt.Errorf("query: Values() expects struct input. Got %v", val.Kind())
 	}
 
 	err := reflectValue(values, val, "")
+	if err != nil {
+		return reflect.Value{}, nil, err
+	}
+
+	return val, values, nil
+}
+
+// QueryValues encodes url.Values from request objects.
+//
+// Note: This type is inspired by Google's query encoding library, but
+// supports far less customization and is tailored to fit this SDK's use case.
+//
+// Ref: https://github.com/google/go-querystring
+func QueryValues(v interface{}) (url.Values, error) {
+	_, values, err := prepareValue(v)
+	return values, err
+}
+
+// QueryValuesWithDefaults encodes url.Values from request objects
+// and default values, merging the defaults into the request.
+// It's expected that the values of defaults are wire names.
+func QueryValuesWithDefaults(v interface{}, defaults map[string]interface{}) (url.Values, error) {
+	val, values, err := prepareValue(v)
+	if err != nil {
+		return values, err
+	}
+
+	// apply defaults to zero-value fields directly on the original struct
+	valType := val.Type()
+	for i := 0; i < val.NumField(); i++ {
+		field := val.Field(i)
+		fieldType := valType.Field(i)
+		fieldName := fieldType.Name
+
+		if fieldType.PkgPath != "" && !fieldType.Anonymous {
+			// Skip unexported fields.
+			continue
+		}
+
+		// check if field is zero value and we have a default for it
+		if field.CanSet() && field.IsZero() {
+			tag := fieldType.Tag.Get("url")
+			if tag == "" || tag == "-" {
+				continue
+			}
+			wireName, _ := parseTag(tag)
+			if wireName == "" {
+				wireName = fieldName
+			}
+			if defaultVal, exists := defaults[wireName]; exists {
+				values.Set(wireName, valueString(reflect.ValueOf(defaultVal), tagOptions{}, reflect.StructField{}))
+			}
+		}
+	}
+
 	return values, err
 }