aboutsummaryrefslogtreecommitdiff
path: root/packages/server/src/git/branch.ts
blob: 7ddf6729cfa17d5ea9adcaf9d9d30d3a10e5f097 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
import { CommitSummary } from "./commit";
import { Reference } from "./reference";
import { Repository } from "./repository";
import { Repository as NodeGitRepository } from "nodegit";
import { BranchError, createError } from "./error";

/**
 * A representation of a branch
 *
 * @extends Reference
 */
export class Branch extends Reference {
	/**
	 * Returns the branch's latest commit
	 *
	 * @returns A commit summary instance
	 */
	public async latestCommit(): Promise<CommitSummary> {
		const latest_commit = this._owner.nodegitRepository.getBranchCommit(this._ng_reference).catch(() => {
			throw(createError(BranchError, 500, "Failed to get the latest commit"));
		});

		return {
			id: (await latest_commit).sha(),
			message: (await latest_commit).message(),
			date: (await latest_commit).time()
		};
	}

	/**
	 * Lookup a branch
	 *
	 * @param owner - The repository which the branch is in
	 * @param branch - The SHA of a branch
	 * @returns An instance of a branch
	 */
	public static async lookup(owner: Repository, branch: string): Promise<Branch> {
		const reference = await owner.nodegitRepository.getBranch(branch).catch(err => {
			if(err.errno === -3) {
				throw(createError(BranchError, 404, "Branch not found!"));
			}
			throw(createError(BranchError, 500, "Something went wrong."));
		});
		return new Branch(owner, reference);
	}

	/**
	 * Returns if a branch exists or not
	 *
	 * @param owner - The repository which the branch is in
	 * @param branch - The SHA of a branch
	 * @returns Whether or not the branch exists
	 */
	public static async lookupExists(owner: NodeGitRepository, branch: string): Promise<boolean> {
		return owner.getBranch(branch)
			.then(() => true)
			.catch(() => false);
	}
}