{"id":42356,"library":"zenhub-api","title":"zenhub-api","description":"A Node.js wrapper for the ZenHub API, version 0.2.0. It provides an easy-to-use interface for interacting with ZenHub's project management features, including boards, issues, epics, pipelines, estimates, and release reports. The package uses CommonJS and is intended for Node.js environments. It offers 18 methods covering the full ZenHub API, but lacks TypeScript definitions and has seen no recent updates (last release in 2018).","status":"maintenance","version":"0.2.0","language":"javascript","source_language":"en","source_url":"https://github.com/Webini/zenhub-api","tags":["javascript","zenhub","zenhub-api"],"install":[{"cmd":"npm install zenhub-api","lang":"bash","label":"npm"},{"cmd":"yarn add zenhub-api","lang":"bash","label":"yarn"},{"cmd":"pnpm add zenhub-api","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Used internally for HTTP requests","package":"node-fetch","optional":false},{"reason":"Used for query string parsing","package":"qs","optional":false}],"imports":[{"note":"Package uses CommonJS; ES module import not supported natively.","wrong":"import ZenHub from 'zenhub-api';","symbol":"ZenHub","correct":"const ZenHub = require('zenhub-api');"},{"note":"Constructor requires an API key string as first argument.","wrong":"const api = new ZenHub();","symbol":"ZenHub","correct":"const api = new ZenHub('your-api-key');"},{"note":"Methods expect an object parameter (e.g., { repo_id: number }) not a plain string or number.","wrong":"api.getBoard('123456');","symbol":"ZenHub","correct":"api.getBoard({ repo_id: 123456 }).then(console.log);"}],"quickstart":{"code":"const ZenHub = require('zenhub-api');\nconst api = new ZenHub(process.env.ZENHUB_API_KEY ?? '');\n\napi.getBoard({ repo_id: 123456 })\n  .then(board => {\n    console.log('Board data:', JSON.stringify(board, null, 2));\n  })\n  .catch(err => {\n    console.error('Error fetching board:', err);\n  });","lang":"javascript","description":"Demonstrates CommonJS import, instantiation with API key, and calling getBoard with repo_id."},"warnings":[{"fix":"Use require() or configure a bundler that can convert CommonJS.","message":"Package uses CommonJS require() only; ESM import will fail.","severity":"breaking","affected_versions":">=0.0.0"},{"fix":"Always refer to the official ZenHub API docs for parameter shapes (e.g., { repo_id: number }).","message":"All API methods expect an object argument with specific keys; passing wrong types causes silent failures or unexpected errors.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Consider using a more up-to-date alternative or pinning node-fetch@2.","message":"The package relies on node-fetch v2, which is deprecated and may have vulnerabilities.","severity":"deprecated","affected_versions":">=0.0.0"},{"fix":"Use with JavaScript or create custom .d.ts file.","message":"No TypeScript definitions; type checking requires manual declaration or @types/zenhub-api which does not exist.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Check the number after the repository URL (e.g., GitHub API returns 'id' field).","message":"Repository IDs must be numeric; GitHub repo IDs (not GitHub project IDs).","severity":"gotcha","affected_versions":">=0.0.0"}],"env_vars":null,"search_vec":"'0.2.0':12 '18':50 '2018':70 'api':3,10,56,75 'board':30 'commonj':41 'cover':52 'definit':60 'easi':17 'easy-to-us':16 'environ':47 'epic':32 'estim':34 'featur':28 'full':54 'includ':29 'intend':44 'interact':22 'interfac':20 'issu':31 'javascript':71 'lack':58 'last':67 'manag':27 'method':51 'node.js':5,46 'offer':49 'packag':39 'pipelin':33 'project':26 'provid':14 'recent':65 'releas':36,68 'report':37 'seen':63 'typescript':59 'updat':66 'use':19,40 'version':11 'wrapper':6 'zenhub':2,9,24,55,72,74 'zenhub-api':1,73","created_at":"2026-06-04T18:56:51.852263+00:00","updated_at":"2026-06-04T18:56:51.852263+00:00","problems":[{"fix":"Change to const ZenHub = require('zenhub-api');","cause":"Using ES6 import with this CommonJS-only package.","error":"SyntaxError: Cannot use import statement outside a module"},{"fix":"Use new ZenHub(apiKey) and ensure proper method calls.","cause":"Instantiating without new keyword or missing parentheses.","error":"TypeError: api.getBoard is not a function"},{"fix":"Check internet connection and ensure you have access to ZenHub API.","cause":"Network issue or incorrect API endpoint (package uses hardcoded https://api.zenhub.com).","error":"RequestError: getaddrinfo ENOTFOUND api.zenhub.com"}],"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/Webini/zenhub-api#readme","github":"https://github.com/Webini/zenhub-api","docs":null,"changelog":null,"pypi":null,"npm":"zenhub-api","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-04","next_check":"2026-09-02","install_tag":null}}