release: 0.3.0 (#25)

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

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

* 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-typescript/compare/v0.2.0...v0.3.0)
+
+### Features
+
+* **api:** manual updates ([#24](https://github.com/gitpod-io/gitpod-sdk-typescript/issues/24)) ([66153db](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/66153dbf178520a0a52f26e0e10b4ef1421a9317))
+* **api:** manual updates ([#26](https://github.com/gitpod-io/gitpod-sdk-typescript/issues/26)) ([b6fb638](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/b6fb638e126b63f4563b789a6e1f91a9e11f9320))
+
 ## 0.2.0 (2025-02-18)
 
 Full Changelog: [v0.1.2...v0.2.0](https://github.com/gitpod-io/gitpod-sdk-typescript/compare/v0.1.2...v0.2.0)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gitpod/sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "The official TypeScript library for the Gitpod API",
   "author": "Gitpod <[email protected]>",
   "types": "dist/index.d.ts",

src/resources/environments/automations/services.ts

@@ -501,11 +501,11 @@ export interface ServiceStatus {
 }
 
 export interface ServiceCreateResponse {
-  service?: Service;
+  service: Service;
 }
 
 export interface ServiceRetrieveResponse {
-  service?: Service;
+  service: Service;
 }
 
 export type ServiceUpdateResponse = unknown;

src/resources/environments/automations/tasks/executions.ts

@@ -108,7 +108,7 @@ export class Executions extends APIResource {
 }
 
 export interface ExecutionRetrieveResponse {
-  taskExecution?: Shared.TaskExecution;
+  taskExecution: Shared.TaskExecution;
 }
 
 export type ExecutionStopResponse = unknown;

src/resources/environments/automations/tasks/tasks.ts

@@ -218,19 +218,19 @@ export class Tasks extends APIResource {
 }
 
 export interface TaskCreateResponse {
-  task?: Shared.Task;
+  task: Shared.Task;
 }
 
 export interface TaskRetrieveResponse {
-  task?: Shared.Task;
+  task: Shared.Task;
 }
 
 export type TaskUpdateResponse = unknown;
 
 export type TaskDeleteResponse = unknown;
 
 export interface TaskStartResponse {
-  taskExecution?: Shared.TaskExecution;
+  taskExecution: Shared.TaskExecution;
 }
 
 export interface TaskCreateParams {

src/resources/environments/environments.ts

@@ -887,9 +887,40 @@ export namespace EnvironmentSpec {
      */
     devcontainerFilePath?: string;
 
+    /**
+     * Experimental: dotfiles is the dotfiles configuration of the devcontainer
+     */
+    dotfiles?: Devcontainer.Dotfiles;
+
     session?: string;
   }
 
+  export namespace Devcontainer {
+    /**
+     * Experimental: dotfiles is the dotfiles configuration of the devcontainer
+     */
+    export interface Dotfiles {
+      /**
+       * URL of a dotfiles Git repository (e.g. https://github.com/owner/repository)
+       */
+      repository: string;
+
+      /**
+       * 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;
+
+      /**
+       * target_path is the path to clone the dotfiles repository to. Defaults to
+       * `~/dotfiles`.
+       */
+      targetPath?: string;
+    }
+  }
+
   /**
    * machine is the machine spec of the environment
    */
@@ -1509,14 +1540,14 @@ export interface EnvironmentCreateResponse {
   /**
    * +resource get environment
    */
-  environment?: Environment;
+  environment: Environment;
 }
 
 export interface EnvironmentRetrieveResponse {
   /**
    * +resource get environment
    */
-  environment?: Environment;
+  environment: Environment;
 }
 
 export type EnvironmentUpdateResponse = unknown;
@@ -1527,14 +1558,14 @@ export interface EnvironmentCreateFromProjectResponse {
   /**
    * +resource get environment
    */
-  environment?: Environment;
+  environment: Environment;
 }
 
 export interface EnvironmentCreateLogsTokenResponse {
   /**
    * access_token is the token that can be used to access the logs of the environment
    */
-  accessToken?: string;
+  accessToken: string;
 }
 
 export type EnvironmentMarkActiveResponse = unknown;

src/resources/runners/configurations/host-authentication-tokens.ts

@@ -71,7 +71,7 @@ export class HostAuthenticationTokens extends APIResource {
 export type HostAuthenticationTokensTokensPage = TokensPage<HostAuthenticationToken>;
 
 export interface HostAuthenticationToken {
-  id?: string;
+  id: string;
 
   /**
    * A Timestamp represents a point in time independent of any time zone or local
@@ -180,11 +180,11 @@ export type HostAuthenticationTokenSource =
   | 'HOST_AUTHENTICATION_TOKEN_SOURCE_PAT';
 
 export interface HostAuthenticationTokenCreateResponse {
-  token?: HostAuthenticationToken;
+  token: HostAuthenticationToken;
 }
 
 export interface HostAuthenticationTokenRetrieveResponse {
-  token?: HostAuthenticationToken;
+  token: HostAuthenticationToken;
 }
 
 export type HostAuthenticationTokenUpdateResponse = unknown;

src/resources/runners/policies.ts

@@ -57,11 +57,11 @@ export interface RunnerPolicy {
 export type RunnerRole = 'RUNNER_ROLE_UNSPECIFIED' | 'RUNNER_ROLE_ADMIN' | 'RUNNER_ROLE_USER';
 
 export interface PolicyCreateResponse {
-  policy?: RunnerPolicy;
+  policy: RunnerPolicy;
 }
 
 export interface PolicyUpdateResponse {
-  policy?: RunnerPolicy;
+  policy: RunnerPolicy;
 }
 
 export type PolicyDeleteResponse = unknown;

src/resources/runners/runners.ts

@@ -550,6 +550,8 @@ export interface RunnerStatus {
 }
 
 export interface RunnerCreateResponse {
+  runner: Runner;
+
   /**
    * deprecated, will be removed. Use exchange_token instead.
    */
@@ -561,12 +563,10 @@ export interface RunnerCreateResponse {
    * expires after 24 hours.
    */
   exchangeToken?: string;
-
-  runner?: Runner;
 }
 
 export interface RunnerRetrieveResponse {
-  runner?: Runner;
+  runner: Runner;
 }
 
 export type RunnerUpdateResponse = unknown;

src/resources/shared.ts

@@ -37,6 +37,12 @@ export interface EnvironmentClass {
    */
   id: string;
 
+  /**
+   * runner_id is the unique identifier of the runner the environment class belongs
+   * to
+   */
+  runnerId: string;
+
   /**
    * configuration describes the configuration of the environment class
    */
@@ -57,12 +63,6 @@ export interface EnvironmentClass {
    * environments.
    */
   enabled?: boolean;
-
-  /**
-   * runner_id is the unique identifier of the runner the environment class belongs
-   * to
-   */
-  runnerId?: string;
 }
 
 /**
@@ -146,7 +146,7 @@ export interface Task {
 }
 
 export interface TaskExecution {
-  id?: string;
+  id: string;
 
   metadata?: TaskExecutionMetadata;
 

src/resources/users/pats.ts

@@ -379,7 +379,7 @@ export interface PersonalAccessToken {
 export type PatDeleteResponse = unknown;
 
 export interface PatGetResponse {
-  pat?: PersonalAccessToken;
+  pat: PersonalAccessToken;
 }
 
 export interface PatListParams extends PersonalAccessTokensPageParams {

src/resources/users/users.ts

@@ -84,7 +84,7 @@ export interface User {
   /**
    * id is a UUID of the user
    */
-  id?: string;
+  id: string;
 
   /**
    * avatar_url is a link to the user avatar
@@ -202,7 +202,7 @@ export interface User {
 }
 
 export interface UserGetAuthenticatedUserResponse {
-  user?: User;
+  user: User;
 }
 
 export type UserSetSuspendedResponse = unknown;

src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.2.0'; // x-release-please-version
+export const VERSION = '0.3.0'; // x-release-please-version