@vitalyostanin/youtrack-mcp 0.2.0

package/dist/src/utils/mappers.js

@@ -0,0 +1,126 @@
+import { DateTime } from "luxon";
+/**
+ * Convert timestamp in milliseconds to ISO date string (YYYY-MM-DD)
+ */
+export function timestampToIsoDate(timestamp) {
+    if (timestamp === undefined || timestamp === null) {
+        return undefined;
+    }
+    if (!Number.isFinite(timestamp)) {
+        return undefined;
+    }
+    return DateTime.fromMillis(timestamp).toFormat("yyyy-MM-dd");
+}
+/**
+ * Convert timestamp in milliseconds to ISO datetime string (YYYY-MM-DDTHH:mm:ss.sssZ)
+ */
+export function timestampToIsoDateTime(timestamp) {
+    if (timestamp === undefined || timestamp === null) {
+        return undefined;
+    }
+    if (!Number.isFinite(timestamp)) {
+        return undefined;
+    }
+    return DateTime.fromMillis(timestamp).toISO() ?? undefined;
+}
+/**
+ * Map YoutrackIssue to MappedYoutrackIssue
+ */
+export function mapIssue(issue) {
+    return {
+        ...issue,
+    };
+}
+/**
+ * Map YoutrackIssueDetails to MappedYoutrackIssueDetails
+ */
+export function mapIssueDetails(issue) {
+    return {
+        ...issue,
+        created: timestampToIsoDateTime(issue.created),
+        updated: timestampToIsoDateTime(issue.updated),
+        resolved: timestampToIsoDateTime(issue.resolved),
+    };
+}
+/**
+ * Map YoutrackWorkItem to MappedYoutrackWorkItem
+ */
+export function mapWorkItem(item) {
+    const mapped = {
+        ...item,
+        date: timestampToIsoDate(item.date) ?? "",
+    };
+    return mapped;
+}
+/**
+ * Map YoutrackIssueComment to MappedYoutrackIssueComment
+ */
+export function mapComment(comment) {
+    const mapped = {
+        ...comment,
+        created: timestampToIsoDateTime(comment.created) ?? "",
+        updated: timestampToIsoDateTime(comment.updated),
+    };
+    return mapped;
+}
+/**
+ * Map array of issues
+ */
+export function mapIssues(issues) {
+    return issues.map(mapIssue);
+}
+/**
+ * Map array of work items
+ */
+export function mapWorkItems(items) {
+    return items.map(mapWorkItem);
+}
+/**
+ * Map array of comments
+ */
+export function mapComments(comments) {
+    return comments.map(mapComment);
+}
+/**
+ * Format file size in bytes to human-readable format
+ */
+export function formatFileSize(bytes) {
+    if (bytes === 0) {
+        return "0 Bytes";
+    }
+    const k = 1024;
+    const sizes = ["Bytes", "KB", "MB", "GB"];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${Math.round((bytes / Math.pow(k, i)) * 100) / 100} ${sizes[i]}`;
+}
+/**
+ * Map YoutrackAttachment to MappedYoutrackAttachment
+ */
+export function mapAttachment(attachment) {
+    return {
+        id: attachment.id,
+        name: attachment.name,
+        author: attachment.author
+            ? {
+                id: attachment.author.id,
+                login: attachment.author.login,
+                name: attachment.author.name,
+            }
+            : undefined,
+        created: timestampToIsoDateTime(attachment.created) ?? "",
+        updated: timestampToIsoDateTime(attachment.updated),
+        size: attachment.size,
+        sizeFormatted: formatFileSize(attachment.size),
+        mimeType: attachment.mimeType,
+        extension: attachment.extension,
+        url: attachment.url,
+        thumbnailURL: attachment.thumbnailURL,
+    };
+}
+/**
+ * Map array of attachments
+ */
+export function mapAttachments(attachments) {
+    return attachments.map(mapAttachment);
+}
+//# sourceMappingURL=mappers.js.map

package/dist/src/utils/tool-response.d.ts

@@ -0,0 +1,4 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+export declare function toolSuccess<T>(payload: T): CallToolResult;
+export declare function toolError(error: unknown): CallToolResult;
+//# sourceMappingURL=tool-response.d.ts.map

package/dist/src/utils/tool-response.js

@@ -0,0 +1,61 @@
+import { ZodError } from "zod";
+export function toolSuccess(payload) {
+    const structuredContent = {
+        success: true,
+        payload,
+    };
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(structuredContent, null, 2),
+            },
+        ],
+        structuredContent,
+    };
+}
+export function toolError(error) {
+    if (error instanceof ZodError) {
+        const structuredContent = {
+            success: false,
+            error: {
+                name: "ValidationError",
+                message: "Invalid input",
+                details: error.flatten(),
+            },
+        };
+        return {
+            content: [],
+            isError: true,
+            structuredContent,
+        };
+    }
+    if (error instanceof Error) {
+        const structuredContent = {
+            success: false,
+            error: {
+                name: error.name,
+                message: error.message,
+            },
+        };
+        return {
+            content: [],
+            isError: true,
+            structuredContent,
+        };
+    }
+    const structuredContent = {
+        success: false,
+        error: {
+            name: "UnknownError",
+            message: "An unknown error occurred",
+            details: error,
+        },
+    };
+    return {
+        content: [],
+        isError: true,
+        structuredContent,
+    };
+}
+//# sourceMappingURL=tool-response.js.map

package/dist/src/youtrack-client.d.ts

@@ -0,0 +1,86 @@
+import { type MappedYoutrackIssueComment, type MappedYoutrackWorkItem } from "./utils/mappers.js";
+import type { ArticleCreateInput, ArticleListPayload, ArticlePayload, ArticleSearchInput, ArticleSearchPayload, ArticleUpdateInput, AttachmentDeleteInput, AttachmentDeletePayload, AttachmentDownloadPayload, AttachmentPayload, AttachmentsListPayload, AttachmentUploadInput, AttachmentUploadPayload, IssueCommentsPayload, IssueCommentCreateInput, IssueDetailsPayload, IssueLookupPayload, IssueSearchInput, IssueSearchPayload, IssuesCommentsPayload, IssuesDetailsPayload, IssuesLookupPayload, WorkItemBulkResultPayload, WorkItemDeletePayload, WorkItemInvalidDay, WorkItemReportPayload, WorkItemUsersReportPayload, YoutrackActivityItem, YoutrackConfig, YoutrackIssueAssignInput, YoutrackIssueCreateInput, YoutrackIssueUpdateInput, YoutrackProject, YoutrackProjectListPayload, YoutrackUser, YoutrackUserListPayload, YoutrackWorkItem, YoutrackWorkItemCreateInput, YoutrackWorkItemIdempotentCreateInput, YoutrackWorkItemPeriodCreateInput, YoutrackWorkItemReportOptions, YoutrackWorkItemUpdateInput } from "./types.js";
+export declare class YoutrackClient {
+    private readonly config;
+    private readonly http;
+    private cachedCurrentUser?;
+    private readonly usersByLogin;
+    private readonly projectsByShortName;
+    constructor(config: YoutrackConfig);
+    getCurrentUser(): Promise<YoutrackUser>;
+    getUserByLogin(login: string): Promise<YoutrackUser | null>;
+    listUsers(): Promise<YoutrackUserListPayload>;
+    listProjects(): Promise<YoutrackProjectListPayload>;
+    getProjectByShortName(shortName: string): Promise<YoutrackProject | null>;
+    private getProjectById;
+    getIssue(issueId: string): Promise<IssueLookupPayload>;
+    getIssueDetails(issueId: string): Promise<IssueDetailsPayload>;
+    getIssueComments(issueId: string): Promise<IssueCommentsPayload>;
+    createIssueComment(input: IssueCommentCreateInput): Promise<{
+        comment: MappedYoutrackIssueComment;
+    }>;
+    getIssueActivities(issueId: string, { author, startDate, endDate }?: {
+        author?: string;
+        startDate?: number;
+        endDate?: number;
+    }): Promise<YoutrackActivityItem[]>;
+    createIssue(input: YoutrackIssueCreateInput): Promise<IssueLookupPayload>;
+    updateIssue(input: YoutrackIssueUpdateInput): Promise<IssueLookupPayload>;
+    assignIssue(input: YoutrackIssueAssignInput): Promise<IssueLookupPayload>;
+    getIssues(issueIds: string[]): Promise<IssuesLookupPayload>;
+    getIssuesDetails(issueIds: string[]): Promise<IssuesDetailsPayload>;
+    getMultipleIssuesComments(issueIds: string[]): Promise<IssuesCommentsPayload>;
+    searchIssuesByUserActivity(input: IssueSearchInput): Promise<IssueSearchPayload>;
+    private searchIssuesByUserActivitySimple;
+    private searchIssuesByUserActivityStrict;
+    listWorkItems({ author, startDate, endDate, issueId, top: limit, allUsers, }?: {
+        author?: string;
+        startDate?: string | number | Date;
+        endDate?: string | number | Date;
+        issueId?: string;
+        top?: number;
+        allUsers?: boolean;
+    }): Promise<YoutrackWorkItem[]>;
+    getWorkItemsForUsers(logins: string[], params?: {
+        startDate?: string | number | Date;
+        endDate?: string | number | Date;
+        issueId?: string;
+    }): Promise<YoutrackWorkItem[]>;
+    listAllUsersWorkItems(params?: {
+        startDate?: string | number | Date;
+        endDate?: string | number | Date;
+        issueId?: string;
+    }): Promise<YoutrackWorkItem[]>;
+    listRecentWorkItems(params?: {
+        users?: string[];
+        limit?: number;
+    }): Promise<YoutrackWorkItem[]>;
+    createWorkItem(input: YoutrackWorkItemCreateInput): Promise<YoutrackWorkItem>;
+    createWorkItemMapped(input: YoutrackWorkItemCreateInput): Promise<MappedYoutrackWorkItem>;
+    deleteWorkItem(issueId: string, workItemId: string): Promise<WorkItemDeletePayload>;
+    updateWorkItem(input: YoutrackWorkItemUpdateInput): Promise<YoutrackWorkItem>;
+    createWorkItemsForPeriod(input: YoutrackWorkItemPeriodCreateInput): Promise<WorkItemBulkResultPayload>;
+    createWorkItemIdempotent(input: YoutrackWorkItemIdempotentCreateInput): Promise<MappedYoutrackWorkItem | null>;
+    generateWorkItemReport(options?: YoutrackWorkItemReportOptions): Promise<WorkItemReportPayload>;
+    generateInvalidWorkItemReport(options?: YoutrackWorkItemReportOptions): Promise<WorkItemInvalidDay[]>;
+    generateUsersWorkItemReports(logins: string[], options?: YoutrackWorkItemReportOptions): Promise<WorkItemUsersReportPayload>;
+    getArticle(articleId: string): Promise<ArticlePayload>;
+    listArticles(args?: {
+        parentArticleId?: string;
+        projectId?: string;
+    }): Promise<ArticleListPayload>;
+    createArticle(input: ArticleCreateInput): Promise<ArticlePayload>;
+    updateArticle(input: ArticleUpdateInput): Promise<ArticlePayload>;
+    searchArticles(input: ArticleSearchInput): Promise<ArticleSearchPayload>;
+    listAttachments(issueId: string): Promise<AttachmentsListPayload>;
+    getAttachment(issueId: string, attachmentId: string): Promise<AttachmentPayload>;
+    getAttachmentDownloadInfo(issueId: string, attachmentId: string): Promise<AttachmentDownloadPayload>;
+    uploadAttachments(input: AttachmentUploadInput): Promise<AttachmentUploadPayload>;
+    deleteAttachment(input: AttachmentDeleteInput): Promise<AttachmentDeletePayload>;
+    private normalizeError;
+    private resolveAssignee;
+    private getIssueRaw;
+    private getWorkItemById;
+    private resolveReportBoundary;
+}
+//# sourceMappingURL=youtrack-client.d.ts.map