{"_id":"@airnauts/comments-integration-jira","_rev":"4-efea19e2bc3d0fd59c7e677580e7acf2","name":"@airnauts/comments-integration-jira","dist-tags":{"latest":"0.7.0"},"versions":{"0.5.1":{"name":"@airnauts/comments-integration-jira","version":"0.5.1","keywords":["comments","commenting","annotations","feedback","airnauts","integration","jira"],"author":{"name":"Airnauts"},"license":"MIT","_id":"@airnauts/comments-integration-jira@0.5.1","maintainers":[{"name":"jkrzemie","email":"hello@airnauts.com"},{"name":"mateuszpaulski","email":"mateusz@airnauts.com"}],"homepage":"https://github.com/Airnauts/commenting-tool#readme","bugs":{"url":"https://github.com/Airnauts/commenting-tool/issues"},"dist":{"shasum":"94975218ce9e521ef754090e1e33288d53b53808","tarball":"https://registry.npmjs.org/@airnauts/comments-integration-jira/-/comments-integration-jira-0.5.1.tgz","fileCount":13,"integrity":"sha512-nPGynwfVSzw8Fs4J9w2zcVw5t4VZEhxS1dCVELSpEWIchocGqo+RVVLcYy/4Xk5w6+ONPMgELnCBCR9zkIElfQ==","signatures":[{"sig":"MEUCIBXNy2pkXwJ2Cdnj9FDYQS+mh0/dfd3GoBif6Hy++0OqAiEAwtqfdbQb/D4JfKrqbrbupNCJyLjvePDTa2rTwb5HgDk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29516},"type":"module","_from":"file:airnauts-comments-integration-jira-0.5.1.tgz","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"test":"vitest run","build":"tsup && tsc --build --force","typecheck":"tsc --build"},"_npmUser":{"name":"mateuszpaulski","email":"mateusz@airnauts.com"},"_resolved":"/tmp/d207b9ac7a061b0bc0d11890bc0f398e/airnauts-comments-integration-jira-0.5.1.tgz","_integrity":"sha512-nPGynwfVSzw8Fs4J9w2zcVw5t4VZEhxS1dCVELSpEWIchocGqo+RVVLcYy/4Xk5w6+ONPMgELnCBCR9zkIElfQ==","repository":{"url":"git+https://github.com/Airnauts/commenting-tool.git","type":"git","directory":"packages/integration-jira"},"_npmVersion":"10.9.8","description":"Create Jira issues from comment threads (server extension).","directories":{},"_nodeVersion":"22.22.3","dependencies":{"@airnauts/comments-core":"^0.5.1","@airnauts/comments-server":"^0.5.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@airnauts/comments-test-support":"0.0.0"},"_npmOperationalInternal":{"tmp":"tmp/comments-integration-jira_0.5.1_1781524861677_0.2561336312046536","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Renamed to @airnauts/airside-extension-jira — install that instead. No longer maintained."},"0.6.0":{"name":"@airnauts/comments-integration-jira","version":"0.6.0","keywords":["comments","commenting","annotations","feedback","airnauts","integration","jira"],"author":{"name":"Airnauts"},"license":"MIT","_id":"@airnauts/comments-integration-jira@0.6.0","maintainers":[{"name":"jkrzemie","email":"hello@airnauts.com"},{"name":"mateuszpaulski","email":"mateusz@airnauts.com"}],"homepage":"https://github.com/Airnauts/commenting-tool#readme","bugs":{"url":"https://github.com/Airnauts/commenting-tool/issues"},"dist":{"shasum":"541df0b8438769055630488563815fc899ddf1df","tarball":"https://registry.npmjs.org/@airnauts/comments-integration-jira/-/comments-integration-jira-0.6.0.tgz","fileCount":13,"integrity":"sha512-YKZbrgngOz/AcA9yCi9UV3t54+VkvJHQim3ZqAKiGyB+0BX2r4C73ibMI7m1N778n+NleAJdZMVkiS8EPSk9JQ==","signatures":[{"sig":"MEUCIE3LoMzy7Ui+C5v276usUU3m8BvQopIoMgfzVeXK42kDAiEAh54vlyb6AHZW6puslBxwiikOYZxIPNLtXxAu6bf499w=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29516},"type":"module","_from":"file:airnauts-comments-integration-jira-0.6.0.tgz","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"test":"vitest run","build":"tsup && tsc --build --force","typecheck":"tsc --build"},"_npmUser":{"name":"mateuszpaulski","email":"mateusz@airnauts.com"},"_resolved":"/tmp/07ea7bed2681183ae8b24eda3bdf6b4b/airnauts-comments-integration-jira-0.6.0.tgz","_integrity":"sha512-YKZbrgngOz/AcA9yCi9UV3t54+VkvJHQim3ZqAKiGyB+0BX2r4C73ibMI7m1N778n+NleAJdZMVkiS8EPSk9JQ==","repository":{"url":"git+https://github.com/Airnauts/commenting-tool.git","type":"git","directory":"packages/integration-jira"},"_npmVersion":"10.9.8","description":"Create Jira issues from comment threads (server extension).","directories":{},"_nodeVersion":"22.22.3","dependencies":{"@airnauts/comments-core":"^0.6.0","@airnauts/comments-server":"^0.6.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@airnauts/comments-test-support":"0.0.0"},"_npmOperationalInternal":{"tmp":"tmp/comments-integration-jira_0.6.0_1781537514597_0.7548163657718032","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Renamed to @airnauts/airside-extension-jira — install that instead. No longer maintained."},"0.7.0":{"name":"@airnauts/comments-integration-jira","version":"0.7.0","keywords":["comments","commenting","annotations","feedback","airnauts","integration","jira"],"author":{"name":"Airnauts"},"license":"MIT","_id":"@airnauts/comments-integration-jira@0.7.0","maintainers":[{"name":"jkrzemie","email":"hello@airnauts.com"},{"name":"mateuszpaulski","email":"mateusz@airnauts.com"}],"homepage":"https://github.com/Airnauts/commenting-tool#readme","bugs":{"url":"https://github.com/Airnauts/commenting-tool/issues"},"dist":{"shasum":"3f07aed25935db3049183df49d19d20060a52913","tarball":"https://registry.npmjs.org/@airnauts/comments-integration-jira/-/comments-integration-jira-0.7.0.tgz","fileCount":13,"integrity":"sha512-xL13DU8mJ41k6eAf+53CvuPbWbSfnsgFyC78A+aQIfUGKzpJSyGuwmgKx2ZG4sZrq1bvTO6QRHDXq3BrIw67uA==","signatures":[{"sig":"MEUCICnuyORrTwrUxAIwrjwHUmJTjwT7I32XKbIpCoqONfMWAiEAtxrUbA+mDEB7vdKeCbNtvHcx1LUxyWXiRqAaELMGQa4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":30250},"type":"module","_from":"file:airnauts-comments-integration-jira-0.7.0.tgz","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"test":"vitest run","build":"tsup && tsc --build --force","typecheck":"tsc --build"},"_npmUser":{"name":"mateuszpaulski","email":"mateusz@airnauts.com"},"_resolved":"/tmp/9be181aadc3e1c927bb9ce834fb0ef4e/airnauts-comments-integration-jira-0.7.0.tgz","_integrity":"sha512-xL13DU8mJ41k6eAf+53CvuPbWbSfnsgFyC78A+aQIfUGKzpJSyGuwmgKx2ZG4sZrq1bvTO6QRHDXq3BrIw67uA==","repository":{"url":"git+https://github.com/Airnauts/commenting-tool.git","type":"git","directory":"packages/integration-jira"},"_npmVersion":"10.9.8","description":"Create Jira issues from comment threads (server extension).","directories":{},"_nodeVersion":"22.22.3","dependencies":{"@airnauts/comments-core":"^0.7.0","@airnauts/comments-server":"^0.7.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@airnauts/comments-test-support":"0.0.0"},"_npmOperationalInternal":{"tmp":"tmp/comments-integration-jira_0.7.0_1781540305045_0.6366266737459942","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Renamed to @airnauts/airside-extension-jira — install that instead. No longer maintained."}},"time":{"created":"2026-06-15T12:01:01.439Z","modified":"2026-06-16T09:43:10.292Z","0.5.1":"2026-06-15T12:01:01.843Z","0.6.0":"2026-06-15T15:31:54.747Z","0.7.0":"2026-06-15T16:18:25.192Z"},"bugs":{"url":"https://github.com/Airnauts/commenting-tool/issues"},"author":{"name":"Airnauts"},"license":"MIT","homepage":"https://github.com/Airnauts/commenting-tool#readme","keywords":["comments","commenting","annotations","feedback","airnauts","integration","jira"],"repository":{"url":"git+https://github.com/Airnauts/commenting-tool.git","type":"git","directory":"packages/integration-jira"},"description":"Create Jira issues from comment threads (server extension).","maintainers":[{"name":"jkrzemie","email":"hello@airnauts.com"},{"name":"mateuszpaulski","email":"mateusz@airnauts.com"}],"readme":"# @airnauts/comments-integration-jira\n\nJira Cloud thread-action extension for the [Airnauts commenting tool](https://github.com/Airnauts/commenting-tool) server. Adds a **\"Create Jira issue\"** button to each comment thread; clicking it creates a Jira Cloud issue pre-filled with the thread content and stores the issue link back on the thread.\n\n## Installation\n\n```bash\npnpm add @airnauts/comments-integration-jira\n```\n\n## Quick start\n\n```ts\nimport { createCommentsServer } from '@airnauts/comments-server'\nimport { jiraExtension } from '@airnauts/comments-integration-jira'\n\ncreateCommentsServer({\n  repository,\n  storage,\n  secretKey: process.env.COMMENTS_SECRET!,\n  projectId: 'my-app',\n  allowedOrigins: ['https://my-app.example.com'],\n  extensions: jiraExtension({\n    siteUrl: 'https://your-org.atlassian.net',\n    email: process.env.JIRA_EMAIL!,\n    apiToken: process.env.JIRA_API_TOKEN!,\n    projectKey: 'PROJ',\n  }),\n})\n```\n\nThe action appears in the thread toolbar. Once a Jira issue has been created for a thread, the button hides itself — so repeated presses create only one issue. The Jira issue URL is stored as an `externalLink` on the thread and shown in the UI.\n\n## API reference\n\n### `jiraExtension(opts)`\n\n```ts\njiraExtension({\n  siteUrl: string      // Jira Cloud base URL, e.g. \"https://acme.atlassian.net\" (required)\n  email: string        // Atlassian account email used for Basic Auth (required)\n  apiToken: string     // API token from id.atlassian.com (required)\n  projectKey: string   // Project key, e.g. \"PROJ\" (required)\n  issueType?: string   // Issue type name (default \"Task\")\n  labels?: string[]    // Labels applied to every created issue\n}): ServerExtension[]\n```\n\nAll four required fields (`siteUrl`, `email`, `apiToken`, `projectKey`) are validated at construction time — a missing value throws immediately so misconfiguration fails fast.\n\n### `JiraConfig`\n\n```ts\ntype JiraConfig = {\n  siteUrl: string\n  email: string\n  apiToken: string\n  projectKey: string\n  issueType?: string\n}\n```\n\n### `JiraExtensionOptions`\n\n`JiraConfig` plus an optional `labels?: string[]` array.\n\n## Configuration / env vars\n\n| Env var | Description |\n|---|---|\n| `JIRA_EMAIL` | Atlassian account email |\n| `JIRA_API_TOKEN` | API token from [id.atlassian.com](https://id.atlassian.com/manage-profile/security/api-tokens) |\n\n## Requirements\n\n- Node.js ≥ 18 (or any fetch-capable runtime)\n- Jira Cloud (Atlassian REST API v3)\n\n## Related packages\n\n- **`@airnauts/comments-server`** — defines `ServerExtension` and `ThreadActionExtension`\n- **`@airnauts/comments-notifier-slack`** — Slack notification extension\n- **`@airnauts/comments-notifier-email`** — email notification extension\n\n## License\n\nMIT © Airnauts\n","readmeFilename":"README.md"}