@gongrzhe/server-jira 0.1.0

package/README.md

@@ -0,0 +1,374 @@
+# JIRA MCP Server
+
+A stateless, multi-tenant Model Context Protocol (MCP) server for Atlassian JIRA, providing comprehensive access to JIRA's REST API through standardized tools.
+
+## Features
+
+- **🎯 Zero Configuration**: Just provide your token - Jira URL is auto-discovered!
+- **🔐 Dual Authentication**: Support for both OAuth 2.0 and API tokens
+- **🌐 Multi-Tenant Architecture**: Each user connects to their own Jira instance
+- **⚡ Stateless Design**: Complete request isolation with no session management
+- **🔑 Smart Routing**: OAuth tokens → API Gateway, API tokens → Direct URL
+- **📦 Fresh Instance Per Request**: Each request gets a new server instance
+- **🛠️ Comprehensive API Coverage**: 30+ tools covering all major JIRA operations
+- **📈 Horizontal Scaling**: Stateless design enables easy load balancing
+- **💾 Smart Caching**: Token-to-URL mappings cached for performance (5-min TTL)
+- **🚀 OAuth Helper**: Included script for easy OAuth token generation
+
+## Tools Overview
+
+### Issue Management (7 tools)
+- `jira_get_issue` - Get issue details by key
+- `jira_search_issues` - Search using JQL queries
+- `jira_create_issue` - Create new issues
+- `jira_update_issue` - Update issue fields
+- `jira_delete_issue` - Delete issues
+- `jira_assign_issue` - Assign issues to users
+- `jira_link_issues` - Create issue relationships
+
+### Comments (4 tools)
+- `jira_get_comments` - Retrieve all comments
+- `jira_add_comment` - Add new comments
+- `jira_update_comment` - Modify comments
+- `jira_delete_comment` - Remove comments
+
+### Projects (6 tools)
+- `jira_list_projects` - List accessible projects
+- `jira_get_project` - Get project details
+- `jira_get_project_issues` - Get issues in project
+- `jira_get_project_versions` - Get project versions
+- `jira_get_project_components` - Get project components
+- `jira_search_projects` - Search projects
+
+### Workflow (3 tools)
+- `jira_get_transitions` - Get available transitions
+- `jira_transition_issue` - Move issues through workflow
+- `jira_get_workflows` - List workflows
+
+### Users & Watchers (5 tools)
+- `jira_get_current_user` - Current user info
+- `jira_search_users` - Find users
+- `jira_get_watchers` - Get issue watchers
+- `jira_add_watcher` - Add watchers
+- `jira_remove_watcher` - Remove watchers
+
+### Metadata (5 tools)
+- `jira_get_issue_types` - Available issue types
+- `jira_get_priorities` - Available priorities
+- `jira_get_statuses` - Available statuses
+- `jira_get_fields` - System/custom fields
+- `jira_get_resolutions` - Available resolutions
+
+### Time Tracking (4 tools)
+- `jira_get_worklogs` - Get time entries
+- `jira_add_worklog` - Log work time
+- `jira_update_worklog` - Update time entries
+- `jira_delete_worklog` - Remove time entries
+
+## Authentication
+
+The server supports **two authentication methods** with **automatic Jira URL discovery**:
+
+1. **API Tokens** - For personal/service account access
+2. **OAuth 2.0** - For delegated user access (recommended for production)
+
+Both methods automatically discover your Jira instance URL - no manual configuration needed!
+
+### Option 1: API Token Authentication (Quick Start)
+
+#### Getting Your API Token
+
+1. Go to https://id.atlassian.com/manage-profile/security/api-tokens
+2. Click "Create API token"
+3. Give it a label (e.g., "MCP Server")
+4. Copy the generated token
+
+#### Using API Tokens
+
+```bash
+curl -X POST http://localhost:30000/mcp \
+  -H "Authorization: Bearer YOUR_API_TOKEN" \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": "1",
+    "method": "tools/call",
+    "params": {
+      "name": "jira_get_current_user",
+      "arguments": {}
+    }
+  }'
+```
+
+### Option 2: OAuth 2.0 Authentication (Recommended)
+
+OAuth 2.0 provides better security and user experience for production deployments.
+
+#### Setting Up OAuth 2.0
+
+1. **Create OAuth 2.0 App** at https://developer.atlassian.com/console/myapps/
+   - Click "Create" → "OAuth 2.0 integration"
+   - Set Authorization callback URL (e.g., `https://your-app.com/callback`)
+   - Add permissions: `read:jira-work`, `write:jira-work`, `read:jira-user`, `offline_access`
+   - Save your Client ID and Client Secret
+
+2. **Generate Access Token** using the included helper:
+   ```bash
+   JIRA_CLIENT_ID=your_client_id \
+   JIRA_CLIENT_SECRET=your_client_secret \
+   node get-oauth-token.js
+   ```
+
+3. **Use OAuth Token** (same as API token):
+   ```bash
+   curl -X POST http://localhost:30000/mcp \
+     -H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
+     -H "Content-Type: application/json" \
+     -H "Accept: application/json, text/event-stream" \
+     -d '{"jsonrpc":"2.0","id":"1","method":"tools/call","params":{"name":"jira_get_current_user","arguments":{}}}'
+   ```
+
+#### OAuth vs API Tokens
+
+| Feature | OAuth 2.0 | API Tokens |
+|---------|-----------|------------|
+| User delegation | ✅ Yes | ❌ No (account-level) |
+| Token refresh | ✅ Yes (refresh tokens) | ❌ No |
+| Granular scopes | ✅ Yes | ❌ All permissions |
+| Revocation | ✅ Per-app | ❌ All or nothing |
+| Best for | Production apps | Development/testing |
+
+### How It Works
+
+**Both authentication methods automatically:**
+- ✅ Discover your Jira URL from the token (API tokens use direct instance URL)
+- ✅ Discover your Jira URL and Cloud ID (OAuth uses Atlassian API Gateway)
+- ✅ Cache the URL for fast subsequent requests (5-minute TTL)
+- ✅ Handle multi-site tokens (uses the first/primary site)
+- ✅ Route requests correctly (OAuth → API Gateway, API tokens → direct)
+
+## Quick Start
+
+### Development Mode
+
+```bash
+# Install dependencies
+npm install
+
+# Run in development mode
+npm run dev
+```
+
+### Production Mode
+
+```bash
+# Build the project
+npm run build
+
+# Start the server
+npm start
+```
+
+The server will start on port 30000 by default (configurable via `PORT` environment variable).
+
+**No environment variables required!** Each request provides its own JIRA URL.
+
+## Usage Examples
+
+**Important**: Only provide your API token - the Jira URL is auto-discovered!
+
+### Search Issues
+```bash
+curl -X POST http://localhost:30000/mcp \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": "1",
+    "method": "tools/call",
+    "params": {
+      "name": "jira_search_issues",
+      "arguments": {
+        "jql": "project = PROJ AND status = \"In Progress\"",
+        "maxResults": 10
+      }
+    }
+  }'
+```
+
+### Create Issue
+```bash
+curl -X POST http://localhost:30000/mcp \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": "2",
+    "method": "tools/call",
+    "params": {
+      "name": "jira_create_issue",
+      "arguments": {
+        "project": "PROJ",
+        "issueType": "Task",
+        "summary": "New task from MCP server",
+        "description": "Created via MCP JIRA server"
+      }
+    }
+  }'
+```
+
+### Add Comment
+```bash
+curl -X POST http://localhost:30000/mcp \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": "3",
+    "method": "tools/call",
+    "params": {
+      "name": "jira_add_comment",
+      "arguments": {
+        "issueKey": "PROJ-123",
+        "body": "This is a comment from the MCP server"
+      }
+    }
+  }'
+```
+
+### Transition Issue
+```bash
+curl -X POST http://localhost:30000/mcp \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": "4",
+    "method": "tools/call",
+    "params": {
+      "name": "jira_transition_issue",
+      "arguments": {
+        "issueKey": "PROJ-123",
+        "transitionId": "41",
+        "comment": "Transitioning via MCP server"
+      }
+    }
+  }'
+```
+
+## Configuration
+
+### Environment Variables
+
+The server requires **zero configuration**:
+
+- `PORT` - Server port (default: 30000) - **Optional**
+
+**That's it!** Users only provide:
+- API token - Via `Authorization: Bearer <token>` header
+- Jira URL - **Automatically discovered from the token**
+
+### JQL (JIRA Query Language)
+
+Many tools support JQL for powerful querying:
+
+```sql
+-- Basic searches
+project = "PROJ"
+status = "In Progress"
+assignee = currentUser()
+
+-- Advanced searches
+project = "PROJ" AND status WAS "In Progress" DURING ("2024-01-01", "2024-12-31")
+worklogAuthor = currentUser() AND worklogDate >= startOfWeek()
+issueType = Bug AND priority = High AND created >= -7d
+```
+
+## Error Handling
+
+The server provides structured error responses:
+
+```json
+{
+  "error": true,
+  "tool": "jira_get_issue",
+  "message": "Error in jira_get_issue: [404] Issue not found: PROJ-999",
+  "timestamp": "2024-01-15T10:30:00.000Z"
+}
+```
+
+Common error codes:
+- `401` - Authentication required/invalid
+- `403` - Permission denied
+- `404` - Resource not found
+- `400` - Validation error
+- `429` - Rate limit exceeded
+
+## Health Check
+
+```bash
+curl http://localhost:30000/health
+```
+
+Returns:
+```json
+{
+  "status": "healthy",
+  "version": "0.1.0",
+  "timestamp": "2024-01-15T10:30:00.000Z",
+  "mode": "stateless"
+}
+```
+
+## Architecture
+
+### Smart Token Discovery
+- Calls Atlassian's `oauth/token/accessible-resources` API
+- Discovers all Jira instances accessible to the token
+- Uses the primary/first site automatically
+- Caches URL mappings for 5 minutes (configurable)
+- Automatic cache cleanup for memory efficiency
+
+### Multi-Tenant Support
+- Each user's token maps to their own Jira instance
+- No shared configuration between users
+- Perfect for SaaS deployments
+- Supports JIRA Cloud, Server, and Data Center
+- Handles multi-site tokens gracefully
+
+### Stateless Design
+- Fresh server instance per request
+- No session management
+- Complete request isolation
+- Automatic cleanup prevents memory leaks
+
+### Security
+- No token storage (except in-memory cache)
+- Request-level authentication and discovery
+- Standard Bearer token support
+- Fresh token validation per request
+- Zero cross-tenant contamination
+
+### Performance
+- Horizontal scaling ready
+- Intelligent caching (5-min TTL)
+- Minimal memory footprint
+- Fast startup time
+- Zero configuration overhead
+- Automatic cache eviction
+
+## API Compatibility
+
+This server is compatible with:
+- JIRA Cloud
+- JIRA Server/Data Center (7.0+)
+- JIRA REST API v2
+
+## License
+
+MIT

