feat: Expose connection-specific decorated OAS

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 19
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/stainless%2Fstainless-v0-5c1008fd27f64bcde1a146a4158f1c3113b4e13437a4d880bd6811fb063cfcd6.yml
-openapi_spec_hash: 9583f62164b5dc15b10051dad6a7fca4
-config_hash: e895f7992a607a15865ed026cbe5470d
+configured_endpoints: 20
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/stainless%2Fstainless-v0-030e47a1bfd79a657974f5beddd685940ec04b1aa1786c3b2cb0f4610ad2b42c.yml
+openapi_spec_hash: 33b337af28bcc1c9aa1a5218acf2a7fe
+config_hash: ebaca4741c1a2caf1372aa5bba88d4c7

pkg/cmd/cmd.go

@@ -164,6 +164,13 @@ stl builds create --branch <branch>`,
 
 			&lintCommand,
 
+			{
+				Name:     "spec",
+				Category: "API RESOURCE",
+				Commands: []*cli.Command{
+					&specRetrieveDecoratedSpec,
+				},
+			},
 			{
 				Name:            "@manpages",
 				Usage:           "Generate documentation for 'man'",

pkg/cmd/spec.go

@@ -0,0 +1,60 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+package cmd
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/stainless-api/stainless-api-go"
+	"github.com/stainless-api/stainless-api-go/option"
+	"github.com/tidwall/gjson"
+	"github.com/urfave/cli/v3"
+)
+
+var specRetrieveDecoratedSpec = cli.Command{
+	Name:  "retrieve-decorated-spec",
+	Usage: "Retrieve the decorated spec for a given application and project.",
+	Flags: []cli.Flag{
+		&cli.StringFlag{
+			Name: "client-id",
+		},
+		&cli.StringFlag{
+			Name: "project-name",
+		},
+	},
+	Action:          handleSpecRetrieveDecoratedSpec,
+	HideHelpCommand: true,
+}
+
+func handleSpecRetrieveDecoratedSpec(ctx context.Context, cmd *cli.Command) error {
+	cc := getAPICommandContext(cmd)
+	unusedArgs := cmd.Args().Slice()
+	if !cmd.IsSet("project-name") && len(unusedArgs) > 0 {
+		cmd.Set("project-name", unusedArgs[0])
+		unusedArgs = unusedArgs[1:]
+	}
+	if len(unusedArgs) > 0 {
+		return fmt.Errorf("Unexpected extra arguments: %v", unusedArgs)
+	}
+	params := stainless.SpecGetDecoratedSpecParams{}
+	if cmd.IsSet("client-id") {
+		params.ClientID = cmd.Value("client-id").(string)
+	}
+	var res []byte
+	_, err := cc.client.Spec.GetDecoratedSpec(
+		context.TODO(),
+		cmd.Value("project-name").(string),
+		params,
+		option.WithMiddleware(cc.AsMiddleware()),
+		option.WithResponseBodyInto(&res),
+	)
+	if err != nil {
+		return err
+	}
+
+	json := gjson.Parse(string(res))
+	format := cmd.Root().String("format")
+	transform := cmd.Root().String("transform")
+	return ShowJSON("spec retrieve-decorated-spec", json, format, transform)
+}