@jagadeesh52423/atlassian-mcp-server 1.0.1 → 1.0.3

package/dist/error-handler.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Standard MCP tool response type
+ */
+export interface ToolResponse {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * Error context for building informative error messages
+ */
+export interface ErrorContext {
+    operation: string;
+    params?: Record<string, any>;
+    tip?: string;
+}
+/**
+ * Creates a successful response with text content
+ */
+export declare function successResponse(text: string): ToolResponse;
+/**
+ * Creates a successful response with JSON content
+ */
+export declare function jsonResponse(data: any): ToolResponse;
+/**
+ * Creates an error response with detailed information
+ */
+export declare function errorResponse(error: any, context: ErrorContext): ToolResponse;
+/**
+ * Wraps an async operation with standardized error handling
+ */
+export declare function withErrorHandling<T>(operation: () => Promise<T>, context: ErrorContext, formatResult: (result: T) => ToolResponse): Promise<ToolResponse>;
+/**
+ * Common error tips for different scenarios
+ */
+export declare const ERROR_TIPS: {
+    readonly CONFLUENCE_SEARCH: "Check your Confluence permissions and that the domain is accessible.";
+    readonly CONFLUENCE_PAGE_VIEW: "Check if the page ID exists and you have permission to view it.";
+    readonly CONFLUENCE_PAGE_CREATE: "Check if the space exists and you have permission to create pages in it.";
+    readonly CONFLUENCE_PAGE_EDIT: "Check if the page exists, version is correct, and you have permission to edit it.";
+    readonly CONFLUENCE_SPACE: "Check your Confluence permissions and API access.";
+    readonly CONFLUENCE_ATTACHMENT: "Check if the page exists and you have permission to attach files.";
+    readonly CONFLUENCE_COMMENT: "Check if the page/comment exists and you have the appropriate permissions.";
+    readonly JIRA_SEARCH: "Check your JQL syntax and Jira permissions.";
+    readonly JIRA_ISSUE_VIEW: "Check if the issue key exists and you have permission to view it.";
+    readonly JIRA_ISSUE_CREATE: "Check if all required fields are provided and project exists.";
+    readonly JIRA_ISSUE_EDIT: "Check if the issue exists and you have permission to update it.";
+    readonly JIRA_COMMENT: "Check if the issue/comment exists and you have the appropriate permissions.";
+    readonly JIRA_TRANSITION: "Check if the transition ID is valid for this issue and you have permission to transition it.";
+    readonly JIRA_ATTACHMENT: "Check if the issue exists and file content is properly base64 encoded.";
+    readonly JIRA_LINK: "Check if both issues exist and the link type is valid. Use jira_get_link_types to see available link types.";
+    readonly JIRA_WORKLOG: "Check if the issue/worklog exists and you have permission.";
+    readonly JIRA_WATCHER: "Check if the issue and user exist, and you have permission.";
+    readonly JIRA_SUBTASK: "Check if the parent issue exists, the project allows sub-tasks, and you have permission to create issues.";
+    readonly BITBUCKET_REPO: "Check your Bitbucket permissions and API access.";
+    readonly BITBUCKET_REPO_VIEW: "Check if the repository exists and you have access to it.";
+};
+/**
+ * Format helpers for common response patterns
+ */
+export declare const formatHelpers: {
+    /**
+     * Format a success message with optional details
+     */
+    success(message: string, details?: Record<string, any>): string;
+    /**
+     * Format an issue creation success message
+     */
+    issueCreated(issue: any, optionalFields?: Record<string, any>): string;
+    /**
+     * Format an issue update success message
+     */
+    issueUpdated(issue: any, updatedFields: string[]): string;
+};
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAI1D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,GAAG,GAAG,YAAY,CAIpD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY,GAAG,YAAY,CAsB7E;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,YAAY,EACrB,YAAY,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,YAAY,GACxC,OAAO,CAAC,YAAY,CAAC,CAOvB;AAED;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;CA0Bb,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB;;OAEG;qBACc,MAAM,YAAY,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM;IAU/D;;OAEG;wBACiB,GAAG,mBAAmB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM;IAsBtE;;OAEG;wBACiB,GAAG,iBAAiB,MAAM,EAAE,GAAG,MAAM;CAe1D,CAAC"}

package/dist/error-handler.js

@@ -0,0 +1,135 @@
+import { ICONS } from './constants.js';
+/**
+ * Creates a successful response with text content
+ */
+export function successResponse(text) {
+    return {
+        content: [{ type: 'text', text }],
+    };
+}
+/**
+ * Creates a successful response with JSON content
+ */
+export function jsonResponse(data) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+    };
+}
+/**
+ * Creates an error response with detailed information
+ */
+export function errorResponse(error, context) {
+    const errorDetails = error.response?.data || error.message;
+    const paramsText = context.params
+        ? Object.entries(context.params)
+            .map(([key, value]) => `- ${key}: ${value ?? 'none'}`)
+            .join('\n')
+        : '';
+    let text = `${ICONS.ERROR} ${context.operation}\n\n**Error Details:**\n${JSON.stringify(errorDetails, null, 2)}`;
+    if (paramsText) {
+        text += `\n\n**Request:**\n${paramsText}`;
+    }
+    if (context.tip) {
+        text += `\n\n**Tip:** ${context.tip}`;
+    }
+    return {
+        content: [{ type: 'text', text }],
+        isError: true,
+    };
+}
+/**
+ * Wraps an async operation with standardized error handling
+ */
+export async function withErrorHandling(operation, context, formatResult) {
+    try {
+        const result = await operation();
+        return formatResult(result);
+    }
+    catch (error) {
+        return errorResponse(error, context);
+    }
+}
+/**
+ * Common error tips for different scenarios
+ */
+export const ERROR_TIPS = {
+    // Confluence
+    CONFLUENCE_SEARCH: 'Check your Confluence permissions and that the domain is accessible.',
+    CONFLUENCE_PAGE_VIEW: 'Check if the page ID exists and you have permission to view it.',
+    CONFLUENCE_PAGE_CREATE: 'Check if the space exists and you have permission to create pages in it.',
+    CONFLUENCE_PAGE_EDIT: 'Check if the page exists, version is correct, and you have permission to edit it.',
+    CONFLUENCE_SPACE: 'Check your Confluence permissions and API access.',
+    CONFLUENCE_ATTACHMENT: 'Check if the page exists and you have permission to attach files.',
+    CONFLUENCE_COMMENT: 'Check if the page/comment exists and you have the appropriate permissions.',
+    // Jira
+    JIRA_SEARCH: 'Check your JQL syntax and Jira permissions.',
+    JIRA_ISSUE_VIEW: 'Check if the issue key exists and you have permission to view it.',
+    JIRA_ISSUE_CREATE: 'Check if all required fields are provided and project exists.',
+    JIRA_ISSUE_EDIT: 'Check if the issue exists and you have permission to update it.',
+    JIRA_COMMENT: 'Check if the issue/comment exists and you have the appropriate permissions.',
+    JIRA_TRANSITION: 'Check if the transition ID is valid for this issue and you have permission to transition it.',
+    JIRA_ATTACHMENT: 'Check if the issue exists and file content is properly base64 encoded.',
+    JIRA_LINK: 'Check if both issues exist and the link type is valid. Use jira_get_link_types to see available link types.',
+    JIRA_WORKLOG: 'Check if the issue/worklog exists and you have permission.',
+    JIRA_WATCHER: 'Check if the issue and user exist, and you have permission.',
+    JIRA_SUBTASK: 'Check if the parent issue exists, the project allows sub-tasks, and you have permission to create issues.',
+    // Bitbucket
+    BITBUCKET_REPO: 'Check your Bitbucket permissions and API access.',
+    BITBUCKET_REPO_VIEW: 'Check if the repository exists and you have access to it.',
+};
+/**
+ * Format helpers for common response patterns
+ */
+export const formatHelpers = {
+    /**
+     * Format a success message with optional details
+     */
+    success(message, details) {
+        let text = `${ICONS.SUCCESS} ${message}`;
+        if (details) {
+            text += '\n\n' + Object.entries(details)
+                .map(([key, value]) => `**${key}:** ${value}`)
+                .join('\n');
+        }
+        return text;
+    },
+    /**
+     * Format an issue creation success message
+     */
+    issueCreated(issue, optionalFields) {
+        const domain = process.env.JIRA_DOMAIN || process.env.ATLASSIAN_DOMAIN || 'your-domain.atlassian.net';
+        let text = `${ICONS.SUCCESS} **Jira Issue Created Successfully**
+
+${ICONS.TICKET} **Issue Key:** ${issue.key}
+${ICONS.SUMMARY} **Summary:** ${issue.summary}
+${ICONS.STATUS} **Status:** ${issue.status}
+${ICONS.DATE} **Created:** ${new Date(issue.created).toLocaleString()}`;
+        if (optionalFields) {
+            const fieldLines = Object.entries(optionalFields)
+                .filter(([_, value]) => value)
+                .map(([key, value]) => `${key}: ${value}`);
+            if (fieldLines.length > 0) {
+                text += '\n\n' + fieldLines.join('\n');
+            }
+        }
+        text += `\n\n${ICONS.LINK} **Issue URL:** [View Issue](https://${domain}/browse/${issue.key})`;
+        return text;
+    },
+    /**
+     * Format an issue update success message
+     */
+    issueUpdated(issue, updatedFields) {
+        const domain = process.env.JIRA_DOMAIN || process.env.ATLASSIAN_DOMAIN || 'your-domain.atlassian.net';
+        let text = `${ICONS.SUCCESS} **Jira Issue Updated Successfully**
+
+${ICONS.TICKET} **Issue Key:** ${issue.key}
+${ICONS.STATUS} **Current Status:** ${issue.status}
+${ICONS.DATE} **Last Updated:** ${new Date(issue.updated).toLocaleString()}`;
+        if (updatedFields.length > 0) {
+            text += `\n\n**Updated Fields:**\n${updatedFields.join('\n')}`;
+        }
+        text += `\n\n${ICONS.LINK} **Issue URL:** [View Issue](https://${domain}/browse/${issue.key})`;
+        return text;
+    },
+};
+//# sourceMappingURL=error-handler.js.map

package/dist/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"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"}

package/dist/formatters/adf-formatter.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ADF (Atlassian Document Format) Formatter
+ * Handles conversion between plain text/markdown and ADF format used by Jira API v3
+ */
+/**
+ * Extracts plain text from ADF (Atlassian Document Format) body
+ */
+export declare function extractTextFromADF(body: any): string;
+/**
+ * Formats wiki markup to cleaner text
+ */
+export declare function formatWikiMarkup(text: string): string;
+/**
+ * Parses inline formatting like **bold**, *italic*, `code`, {{code}}
+ */
+export declare function parseInlineFormatting(text: string): any[];
+/**
+ * Enhanced description parser that converts text to proper ADF format
+ */
+export declare function parseDescriptionToADF(description: string): any;
+/**
+ * Convert description to wiki markup text format
+ */
+export declare function parseDescriptionToWikiMarkup(description: string): string;
+//# sourceMappingURL=adf-formatter.d.ts.map

package/dist/formatters/adf-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adf-formatter.d.ts","sourceRoot":"","sources":["../../src/formatters/adf-formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,CAqGpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqBrD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,EAAE,CAmHzD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAgT9D;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA6FxE"}