feat(api): update via SDK Studio

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 13
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/beeper%2Fbeeper-desktop-api-75447a6b19c812a016a6c45e1476b1de96b920ddce034ebaa7475445001b950f.yml
-openapi_spec_hash: 79e81d6d22079cc96dc079cade4f5584
-config_hash: bb65707bab3f0f379c5b19da035d3def
+configured_endpoints: 12
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/beeper%2Fbeeper-desktop-api-0e822b2bf1c6e9913f5ef95f9feb25ee9c76aa38d9b927ad181165c6a6ad6588.yml
+openapi_spec_hash: 2ec51cfeccf119e5fca24930aed25113
+config_hash: c94b6329bfcab27d3a6a65bbfb737e4a

README.md

@@ -52,14 +52,11 @@ func main() {
 	client := githubcombeeperdesktopapigo.NewClient(
 		option.WithAccessToken("My Access Token"), // defaults to os.LookupEnv("BEEPER_ACCESS_TOKEN")
 	)
-	page, err := client.V0.FindChats(context.TODO(), githubcombeeperdesktopapigo.V0FindChatsParams{
-		Limit: githubcombeeperdesktopapigo.Int(10),
-		Type:  githubcombeeperdesktopapigo.V0FindChatsParamsTypeSingle,
-	})
+	accounts, err := client.Accounts.List(context.TODO())
 	if err != nil {
 		panic(err.Error())
 	}
-	fmt.Printf("%+v\n", page)
+	fmt.Printf("%+v\n", accounts.Accounts)
 }
 
 ```
@@ -265,7 +262,7 @@ client := githubcombeeperdesktopapigo.NewClient(
 	option.WithHeader("X-Some-Header", "custom_header_info"),
 )
 
-client.V0.GetAccounts(context.TODO(), ...,
+client.Accounts.List(context.TODO(), ...,
 	// Override the header
 	option.WithHeader("X-Some-Header", "some_other_custom_header_info"),
 	// Add an undocumented field to the request body, using sjson syntax
@@ -284,7 +281,7 @@ This library provides some conveniences for working with paginated list endpoint
 You can use `.ListAutoPaging()` methods to iterate through items across all pages:
 
 ```go
