generated code makeover

[andreykaipov]

This is a breaking change PR. While the usage of the client library remains the same, we introduce the following breaking changes:

• Motivated by Make API values optional #27 and InputVolumeMul doesn't accept 0 volume #60, we make all the API values optional by making every primitive request field a pointer (i.e. *int, *string, *bool). This is because values like 0, "", false respectively are all potentially valid values in requests, but if intentionally set they'll just be omitted as every field is tagged with omitempty. We also simply can't remove omitempty from our request fields as it'll make them non-optional. The solution is to introduce pointers for these fields as now we can distinguish between present, not present, and intentional zero-value fields. In addition, to ease the UX for this, we introduce a new builder pattern for param structs:

    params := inputs.NewCreateInputParams().
    	WithSceneName(scene).
    	WithInputName(name).
    	WithInputKind(kind)
    resp, err := client.Inputs.CreateInput(params)

• We simplify the generation code for complex types (like Object and Array<Object> in the protocol documentation) and try to address any missing types that were once just interface{} and map[string]any. The only fields that remain map[string]any are mostly *Settings ones which are generic enough to merit map[string]any.

  • TODO add mapstructure to all response structs so we can have a Remaining field in case any fields are missed.

    • actually on second thought idk if this is the right approach. think it would overcomplicate a lot of stuff. the motivation behind this is so that if there's a missing field from one of the response structs, a user can still access it (albeit through a map[string]any) without having to wait for me to update the library. maybe instead i can just expose the raw response? the user can then just parse it into a map[string]any themselves

      • The raw approach is what I've taken. Each response now has a GetRaw() json.RawMessage method that returns the bytes it got from the server for that response

• Change the types for fields ending in Id or Index to be ints instead of floats.

• And of course update the examples and the test generation accordingly to reflect the above.

[andreykaipov]

generate check will fail because i don't want to clutter the PR view with the diff from the generated files just yet