package/dist/common/context.d.ts

@@ -0,0 +1,15 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+interface AuthContext {
+    token: string | null;
+    jiraUrl: string | null;
+    cloudId: string | null;
+}
+export declare const authStorage: AsyncLocalStorage<AuthContext>;
+export declare function getAuthToken(): string | null;
+export declare function requireAuthToken(): string;
+export declare function getJiraUrl(): string | null;
+export declare function requireJiraUrl(): string;
+export declare function getCloudId(): string | null;
+export declare function requireCloudId(): string;
+export {};
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../common/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,eAAO,MAAM,WAAW,gCAAuC,CAAC;AAEhE,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC;AAED,wBAAgB,UAAU,IAAI,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,cAAc,IAAI,MAAM,CAMvC;AAED,wBAAgB,UAAU,IAAI,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,cAAc,IAAI,MAAM,CAMvC"}

package/dist/common/context.js

@@ -0,0 +1,33 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+export const authStorage = new AsyncLocalStorage();
+export function getAuthToken() {
+    return authStorage.getStore()?.token || null;
+}
+export function requireAuthToken() {
+    const token = getAuthToken();
+    if (!token) {
+        throw new Error("Authentication token is required");
+    }
+    return token;
+}
+export function getJiraUrl() {
+    return authStorage.getStore()?.jiraUrl || null;
+}
+export function requireJiraUrl() {
+    const jiraUrl = getJiraUrl();
+    if (!jiraUrl) {
+        throw new Error("JIRA URL is required");
+    }
+    return jiraUrl;
+}
+export function getCloudId() {
+    return authStorage.getStore()?.cloudId || null;
+}
+export function requireCloudId() {
+    const cloudId = getCloudId();
+    if (!cloudId) {
+        throw new Error("Cloud ID is required for OAuth 2.0 authentication");
+    }
+    return cloudId;
+}
+//# sourceMappingURL=context.js.map