-iter := client.V0.SearchMessagesAutoPaging(context.TODO(), githubcombeeperdesktopapigo.V0SearchMessagesParams{
+iter := client.Messages.SearchAutoPaging(context.TODO(), githubcombeeperdesktopapigo.MessageSearchParams{
 	Limit: githubcombeeperdesktopapigo.Int(20),
 	Query: githubcombeeperdesktopapigo.String("meeting"),
 })
@@ -302,13 +299,13 @@ Or you can use simple `.List()` methods to fetch a single page and receive a sta
 with additional helper methods like `.GetNextPage()`, e.g.:
 
 ```go
-page, err := client.V0.SearchMessages(context.TODO(), githubcombeeperdesktopapigo.V0SearchMessagesParams{
+page, err := client.Messages.Search(context.TODO(), githubcombeeperdesktopapigo.MessageSearchParams{
 	Limit: githubcombeeperdesktopapigo.Int(20),
 	Query: githubcombeeperdesktopapigo.String("meeting"),
 })
 for page != nil {
-	for _, v0 := range page.Data {
-		fmt.Printf("%+v\n", v0)
+	for _, message := range page.Data {
+		fmt.Printf("%+v\n", message)
 	}
 	page, err = page.GetNextPage()
 }
@@ -327,7 +324,7 @@ When the API returns a non-success status code, we return an error with type
 To handle errors, we recommend that you use the `errors.As` pattern:
 
 ```go
-_, err := client.V0.SendMessage(context.TODO(), githubcombeeperdesktopapigo.V0SendMessageParams{
+_, err := client.Messages.Send(context.TODO(), githubcombeeperdesktopapigo.MessageSendParams{
 	ChatID: "!invalid-chat-id",
 	Text:   githubcombeeperdesktopapigo.String("Test message"),
 })
@@ -355,7 +352,7 @@ To set a per-retry timeout, use `option.WithRequestTimeout()`.
 // This sets the timeout for the request, including all the retries.
 ctx, cancel := context.WithTimeout(context.Background(), 5*time.Minute)
 defer cancel()
-client.V0.GetAccounts(
+client.Accounts.List(
 	ctx,
 	// This sets the per-retry timeout
 	option.WithRequestTimeout(20*time.Second),
@@ -390,7 +387,7 @@ client := githubcombeeperdesktopapigo.NewClient(
 )
 
 // Override per-request:
-client.V0.GetAccounts(context.TODO(), option.WithMaxRetries(5))
+client.Accounts.List(context.TODO(), option.WithMaxRetries(5))
 ```
 
 ### Accessing raw response data (e.g. response headers)
@@ -401,11 +398,11 @@ you need to examine response headers, status codes, or other details.
 ```go
 // Create a variable to store the HTTP response
 var response *http.Response
-accountsResponse, err := client.V0.GetAccounts(context.TODO(), option.WithResponseInto(&response))
+accounts, err := client.Accounts.List(context.TODO(), option.WithResponseInto(&response))
 if err != nil {
 	// handle error
 }
-fmt.Printf("%+v\n", accountsResponse)
+fmt.Printf("%+v\n", accounts)
 
 fmt.Printf("Status Code: %d\n", response.StatusCode)
 fmt.Printf("Headers: %+#v\n", response.Header)

account.go

@@ -0,0 +1,62 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+package githubcombeeperdesktopapigo
+
+import (
+	"context"
+	"net/http"
+
+	"github.com/beeper/desktop-api-go/internal/apijson"
+	"github.com/beeper/desktop-api-go/internal/requestconfig"
+	"github.com/beeper/desktop-api-go/option"
+	"github.com/beeper/desktop-api-go/packages/respjson"
+	"github.com/beeper/desktop-api-go/shared"
+)
+
+// Accounts operations
+//
+// AccountService contains methods and other services that help with interacting
+// with the beeperdesktop API.
+//
+// Note, unlike clients, this service does not read variables from the environment
+// automatically. You should not instantiate this service directly, and instead use
+// the [NewAccountService] method instead.
+type AccountService struct {
+	Options []option.RequestOption
+}
+
+// NewAccountService generates a new service that applies the given options to each
+// request. These options are applied after the parent client's options (if there
+// is one), and before any request-specific options.
+func NewAccountService(opts ...option.RequestOption) (r AccountService) {
+	r = AccountService{}
+	r.Options = opts
+	return
+}
+
+// List connected Beeper accounts available on this device
+func (r *AccountService) List(ctx context.Context, opts ...option.RequestOption) (res *AccountListResponse, err error) {
+	opts = append(r.Options[:], opts...)
+	path := "v0/get-accounts"
+	err = requestconfig.ExecuteNewRequest(ctx, http.MethodGet, path, nil, &res, opts...)
+	return
+}
+
+// Response payload for listing connected Beeper accounts.
+type AccountListResponse struct {
+	// Connected accounts the user can act through. Includes accountID, network, and
+	// user identity.
+	Accounts []shared.Account `json:"accounts,required"`
+	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
+	JSON struct {
+		Accounts    respjson.Field
+		ExtraFields map[string]respjson.Field
+		raw         string
+	} `json:"-"`
+}
+
+// Returns the unmodified JSON received from the API
+func (r AccountListResponse) RawJSON() string { return r.JSON.raw }
+func (r *AccountListResponse) UnmarshalJSON(data []byte) error {
+	return apijson.UnmarshalRoot(data, r)
+}

account_test.go

@@ -0,0 +1,36 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+package githubcombeeperdesktopapigo_test
+
+import (
+	"context"
+	"errors"
+	"os"
+	"testing"
+
+	"github.com/beeper/desktop-api-go"
+	"github.com/beeper/desktop-api-go/internal/testutil"
+	"github.com/beeper/desktop-api-go/option"
+)
+
+func TestAccountList(t *testing.T) {
+	baseURL := "http://localhost:4010"
+	if envURL, ok := os.LookupEnv("TEST_API_BASE_URL"); ok {
+		baseURL = envURL
+	}
+	if !testutil.CheckTestServer(t, baseURL) {
+		return
+	}
+	client := githubcombeeperdesktopapigo.NewClient(
+		option.WithBaseURL(baseURL),
+		option.WithAccessToken("My Access Token"),
+	)
+	_, err := client.Accounts.List(context.TODO())
+	if err != nil {
+		var apierr *githubcombeeperdesktopapigo.Error
+		if errors.As(err, &apierr) {
+			t.Log(string(apierr.DumpRequest(true)))
+		}
+		t.Fatalf("err should be nil: %s", err.Error())
+	}
+}