{"id":48752,"library":"node-jira","title":"node-jira","description":"A Node.js library for interacting with Atlassian JIRA's REST API. Version 0.2.0 is the current stable release, though the package appears to be in early development with limited updates. It provides basic authentication and simple issue operations. Compared to more robust alternatives like 'jira-connector' or '@atlassian/jira-client', this library has minimal features and documentation, making it suitable only for simple use cases.","status":"maintenance","version":"0.2.0","language":"javascript","source_language":"en","source_url":"https://github.com/stefanmayer13/node-jira","tags":["javascript","jira","node","rest","api"],"install":[{"cmd":"npm install node-jira","lang":"bash","label":"npm"},{"cmd":"yarn add node-jira","lang":"bash","label":"yarn"},{"cmd":"pnpm add node-jira","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"Package does not ship ESM; use CommonJS require. No default export.","wrong":"import JiraApi from 'node-jira';","symbol":"JiraApi","correct":"const JiraApi = require('node-jira');"},{"note":"Constructor expects username and password as first two arguments, host in options object.","wrong":"const jira = new JiraApi({ host: 'jira.example.com' });","symbol":"JiraApi constructor","correct":"const jira = new JiraApi('username', 'password', { host: 'jira.example.com' });"},{"note":"Uses callbacks, not promises. No promise support in this version.","wrong":"jira.getIssue('PROJ-123').then(issue => ...);","symbol":"getIssue","correct":"jira.getIssue('PROJ-123', function(err, issue) { ... });"}],"quickstart":{"code":"const JiraApi = require('node-jira');\n\nconst jira = new JiraApi('username', 'password', {\n  host: 'jira.example.com',\n  protocol: 'https',\n  port: 443,\n  apiVersion: '2',\n  strictSSL: true\n});\n\njira.getIssue('PROJ-123', function(err, issue) {\n  if (err) {\n    console.error('Error:', err);\n    return;\n  }\n  console.log('Issue summary:', issue.fields.summary);\n});","lang":"javascript","description":"Demonstrates initializing JiraApi with basic auth and fetching an issue via callback."},"warnings":[{"fix":"Wrap callbacks in promises manually or switch to a promise-based library like 'jira-connector'.","message":"No promise support; all async operations use callbacks.","severity":"gotcha","affected_versions":"<=0.2.0"},{"fix":"Use a more complete JIRA client for advanced features like project management or agile boards.","message":"Limited API coverage: only basic issue operations (get, create, update) and search.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Use environment variables for credentials securely, or switch to a library with token support.","message":"Authentication only supports basic auth (username/password). No OAuth or token-based auth.","severity":"gotcha","affected_versions":"<=0.2.0"}],"env_vars":null,"search_vec":"'0.2.0':16 'altern':46 'api':14,72 'appear':25 'atlassian':10 'atlassian/jira-client':52 'authent':37 'basic':36 'case':67 'compar':42 'connector':50 'current':19 'develop':30 'document':59 'earli':29 'featur':57 'interact':8 'issu':40 'javascript':68 'jira':3,11,49,69 'jira-connector':48 'librari':6,54 'like':47 'limit':32 'make':60 'minim':56 'node':2,70 'node-jira':1 'node.js':5 'oper':41 'packag':24 'provid':35 'releas':21 'rest':13,71 'robust':45 'simpl':39,65 'stabl':20 'suitabl':62 'though':22 'updat':33 'use':66 'version':15","created_at":"2026-06-07T16:58:16.953854+00:00","updated_at":"2026-06-07T16:58:16.953854+00:00","problems":[{"fix":"Run 'npm install node-jira' and ensure require path is 'node-jira'.","cause":"Package not installed or misspelled in require.","error":"Cannot find module 'node-jira'"},{"fix":"Use 'const JiraApi = require('node-jira');' (CommonJS).","cause":"Using wrong import style (e.g., ES6 import), or package not installed correctly.","error":"JiraApi is not a constructor"},{"fix":"Ensure you call 'new JiraApi(username, password, options)' with correct parameters.","cause":"JiraApi instance not created properly (missing or incorrect arguments).","error":"TypeError: jira.getIssue is not a function"}],"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/stefanmayer13/node-jira#readme","github":"https://github.com/stefanmayer13/node-jira","docs":null,"changelog":null,"pypi":null,"npm":"node-jira","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"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}}