package/dist/common/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../common/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAQrD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,iBAAiB,EAAe,CAAC;AAEhE,MAAM,UAAU,YAAY;IAC1B,OAAO,WAAW,CAAC,QAAQ,EAAE,EAAE,KAAK,IAAI,IAAI,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,WAAW,CAAC,QAAQ,EAAE,EAAE,OAAO,IAAI,IAAI,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,WAAW,CAAC,QAAQ,EAAE,EAAE,OAAO,IAAI,IAAI,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/common/errors.d.ts

@@ -0,0 +1,26 @@
+export declare class JiraError extends Error {
+    statusCode?: number | undefined;
+    errorCode?: string | undefined;
+    constructor(message: string, statusCode?: number | undefined, errorCode?: string | undefined);
+}
+export declare class JiraAuthenticationError extends JiraError {
+    constructor(message?: string);
+}
+export declare class JiraPermissionError extends JiraError {
+    constructor(message?: string);
+}
+export declare class JiraResourceNotFoundError extends JiraError {
+    constructor(resource: string, identifier: string);
+}
+export declare class JiraValidationError extends JiraError {
+    constructor(message: string);
+}
+export declare class JiraRateLimitError extends JiraError {
+    constructor(message?: string);
+}
+export declare class JiraConflictError extends JiraError {
+    constructor(message: string);
+}
+export declare function isJiraError(error: unknown): error is JiraError;
+export declare function createJiraErrorFromResponse(response: Response, responseBody: any): JiraError;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../common/errors.ts"],"names":[],"mappings":"AACA,qBAAa,SAAU,SAAQ,KAAK;IACE,UAAU,CAAC,EAAE,MAAM;IAAS,SAAS,CAAC,EAAE,MAAM;gBAAtE,OAAO,EAAE,MAAM,EAAS,UAAU,CAAC,EAAE,MAAM,YAAA,EAAS,SAAS,CAAC,EAAE,MAAM,YAAA;CAInF;AAED,qBAAa,uBAAwB,SAAQ,SAAS;gBACxC,OAAO,GAAE,MAAgC;CAItD;AAED,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,OAAO,GAAE,MAA4B;CAIlD;AAED,qBAAa,yBAA0B,SAAQ,SAAS;gBAC1C,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAIjD;AAED,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,SAAS;gBACnC,OAAO,GAAE,MAA8B;CAIpD;AAED,qBAAa,iBAAkB,SAAQ,SAAS;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,GAAG,SAAS,CAoB5F"}

