release: 0.3.0 (#39)

* feat(api): manual updates (#38)

* feat(api): manual updates (#40)

* release: 0.3.0

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.2.0"
+  ".": "0.3.0"
 }

.stats.yml

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

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.3.0 (2025-02-18)
+
+Full Changelog: [v0.2.0...v0.3.0](https://github.com/gitpod-io/gitpod-sdk-go/compare/v0.2.0...v0.3.0)
+
+### Features
+
+* **api:** manual updates ([#38](https://github.com/gitpod-io/gitpod-sdk-go/issues/38)) ([853ae5c](https://github.com/gitpod-io/gitpod-sdk-go/commit/853ae5cf56e0d0fef0d2371166bd167b33e4ffa5))
+* **api:** manual updates ([#40](https://github.com/gitpod-io/gitpod-sdk-go/issues/40)) ([a71a350](https://github.com/gitpod-io/gitpod-sdk-go/commit/a71a350d93dc72bb856668893583195f2d22b5c5))
+
 ## 0.2.0 (2025-02-18)
 
 Full Changelog: [v0.1.1...v0.2.0](https://github.com/gitpod-io/gitpod-sdk-go/compare/v0.1.1...v0.2.0)

README.md

@@ -24,7 +24,7 @@ Or to pin the version:
 <!-- x-release-please-start-version -->
 
 ```sh
-go get -u 'github.com/gitpod-io/gitpod-sdk-go@v0.2.0'
+go get -u 'github.com/gitpod-io/gitpod-sdk-go@v0.3.0'
 ```
 
 <!-- x-release-please-end -->

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
@@ -2215,7 +2271,7 @@ func (r EnvironmentStatusSSHPublicKeysPhase) IsKnown() bool {
 
 type EnvironmentNewResponse struct {
 	// +resource get environment
-	Environment Environment                `json:"environment"`
+	Environment Environment                `json:"environment,required"`
 	JSON        environmentNewResponseJSON `json:"-"`
 }
 
@@ -2237,7 +2293,7 @@ func (r environmentNewResponseJSON) RawJSON() string {
 
 type EnvironmentGetResponse struct {
 	// +resource get environment
-	Environment Environment                `json:"environment"`
+	Environment Environment                `json:"environment,required"`
 	JSON        environmentGetResponseJSON `json:"-"`
 }
 
@@ -2263,7 +2319,7 @@ type EnvironmentDeleteResponse = interface{}
 
 type EnvironmentNewFromProjectResponse struct {
 	// +resource get environment
-	Environment Environment                           `json:"environment"`
+	Environment Environment                           `json:"environment,required"`
 	JSON        environmentNewFromProjectResponseJSON `json:"-"`
 }
 
@@ -2285,7 +2341,7 @@ func (r environmentNewFromProjectResponseJSON) RawJSON() string {
 
 type EnvironmentNewLogsTokenResponse struct {
 	// access_token is the token that can be used to access the logs of the environment
-	AccessToken string                              `json:"accessToken"`
+	AccessToken string                              `json:"accessToken,required"`
 	JSON        environmentNewLogsTokenResponseJSON `json:"-"`
 }
 

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"),

environmentautomationservice.go

@@ -784,7 +784,7 @@ func (r serviceStatusJSON) RawJSON() string {
 }
 
 type EnvironmentAutomationServiceNewResponse struct {
-	Service Service                                     `json:"service"`
+	Service Service                                     `json:"service,required"`
 	JSON    environmentAutomationServiceNewResponseJSON `json:"-"`
 }
 
@@ -805,7 +805,7 @@ func (r environmentAutomationServiceNewResponseJSON) RawJSON() string {
 }
 
 type EnvironmentAutomationServiceGetResponse struct {
-	Service Service                                     `json:"service"`
+	Service Service                                     `json:"service,required"`
 	JSON    environmentAutomationServiceGetResponseJSON `json:"-"`
 }
 

environmentautomationtask.go

@@ -281,7 +281,7 @@ func (r *EnvironmentAutomationTaskService) Start(ctx context.Context, body Envir
 }
 
 type EnvironmentAutomationTaskNewResponse struct {
-	Task shared.Task                              `json:"task"`
+	Task shared.Task                              `json:"task,required"`
 	JSON environmentAutomationTaskNewResponseJSON `json:"-"`
 }
 
@@ -302,7 +302,7 @@ func (r environmentAutomationTaskNewResponseJSON) RawJSON() string {
 }
 
 type EnvironmentAutomationTaskGetResponse struct {
-	Task shared.Task                              `json:"task"`
+	Task shared.Task                              `json:"task,required"`
 	JSON environmentAutomationTaskGetResponseJSON `json:"-"`
 }
 
@@ -327,7 +327,7 @@ type EnvironmentAutomationTaskUpdateResponse = interface{}
 type EnvironmentAutomationTaskDeleteResponse = interface{}
 
 type EnvironmentAutomationTaskStartResponse struct {
-	TaskExecution shared.TaskExecution                       `json:"taskExecution"`
+	TaskExecution shared.TaskExecution                       `json:"taskExecution,required"`
 	JSON          environmentAutomationTaskStartResponseJSON `json:"-"`
 }
 

environmentautomationtaskexecution.go

@@ -169,7 +169,7 @@ func (r *EnvironmentAutomationTaskExecutionService) Stop(ctx context.Context, bo
 }
 
 type EnvironmentAutomationTaskExecutionGetResponse struct {
-	TaskExecution shared.TaskExecution                              `json:"taskExecution"`
+	TaskExecution shared.TaskExecution                              `json:"taskExecution,required"`
 	JSON          environmentAutomationTaskExecutionGetResponseJSON `json:"-"`
 }
 

internal/version.go

@@ -2,4 +2,4 @@
 
 package internal
 
-const PackageVersion = "0.2.0" // x-release-please-version
+const PackageVersion = "0.3.0" // x-release-please-version