@pschroee/redmine-mcp 0.3.1

package/dist/redmine/client.js

@@ -0,0 +1,458 @@
+export class RedmineClient {
+    baseUrl;
+    apiKey;
+    constructor(baseUrl, apiKey) {
+        this.baseUrl = baseUrl;
+        this.apiKey = apiKey;
+        // Remove trailing slash if present
+        this.baseUrl = baseUrl.replace(/\/$/, "");
+    }
+    async request(method, path, body) {
+        try {
+            const response = await fetch(`${this.baseUrl}${path}`, {
+                method,
+                headers: {
+                    "X-Redmine-API-Key": this.apiKey,
+                    "Content-Type": "application/json",
+                },
+                body: body ? JSON.stringify(body) : undefined,
+            });
+            if (!response.ok) {
+                const errorData = await response.json().catch(() => ({}));
+                const errorResponse = {
+                    error: true,
+                    status: response.status,
+                    message: errorData.errors?.join(", ") ||
+                        `HTTP ${response.status}`,
+                };
+                return errorResponse;
+            }
+            // Handle 204 No Content
+            if (response.status === 204) {
+                return {};
+            }
+            const text = await response.text();
+            if (!text) {
+                return {};
+            }
+            return JSON.parse(text);
+        }
+        catch (err) {
+            const errorResponse = {
+                error: true,
+                status: 0,
+                message: err instanceof Error ? err.message : "Unknown error",
+            };
+            return errorResponse;
+        }
+    }
+    // ==================== ISSUES ====================
+    async listIssues(params) {
+        const query = new URLSearchParams();
+        if (params?.project_id)
+            query.set("project_id", String(params.project_id));
+        if (params?.subproject_id)
+            query.set("subproject_id", params.subproject_id);
+        if (params?.tracker_id)
+            query.set("tracker_id", String(params.tracker_id));
+        if (params?.status_id)
+            query.set("status_id", String(params.status_id));
+        if (params?.assigned_to_id)
+            query.set("assigned_to_id", String(params.assigned_to_id));
+        if (params?.parent_id)
+            query.set("parent_id", String(params.parent_id));
+        if (params?.author_id)
+            query.set("author_id", String(params.author_id));
+        if (params?.category_id)
+            query.set("category_id", String(params.category_id));
+        if (params?.fixed_version_id)
+            query.set("fixed_version_id", String(params.fixed_version_id));
+        if (params?.subject)
+            query.set("subject", params.subject);
+        if (params?.created_on)
+            query.set("created_on", params.created_on);
+        if (params?.updated_on)
+            query.set("updated_on", params.updated_on);
+        if (params?.sort)
+            query.set("sort", params.sort);
+        if (params?.include)
+            query.set("include", params.include);
+        if (params?.limit)
+            query.set("limit", String(params.limit));
+        if (params?.offset)
+            query.set("offset", String(params.offset));
+        const queryString = query.toString();
+        const path = `/issues.json${queryString ? `?${queryString}` : ""}`;
+        return this.request("GET", path);
+    }
+    async getIssue(id, include) {
+        const query = include ? `?include=${include}` : "";
+        return this.request("GET", `/issues/${id}.json${query}`);
+    }
+    async createIssue(data) {
+        return this.request("POST", "/issues.json", {
+            issue: data,
+        });
+    }
+    async updateIssue(id, data) {
+        return this.request("PUT", `/issues/${id}.json`, {
+            issue: data,
+        });
+    }
+    async deleteIssue(id) {
+        return this.request("DELETE", `/issues/${id}.json`);
+    }
+    async addIssueWatcher(issueId, userId) {
+        return this.request("POST", `/issues/${issueId}/watchers.json`, {
+            user_id: userId,
+        });
+    }
+    async removeIssueWatcher(issueId, userId) {
+        return this.request("DELETE", `/issues/${issueId}/watchers/${userId}.json`);
+    }
+    // ==================== PROJECTS ====================
+    async listProjects(params) {
+        const query = new URLSearchParams();
+        if (params?.include)
+            query.set("include", params.include);
+        if (params?.limit)
+            query.set("limit", String(params.limit));
+        if (params?.offset)
+            query.set("offset", String(params.offset));
+        const queryString = query.toString();
+        const path = `/projects.json${queryString ? `?${queryString}` : ""}`;
+        return this.request("GET", path);
+    }
+    async getProject(id, include) {
+        const query = include ? `?include=${include}` : "";
+        return this.request("GET", `/projects/${id}.json${query}`);
+    }
+    async createProject(data) {
+        return this.request("POST", "/projects.json", {
+            project: data,
+        });
+    }
+    async updateProject(id, data) {
+        return this.request("PUT", `/projects/${id}.json`, { project: data });
+    }
+    async deleteProject(id) {
+        return this.request("DELETE", `/projects/${id}.json`);
+    }
+    async archiveProject(id) {
+        return this.request("PUT", `/projects/${id}/archive.json`);
+    }
+    async unarchiveProject(id) {
+        return this.request("PUT", `/projects/${id}/unarchive.json`);
+    }
+    // ==================== WIKI ====================
+    async listWikiPages(projectId) {
+        return this.request("GET", `/projects/${projectId}/wiki/index.json`);
+    }
+    async getWikiPage(projectId, pageName, options) {
+        const query = new URLSearchParams();
+        if (options?.include)
+            query.set("include", options.include);
+        const queryString = query.toString();
+        const versionPath = options?.version ? `/${options.version}` : "";
+        const path = `/projects/${projectId}/wiki/${encodeURIComponent(pageName)}${versionPath}.json${queryString ? `?${queryString}` : ""}`;
+        return this.request("GET", path);
+    }
+    async createOrUpdateWikiPage(projectId, pageName, data) {
+        return this.request("PUT", `/projects/${projectId}/wiki/${encodeURIComponent(pageName)}.json`, { wiki_page: data });
+    }
+    async deleteWikiPage(projectId, pageName) {
+        return this.request("DELETE", `/projects/${projectId}/wiki/${encodeURIComponent(pageName)}.json`);
+    }
+    // ==================== ATTACHMENTS ====================
+    async getAttachment(id) {
+        return this.request("GET", `/attachments/${id}.json`);
+    }
+    async deleteAttachment(id) {
+        return this.request("DELETE", `/attachments/${id}.json`);
+    }
+    async uploadFile(filename, contentType, content) {
+        try {
+            const response = await fetch(`${this.baseUrl}/uploads.json?filename=${encodeURIComponent(filename)}`, {
+                method: "POST",
+                headers: {
+                    "X-Redmine-API-Key": this.apiKey,
+                    "Content-Type": "application/octet-stream",
+                },
+                body: content,
+            });
+            if (!response.ok) {
+                const errorData = await response.json().catch(() => ({}));
+                const errorResponse = {
+                    error: true,
+                    status: response.status,
+                    message: errorData.errors?.join(", ") ||
+                        `HTTP ${response.status}`,
+                };
+                return errorResponse;
+            }
+            return (await response.json());
+        }
+        catch (err) {
+            const errorResponse = {
+                error: true,
+                status: 0,
+                message: err instanceof Error ? err.message : "Unknown error",
+            };
+            return errorResponse;
+        }
+    }
+    // ==================== PROJECT FILES ====================
+    async listProjectFiles(projectId) {
+        return this.request("GET", `/projects/${projectId}/files.json`);
+    }
+    async uploadProjectFile(projectId, data) {
+        return this.request("POST", `/projects/${projectId}/files.json`, {
+            file: data,
+        });
+    }
+    // ==================== ISSUE RELATIONS ====================
+    async listIssueRelations(issueId) {
+        return this.request("GET", `/issues/${issueId}/relations.json`);
+    }
+    async getRelation(id) {
+        return this.request("GET", `/relations/${id}.json`);
+    }
+    async createIssueRelation(issueId, data) {
+        return this.request("POST", `/issues/${issueId}/relations.json`, {
+            relation: data,
+        });
+    }
+    async deleteRelation(id) {
+        return this.request("DELETE", `/relations/${id}.json`);
+    }
+    // ==================== VERSIONS ====================
+    async listVersions(projectId) {
+        return this.request("GET", `/projects/${projectId}/versions.json`);
+    }
+    async getVersion(id) {
+        return this.request("GET", `/versions/${id}.json`);
+    }
+    async createVersion(projectId, data) {
+        return this.request("POST", `/projects/${projectId}/versions.json`, {
+            version: data,
+        });
+    }
+    async updateVersion(id, data) {
+        return this.request("PUT", `/versions/${id}.json`, {
+            version: data,
+        });
+    }
+    async deleteVersion(id) {
+        return this.request("DELETE", `/versions/${id}.json`);
+    }
+    // ==================== TRACKERS ====================
+    async listTrackers() {
+        return this.request("GET", "/trackers.json");
+    }
+    // ==================== ISSUE STATUSES ====================
+    async listIssueStatuses() {
+        return this.request("GET", "/issue_statuses.json");
+    }
+    // ==================== ISSUE CATEGORIES ====================
+    async listIssueCategories(projectId) {
+        return this.request("GET", `/projects/${projectId}/issue_categories.json`);
+    }
+    async getIssueCategory(id) {
+        return this.request("GET", `/issue_categories/${id}.json`);
+    }
+    async createIssueCategory(projectId, data) {
+        return this.request("POST", `/projects/${projectId}/issue_categories.json`, { issue_category: data });
+    }
+    async updateIssueCategory(id, data) {
+        return this.request("PUT", `/issue_categories/${id}.json`, {
+            issue_category: data,
+        });
+    }
+    async deleteIssueCategory(id, reassignToId) {
+        const query = reassignToId ? `?reassign_to_id=${reassignToId}` : "";
+        return this.request("DELETE", `/issue_categories/${id}.json${query}`);
+    }
+    // ==================== CUSTOM FIELDS ====================
+    async listCustomFields() {
+        return this.request("GET", "/custom_fields.json");
+    }
+    // ==================== QUERIES ====================
+    async listQueries() {
+        return this.request("GET", "/queries.json");
+    }
+    // ==================== SEARCH ====================
+    async search(params) {
+        const query = new URLSearchParams();
+        query.set("q", params.q);
+        if (params.scope)
+            query.set("scope", params.scope);
+        if (params.all_words !== undefined)
+            query.set("all_words", params.all_words ? "1" : "0");
+        if (params.titles_only !== undefined)
+            query.set("titles_only", params.titles_only ? "1" : "0");
+        if (params.open_issues !== undefined)
+            query.set("open_issues", params.open_issues ? "1" : "0");
+        if (params.attachments)
+            query.set("attachments", params.attachments);
+        if (params.issues)
+            query.set("issues", "1");
+        if (params.news)
+            query.set("news", "1");
+        if (params.documents)
+            query.set("documents", "1");
+        if (params.changesets)
+            query.set("changesets", "1");
+        if (params.wiki_pages)
+            query.set("wiki_pages", "1");
+        if (params.messages)
+            query.set("messages", "1");
+        if (params.projects)
+            query.set("projects", "1");
+        if (params.limit)
+            query.set("limit", String(params.limit));
+        if (params.offset)
+            query.set("offset", String(params.offset));
+        return this.request("GET", `/search.json?${query.toString()}`);
+    }
+    // ==================== MY ACCOUNT ====================
+    async getMyAccount() {
+        return this.request("GET", "/my/account.json");
+    }
+    // ==================== TIME ENTRIES ====================
+    async listTimeEntries(params) {
+        const query = new URLSearchParams();
+        if (params?.project_id)
+            query.set("project_id", String(params.project_id));
+        if (params?.user_id)
+            query.set("user_id", String(params.user_id));
+        if (params?.spent_on)
+            query.set("spent_on", params.spent_on);
+        if (params?.from)
+            query.set("from", params.from);
+        if (params?.to)
+            query.set("to", params.to);
+        if (params?.limit)
+            query.set("limit", String(params.limit));
+        if (params?.offset)
+            query.set("offset", String(params.offset));
+        const queryString = query.toString();
+        const path = `/time_entries.json${queryString ? `?${queryString}` : ""}`;
+        return this.request("GET", path);
+    }
+    async getTimeEntry(id) {
+        return this.request("GET", `/time_entries/${id}.json`);
+    }
+    async createTimeEntry(data) {
+        return this.request("POST", "/time_entries.json", {
+            time_entry: data,
+        });
+    }
+    async updateTimeEntry(id, data) {
+        return this.request("PUT", `/time_entries/${id}.json`, {
+            time_entry: data,
+        });
+    }
+    async deleteTimeEntry(id) {
+        return this.request("DELETE", `/time_entries/${id}.json`);
+    }
+    // ==================== ENUMERATIONS ====================
+    async listIssuePriorities() {
+        return this.request("GET", "/enumerations/issue_priorities.json");
+    }
+    async listTimeEntryActivities() {
+        return this.request("GET", "/enumerations/time_entry_activities.json");
+    }
+    async listDocumentCategories() {
+        return this.request("GET", "/enumerations/document_categories.json");
+    }
+    // ==================== USERS ====================
+    async listUsers(params) {
+        const query = new URLSearchParams();
+        if (params?.status !== undefined)
+            query.set("status", String(params.status));
+        if (params?.name)
+            query.set("name", params.name);
+        if (params?.group_id)
+            query.set("group_id", String(params.group_id));
+        if (params?.limit)
+            query.set("limit", String(params.limit));
+        if (params?.offset)
+            query.set("offset", String(params.offset));
+        const queryString = query.toString();
+        const path = `/users.json${queryString ? `?${queryString}` : ""}`;
+        return this.request("GET", path);
+    }
+    async getUser(id, include) {
+        const query = include ? `?include=${include}` : "";
+        return this.request("GET", `/users/${id}.json${query}`);
+    }
+    async createUser(data) {
+        return this.request("POST", "/users.json", {
+            user: data,
+        });
+    }
+    async updateUser(id, data) {
+        return this.request("PUT", `/users/${id}.json`, {
+            user: data,
+        });
+    }
+    async deleteUser(id) {
+        return this.request("DELETE", `/users/${id}.json`);
+    }
+    // ==================== GROUPS ====================
+    async listGroups() {
+        return this.request("GET", "/groups.json");
+    }
+    async getGroup(id, include) {
+        const query = include ? `?include=${include}` : "";
+        return this.request("GET", `/groups/${id}.json${query}`);
+    }
+    async createGroup(data) {
+        return this.request("POST", "/groups.json", {
+            group: data,
+        });
+    }
+    async deleteGroup(id) {
+        return this.request("DELETE", `/groups/${id}.json`);
+    }
+    async addUserToGroup(groupId, userId) {
+        return this.request("POST", `/groups/${groupId}/users.json`, {
+            user_id: userId,
+        });
+    }
+    async removeUserFromGroup(groupId, userId) {
+        return this.request("DELETE", `/groups/${groupId}/users/${userId}.json`);
+    }
+    // ==================== MEMBERSHIPS ====================
+    async listProjectMemberships(projectId, params) {
+        const query = new URLSearchParams();
+        if (params?.limit)
+            query.set("limit", String(params.limit));
+        if (params?.offset)
+            query.set("offset", String(params.offset));
+        const queryString = query.toString();
+        const path = `/projects/${projectId}/memberships.json${queryString ? `?${queryString}` : ""}`;
+        return this.request("GET", path);
+    }
+    async getMembership(id) {
+        return this.request("GET", `/memberships/${id}.json`);
+    }
+    async createProjectMembership(projectId, data) {
+        return this.request("POST", `/projects/${projectId}/memberships.json`, { membership: data });
+    }
+    async updateMembership(id, data) {
+        return this.request("PUT", `/memberships/${id}.json`, {
+            membership: data,
+        });
+    }
+    async deleteMembership(id) {
+        return this.request("DELETE", `/memberships/${id}.json`);
+    }
+    // ==================== ROLES ====================
+    async listRoles() {
+        return this.request("GET", "/roles.json");
+    }
+    async getRole(id) {
+        return this.request("GET", `/roles/${id}.json`);
+    }
+}