Function getFileBlame

packages/web/src/features/git/getFileBlameApi.ts:159–214

({ path: filePath, repo: repoName, ref }: FileBlameRequest, { source }: { source?: string } = {})

};

export const getFileBlame = async ({ path: filePath, repo: repoName, ref }: FileBlameRequest, { source }: { source?: string } = {}): Promise<FileBlameResponse | ServiceError> =>
    sew(() =>
        withOptionalAuth(async ({ org, prisma, user }) => {
            if (user) {
                const resolvedSource = source ?? (await headers()).get('X-Sourcebot-Client-Source') ?? undefined;
                await createAudit({
                    action: 'user.fetched_file_blame',
                    actor: { id: user.id, type: 'user' },
                    target: { id: org.id.toString(), type: 'org' },
                    orgId: org.id,
                    metadata: { source: resolvedSource },
                });
            }

            const repo = await prisma.repo.findFirst({
                where: { name: repoName, orgId: org.id },
            });
            if (!repo) {
                return notFound(`Repository "${repoName}" not found.`);
            }

            if (!isPathValid(filePath)) {
                return fileNotFound(filePath, repoName);
            }

            if (ref !== undefined && !isGitRefValid(ref)) {
                return invalidGitRef(ref);
            }

            const { path: repoPath } = getRepoPath(repo);
            const git = simpleGit().cwd(repoPath);

            const gitRef = ref ?? repo.defaultBranch ?? 'HEAD';

            let porcelain: string;
            try {
                porcelain = await git.raw(['blame', '--porcelain', gitRef, '--', filePath]);
            } catch (error: unknown) {
                const errorMessage = error instanceof Error ? error.message : String(error);
                if (errorMessage.includes('no such path') || errorMessage.includes('does not exist') || errorMessage.includes('fatal: path') || errorMessage.includes('no such file')) {
                    return fileNotFound(filePath, repoName);
                }
                if (errorMessage.includes('unknown revision') || errorMessage.includes('bad revision') || errorMessage.includes('invalid object name')) {
                    return unresolvedGitRef(gitRef);
                }
                return unexpectedError(errorMessage);
            }

            try {
                return parsePorcelainBlame(porcelain) satisfies FileBlameResponse;
            } catch (error: unknown) {
                const errorMessage = error instanceof Error ? error.message : String(error);
                return unexpectedError(`Failed to parse git blame output: ${errorMessage}`);
            }
        })
    );