@alis-build/alis-build-v1 1.17.0 → 1.20.0

package/alis/build/v1/repos_pb.d.ts

@@ -1,4 +1,4 @@
-// @generated by protoc-gen-es v2.13.0 with parameter "target=js+dts,import_extension=js,json_types=true"
+// @generated by protoc-gen-es v2.16.0 with parameter "target=js+dts,import_extension=js,json_types=true"
 // @generated from file alis/build/v1/repos.proto (package alis.build.v1, syntax proto3)
 /* eslint-disable */
 
@@ -11,12 +11,16 @@ import type { Message } from "@bufbuild/protobuf";
 export declare const file_alis_build_v1_repos: GenFile;
 
 /**
+ * An empty message, returned by RPCs that have no response data.
+ *
  * @generated from message alis.build.v1.Empty
  */
 export declare type Empty = Message<"alis.build.v1.Empty"> & {
 };
 
 /**
+ * An empty message, returned by RPCs that have no response data.
+ *
  * @generated from message alis.build.v1.Empty
  */
 export declare type EmptyJson = {
@@ -29,20 +33,30 @@ export declare type EmptyJson = {
 export declare const EmptySchema: GenMessage<Empty, {jsonType: EmptyJson}>;
 
 /**
+ * Request message for `ListRepos`.
+ *
  * @generated from message alis.build.v1.ListReposRequest
  */
 export declare type ListReposRequest = Message<"alis.build.v1.ListReposRequest"> & {
   /**
+   * The ID of the landing zone whose repositories to list.
+   * E.g. "alistest"
+   *
    * @generated from field: string landing_zone_id = 1;
    */
   landingZoneId: string;
 };
 
 /**
+ * Request message for `ListRepos`.
+ *
  * @generated from message alis.build.v1.ListReposRequest
  */
 export declare type ListReposRequestJson = {
   /**
+   * The ID of the landing zone whose repositories to list.
+   * E.g. "alistest"
+   *
    * @generated from field: string landing_zone_id = 1;
    */
   landingZoneId?: string;
@@ -55,20 +69,28 @@ export declare type ListReposRequestJson = {
 export declare const ListReposRequestSchema: GenMessage<ListReposRequest, {jsonType: ListReposRequestJson}>;
 
 /**
+ * Response message for `ListRepos`.
+ *
  * @generated from message alis.build.v1.ListReposResponse
  */
 export declare type ListReposResponse = Message<"alis.build.v1.ListReposResponse"> & {
   /**
+   * The repositories in the landing zone.
+   *
    * @generated from field: repeated alis.build.v1.Repo repos = 1;
    */
   repos: Repo[];
 };
 
 /**
+ * Response message for `ListRepos`.
+ *
  * @generated from message alis.build.v1.ListReposResponse
  */
 export declare type ListReposResponseJson = {
   /**
+   * The repositories in the landing zone.
+   *
    * @generated from field: repeated alis.build.v1.Repo repos = 1;
    */
   repos?: RepoJson[];
@@ -81,40 +103,60 @@ export declare type ListReposResponseJson = {
 export declare const ListReposResponseSchema: GenMessage<ListReposResponse, {jsonType: ListReposResponseJson}>;
 
 /**
+ * Request message for `CreateBranch`.
+ *
  * @generated from message alis.build.v1.CreateBranchRequest
  */
 export declare type CreateBranchRequest = Message<"alis.build.v1.CreateBranchRequest"> & {
   /**
+   * Format: {landing_zone_id}/{repo}
+   * E.g. "alistest/proto"
+   *
    * @generated from field: string repo = 1;
    */
   repo: string;
 
   /**
+   * The name of the branch to create.
+   * E.g. "feature-x"
+   *
    * @generated from field: string branch = 2;
    */
   branch: string;
 
   /**
+   * The reference to create the branch from, e.g. HEAD or a commit hash.
+   *
    * @generated from field: string ref = 3;
    */
   ref: string;
 };
 
 /**
+ * Request message for `CreateBranch`.
+ *
  * @generated from message alis.build.v1.CreateBranchRequest
  */
 export declare type CreateBranchRequestJson = {
   /**
+   * Format: {landing_zone_id}/{repo}
+   * E.g. "alistest/proto"
+   *
    * @generated from field: string repo = 1;
    */
   repo?: string;
 
   /**
+   * The name of the branch to create.
+   * E.g. "feature-x"
+   *
    * @generated from field: string branch = 2;
    */
   branch?: string;
 
   /**
+   * The reference to create the branch from, e.g. HEAD or a commit hash.
+   *
    * @generated from field: string ref = 3;
    */
   ref?: string;
@@ -127,20 +169,30 @@ export declare type CreateBranchRequestJson = {
 export declare const CreateBranchRequestSchema: GenMessage<CreateBranchRequest, {jsonType: CreateBranchRequestJson}>;
 
 /**
+ * A Git repository in a landing zone.
+ *
  * @generated from message alis.build.v1.Repo
  */
 export declare type Repo = Message<"alis.build.v1.Repo"> & {
   /**
+   * Format: {landing_zone_id}/{repo}
+   * E.g. "alistest/proto"
+   *
    * @generated from field: string name = 1;
    */
   name: string;
 };
 
 /**
+ * A Git repository in a landing zone.
+ *
  * @generated from message alis.build.v1.Repo
  */
 export declare type RepoJson = {
   /**
+   * Format: {landing_zone_id}/{repo}
+   * E.g. "alistest/proto"
+   *
    * @generated from field: string name = 1;
    */
   name?: string;
@@ -153,40 +205,58 @@ export declare type RepoJson = {
 export declare const RepoSchema: GenMessage<Repo, {jsonType: RepoJson}>;
 
 /**
+ * Request message for `ListBranches`.
+ *
  * @generated from message alis.build.v1.ListBranchesRequest
  */
 export declare type ListBranchesRequest = Message<"alis.build.v1.ListBranchesRequest"> & {
   /**
+   * Format: {landing_zone_id}/{repo}
+   * E.g. "alistest/proto"
+   *
    * @generated from field: string repo = 1;
    */
   repo: string;
 
   /**
+   * The number of branches to return.
+   *
    * @generated from field: int32 limit = 2;
    */
   limit: number;
 
   /**
+   * Which page to return (1-indexed).
+   *
    * @generated from field: int32 page = 3;
    */
   page: number;
 };
 
 /**
+ * Request message for `ListBranches`.
+ *
  * @generated from message alis.build.v1.ListBranchesRequest
  */
 export declare type ListBranchesRequestJson = {
   /**
+   * Format: {landing_zone_id}/{repo}
+   * E.g. "alistest/proto"
+   *
    * @generated from field: string repo = 1;
    */
   repo?: string;
 
   /**
+   * The number of branches to return.
+   *
    * @generated from field: int32 limit = 2;
    */
   limit?: number;
 
   /**
+   * Which page to return (1-indexed).
+   *
    * @generated from field: int32 page = 3;
    */
   page?: number;
@@ -199,20 +269,28 @@ export declare type ListBranchesRequestJson = {
 export declare const ListBranchesRequestSchema: GenMessage<ListBranchesRequest, {jsonType: ListBranchesRequestJson}>;
 
 /**
+ * Response message for `ListBranches`.
+ *
  * @generated from message alis.build.v1.ListBranchesResponse
  */
 export declare type ListBranchesResponse = Message<"alis.build.v1.ListBranchesResponse"> & {
   /**
+   * The branches on the requested page.
+   *
    * @generated from field: repeated alis.build.v1.Branch branches = 1;
    */
   branches: Branch[];
 };
 
 /**
+ * Response message for `ListBranches`.
+ *
  * @generated from message alis.build.v1.ListBranchesResponse
  */
 export declare type ListBranchesResponseJson = {
   /**
+   * The branches on the requested page.
+   *
    * @generated from field: repeated alis.build.v1.Branch branches = 1;
    */
   branches?: BranchJson[];
@@ -225,20 +303,28 @@ export declare type ListBranchesResponseJson = {
 export declare const ListBranchesResponseSchema: GenMessage<ListBranchesResponse, {jsonType: ListBranchesResponseJson}>;
 
 /**
+ * A branch of a repository.
+ *
  * @generated from message alis.build.v1.Branch
  */
 export declare type Branch = Message<"alis.build.v1.Branch"> & {
   /**
+   * E.g. "feature-x"
+   *
    * @generated from field: string name = 1;
    */
   name: string;
 };
 
 /**
+ * A branch of a repository.
+ *
  * @generated from message alis.build.v1.Branch
  */
 export declare type BranchJson = {
   /**
+   * E.g. "feature-x"
+   *
    * @generated from field: string name = 1;
    */
   name?: string;
@@ -251,30 +337,46 @@ export declare type BranchJson = {
 export declare const BranchSchema: GenMessage<Branch, {jsonType: BranchJson}>;
 
 /**
+ * Request message for `DeleteBranch`.
+ *
  * @generated from message alis.build.v1.DeleteBranchRequest
  */
 export declare type DeleteBranchRequest = Message<"alis.build.v1.DeleteBranchRequest"> & {
   /**
+   * Format: {landing_zone_id}/{repo}
+   * E.g. "alistest/proto"
+   *
    * @generated from field: string repo = 1;
    */
   repo: string;
 
   /**
+   * The name of the branch to delete.
+   * E.g. "feature-x"
+   *
    * @generated from field: string branch = 2;
    */
   branch: string;
 };
 
 /**
+ * Request message for `DeleteBranch`.
+ *
  * @generated from message alis.build.v1.DeleteBranchRequest
  */
 export declare type DeleteBranchRequestJson = {
   /**
+   * Format: {landing_zone_id}/{repo}
+   * E.g. "alistest/proto"
+   *
    * @generated from field: string repo = 1;
    */
   repo?: string;
 
   /**
+   * The name of the branch to delete.
+   * E.g. "feature-x"
+   *
    * @generated from field: string branch = 2;
    */
   branch?: string;
@@ -287,50 +389,76 @@ export declare type DeleteBranchRequestJson = {
 export declare const DeleteBranchRequestSchema: GenMessage<DeleteBranchRequest, {jsonType: DeleteBranchRequestJson}>;
 
 /**
+ * Request message for `CreateCommit`.
+ *
  * @generated from message alis.build.v1.CreateCommitRequest
  */
 export declare type CreateCommitRequest = Message<"alis.build.v1.CreateCommitRequest"> & {
   /**
+   * Format: {landing_zone_id}/{repo}
+   * E.g. "alistest/proto"
+   *
    * @generated from field: string repo = 1;
    */
   repo: string;
 
   /**
+   * The branch to commit to.
+   * E.g. "feature-x"
+   *
    * @generated from field: string branch = 2;
    */
   branch: string;
 
   /**
+   * The commit message.
+   * E.g. "feat: add a new feature"
+   *
    * @generated from field: string message = 3;
    */
   message: string;
 
   /**
+   * The file changes the commit makes.
+   *
    * @generated from field: repeated alis.build.v1.CreateCommitRequest.Operation operations = 4;
    */
   operations: CreateCommitRequest_Operation[];
 };
 
 /**
+ * Request message for `CreateCommit`.
+ *
  * @generated from message alis.build.v1.CreateCommitRequest
  */
 export declare type CreateCommitRequestJson = {
   /**
+   * Format: {landing_zone_id}/{repo}
+   * E.g. "alistest/proto"
+   *
    * @generated from field: string repo = 1;
    */
   repo?: string;
 
   /**
+   * The branch to commit to.
+   * E.g. "feature-x"
+   *
    * @generated from field: string branch = 2;
    */
   branch?: string;
 
   /**
+   * The commit message.
+   * E.g. "feat: add a new feature"
+   *
    * @generated from field: string message = 3;
    */
   message?: string;
 
   /**
+   * The file changes the commit makes.
+   *
    * @generated from field: repeated alis.build.v1.CreateCommitRequest.Operation operations = 4;
    */
   operations?: CreateCommitRequest_OperationJson[];
@@ -343,50 +471,70 @@ export declare type CreateCommitRequestJson = {
 export declare const CreateCommitRequestSchema: GenMessage<CreateCommitRequest, {jsonType: CreateCommitRequestJson}>;
 
 /**
+ * A change to a single file in a commit.
+ *
  * @generated from message alis.build.v1.CreateCommitRequest.Operation
  */
 export declare type CreateCommitRequest_Operation = Message<"alis.build.v1.CreateCommitRequest.Operation"> & {
   /**
+   * Path of the file relative to the repo root.
+   *
    * @generated from field: string path = 1;
    */
   path: string;
 
   /**
+   * Type of operation to perform.
+   *
    * @generated from field: alis.build.v1.CreateCommitRequest.Operation.Type type = 2;
    */
   type: CreateCommitRequest_Operation_Type;
 
   /**
+   * Content to create/update.
+   *
    * @generated from field: string content = 3;
    */
   content: string;
 
   /**
+   * The current sha of the file (not the commit). Only used for UPDATE and DELETE
+   *
    * @generated from field: string current_file_sha = 4;
    */
   currentFileSha: string;
 };
 
 /**
+ * A change to a single file in a commit.
+ *
  * @generated from message alis.build.v1.CreateCommitRequest.Operation
  */
 export declare type CreateCommitRequest_OperationJson = {
   /**
+   * Path of the file relative to the repo root.
+   *
    * @generated from field: string path = 1;
    */
   path?: string;
 
   /**
+   * Type of operation to perform.
+   *
    * @generated from field: alis.build.v1.CreateCommitRequest.Operation.Type type = 2;
    */
   type?: CreateCommitRequest_Operation_TypeJson;
 
   /**
+   * Content to create/update.
+   *
    * @generated from field: string content = 3;
    */
   content?: string;
 
   /**
+   * The current sha of the file (not the commit). Only used for UPDATE and DELETE
+   *
    * @generated from field: string current_file_sha = 4;
    */
   currentFileSha?: string;
@@ -399,31 +547,43 @@ export declare type CreateCommitRequest_OperationJson = {
 export declare const CreateCommitRequest_OperationSchema: GenMessage<CreateCommitRequest_Operation, {jsonType: CreateCommitRequest_OperationJson}>;
 
 /**
+ * The kind of change an operation makes to a file.
+ *
  * @generated from enum alis.build.v1.CreateCommitRequest.Operation.Type
  */
 export enum CreateCommitRequest_Operation_Type {
   /**
+   * Not set. The default value; should not be used.
+   *
    * @generated from enum value: UNSPECIFIED = 0;
    */
   UNSPECIFIED = 0,
 
   /**
+   * Creates a new file at `path` with `content`.
+   *
    * @generated from enum value: CREATE = 1;
    */
   CREATE = 1,
 
   /**
+   * Replaces the content of the existing file at `path` with `content`.
+   *
    * @generated from enum value: UPDATE = 2;
    */
   UPDATE = 2,
 
   /**
+   * Deletes the existing file at `path`.
+   *
    * @generated from enum value: DELETE = 3;
    */
   DELETE = 3,
 }
 
 /**
+ * The kind of change an operation makes to a file.
+ *
  * @generated from enum alis.build.v1.CreateCommitRequest.Operation.Type
  */
 export declare type CreateCommitRequest_Operation_TypeJson = "UNSPECIFIED" | "CREATE" | "UPDATE" | "DELETE";
@@ -434,60 +594,86 @@ export declare type CreateCommitRequest_Operation_TypeJson = "UNSPECIFIED" | "CR
 export declare const CreateCommitRequest_Operation_TypeSchema: GenEnum<CreateCommitRequest_Operation_Type, CreateCommitRequest_Operation_TypeJson>;
 
 /**
+ * Request message for `ListCommits`.
+ *
  * @generated from message alis.build.v1.ListCommitsRequest
  */
 export declare type ListCommitsRequest = Message<"alis.build.v1.ListCommitsRequest"> & {
   /**
+   * Format: {landing_zone_id}/{repo}
+   * E.g. "alistest/proto"
+   *
    * @generated from field: string repo = 1;
    */
   repo: string;
 
   /**
+   * The commit or branch to start from, e.g. "master" or a commit hash.
+   *
    * @generated from field: string start_ref = 2;
    */
   startRef: string;
 
   /**
+   * The repo path to list commits for.
+   *
    * @generated from field: string path = 3;
    */
   path: string;
 
   /**
+   * The number of commits to return.
+   *
    * @generated from field: int32 limit = 4;
    */
   limit: number;
 
   /**
+   * Which page to return (1-indexed).
+   *
    * @generated from field: int32 page = 5;
    */
   page: number;
 };
 
 /**
+ * Request message for `ListCommits`.
+ *
  * @generated from message alis.build.v1.ListCommitsRequest
  */
 export declare type ListCommitsRequestJson = {
   /**
+   * Format: {landing_zone_id}/{repo}
+   * E.g. "alistest/proto"
+   *
    * @generated from field: string repo = 1;
    */
   repo?: string;
 
   /**
+   * The commit or branch to start from, e.g. "master" or a commit hash.
+   *
    * @generated from field: string start_ref = 2;
    */
   startRef?: string;
 
   /**
+   * The repo path to list commits for.
+   *
    * @generated from field: string path = 3;
    */
   path?: string;
 
   /**
+   * The number of commits to return.
+   *
    * @generated from field: int32 limit = 4;
    */
   limit?: number;
 
   /**
+   * Which page to return (1-indexed).
+   *
    * @generated from field: int32 page = 5;
    */
   page?: number;
@@ -500,20 +686,28 @@ export declare type ListCommitsRequestJson = {
 export declare const ListCommitsRequestSchema: GenMessage<ListCommitsRequest, {jsonType: ListCommitsRequestJson}>;
 
 /**
+ * Response message for `ListCommits`.
+ *
  * @generated from message alis.build.v1.ListCommitsResponse
  */
 export declare type ListCommitsResponse = Message<"alis.build.v1.ListCommitsResponse"> & {
   /**
+   * The commits on the requested page.
+   *
    * @generated from field: repeated alis.build.v1.Commit commits = 1;
    */
   commits: Commit[];
 };
 
 /**
+ * Response message for `ListCommits`.
+ *
  * @generated from message alis.build.v1.ListCommitsResponse
  */
 export declare type ListCommitsResponseJson = {
   /**
+   * The commits on the requested page.
+   *
    * @generated from field: repeated alis.build.v1.Commit commits = 1;
    */
   commits?: CommitJson[];
@@ -526,60 +720,84 @@ export declare type ListCommitsResponseJson = {
 export declare const ListCommitsResponseSchema: GenMessage<ListCommitsResponse, {jsonType: ListCommitsResponseJson}>;
 
 /**
+ * A commit in a repository.
+ *
  * @generated from message alis.build.v1.Commit
  */
 export declare type Commit = Message<"alis.build.v1.Commit"> & {
   /**
+   * The commit SHA.
+   *
    * @generated from field: string sha = 1;
    */
   sha: string;
 
   /**
+   * The email address of the committer.
+   *
    * @generated from field: string committer_email = 2;
    */
   committerEmail: string;
 
   /**
+   * The time the commit was created.
+   *
    * @generated from field: string created_at = 3;
    */
   createdAt: string;
 
   /**
+   * The commit message.
+   *
    * @generated from field: string message = 4;
    */
   message: string;
 
   /**
+   * The files the commit changed.
+   *
    * @generated from field: repeated alis.build.v1.Commit.Change changes = 5;
    */
   changes: Commit_Change[];
 };
 
 /**
+ * A commit in a repository.
+ *
  * @generated from message alis.build.v1.Commit
  */
 export declare type CommitJson = {
   /**
+   * The commit SHA.
+   *
    * @generated from field: string sha = 1;
    */
   sha?: string;
 
   /**
+   * The email address of the committer.
+   *
    * @generated from field: string committer_email = 2;
    */
   committerEmail?: string;
 
   /**
+   * The time the commit was created.
+   *
    * @generated from field: string created_at = 3;
    */
   createdAt?: string;
 
   /**
+   * The commit message.
+   *
    * @generated from field: string message = 4;
    */
   message?: string;
 
   /**
+   * The files the commit changed.
+   *
    * @generated from field: repeated alis.build.v1.Commit.Change changes = 5;
    */
   changes?: Commit_ChangeJson[];
@@ -592,30 +810,46 @@ export declare type CommitJson = {
 export declare const CommitSchema: GenMessage<Commit, {jsonType: CommitJson}>;
 
 /**
+ * A file changed by a commit.
+ *
  * @generated from message alis.build.v1.Commit.Change
  */
 export declare type Commit_Change = Message<"alis.build.v1.Commit.Change"> & {
   /**
+   * Path of the file relative to the repo root.
+   * E.g. "folder/file.proto"
+   *
    * @generated from field: string path = 1;
    */
   path: string;
 
   /**
+   * How the commit changed the file.
+   * E.g. added/modified/deleted
+   *
    * @generated from field: string status = 2;
    */
   status: string;
 };
 
 /**
+ * A file changed by a commit.
+ *
  * @generated from message alis.build.v1.Commit.Change
  */
 export declare type Commit_ChangeJson = {
   /**
+   * Path of the file relative to the repo root.
+   * E.g. "folder/file.proto"
+   *
    * @generated from field: string path = 1;
    */
   path?: string;
 
   /**
+   * How the commit changed the file.
+   * E.g. added/modified/deleted
+   *
    * @generated from field: string status = 2;
    */
   status?: string;
@@ -628,40 +862,58 @@ export declare type Commit_ChangeJson = {
 export declare const Commit_ChangeSchema: GenMessage<Commit_Change, {jsonType: Commit_ChangeJson}>;
 
 /**
+ * Request message for `ListFiles`.
+ *
  * @generated from message alis.build.v1.ListFilesRequest
  */
 export declare type ListFilesRequest = Message<"alis.build.v1.ListFilesRequest"> & {
   /**
+   * Format: {landing_zone_id}/{repo}
+   * E.g. "alistest/proto"
+   *
    * @generated from field: string repo = 1;
    */
   repo: string;
 
   /**
+   * The branch or commit to list files for, e.g. HEAD or a commit hash.
+   *
    * @generated from field: string ref = 2;
    */
   ref: string;
 
   /**
+   * The repo path to list files for.
+   *
    * @generated from field: string path = 3;
    */
   path: string;
 };
 
 /**
+ * Request message for `ListFiles`.
+ *
  * @generated from message alis.build.v1.ListFilesRequest
  */
 export declare type ListFilesRequestJson = {
   /**
+   * Format: {landing_zone_id}/{repo}
+   * E.g. "alistest/proto"
+   *
    * @generated from field: string repo = 1;
    */
   repo?: string;
 
   /**
+   * The branch or commit to list files for, e.g. HEAD or a commit hash.
+   *
    * @generated from field: string ref = 2;
    */
   ref?: string;
 
   /**
+   * The repo path to list files for.
+   *
    * @generated from field: string path = 3;
    */
   path?: string;
@@ -674,20 +926,28 @@ export declare type ListFilesRequestJson = {
 export declare const ListFilesRequestSchema: GenMessage<ListFilesRequest, {jsonType: ListFilesRequestJson}>;
 
 /**
+ * Response message for `ListFiles`.
+ *
  * @generated from message alis.build.v1.ListFilesResponse
  */
 export declare type ListFilesResponse = Message<"alis.build.v1.ListFilesResponse"> & {
   /**
+   * The files under the requested path.
+   *
    * @generated from field: repeated alis.build.v1.ListFilesResponse.File files = 1;
    */
   files: ListFilesResponse_File[];
 };
 
 /**
+ * Response message for `ListFiles`.
+ *
  * @generated from message alis.build.v1.ListFilesResponse
  */
 export declare type ListFilesResponseJson = {
   /**
+   * The files under the requested path.
+   *
    * @generated from field: repeated alis.build.v1.ListFilesResponse.File files = 1;
    */
   files?: ListFilesResponse_FileJson[];
@@ -700,30 +960,44 @@ export declare type ListFilesResponseJson = {
 export declare const ListFilesResponseSchema: GenMessage<ListFilesResponse, {jsonType: ListFilesResponseJson}>;
 
 /**
+ * A file in a repository.
+ *
  * @generated from message alis.build.v1.ListFilesResponse.File
  */
 export declare type ListFilesResponse_File = Message<"alis.build.v1.ListFilesResponse.File"> & {
   /**
+   * Path of the file relative to the repo root.
+   * E.g. "folder/file.proto"
+   *
    * @generated from field: string path = 1;
    */
   path: string;
 
   /**
+   * The sha of the file (not the commit).
+   *
    * @generated from field: string sha = 2;
    */
   sha: string;
 };
 
 /**
+ * A file in a repository.
+ *
  * @generated from message alis.build.v1.ListFilesResponse.File
  */
 export declare type ListFilesResponse_FileJson = {
   /**
+   * Path of the file relative to the repo root.
+   * E.g. "folder/file.proto"
+   *
    * @generated from field: string path = 1;
    */
   path?: string;
 
   /**
+   * The sha of the file (not the commit).
+   *
    * @generated from field: string sha = 2;
    */
   sha?: string;
@@ -736,40 +1010,60 @@ export declare type ListFilesResponse_FileJson = {
 export declare const ListFilesResponse_FileSchema: GenMessage<ListFilesResponse_File, {jsonType: ListFilesResponse_FileJson}>;
 
 /**
+ * Request message for `ViewFile`.
+ *
  * @generated from message alis.build.v1.ViewFileRequest
  */
 export declare type ViewFileRequest = Message<"alis.build.v1.ViewFileRequest"> & {
   /**
+   * Format: {landing_zone_id}/{repo}
+   * E.g. "alistest/proto"
+   *
    * @generated from field: string repo = 1;
    */
   repo: string;
 
   /**
+   * The branch or commit at which to view the file for, e.g. HEAD or a commit hash.
+   *
    * @generated from field: string ref = 2;
    */
   ref: string;
 
   /**
+   * Path of the file to view, relative to the repo root.
+   * E.g. "folder/file.proto"
+   *
    * @generated from field: string path = 3;
    */
   path: string;
 };
 
 /**
+ * Request message for `ViewFile`.
+ *
  * @generated from message alis.build.v1.ViewFileRequest
  */
 export declare type ViewFileRequestJson = {
   /**
+   * Format: {landing_zone_id}/{repo}
+   * E.g. "alistest/proto"
+   *
    * @generated from field: string repo = 1;
    */
   repo?: string;
 
   /**
+   * The branch or commit at which to view the file for, e.g. HEAD or a commit hash.
+   *
    * @generated from field: string ref = 2;
    */
   ref?: string;
 
   /**
+   * Path of the file to view, relative to the repo root.
+   * E.g. "folder/file.proto"
+   *
    * @generated from field: string path = 3;
    */
   path?: string;
@@ -782,30 +1076,42 @@ export declare type ViewFileRequestJson = {
 export declare const ViewFileRequestSchema: GenMessage<ViewFileRequest, {jsonType: ViewFileRequestJson}>;
 
 /**
+ * Response message for `ViewFile`.
+ *
  * @generated from message alis.build.v1.ViewFileResponse
  */
 export declare type ViewFileResponse = Message<"alis.build.v1.ViewFileResponse"> & {
   /**
+   * The actual file content.
+   *
    * @generated from field: string content = 1;
    */
   content: string;
 
   /**
+   * The sha of the file (not the commit).
+   *
    * @generated from field: string sha = 2;
    */
   sha: string;
 };
 
 /**
+ * Response message for `ViewFile`.
+ *
  * @generated from message alis.build.v1.ViewFileResponse
  */
 export declare type ViewFileResponseJson = {
   /**
+   * The actual file content.
+   *
    * @generated from field: string content = 1;
    */
   content?: string;
 
   /**
+   * The sha of the file (not the commit).
+   *
    * @generated from field: string sha = 2;
    */
   sha?: string;
@@ -818,10 +1124,15 @@ export declare type ViewFileResponseJson = {
 export declare const ViewFileResponseSchema: GenMessage<ViewFileResponse, {jsonType: ViewFileResponseJson}>;
 
 /**
+ * Manages the Git repositories of a landing zone: their branches, commits
+ * and files.
+ *
  * @generated from service alis.build.v1.Repos
  */
 export declare const Repos: GenService<{
   /**
+   * Lists the repositories in a landing zone.
+   *
    * @generated from rpc alis.build.v1.Repos.ListRepos
    */
   listRepos: {
@@ -830,6 +1141,8 @@ export declare const Repos: GenService<{
     output: typeof ListReposResponseSchema;
   },
   /**
+   * Creates a branch in a repository, starting from an existing ref.
+   *
    * @generated from rpc alis.build.v1.Repos.CreateBranch
    */
   createBranch: {
@@ -838,6 +1151,9 @@ export declare const Repos: GenService<{
     output: typeof EmptySchema;
   },
   /**
+   * Lists the branches of a repository. Paginated with `limit` and a
+   * 1-indexed `page`.
+   *
    * @generated from rpc alis.build.v1.Repos.ListBranches
    */
   listBranches: {
@@ -846,6 +1162,8 @@ export declare const Repos: GenService<{
     output: typeof ListBranchesResponseSchema;
   },
   /**
+   * Deletes a branch from a repository.
+   *
    * @generated from rpc alis.build.v1.Repos.DeleteBranch
    */
   deleteBranch: {
@@ -854,6 +1172,9 @@ export declare const Repos: GenService<{
     output: typeof EmptySchema;
   },
   /**
+   * Creates a commit on a branch that creates, updates or deletes the files
+   * listed in `operations`.
+   *
    * @generated from rpc alis.build.v1.Repos.CreateCommit
    */
   createCommit: {
@@ -862,6 +1183,9 @@ export declare const Repos: GenService<{
     output: typeof EmptySchema;
   },
   /**
+   * Lists the commits of a repository starting from `start_ref`, optionally
+   * limited to a path. Paginated with `limit` and a 1-indexed `page`.
+   *
    * @generated from rpc alis.build.v1.Repos.ListCommits
    */
   listCommits: {
@@ -870,6 +1194,8 @@ export declare const Repos: GenService<{
     output: typeof ListCommitsResponseSchema;
   },
   /**
+   * Lists the files under a path of a repository at a given ref.
+   *
    * @generated from rpc alis.build.v1.Repos.ListFiles
    */
   listFiles: {
@@ -878,6 +1204,8 @@ export declare const Repos: GenService<{
     output: typeof ListFilesResponseSchema;
   },
   /**
+   * Returns the content and SHA of a single file at a given ref.
+   *
    * @generated from rpc alis.build.v1.Repos.ViewFile
    */
   viewFile: {