@gongrzhe/server-jira 0.1.0

package/dist/common/token-parser.js

@@ -0,0 +1,117 @@
+/**
+ * Jira Token Parser
+ *
+ * Extracts Jira site information from API tokens by making a discovery call
+ * to the Jira API to determine the accessible sites for the given token.
+ */
+/**
+ * Get accessible Jira sites for the given API token
+ * This calls the Atlassian API to discover which Jira instances the token has access to
+ */
+export async function getAccessibleSites(apiToken) {
+    try {
+        // Use Atlassian's OAuth 2.0 accessible resources endpoint
+        const response = await fetch('https://api.atlassian.com/oauth/token/accessible-resources', {
+            method: 'GET',
+            headers: {
+                'Authorization': `Bearer ${apiToken}`,
+                'Accept': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Failed to get accessible sites: ${response.status} ${errorText}`);
+        }
+        const sites = await response.json();
+        return sites;
+    }
+    catch (error) {
+        throw new Error(`Failed to discover Jira sites from token: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Get the primary/first Jira site URL from the API token
+ * This is the recommended approach for single-site users
+ */
+export async function getJiraUrlFromToken(apiToken) {
+    const sites = await getAccessibleSites(apiToken);
+    if (!sites || sites.length === 0) {
+        throw new Error('No accessible Jira sites found for this token. Please verify your token has Jira access.');
+    }
+    // Return the first site's URL
+    const primarySite = sites[0];
+    return primarySite.url;
+}
+/**
+ * Get the cloud ID from the API token
+ * Cloud ID is required for OAuth 2.0 tokens to use the Atlassian API Gateway
+ */
+export async function getCloudIdFromToken(apiToken) {
+    const sites = await getAccessibleSites(apiToken);
+    if (!sites || sites.length === 0) {
+        throw new Error('No accessible Jira sites found for this token. Please verify your token has Jira access.');
+    }
+    // Return the first site's cloud ID
+    const primarySite = sites[0];
+    return primarySite.id;
+}
+/**
+ * Get both URL and cloud ID from token
+ */
+export async function getSiteInfoFromToken(apiToken) {
+    const sites = await getAccessibleSites(apiToken);
+    if (!sites || sites.length === 0) {
+        throw new Error('No accessible Jira sites found for this token. Please verify your token has Jira access.');
+    }
+    const primarySite = sites[0];
+    return {
+        url: primarySite.url,
+        cloudId: primarySite.id,
+        name: primarySite.name,
+    };
+}
+/**
+ * Cache for storing token -> site info mappings to avoid repeated API calls
+ */
+const tokenCache = new Map();
+const CACHE_TTL = 5 * 60 * 1000; // 5 minutes
+/**
+ * Get Jira site info from token with caching
+ */
+export async function getCachedSiteInfo(apiToken) {
+    // Check cache first
+    const cached = tokenCache.get(apiToken);
+    const now = Date.now();
+    if (cached && (now - cached.timestamp) < CACHE_TTL) {
+        return cached.siteInfo;
+    }
+    // Fetch fresh site info
+    const siteInfo = await getSiteInfoFromToken(apiToken);
+    // Update cache
+    tokenCache.set(apiToken, { siteInfo, timestamp: now });
+    // Clean old cache entries (simple cleanup)
+    if (tokenCache.size > 1000) {
+        const entriesToDelete = [];
+        tokenCache.forEach((value, key) => {
+            if (now - value.timestamp > CACHE_TTL) {
+                entriesToDelete.push(key);
+            }
+        });
+        entriesToDelete.forEach(key => tokenCache.delete(key));
+    }
+    return siteInfo;
+}
+/**
+ * Get Jira URL from token with caching (backward compatibility)
+ */
+export async function getCachedJiraUrl(apiToken) {
+    const siteInfo = await getCachedSiteInfo(apiToken);
+    return siteInfo.url;
+}
+/**
+ * Clear the token cache (useful for testing)
+ */
+export function clearTokenCache() {
+    tokenCache.clear();
+}
+//# sourceMappingURL=token-parser.js.map

package/dist/common/token-parser.js.map

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

package/dist/common/types.d.ts

@@ -0,0 +1,151 @@
+export interface JiraIssue {
+    id: string;
+    key: string;
+    self: string;
+    fields: {
+        summary: string;
+        description?: string;
+        status: {
+            name: string;
+            id: string;
+            statusCategory: {
+                key: string;
+                name: string;
+            };
+        };
+        issuetype: {
+            name: string;
+            id: string;
+            iconUrl?: string;
+        };
+        priority?: {
+            name: string;
+            id: string;
+        };
+        assignee?: {
+            displayName: string;
+            accountId: string;
+            emailAddress?: string;
+        };
+        reporter: {
+            displayName: string;
+            accountId: string;
+            emailAddress?: string;
+        };
+        created: string;
+        updated: string;
+        project: {
+            key: string;
+            name: string;
+            id: string;
+        };
+        labels?: string[];
+        components?: Array<{
+            name: string;
+            id: string;
+        }>;
+        fixVersions?: Array<{
+            name: string;
+            id: string;
+        }>;
+        [key: string]: any;
+    };
+}
+export interface JiraProject {
+    id: string;
+    key: string;
+    name: string;
+    projectTypeKey: string;
+    simplified: boolean;
+    style: string;
+    isPrivate: boolean;
+    lead?: {
+        displayName: string;
+        accountId: string;
+    };
+    description?: string;
+    url?: string;
+    avatarUrls?: {
+        [size: string]: string;
+    };
+}
+export interface JiraComment {
+    id: string;
+    author: {
+        displayName: string;
+        accountId: string;
+        emailAddress?: string;
+    };
+    body: string;
+    created: string;
+    updated: string;
+    visibility?: {
+        type: string;
+        value: string;
+    };
+}
+export interface JiraTransition {
+    id: string;
+    name: string;
+    to: {
+        name: string;
+        id: string;
+        statusCategory: {
+            key: string;
+            name: string;
+        };
+    };
+    fields?: {
+        [key: string]: {
+            required: boolean;
+            schema: any;
+            name: string;
+        };
+    };
+}
+export interface JiraUser {
+    accountId: string;
+    displayName: string;
+    emailAddress?: string;
+    avatarUrls?: {
+        [size: string]: string;
+    };
+    active: boolean;
+}
+export interface JiraSearchResults {
+    startAt: number;
+    maxResults: number;
+    total: number;
+    issues: JiraIssue[];
+}
+export interface JiraWorklog {
+    id: string;
+    author: {
+        displayName: string;
+        accountId: string;
+    };
+    timeSpent: string;
+    timeSpentSeconds: number;
+    started: string;
+    comment?: string;
+}
+export interface JiraFieldOption {
+    id: string;
+    value: string;
+    self?: string;
+}
+export interface JiraField {
+    id: string;
+    name: string;
+    custom: boolean;
+    schema: {
+        type: string;
+        system?: string;
+        custom?: string;
+        customId?: number;
+    };
+    searchable: boolean;
+    navigable: boolean;
+    orderable: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/common/types.d.ts.map

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

package/dist/common/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../common/types.ts"],"names":[],"mappings":""}

package/dist/common/utils.d.ts

@@ -0,0 +1,9 @@
+export declare function normalizeJiraUrl(url: string): string;
+export declare function createAuthHeaders(): Record<string, string>;
+export declare function jiraRequest<T = any>(endpoint: string, options?: RequestInit): Promise<T>;
+export declare function formatJQL(jql: string): string;
+export declare function validateIssueKey(issueKey: string): boolean;
+export declare function formatJiraDate(date: Date | string): string;
+export declare function parseJiraErrors(errors: any): string[];
+export declare function truncateText(text: string, maxLength?: number): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/common/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../common/utils.ts"],"names":[],"mappings":"AAIA,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiBpD;AAGD,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAS1D;AAyBD,wBAAsB,WAAW,CAAC,CAAC,GAAG,GAAG,EACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,CAAC,CAAC,CAoCZ;AAGD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAGD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAE1D;AAGD,wBAAgB,eAAe,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,EAAE,CAcrD;AAGD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM,CAG1E"}

package/dist/common/utils.js

@@ -0,0 +1,116 @@
+import { requireAuthToken, requireJiraUrl, getCloudId } from './context.js';
+import { createJiraErrorFromResponse, JiraError } from './errors.js';
+// Validate and normalize JIRA URL
+export function normalizeJiraUrl(url) {
+    if (!url) {
+        throw new Error("JIRA URL is required");
+    }
+    // Basic URL validation
+    try {
+        const urlObj = new URL(url);
+        if (!urlObj.protocol.startsWith('http')) {
+            throw new Error("JIRA URL must use http or https protocol");
+        }
+    }
+    catch (error) {
+        throw new Error(`Invalid JIRA URL: ${url}`);
+    }
+    // Remove trailing slash
+    return url.replace(/\/$/, '');
+}
+// Create authenticated headers for JIRA API requests
+export function createAuthHeaders() {
+    const token = requireAuthToken();
+    return {
+        'Content-Type': 'application/json',
+        'Accept': 'application/json',
+        'User-Agent': 'mcp-server-jira/0.1.0',
+        'Authorization': `Bearer ${token}`,
+    };
+}
+/**
+ * Build the correct Jira API URL
+ *
+ * For OAuth 2.0 tokens (when cloudId is available):
+ *   Uses Atlassian API Gateway: https://api.atlassian.com/ex/jira/{cloudId}/rest/api/2/...
+ *
+ * For API tokens (no cloudId):
+ *   Uses direct URL: https://your-instance.atlassian.net/rest/api/2/...
+ */
+function buildJiraApiUrl(endpoint) {
+    const cloudId = getCloudId();
+    if (cloudId) {
+        // OAuth 2.0 - use Atlassian API Gateway
+        return `https://api.atlassian.com/ex/jira/${cloudId}/rest/api/2/${endpoint}`;
+    }
+    else {
+        // API Token - use direct instance URL
+        const baseUrl = normalizeJiraUrl(requireJiraUrl());
+        return `${baseUrl}/rest/api/2/${endpoint}`;
+    }
+}
+// Generic JIRA API request wrapper
+export async function jiraRequest(endpoint, options = {}) {
+    const url = buildJiraApiUrl(endpoint);
+    const headers = {
+        ...createAuthHeaders(),
+        ...options.headers,
+    };
+    try {
+        const response = await fetch(url, {
+            ...options,
+            headers,
+        });
+        let responseBody;
+        const contentType = response.headers.get('content-type');
+        if (contentType?.includes('application/json')) {
+            responseBody = await response.json();
+        }
+        else {
+            responseBody = await response.text();
+        }
+        if (!response.ok) {
+            throw createJiraErrorFromResponse(response, responseBody);
+        }
+        return responseBody;
+    }
+    catch (error) {
+        if (error instanceof JiraError) {
+            throw error;
+        }
+        // Network or other errors
+        throw new Error(`Failed to make JIRA API request: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+// Format JQL query safely
+export function formatJQL(jql) {
+    return jql.trim();
+}
+// Validate issue key format
+export function validateIssueKey(issueKey) {
+    return /^[A-Z][A-Z0-9]*-\d+$/.test(issueKey);
+}
+// Format JIRA date (ISO format)
+export function formatJiraDate(date) {
+    return date instanceof Date ? date.toISOString() : date;
+}
+// Parse JIRA error messages
+export function parseJiraErrors(errors) {
+    const errorMessages = [];
+    if (errors.errorMessages && Array.isArray(errors.errorMessages)) {
+        errorMessages.push(...errors.errorMessages);
+    }
+    if (errors.errors && typeof errors.errors === 'object') {
+        for (const [field, message] of Object.entries(errors.errors)) {
+            errorMessages.push(`${field}: ${message}`);
+        }
+    }
+    return errorMessages.length > 0 ? errorMessages : ['Unknown error occurred'];
+}
+// Truncate long text for display
+export function truncateText(text, maxLength = 200) {
+    if (text.length <= maxLength)
+        return text;
+    return text.substring(0, maxLength - 3) + '...';
+}
+//# sourceMappingURL=utils.js.map

package/dist/common/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../common/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,2BAA2B,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAErE,kCAAkC;AAClC,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IAED,uBAAuB;IACvB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,wBAAwB;IACxB,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,iBAAiB;IAC/B,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;IAEjC,OAAO;QACL,cAAc,EAAE,kBAAkB;QAClC,QAAQ,EAAE,kBAAkB;QAC5B,YAAY,EAAE,uBAAuB;QACrC,eAAe,EAAE,UAAU,KAAK,EAAE;KACnC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,eAAe,CAAC,QAAgB;IACvC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,IAAI,OAAO,EAAE,CAAC;QACZ,wCAAwC;QACxC,OAAO,qCAAqC,OAAO,eAAe,QAAQ,EAAE,CAAC;IAC/E,CAAC;SAAM,CAAC;QACN,sCAAsC;QACtC,MAAM,OAAO,GAAG,gBAAgB,CAAC,cAAc,EAAE,CAAC,CAAC;QACnD,OAAO,GAAG,OAAO,eAAe,QAAQ,EAAE,CAAC;IAC7C,CAAC;AACH,CAAC;AAED,mCAAmC;AACnC,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAgB,EAChB,UAAuB,EAAE;IAEzB,MAAM,GAAG,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAEtC,MAAM,OAAO,GAAG;QACd,GAAG,iBAAiB,EAAE;QACtB,GAAG,OAAO,CAAC,OAAO;KACnB,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,GAAG,OAAO;YACV,OAAO;SACR,CAAC,CAAC;QAEH,IAAI,YAAiB,CAAC;QACtB,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAEzD,IAAI,WAAW,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC9C,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACvC,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,2BAA2B,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAC5D,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;YAC/B,MAAM,KAAK,CAAC;QACd,CAAC;QAED,0BAA0B;QAC1B,MAAM,IAAI,KAAK,CAAC,oCAAoC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAChH,CAAC;AACH,CAAC;AAED,0BAA0B;AAC1B,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC/C,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,cAAc,CAAC,IAAmB;IAChD,OAAO,IAAI,YAAY,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1D,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,eAAe,CAAC,MAAW;IACzC,MAAM,aAAa,GAAa,EAAE,CAAC;IAEnC,IAAI,MAAM,CAAC,aAAa,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QAChE,aAAa,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACvD,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7D,aAAa,CAAC,IAAI,CAAC,GAAG,KAAK,KAAK,OAAO,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,OAAO,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC;AAC/E,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,YAAoB,GAAG;IAChE,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;AAClD,CAAC"}

package/dist/common/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/common/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../common/version.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/common/version.js

@@ -0,0 +1,3 @@
+// Version information
+export const VERSION = "0.1.0";
+//# sourceMappingURL=version.js.map

package/dist/common/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../common/version.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":""}