feat(brand): add search metadata and country and language filters (#1945)

Stainless-Generated-From: 2456c3ddf6bd00a6022538875513744ea04b8811

Author: stlc-bot

pkg/cmd/brand.go

@@ -130,7 +130,7 @@ var brandRetrieve = requestflag.WithInnerFlags(cli.Command{
 
 var brandSearch = cli.Command{
 	Name:    "search",
-	Usage:   "Find up to 10 brands by name or domain, ordered by popularity. Use the returned\ndomain to retrieve a full brand profile.",
+	Usage:   "Find up to 10 brands by name or domain, ordered by popularity. Optionally filter\nby country and primary language; both filters must match when provided together.\nResults include description, country, and language when available. Use the\nreturned domain to retrieve a full brand profile.",
 	Suggest: true,
 	Flags: []cli.Flag{
 		&requestflag.Flag[string]{
@@ -145,6 +145,16 @@ var brandSearch = cli.Command{
 			Default:   true,
 			QueryPath: "autocomplete",
 		},
+		&requestflag.Flag[string]{
+			Name:      "country",
+			Usage:     "Only return brands in this country, as an uppercase ISO 3166-1 alpha-2 code such as US or GB.",
+			QueryPath: "country",
+		},
+		&requestflag.Flag[string]{
+			Name:      "language",
+			Usage:     "Only return brands with this primary language, such as english or french.",
+			QueryPath: "language",
+		},
 		&requestflag.Flag[[]string]{
 			Name:      "query-by",
 			Usage:     "Fields to match the search term against, as a comma-separated list or repeated parameter: 'name', 'domain', or both. Defaults to both.",

pkg/cmd/brand_test.go

@@ -79,6 +79,8 @@ func TestBrandSearch(t *testing.T) {
 			"brand", "search",
 			"--query", "x",
 			"--autocomplete=true",
+			"--country", "US",
+			"--language", "afrikaans",
 			"--query-by", "name",
 			"--tag", "production",
 			"--tag", "team-alpha",