feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 23
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/beeper%2Fbeeper-desktop-api-4acef56b00be513f305543096fdd407e6947f0a5ad268ab2e627ff30b37a75db.yml
 openapi_spec_hash: e876d796b6c25f18577f6be3944bf7d9
-config_hash: b5ac0c1579dfe6257bcdb84cfd1002fc
+config_hash: 659111d4e28efa599b5f800619ed79c2

pkg/cmd/chat.go

@@ -20,55 +20,77 @@ var chatsCreate = requestflag.WithInnerFlags(cli.Command{
 	Usage:   "Create a single/group chat (mode='create') or start a direct chat from merged\nuser data (mode='start').",
 	Suggest: true,
 	Flags: []cli.Flag{
-		&requestflag.Flag[map[string]any]{
-			Name:     "chat",
+		&requestflag.Flag[string]{
+			Name:     "account-id",
+			Usage:    "Account to create or start the chat on.",
 			Required: true,
-			BodyRoot: true,
+			BodyPath: "accountID",
+		},
+		&requestflag.Flag[bool]{
+			Name:     "allow-invite",
+			Usage:    "Whether invite-based DM creation is allowed when required by the platform. Used for mode='start'.",
+			Default:  true,
+			BodyPath: "allowInvite",
+		},
+		&requestflag.Flag[string]{
+			Name:     "message-text",
+			Usage:    "Optional first message content if the platform requires it to create the chat.",
+			BodyPath: "messageText",
+		},
+		&requestflag.Flag[string]{
+			Name:     "mode",
+			Usage:    "Operation mode. Defaults to 'create' when omitted.",
+			BodyPath: "mode",
+		},
+		&requestflag.Flag[[]string]{
+			Name:     "participant-id",
+			Usage:    "Required when mode='create'. User IDs to include in the new chat.",
+			BodyPath: "participantIDs",
+		},
+		&requestflag.Flag[string]{
+			Name:     "title",
+			Usage:    "Optional title for group chats when mode='create'; ignored for single chats on most platforms.",
+			BodyPath: "title",
+		},
+		&requestflag.Flag[string]{
+			Name:     "type",
+			Usage:    "Required when mode='create'. 'single' requires exactly one participantID; 'group' supports multiple participants and optional title.",
+			BodyPath: "type",
+		},
+		&requestflag.Flag[map[string]any]{
+			Name:     "user",
+			Usage:    "Required when mode='start'. Merged user-like contact payload used to resolve the best identifier.",
+			BodyPath: "user",
 		},
 	},
 	Action:          handleChatsCreate,
 	HideHelpCommand: true,
 }, map[string][]requestflag.HasOuterFlag{
-	"chat": {
+	"user": {
 		&requestflag.InnerFlag[string]{
-			Name:       "chat.account-id",
-			Usage:      "Account to create or start the chat on.",
-			InnerField: "accountID",
-		},
-		&requestflag.InnerFlag[bool]{
-			Name:       "chat.allow-invite",
-			Usage:      "Whether invite-based DM creation is allowed when required by the platform. Used for mode='start'.",
-			InnerField: "allowInvite",
+			Name:       "user.id",
+			Usage:      "Known user ID when available.",
+			InnerField: "id",
 		},
 		&requestflag.InnerFlag[string]{
-			Name:       "chat.message-text",
-			Usage:      "Optional first message content if the platform requires it to create the chat.",
-			InnerField: "messageText",
+			Name:       "user.email",
+			Usage:      "Email candidate.",
+			InnerField: "email",
 		},
 		&requestflag.InnerFlag[string]{
-			Name:       "chat.mode",
-			Usage:      "Operation mode. Defaults to 'create' when omitted.",
-			InnerField: "mode",
-		},
-		&requestflag.InnerFlag[[]string]{
-			Name:       "chat.participant-ids",
-			Usage:      "Required when mode='create'. User IDs to include in the new chat.",
-			InnerField: "participantIDs",
+			Name:       "user.full-name",
+			Usage:      "Display name hint used for ranking only.",
+			InnerField: "fullName",
 		},
 		&requestflag.InnerFlag[string]{
-			Name:       "chat.title",
-			Usage:      "Optional title for group chats when mode='create'; ignored for single chats on most platforms.",
-			InnerField: "title",
+			Name:       "user.phone-number",
+			Usage:      "Phone number candidate (E.164 preferred).",
+			InnerField: "phoneNumber",
 		},
 		&requestflag.InnerFlag[string]{
-			Name:       "chat.type",
-			Usage:      "Required when mode='create'. 'single' requires exactly one participantID; 'group' supports multiple participants and optional title.",
-			InnerField: "type",
-		},
-		&requestflag.InnerFlag[map[string]any]{
-			Name:       "chat.user",
-			Usage:      "Required when mode='start'. Merged user-like contact payload used to resolve the best identifier.",
-			InnerField: "user",
+			Name:       "user.username",
+			Usage:      "Username/handle candidate.",
+			InnerField: "username",
 		},
 	},
 })

pkg/cmd/chat_test.go

@@ -13,7 +13,14 @@ func TestChatsCreate(t *testing.T) {
 	mocktest.TestRunMockTestWithFlags(
 		t,
 		"chats", "create",
-		"--chat", "{accountID: accountID, allowInvite: true, messageText: messageText, mode: create, participantIDs: [string], title: title, type: single, user: {id: id, email: email, fullName: fullName, phoneNumber: phoneNumber, username: username}}",
+		"--account-id", "accountID",
+		"--allow-invite=true",
+		"--message-text", "messageText",
+		"--mode", "create",
+		"--participant-id", "string",
+		"--title", "title",
+		"--type", "single",
+		"--user", "{id: id, email: email, fullName: fullName, phoneNumber: phoneNumber, username: username}",
 	)
 
 	// Check that inner flags have been set up correctly
@@ -23,14 +30,18 @@ func TestChatsCreate(t *testing.T) {
 	mocktest.TestRunMockTestWithFlags(
 		t,
 		"chats", "create",
-		"--chat.account-id", "accountID",
-		"--chat.allow-invite=true",
-		"--chat.message-text", "messageText",
-		"--chat.mode", "create",
-		"--chat.participant-ids", "[string]",
-		"--chat.title", "title",
-		"--chat.type", "single",
-		"--chat.user", "{id: id, email: email, fullName: fullName, phoneNumber: phoneNumber, username: username}",
+		"--account-id", "accountID",
+		"--allow-invite=true",
+		"--message-text", "messageText",
+		"--mode", "create",
+		"--participant-id", "string",
+		"--title", "title",
+		"--type", "single",
+		"--user.id", "id",
+		"--user.email", "email",
+		"--user.full-name", "fullName",
+		"--user.phone-number", "phoneNumber",
+		"--user.username", "username",
 	)
 }