@therealchristhomas/gitlab-mcp-server/dist/src/api/files.js

MCP Server for GitLab API operations

import { gitlabGet, gitlabPost, gitlabPut, encodeProjectId, encodeFilePath } from "../utils/gitlab-client.js";
import { GitLabContentSchema, GitLabCreateUpdateFileResponseSchema, GitLabCommitSchema } from "../types/index.js";
export async function getFileContents(projectId, filePath, ref) {
    if (!projectId?.trim()) {
        throw new Error("Project ID is required");
    }
    if (!filePath?.trim()) {
        throw new Error("File path is required");
    }
    const encodedPath = encodeFilePath(filePath);
    const endpoint = `/projects/${encodeProjectId(projectId)}/repository/files/${encodedPath}`;
    const refParam = ref || "HEAD";
    const data = await gitlabGet(`${endpoint}?ref=${encodeURIComponent(refParam)}`);
    const parsedData = GitLabContentSchema.parse(data);
    // Decode base64 content if it's a file
    if (!Array.isArray(parsedData) && parsedData.content) {
        parsedData.content = Buffer.from(parsedData.content, "base64").toString("utf8");
    }
    return parsedData;
}
export async function createOrUpdateFile(projectId, filePath, content, commitMessage, branch, previousPath) {
    if (!projectId?.trim()) {
        throw new Error("Project ID is required");
    }
    if (!filePath?.trim()) {
        throw new Error("File path is required");
    }
    if (!content) {
        throw new Error("File content is required");
    }
    if (!commitMessage?.trim()) {
        throw new Error("Commit message is required");
    }
    if (!branch?.trim()) {
        throw new Error("Branch is required");
    }
    const encodedPath = encodeFilePath(filePath);
    const endpoint = `/projects/${encodeProjectId(projectId)}/repository/files/${encodedPath}`;
    const body = {
        branch,
        content,
        commit_message: commitMessage,
        ...(previousPath ? { previous_path: previousPath } : {})
    };
    // Check if file exists to determine method
    let method = "POST";
    try {
        await getFileContents(projectId, filePath, branch);
        method = "PUT";
    }
    catch (error) {
        // File doesn't exist, use POST
    }
    const response = method === "POST"
        ? await gitlabPost(endpoint, body)
        : await gitlabPut(endpoint, body);
    return GitLabCreateUpdateFileResponseSchema.parse(response);
}
export async function createCommit(projectId, message, branch, actions) {
    if (!projectId?.trim()) {
        throw new Error("Project ID is required");
    }
    if (!message?.trim()) {
        throw new Error("Commit message is required");
    }
    if (!branch?.trim()) {
        throw new Error("Branch is required");
    }
    if (!actions || actions.length === 0) {
        throw new Error("At least one file action is required");
    }
    const endpoint = `/projects/${encodeProjectId(projectId)}/repository/commits`;
    const commit = await gitlabPost(endpoint, {
        branch,
        commit_message: message,
        actions: actions.map((action) => ({
            action: "create",
            file_path: action.path,
            content: action.content
        }))
    });
    return GitLabCommitSchema.parse(commit);
}