package/dist/common/errors.js

@@ -0,0 +1,71 @@
+// JIRA-specific error classes
+export class JiraError extends Error {
+    statusCode;
+    errorCode;
+    constructor(message, statusCode, errorCode) {
+        super(message);
+        this.statusCode = statusCode;
+        this.errorCode = errorCode;
+        this.name = 'JiraError';
+    }
+}
+export class JiraAuthenticationError extends JiraError {
+    constructor(message = 'Authentication failed') {
+        super(message, 401, 'JIRA_AUTH_ERROR');
+        this.name = 'JiraAuthenticationError';
+    }
+}
+export class JiraPermissionError extends JiraError {
+    constructor(message = 'Permission denied') {
+        super(message, 403, 'JIRA_PERMISSION_ERROR');
+        this.name = 'JiraPermissionError';
+    }
+}
+export class JiraResourceNotFoundError extends JiraError {
+    constructor(resource, identifier) {
+        super(`${resource} not found: ${identifier}`, 404, 'JIRA_NOT_FOUND');
+        this.name = 'JiraResourceNotFoundError';
+    }
+}
+export class JiraValidationError extends JiraError {
+    constructor(message) {
+        super(message, 400, 'JIRA_VALIDATION_ERROR');
+        this.name = 'JiraValidationError';
+    }
+}
+export class JiraRateLimitError extends JiraError {
+    constructor(message = 'Rate limit exceeded') {
+        super(message, 429, 'JIRA_RATE_LIMIT');
+        this.name = 'JiraRateLimitError';
+    }
+}
+export class JiraConflictError extends JiraError {
+    constructor(message) {
+        super(message, 409, 'JIRA_CONFLICT');
+        this.name = 'JiraConflictError';
+    }
+}
+export function isJiraError(error) {
+    return error instanceof JiraError;
+}
+export function createJiraErrorFromResponse(response, responseBody) {
+    const status = response.status;
+    const message = responseBody?.errorMessages?.join('; ') ||
+        responseBody?.message ||
+        `JIRA API error: ${response.statusText}`;
+    switch (status) {
+        case 401:
+            return new JiraAuthenticationError(message);
+        case 403:
+            return new JiraPermissionError(message);
+        case 404:
+            return new JiraResourceNotFoundError('Resource', response.url || 'Unknown');
+        case 409:
+            return new JiraConflictError(message);
+        case 429:
+            return new JiraRateLimitError(message);
+        default:
+            return new JiraError(message, status);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/common/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../common/errors.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,MAAM,OAAO,SAAU,SAAQ,KAAK;IACE;IAA4B;IAAhE,YAAY,OAAe,EAAS,UAAmB,EAAS,SAAkB;QAChF,KAAK,CAAC,OAAO,CAAC,CAAC;QADmB,eAAU,GAAV,UAAU,CAAS;QAAS,cAAS,GAAT,SAAS,CAAS;QAEhF,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,SAAS;IACpD,YAAY,UAAkB,uBAAuB;QACnD,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,iBAAiB,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IAChD,YAAY,UAAkB,mBAAmB;QAC/C,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,uBAAuB,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,SAAS;IACtD,YAAY,QAAgB,EAAE,UAAkB;QAC9C,KAAK,CAAC,GAAG,QAAQ,eAAe,UAAU,EAAE,EAAE,GAAG,EAAE,gBAAgB,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IAChD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,uBAAuB,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,SAAS;IAC/C,YAAY,UAAkB,qBAAqB;QACjD,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,iBAAiB,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,KAAK,YAAY,SAAS,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,QAAkB,EAAE,YAAiB;IAC/E,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC/B,MAAM,OAAO,GAAG,YAAY,EAAE,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC;QACxC,YAAY,EAAE,OAAO;QACrB,mBAAmB,QAAQ,CAAC,UAAU,EAAE,CAAC;IAExD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,GAAG;YACN,OAAO,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAAC;QAC9C,KAAK,GAAG;YACN,OAAO,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC1C,KAAK,GAAG;YACN,OAAO,IAAI,yBAAyB,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,IAAI,SAAS,CAAC,CAAC;QAC9E,KAAK,GAAG;YACN,OAAO,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACxC,KAAK,GAAG;YACN,OAAO,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACzC;YACE,OAAO,IAAI,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC"}

package/dist/common/token-parser.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 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.
+ */
+export interface JiraSite {
+    id: string;
+    url: string;
+    name: string;
+    scopes: string[];
+    avatarUrl: string;
+}
+/**
+ * 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 declare function getAccessibleSites(apiToken: string): Promise<JiraSite[]>;
+/**
+ * Get the primary/first Jira site URL from the API token
+ * This is the recommended approach for single-site users
+ */
+export declare function getJiraUrlFromToken(apiToken: string): Promise<string>;
+/**
+ * Get the cloud ID from the API token
+ * Cloud ID is required for OAuth 2.0 tokens to use the Atlassian API Gateway
+ */
+export declare function getCloudIdFromToken(apiToken: string): Promise<string>;
+/**
+ * Site information containing both URL and cloud ID
+ */
+export interface SiteInfo {
+    url: string;
+    cloudId: string;
+    name: string;
+}
+/**
+ * Get both URL and cloud ID from token
+ */
+export declare function getSiteInfoFromToken(apiToken: string): Promise<SiteInfo>;
+/**
+ * Get Jira site info from token with caching
+ */
+export declare function getCachedSiteInfo(apiToken: string): Promise<SiteInfo>;
+/**
+ * Get Jira URL from token with caching (backward compatibility)
+ */
+export declare function getCachedJiraUrl(apiToken: string): Promise<string>;
+/**
+ * Clear the token cache (useful for testing)
+ */
+export declare function clearTokenCache(): void;
+//# sourceMappingURL=token-parser.d.ts.map

package/dist/common/token-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-parser.d.ts","sourceRoot":"","sources":["../../common/token-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAqB9E;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAU3E;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAU3E;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAa9E;AAQD;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CA2B3E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGxE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}