freestyle-sandboxes 0.0.25 → 0.0.27

package/src/index.ts

@@ -1,6 +1,66 @@
-import { Client, createClient } from "@hey-api/client-fetch";
+import { type Client, createClient } from "@hey-api/client-fetch";
 import * as sandbox_openapi from "../openapi/index.ts";
 
+import type {
+  AccessLevel,
+  CreatedToken,
+  CreateRepositoryResponseSuccess,
+  DescribePermissionResponseSuccess,
+  FreestyleCloudstateDeployRequest,
+  FreestyleCloudstateDeploySuccessResponse,
+  FreestyleDeployWebConfiguration,
+  FreestyleDeployWebSuccessResponse,
+  FreestyleExecuteScriptParamsConfiguration,
+  FreestyleExecuteScriptResultSuccess,
+  GitIdentity,
+  HandleBackupCloudstateResponse,
+  HandleCreateDomainVerificationResponse,
+  HandleDeleteDomainVerificationResponse,
+  HandleDeleteIdentityResponse,
+  HandleDeleteRepoResponse,
+  HandleGetExecuteRunResponse,
+  HandleGetLogsResponse,
+  HandleListDomainsResponse,
+  HandleListDomainVerificationRequestsResponse,
+  HandleListExecuteRunsResponse,
+  HandleListRepositoriesResponse,
+  HandleListWebDeploysResponse,
+  HandleVerifyDomainError,
+  HandleVerifyDomainResponse,
+  ListGitTokensResponseSuccess,
+  ListPermissionResponseSuccess,
+} from "../openapi/index.ts";
+
+export type {
+  AccessLevel,
+  CreatedToken,
+  CreateRepositoryResponseSuccess,
+  DescribePermissionResponseSuccess,
+  FreestyleCloudstateDeployRequest,
+  FreestyleCloudstateDeploySuccessResponse,
+  FreestyleDeployWebConfiguration,
+  FreestyleDeployWebSuccessResponse,
+  FreestyleExecuteScriptParamsConfiguration,
+  FreestyleExecuteScriptResultSuccess,
+  GitIdentity,
+  HandleBackupCloudstateResponse,
+  HandleCreateDomainVerificationResponse,
+  HandleDeleteDomainVerificationResponse,
+  HandleDeleteIdentityResponse,
+  HandleDeleteRepoResponse,
+  HandleGetExecuteRunResponse,
+  HandleGetLogsResponse,
+  HandleListDomainsResponse,
+  HandleListDomainVerificationRequestsResponse,
+  HandleListExecuteRunsResponse,
+  HandleListRepositoriesResponse,
+  HandleListWebDeploysResponse,
+  HandleVerifyDomainError,
+  HandleVerifyDomainResponse,
+  ListGitTokensResponseSuccess,
+  ListPermissionResponseSuccess,
+} from "../openapi/index.ts";
+
 export class FreestyleSandboxes {
   private client: Client;
   constructor(options: {
@@ -31,8 +91,8 @@ export class FreestyleSandboxes {
    */
   async executeScript(
     script: string,
-    config?: sandbox_openapi.FreestyleExecuteScriptParamsConfiguration
-  ): Promise<sandbox_openapi.FreestyleExecuteScriptResultSuccess> {
+    config?: FreestyleExecuteScriptParamsConfiguration,
+  ): Promise<FreestyleExecuteScriptResultSuccess> {
     const response = await sandbox_openapi.handleExecuteScript({
       client: this.client,
       body: {
@@ -43,13 +103,12 @@ export class FreestyleSandboxes {
 
     if (response.data) {
       return response.data;
-    } else {
-      throw new Error(
-        `Failed to execute script: \n\n${script}\n\nError:\n\n${JSON.stringify(
-          response
-        )}`
-      );
     }
+    throw new Error(
+      `Failed to execute script: \n\n${script}\n\nError:\n\n${JSON.stringify(
+        response,
+      )}`,
+    );
   }
 
   /**
@@ -63,8 +122,8 @@ export class FreestyleSandboxes {
         encoding?: string;
       }
     >,
-    config?: sandbox_openapi.FreestyleDeployWebConfiguration
-  ): Promise<sandbox_openapi.FreestyleDeployWebSuccessResponse> {
+    config?: FreestyleDeployWebConfiguration,
+  ): Promise<FreestyleDeployWebSuccessResponse> {
     const response = await sandbox_openapi.handleDeployWeb({
       client: this.client,
       body: {
@@ -74,28 +133,28 @@ export class FreestyleSandboxes {
     });
     if (response.data) {
       return response.data;
-    } else {
-      throw new Error(
-        `Failed to deploy web project\n\nStatus: ${response.response.status}\n\nMessage: ${response.error?.message}`
-      );
     }
+    throw new Error(
+      `Failed to deploy web project\n\nStatus: ${response.response.status}\n\nMessage: ${response.error?.message}`,
+    );
   }
 
   /**
    * Deploy a Cloudstate project to a sandbox.
    */
   async deployCloudstate(
-    body: sandbox_openapi.FreestyleCloudstateDeployRequest
-  ): Promise<sandbox_openapi.FreestyleCloudstateDeploySuccessResponse> {
+    body: FreestyleCloudstateDeployRequest,
+  ): Promise<FreestyleCloudstateDeploySuccessResponse> {
     const response = await sandbox_openapi.handleDeployCloudstate({
       client: this.client,
       body: body,
     });
+
     if (response.data) {
       return response.data;
-    } else {
-      throw new Error("Failed to deploy Cloudstate project");
     }
+
+    throw new Error("Failed to deploy Cloudstate project");
   }
 
   /**
@@ -104,20 +163,19 @@ export class FreestyleSandboxes {
    * @returns The backup of the Cloudstate project.
    * @throws An error if the backup could not be retrieved.
    */
-  async backupCloudstate(
-    id: string
-  ): Promise<sandbox_openapi.HandleBackupCloudstateResponse> {
+  async backupCloudstate(id: string): Promise<HandleBackupCloudstateResponse> {
     const response = await sandbox_openapi.handleBackupCloudstate({
       client: this.client,
       path: {
         id: id,
       },
     });
+
     if (response.data) {
       return response.data;
-    } else {
-      throw new Error("Failed to get backup of Cloudstate project");
     }
+
+    throw new Error("Failed to get backup of Cloudstate project");
   }
 
   /**
@@ -126,7 +184,7 @@ export class FreestyleSandboxes {
    * @returns The logs for the sandbox.
    * @throws An error if the logs could not be retrieved.
    */
-  async getLogs(id: string): Promise<sandbox_openapi.HandleGetLogsResponse> {
+  async getLogs(id: string): Promise<HandleGetLogsResponse> {
     const response = await sandbox_openapi.handleGetLogs({
       client: this.client,
       query: {
@@ -138,9 +196,8 @@ export class FreestyleSandboxes {
     });
     if (response.data) {
       return response.data;
-    } else {
-      throw new Error("Failed to get logs for sandbox");
     }
+    throw new Error("Failed to get logs for sandbox");
   }
 
   /**
@@ -149,8 +206,8 @@ export class FreestyleSandboxes {
    * @returns The domain verification token.
    */
   async createDomainVerificationRequest(
-    domain: string
-  ): Promise<sandbox_openapi.HandleCreateDomainVerificationResponse> {
+    domain: string,
+  ): Promise<HandleCreateDomainVerificationResponse> {
     const response = await sandbox_openapi.handleCreateDomainVerification({
       client: this.client,
       body: {
@@ -159,9 +216,9 @@ export class FreestyleSandboxes {
     });
     if (response.data) {
       return response.data;
-    } else {
-      throw new Error(response.error.message);
     }
+
+    throw new Error(response.error.message);
   }
 
   /**
@@ -170,11 +227,8 @@ export class FreestyleSandboxes {
    * @returns The domain verification request.
    */
   async verifyDomain(
-    domain: string
-  ): Promise<
-    | sandbox_openapi.HandleVerifyDomainResponse
-    | sandbox_openapi.HandleVerifyDomainError
-  > {
+    domain: string,
+  ): Promise<HandleVerifyDomainResponse | HandleVerifyDomainError> {
     const response = await sandbox_openapi.handleVerifyDomain({
       client: this.client,
       body: {
@@ -183,43 +237,42 @@ export class FreestyleSandboxes {
     });
     if (response.data) {
       return response.data;
-    } else {
-      throw new Error(
-        `Failed to verify domain ${domain}: ${response.error.message}`
-      );
     }
+    throw new Error(
+      `Failed to verify domain ${domain}: ${response.error.message}`,
+    );
   }
 
-  async listDomains(): Promise<sandbox_openapi.HandleListDomainsResponse> {
+  async listDomains(): Promise<HandleListDomainsResponse> {
     const response = await sandbox_openapi.handleListDomains({
       client: this.client,
     });
     if (response.data) {
       return response.data;
-    } else {
-      throw new Error("Failed to list domains\n" + response.error.message);
     }
+
+    throw new Error(`Failed to list domains\n${response.error.message}`);
   }
 
-  async listDomainVerificationRequests(): Promise<sandbox_openapi.HandleListDomainVerificationRequestsResponse> {
+  async listDomainVerificationRequests(): Promise<HandleListDomainVerificationRequestsResponse> {
     const response = await sandbox_openapi.handleListDomainVerificationRequests(
       {
         client: this.client,
-      }
+      },
     );
     if (response.data) {
       return response.data;
-    } else {
-      throw new Error(
-        "Failed to list domain verification requests\n" + response.error.message
-      );
     }
+
+    throw new Error(
+      `Failed to list domain verification requests\n${response.error.message}`,
+    );
   }
 
   async deleteDomainVerificationRequest(
     domain: string,
-    verificationCode: string
-  ): Promise<sandbox_openapi.HandleDeleteDomainVerificationResponse> {
+    verificationCode: string,
+  ): Promise<HandleDeleteDomainVerificationResponse> {
     const response = await sandbox_openapi.handleDeleteDomainVerification({
       client: this.client,
       body: {
@@ -229,17 +282,17 @@ export class FreestyleSandboxes {
     });
     if (response.data) {
       return response.data;
-    } else {
-      throw new Error(
-        `Failed to delete domain verification request for domain ${domain}: ${response.error.message}`
-      );
     }
+
+    throw new Error(
+      `Failed to delete domain verification request for domain ${domain}: ${response.error.message}`,
+    );
   }
 
   async listWebDeployments(
     limit?: number,
-    offset?: number
-  ): Promise<sandbox_openapi.HandleListWebDeploysResponse> {
+    offset?: number,
+  ): Promise<HandleListWebDeploysResponse> {
     const response = await sandbox_openapi.handleListWebDeploys({
       client: this.client,
       query: {
@@ -247,19 +300,20 @@ export class FreestyleSandboxes {
         offset: offset ?? 0,
       },
     });
+
     if (response.data) {
       return response.data;
-    } else {
-      throw new Error(
-        "Failed to list web deployments\n" + response.error.message
-      );
     }
+
+    throw new Error(
+      `Failed to list web deployments\n${response.error.message}`,
+    );
   }
 
   async listExecuteRuns(
     limit?: number,
-    offset?: number
-  ): Promise<sandbox_openapi.HandleListExecuteRunsResponse> {
+    offset?: number,
+  ): Promise<HandleListExecuteRunsResponse> {
     const response = await sandbox_openapi.handleListExecuteRuns({
       client: this.client,
       query: {
@@ -269,14 +323,11 @@ export class FreestyleSandboxes {
     });
     if (response.data) {
       return response.data;
-    } else {
-      throw new Error("Failed to list execute runs\n" + response.error.message);
     }
+    throw new Error(`Failed to list execute runs\n${response.error.message}`);
   }
 
-  async getExecuteRun(
-    id: string
-  ): Promise<sandbox_openapi.HandleGetExecuteRunResponse> {
+  async getExecuteRun(id: string): Promise<HandleGetExecuteRunResponse> {
     const response = await sandbox_openapi.handleGetExecuteRun({
       client: this.client,
       path: {
@@ -289,7 +340,25 @@ export class FreestyleSandboxes {
     }
 
     throw new Error(
-      `Failed to get execute run with ID ${id}: ${response.error.message}`
+      `Failed to get execute run with ID ${id}: ${response.error.message}`,
+    );
+  }
+
+  /** Provision a wildcard certificate for domain. */
+  async provisionWildcard(domain: string) {
+    const response = await sandbox_openapi.handleVerifyWildcard({
+      client: this.client,
+      path: {
+        domain,
+      },
+    });
+
+    if (response.data) {
+      return response.data;
+    }
+
+    throw new Error(
+      `Failed to provision wildcard for domain ${domain}: ${response.error.message}`,
     );
   }
 
@@ -299,19 +368,21 @@ export class FreestyleSandboxes {
    * @param name The name of the repository.
    */
   async createGitRepository(
-    name: string
-  ): Promise<sandbox_openapi.CreateRepoHandlerResponse> {
-    const response = await sandbox_openapi.createRepoHandler({
+    name: string,
+  ): Promise<CreateRepositoryResponseSuccess> {
+    const response = await sandbox_openapi.handleCreateRepo({
       client: this.client,
       body: {
         name,
       },
     });
+
     if (response.data) {
       return response.data;
     }
+
     throw new Error(
-      `Failed to create git repository ${name}: ${response.error}`
+      `Failed to create git repository ${name}: ${response.error}`,
     );
   }
 
@@ -323,18 +394,20 @@ export class FreestyleSandboxes {
    */
   async listGitRepositories(
     limit?: number,
-    offset?: number
-  ): Promise<sandbox_openapi.ListRepositoriesHandlerResponse> {
-    const response = await sandbox_openapi.listRepositoriesHandler({
+    offset?: number,
+  ): Promise<HandleListRepositoriesResponse> {
+    const response = await sandbox_openapi.handleListRepositories({
       client: this.client,
       query: {
         limit: limit ?? 10,
         offset: offset ?? 0,
       },
     });
+
     if (response.data) {
       return response.data;
     }
+
     throw new Error(`Failed to list git repositories: ${response.error}`);
   }
 
@@ -344,9 +417,9 @@ export class FreestyleSandboxes {
    * @param repositoryId The ID of the repository to delete.
    */
   async deleteGitRepository(
-    repositoryId: string
-  ): Promise<sandbox_openapi.DeleteRepoHandlerResponse> {
-    const response = await sandbox_openapi.deleteRepoHandler({
+    repositoryId: string,
+  ): Promise<HandleDeleteRepoResponse> {
+    const response = await sandbox_openapi.handleDeleteRepo({
       client: this.client,
       path: {
         repo: repositoryId,
@@ -355,29 +428,262 @@ export class FreestyleSandboxes {
 
     if (response.data) {
       return response.data;
-    } else {
-      throw new Error(
-        `Failed to delete git repository ${repositoryId}: ${response.error}`
-      );
     }
+
+    throw new Error(
+      `Failed to delete git repository ${repositoryId}: ${response.error}`,
+    );
   }
 
-  /** Provision a wildcard certificate for domain. */
-  async provisionWildcard(domain: string) {
-    const response = await sandbox_openapi.handleVerifyWildcard({
+  /**
+   * Create a new git identity.
+   */
+  async createGitIdentity(): Promise<GitIdentity> {
+    const response = await sandbox_openapi.handleCreateIdentity({
+      client: this.client,
+    });
+
+    if (response.data) {
+      return response.data;
+    }
+
+    throw new Error(`Failed to create git identity: ${response.error}`);
+  }
+
+  /**
+   * Delete a git identity.
+   *
+   * @param identityId The ID of the identity to delete.
+   */
+  async deleteGitIdentity(
+    identityId: string,
+  ): Promise<HandleDeleteIdentityResponse> {
+    const response = await sandbox_openapi.handleDeleteIdentity({
       client: this.client,
       path: {
-        domain,
+        identity: identityId,
+      },
+    });
+
+    if (response.data) {
+      return response.data;
+    }
+
+    throw new Error(`Failed to delete git identity: ${response.error}`);
+  }
+
+  /**
+   * Grant a git identity access to a repository.
+   *
+   * @param repoId The ID of the repository to grant access to.
+   * @param identityId The ID of the identity grant access to `repoId`.
+   * @param permission The permission to grant.
+   */
+  async grantGitPermission(
+    repoId: string,
+    identityId: string,
+    permission: AccessLevel,
+  ) {
+    const response = await sandbox_openapi.handleGrantPermission({
+      client: this.client,
+      path: {
+        repo: repoId,
+        identity: identityId,
+      },
+      body: {
+        permission,
+      },
+    });
+
+    if (response.data) {
+      return response.data;
+    }
+
+    throw new Error(
+      `Failed to grant access to git identity ${identityId} for repository ${repoId}: ${response.error}`,
+    );
+  }
+
+  /**
+   * Update a git identity's permissions on a repository.
+   *
+   * @param repoId The ID of the repository to update permissions for.
+   * @param identityId The ID of the identity to whose access to update.
+   * @param permission The permission to grant.
+   */
+  async updateGitPermission(
+    repoId: string,
+    identityId: string,
+    permission: AccessLevel,
+  ): Promise<void> {
+    const response = await sandbox_openapi.handleUpdatePermission({
+      client: this.client,
+      path: {
+        repo: repoId,
+        identity: identityId,
+      },
+      body: {
+        permission,
+      },
+    });
+
+    if (response.data) {
+      return;
+    }
+
+    throw new Error(
+      `Failed to update permission for git identity ${identityId} for repository ${repoId}: ${response.error}`,
+    );
+  }
+
+  /**
+   * Revoke a git identity's access to a repository.
+   *
+   * @param repoId The ID of the repository revoke access to.
+   * @param identityId The ID of the identity to revoke access from.
+   */
+  async revokeGitPermission(repoId: string, identityId: string): Promise<void> {
+    const response = await sandbox_openapi.handleRevokePermission({
+      client: this.client,
+      path: {
+        repo: repoId,
+        identity: identityId,
+      },
+    });
+
+    if (response.data) {
+      return;
+    }
+
+    throw new Error(
+      `Failed to revoke access to git identity ${identityId} for repository ${repoId}: ${response.error}`,
+    );
+  }
+
+  /**
+   * List access permissions for a git identity.
+   *
+   * @param identityId The ID of the identity to list permissions for.
+   */
+  async listGitPermissions(
+    identityId: string,
+  ): Promise<ListPermissionResponseSuccess> {
+    const response = await sandbox_openapi.handleListPermissions({
+      client: this.client,
+      path: {
+        identity: identityId,
       },
     });
 
     if (response.data) {
       return response.data;
-    } else {
-      throw new Error(
-        `Failed to provision wildcard for domain ${domain}: ${response.error.message}`
-      );
     }
+
+    throw new Error(
+      `Failed to list permissions for git identity ${identityId}: ${response.error}`,
+    );
+  }
+
+  /**
+   * Get the permission of a git identity on a repository.
+   *
+   * @param repoId The ID of the repository to check permissions for.
+   * @param identityId The ID of the identity to check permissions for.
+   */
+  async getGitPermission(
+    repoId: string,
+    identityId: string,
+  ): Promise<DescribePermissionResponseSuccess> {
+    const response = await sandbox_openapi.handleDescribePermission({
+      client: this.client,
+      path: {
+        repo: repoId,
+        identity: identityId,
+      },
+    });
+
+    if (response.data) {
+      return response.data;
+    }
+
+    throw new Error(
+      `Failed to get permission for git identity ${identityId} on repository ${repoId}: ${response.error}`,
+    );
+  }
+
+  /**
+   * Create a new git access token for an identity.
+   *
+   * @param identityId The ID of the identity to create the token for.
+   */
+  async createGitAccessToken(identityId: string): Promise<CreatedToken> {
+    const response = await sandbox_openapi.handleCreateGitToken({
+      client: this.client,
+      path: {
+        identity: identityId,
+      },
+    });
+
+    if (response.data) {
+      return response.data;
+    }
+
+    throw new Error(
+      `Failed to create git access token: ${response.error.message}`,
+    );
+  }
+
+  /**
+   * Revoke a git access token.
+   *
+   * @param identityId The ID of the identity the token belongs to.
+   * @param tokenId The ID of the token to revoke.
+   */
+  async revokeGitAccessToken(
+    identityId: string,
+    tokenId: string,
+  ): Promise<void> {
+    const response = await sandbox_openapi.handleRevokeGitToken({
+      client: this.client,
+      body: {
+        tokenId,
+      },
+      path: {
+        identity: identityId,
+      },
+    });
+
+    if (response.data) {
+      return;
+    }
+
+    throw new Error(
+      `Failed to revoke git access token ${tokenId}: ${response.error.message}`,
+    );
+  }
+
+  /**
+   * List git access tokens for an identity.
+   *
+   * @param identityId The ID of the identity to list tokens for.
+   */
+  async listGitAccessTokens(
+    identityId: string,
+  ): Promise<ListGitTokensResponseSuccess> {
+    const response = await sandbox_openapi.handleListGitTokens({
+      client: this.client,
+      path: {
+        identity: identityId,
+      },
+    });
+
+    if (response.data) {
+      return response.data;
+    }
+
+    throw new Error(
+      `Failed to list git access tokens: ${response.error.message}`,
+    );
   }
 }