{"id":48224,"library":"jira-data-center-client","title":"Jira Data Center Client","description":"A TypeScript client for Jira Server and Data Center REST APIs. Currently at version 1.0.39 with weekly releases. Designed specifically for Jira On-Premise environments, it offers full type safety with auto-generated interfaces for all endpoints. Key differentiators: native TypeScript support, zero runtime dependencies, and comprehensive coverage of Jira Server/Data Center features without needing Atlassian Connect. Requires Node >=22.","status":"active","version":"1.0.39","language":"javascript","source_language":"en","source_url":"https://github.com/evrimalacan/jira-data-center-client","tags":["javascript","jira","jira-server","jira-data-center","rest-api","client","typescript"],"install":[{"cmd":"npm install jira-data-center-client","lang":"bash","label":"npm"},{"cmd":"yarn add jira-data-center-client","lang":"bash","label":"yarn"},{"cmd":"pnpm add jira-data-center-client","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"ESM-only package; use import, not require.","wrong":"const JiraClient = require('jira-data-center-client')","symbol":"JiraClient","correct":"import { JiraClient } from 'jira-data-center-client'"},{"note":"Factory function for creating client instances.","wrong":"import { createClient } from 'jira-data-center-client/index'","symbol":"createClient","correct":"import { createClient } from 'jira-data-center-client'"},{"note":"Use 'import type' for type-only imports to avoid runtime overhead.","wrong":"import { Issue } from 'jira-data-center-client'","symbol":"Issue","correct":"import type { Issue } from 'jira-data-center-client'"},{"note":"Configuration interface for client options.","symbol":"JiraClientConfig","correct":"import type { JiraClientConfig } from 'jira-data-center-client'"}],"quickstart":{"code":"import { createClient } from 'jira-data-center-client';\n\nconst client = createClient({\n  host: 'https://your-jira-instance.atlassian.net',\n  authentication: {\n    basic: {\n      username: process.env.JIRA_USERNAME ?? '',\n      password: process.env.JIRA_API_TOKEN ?? ''\n    }\n  }\n});\n\nasync function getIssue(issueKey: string) {\n  try {\n    const issue = await client.issues.getIssue({ issueIdOrKey: issueKey });\n    console.log(issue.fields?.summary);\n  } catch (error) {\n    console.error('Failed to fetch issue:', error);\n  }\n}\n\ngetIssue('TEST-123');","lang":"typescript","description":"Initializes a Jira Data Center client with basic auth and fetches an issue by key."},"warnings":[{"fix":"Use createClient() instead of new JiraClient().","message":"Version 1.0.0 changed the client initialization API from constructor to factory function.","severity":"breaking","affected_versions":"<1.0.0"},{"fix":"Upgrade Node.js to >=22.","message":"Node.js version requirement changed from >=18 to >=22 in version 1.0.0.","severity":"breaking","affected_versions":"<1.0.0"},{"fix":"Use 'authentication: { basic: { apiToken: '...' } }'.","message":"The 'password' field in authentication config is deprecated in favor of 'apiToken'.","severity":"deprecated","affected_versions":">=1.0.30"},{"fix":"Use const { data } = await client.issues.getIssue(...);","message":"Client methods return raw AxiosResponse objects, not just data. You must access .data.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Implement retry logic with exponential backoff for 429 status codes.","message":"Rate limiting is not handled automatically. 429 responses must be handled by the user.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"search_vec":"'1.0.39':19 '22':66 'api':15,78 'atlassian':62 'auto':38 'auto-gener':37 'center':3,13,58,75 'client':4,7,79 'comprehens':53 'connect':63 'coverag':54 'current':16 'data':2,12,74 'depend':51 'design':23 'differenti':45 'endpoint':43 'environ':30 'featur':59 'full':33 'generat':39 'interfac':40 'javascript':67 'jira':1,9,26,56,68,70,73 'jira-data-cent':72 'jira-serv':69 'key':44 'nativ':46 'need':61 'node':65 'offer':32 'on-premis':27 'premis':29 'releas':22 'requir':64 'rest':14,77 'rest-api':76 'runtim':50 'safeti':35 'server':10,71 'server/data':57 'specif':24 'support':48 'type':34 'typescript':6,47,80 'version':18 'week':21 'without':60 'zero':49","created_at":"2026-06-07T16:55:31.684629+00:00","updated_at":"2026-06-07T16:55:31.684629+00:00","problems":[{"fix":"Run 'npm install jira-data-center-client'.","cause":"Package not installed or not in node_modules.","error":"Error: Cannot find module 'jira-data-center-client'"},{"fix":"Use 'createClient()' to instantiate the client.","cause":"Old API using new JiraClient() instead of createClient().","error":"TypeError: client.issues.getIssue is not a function"},{"fix":"Check JIRA_USERNAME and JIRA_API_TOKEN environment variables or basic auth config.","cause":"Invalid or missing authentication credentials.","error":"AxiosError: Request failed with status code 401"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/evrimalacan/jira-data-center-client#readme","github":"https://github.com/evrimalacan/jira-data-center-client","docs":null,"changelog":null,"pypi":null,"npm":"jira-data-center-client","openapi_spec":null,"status_page":null,"smithery":null,"categories":["productivity"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}