feat(api): manual updates (#40)

Author: stainless-app[bot]

Diff for: .stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 111
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-410f762771ac58738f3d165b19c5e2e9377ebbfa3f090f041e269142cfa2e7f4.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-bef0e79f204c51c91f5dca61e621e5e31c7494dccccb200e51da0c7654340816.yml

Diff for: environment.go

@@ -1082,15 +1082,18 @@ type EnvironmentSpecDevcontainer struct {
 	// ```
 	// this.matches('^$|^[^/].*')
 	// ```
-	DevcontainerFilePath string                          `json:"devcontainerFilePath"`
-	Session              string                          `json:"session"`
-	JSON                 environmentSpecDevcontainerJSON `json:"-"`
+	DevcontainerFilePath string `json:"devcontainerFilePath"`
+	// Experimental: dotfiles is the dotfiles configuration of the devcontainer
+	Dotfiles EnvironmentSpecDevcontainerDotfiles `json:"dotfiles"`
+	Session  string                              `json:"session"`
+	JSON     environmentSpecDevcontainerJSON     `json:"-"`
 }
 
 // environmentSpecDevcontainerJSON contains the JSON metadata for the struct
 // [EnvironmentSpecDevcontainer]
 type environmentSpecDevcontainerJSON struct {
 	DevcontainerFilePath apijson.Field
+	Dotfiles             apijson.Field
 	Session              apijson.Field
 	raw                  string
 	ExtraFields          map[string]apijson.Field
@@ -1104,6 +1107,39 @@ func (r environmentSpecDevcontainerJSON) RawJSON() string {
 	return r.raw
 }
 
+// Experimental: dotfiles is the dotfiles configuration of the devcontainer
+type EnvironmentSpecDevcontainerDotfiles struct {
+	// URL of a dotfiles Git repository (e.g. https://github.com/owner/repository)
+	Repository string `json:"repository,required" format:"uri"`
+	// install_command is the command to run after cloning the dotfiles repository.
+	// Defaults to run the first file of `install.sh`, `install`, `bootstrap.sh`,
+	// `bootstrap`, `setup.sh` and `setup` found in the dotfiles repository's root
+	// folder.
+	InstallCommand string `json:"installCommand"`
+	// target_path is the path to clone the dotfiles repository to. Defaults to
+	// `~/dotfiles`.
+	TargetPath string                                  `json:"targetPath"`
+	JSON       environmentSpecDevcontainerDotfilesJSON `json:"-"`
+}
+
+// environmentSpecDevcontainerDotfilesJSON contains the JSON metadata for the
+// struct [EnvironmentSpecDevcontainerDotfiles]
+type environmentSpecDevcontainerDotfilesJSON struct {
+	Repository     apijson.Field
+	InstallCommand apijson.Field
+	TargetPath     apijson.Field
+	raw            string
+	ExtraFields    map[string]apijson.Field
+}
+
+func (r *EnvironmentSpecDevcontainerDotfiles) UnmarshalJSON(data []byte) (err error) {
+	return apijson.UnmarshalRoot(data, r)
+}
+
+func (r environmentSpecDevcontainerDotfilesJSON) RawJSON() string {
+	return r.raw
+}
+
 // machine is the machine spec of the environment
 type EnvironmentSpecMachine struct {
 	// Class denotes the class of the environment we ought to start
@@ -1378,13 +1414,33 @@ type EnvironmentSpecDevcontainerParam struct {
 	// this.matches('^$|^[^/].*')
 	// ```
 	DevcontainerFilePath param.Field[string] `json:"devcontainerFilePath"`
-	Session              param.Field[string] `json:"session"`
+	// Experimental: dotfiles is the dotfiles configuration of the devcontainer
+	Dotfiles param.Field[EnvironmentSpecDevcontainerDotfilesParam] `json:"dotfiles"`
+	Session  param.Field[string]                                   `json:"session"`
 }
 
 func (r EnvironmentSpecDevcontainerParam) MarshalJSON() (data []byte, err error) {
 	return apijson.MarshalRoot(r)
 }
 
+// Experimental: dotfiles is the dotfiles configuration of the devcontainer
+type EnvironmentSpecDevcontainerDotfilesParam struct {
+	// URL of a dotfiles Git repository (e.g. https://github.com/owner/repository)
+	Repository param.Field[string] `json:"repository,required" format:"uri"`
+	// install_command is the command to run after cloning the dotfiles repository.
+	// Defaults to run the first file of `install.sh`, `install`, `bootstrap.sh`,
+	// `bootstrap`, `setup.sh` and `setup` found in the dotfiles repository's root
+	// folder.
+	InstallCommand param.Field[string] `json:"installCommand"`
+	// target_path is the path to clone the dotfiles repository to. Defaults to
+	// `~/dotfiles`.
+	TargetPath param.Field[string] `json:"targetPath"`
+}
+
+func (r EnvironmentSpecDevcontainerDotfilesParam) MarshalJSON() (data []byte, err error) {
+	return apijson.MarshalRoot(r)
+}
+
 // machine is the machine spec of the environment
 type EnvironmentSpecMachineParam struct {
 	// Class denotes the class of the environment we ought to start

Diff for: environment_test.go

@@ -56,7 +56,12 @@ func TestEnvironmentNewWithOptionalParams(t *testing.T) {
 			DesiredPhase: gitpod.F(gitpod.EnvironmentPhaseUnspecified),
 			Devcontainer: gitpod.F(gitpod.EnvironmentSpecDevcontainerParam{
 				DevcontainerFilePath: gitpod.F("devcontainerFilePath"),
-				Session:              gitpod.F("session"),
+				Dotfiles: gitpod.F(gitpod.EnvironmentSpecDevcontainerDotfilesParam{
+					Repository:     gitpod.F("https://example.com"),
+					InstallCommand: gitpod.F("installCommand"),
+					TargetPath:     gitpod.F("targetPath"),
+				}),
+				Session: gitpod.F("session"),
 			}),
 			Machine: gitpod.F(gitpod.EnvironmentSpecMachineParam{
 				Class:   gitpod.F("d2c94c27-3b76-4a42-b88c-95a85e392c68"),
@@ -294,7 +299,12 @@ func TestEnvironmentNewFromProjectWithOptionalParams(t *testing.T) {
 			DesiredPhase: gitpod.F(gitpod.EnvironmentPhaseUnspecified),
 			Devcontainer: gitpod.F(gitpod.EnvironmentSpecDevcontainerParam{
 				DevcontainerFilePath: gitpod.F("devcontainerFilePath"),
-				Session:              gitpod.F("session"),
+				Dotfiles: gitpod.F(gitpod.EnvironmentSpecDevcontainerDotfilesParam{
+					Repository:     gitpod.F("https://example.com"),
+					InstallCommand: gitpod.F("installCommand"),
+					TargetPath:     gitpod.F("targetPath"),
+				}),
+				Session: gitpod.F("session"),
 			}),
 			Machine: gitpod.F(gitpod.EnvironmentSpecMachineParam{
 				Class:   gitpod.F("d2c94c27-3b76-4a42-b88c-95a85e392c68"),

Diff for: user.go

@@ -96,7 +96,7 @@ func (r *UserService) SetSuspended(ctx context.Context, body UserSetSuspendedPar
 
 type User struct {
 	// id is a UUID of the user
-	ID string `json:"id" format:"uuid"`
+	ID string `json:"id,required" format:"uuid"`
 	// avatar_url is a link to the user avatar
 	AvatarURL string `json:"avatarUrl"`
 	// A Timestamp represents a point in time independent of any time zone or local