Struct JiraClient 

pub struct JiraClient { /* private fields */ }

Implementations

impl JiraClient

pub fn new(config: JiraConfig) -> Self

pub fn base_url(&self) -> &str

pub async fn get_myself(&self) -> Result<String>

Get the current authenticated user’s accountId.

pub async fn search_issues( &self, jql: &str, next_page_token: Option<&str>, max_results: Option<u32>, ) -> Result<SearchResult>

Search issues using JQL with cursor-based pagination.

pub async fn get_issue(&self, key: &str) -> Result<Issue>

Fetch a single issue by key.

pub async fn create_issue(&self, req: CreateIssueRequest) -> Result<Issue>

Create a new issue.

pub async fn update_issue( &self, key: &str, req: UpdateIssueRequest, ) -> Result<()>

Update an existing issue.

pub async fn delete_issue(&self, key: &str) -> Result<()>

Delete an issue.

pub async fn get_project_fields(&self, project_key: &str) -> Result<Vec<Field>>

Get fields available for a project (runtime field resolution — no hardcoding).

pub async fn get_server_info(&self) -> Result<Value>

Get server info (used to detect Jira tier).

pub async fn transition_issue( &self, key: &str, transition_id: &str, ) -> Result<()>

Transition an issue to a new status.

pub async fn get_transitions(&self, key: &str) -> Result<Vec<Value>>

Get available transitions for an issue.

pub async fn get_issue_types(&self, project_key: &str) -> Result<Vec<IssueType>>

Get available issue types for a project (id + name).

pub async fn get_fields_for_issue_type( &self, project_key: &str, issue_type_id: &str, ) -> Result<Vec<Field>>

Get fields for a specific issue type within a project (with allowed values).

pub async fn search_users(&self, query: &str) -> Result<Vec<Value>>

Search Jira users by query string (for User field autocomplete).

pub async fn upload_attachment( &self, issue_key: &str, file_path: &Path, ) -> Result<Vec<Attachment>>

Upload a file as an attachment to an issue.

pub async fn create_issue_v2(&self, req: CreateIssueRequestV2) -> Result<Issue>

Create a new issue with dynamic custom fields.

pub async fn get_worklogs(&self, issue_key: &str) -> Result<Vec<Worklog>>

List all worklogs for an issue.

pub async fn add_worklog( &self, issue_key: &str, time_spent: &str, comment: Option<&str>, started: Option<&str>, ) -> Result<Worklog>

Add a worklog entry to an issue. time_spent uses Jira format: “2h 30m”, “1d”, “45m” started is optional ISO 8601 timestamp; defaults to now if None.

pub async fn delete_worklog( &self, issue_key: &str, worklog_id: &str, ) -> Result<()>

Delete a worklog entry.

pub async fn get_all_issues(&self, jql: &str) -> Result<Vec<Issue>>

Fetch ALL issues matching a JQL query using cursor-based pagination. Respects the Atlassian safeguard: max 500 pages.

pub async fn archive_issues(&self, issue_keys: &[String]) -> Result<()>

Archive a batch of issues by key. Jira accepts up to 1000 per request.

pub async fn raw_request( &self, method: &str, path: &str, body: Option<Value>, ) -> Result<Option<Value>>

Execute an arbitrary Jira REST API call and return the raw JSON response. Returns None for 204 No Content responses (success with no body). path should start with /rest/...

pub async fn is_premium(&self) -> bool

Check if this Jira instance is Premium tier.

pub async fn get_plans(&self) -> Result<Vec<Value>>

List Jira Plans (requires Jira Premium / Advanced Roadmaps).