feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 37
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-eac90d0a78d6166dc64c49ad4cd44883ab0bd357063ff09e60ed78085e2bde3c.yml
+configured_endpoints: 38
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-155e4761d62255841349c0f8a01b0a9c463ea1d1f2d6c4fd8d1a75c8bef6f226.yml
 openapi_spec_hash: ab91f77e7c9d992400cbc7fc8a9e76c1
-config_hash: 2bea1743c84d63bd61f8501a6ea63065
+config_hash: bff282047fafdad771fb7ec685f56944

pkg/cmd/brand.go

@@ -152,6 +152,27 @@ var brandRetrieveSimplified = cli.Command{
 	HideHelpCommand: true,
 }
 
+var brandSearch = cli.Command{
+	Name:    "search",
+	Usage:   "Search brands by name or domain and get back up to 10 lightweight matches\n(domain, name, logo), most popular first: by Tranco rank, then market cap for\nbrands outside the Tranco list, with text relevance breaking ties. Matching is\nprefix-based with no typo tolerance, so it is suited to autocomplete. Only\nbrands already in the Context.dev index are returned — use /brand/retrieve to\nfetch (and index) a specific domain. Free on Pro and Scale plans; costs 1 credit\nper request on the Free and Starter plans.",
+	Suggest: true,
+	Flags: []cli.Flag{
+		&requestflag.Flag[string]{
+			Name:      "query",
+			Usage:     "Search term, matched against brand names and domains by prefix (e.g. 'nike', 'nike.com', 'nik').",
+			Required:  true,
+			QueryPath: "query",
+		},
+		&requestflag.Flag[[]string]{
+			Name:      "tag",
+			Usage:     "Optional comma-separated caller-defined tags for tracking this request. Tags are recorded on the request's usage log and can be used to filter usage on the dashboard usage page. Up to 20 tags, each 1-50 characters.",
+			QueryPath: "tags",
+		},
+	},
+	Action:          handleBrandSearch,
+	HideHelpCommand: true,
+}
+
 func handleBrandRetrieve(ctx context.Context, cmd *cli.Command) error {
 	client := contextdev.NewClient(getDefaultRequestOptions(cmd)...)
 	unusedArgs := cmd.Args().Slice()
@@ -233,3 +254,44 @@ func handleBrandRetrieveSimplified(ctx context.Context, cmd *cli.Command) error
 		Transform:      transform,
 	})
 }
+
+func handleBrandSearch(ctx context.Context, cmd *cli.Command) error {
+	client := contextdev.NewClient(getDefaultRequestOptions(cmd)...)
+	unusedArgs := cmd.Args().Slice()
+
+	if len(unusedArgs) > 0 {
+		return fmt.Errorf("Unexpected extra arguments: %v", unusedArgs)
+	}
+
+	options, err := flagOptions(
+		cmd,
+		apiquery.NestedQueryFormatBrackets,
+		apiquery.ArrayQueryFormatComma,
+		EmptyBody,
+		false,
+	)
+	if err != nil {
+		return err
+	}
+
+	params := contextdev.BrandSearchParams{}
+
+	var res []byte
+	options = append(options, option.WithResponseBodyInto(&res))
+	_, err = client.Brand.Search(ctx, params, options...)
+	if err != nil {
+		return err
+	}
+
+	obj := gjson.ParseBytes(res)
+	format := cmd.Root().String("format")
+	explicitFormat := cmd.Root().IsSet("format")
+	transform := cmd.Root().String("transform")
+	return ShowJSON(obj, ShowJSONOpts{
+		ExplicitFormat: explicitFormat,
+		Format:         format,
+		RawOutput:      cmd.Root().Bool("raw-output"),
+		Title:          "brand search",
+		Transform:      transform,
+	})
+}

pkg/cmd/brand_test.go

@@ -62,3 +62,17 @@ func TestBrandRetrieveSimplified(t *testing.T) {
 		)
 	})
 }
+
+func TestBrandSearch(t *testing.T) {
+	t.Skip("Mock server tests are disabled")
+	t.Run("regular flags", func(t *testing.T) {
+		mocktest.TestRunMockTestWithFlags(
+			t,
+			"--api-key", "string",
+			"brand", "search",
+			"--query", "x",
+			"--tag", "production",
+			"--tag", "team-alpha",
+		)
+	})
+}

pkg/cmd/cmd.go

@@ -126,6 +126,7 @@ func init() {
 				Commands: []*cli.Command{
 					&brandRetrieve,
 					&brandRetrieveSimplified,
+					&brandSearch,
 				},
 			},
 			{