Установка

jira.js — только ESM, с встроенными определениями типов TypeScript. Требует Node.js 22 или новее и работает в современных браузерах.

TypeScript не обязателен, но если вы им пользуетесь, объявлениям нужна версия 5.7 или новее. В них упомянут ArrayBufferView, ставший генериком именно в этом выпуске; компилятор постарше читает то же самое объявление как ошибку — если только skipLibCheck не прячет её от него самого.

6.0 — это переписывание

npm install jira.js ставит 6.x. Это не бесшовное обновление с 5.x — сначала прочитайте руководство по миграции и обратите внимание, кому там рекомендовано остаться на jira.js@5.

Менеджеры пакетов

# npm
npm install jira.js

# yarn
yarn add jira.js

# pnpm
pnpm add jira.js

Импорт

import { createCloudClient } from 'jira.js';

Сборки CommonJS нет. require('jira.js') не работает; из CommonJS-модуля используйте динамический await import('jira.js').

Пакет также отдаёт подпути по поверхностям — jira.js/cloud, jira.js/agile, jira.js/serviceDesk и jira.js/core, — в которых лежат плоские функции вместе со всеми типами параметров и ответов. См. Tree-Shaking.

Требования

Node.js	≥ 22
Модули	только ESM
Зависимости в рантайме	zod

Использование в браузере

Пакет целиком браузеро-безопасен, а jira.js/browser — готовая сборка. Обращаться к Jira напрямую со страницы обычно мешает CORS, и это раскрывает учётные данные любому, кто откроет devtools. Так что это про расширения, Forge-приложения и проксирование, а не про то, чтобы положить API-токен в веб-приложение.

Переход к исходникам

В опубликованный пакет входит src/, поэтому «перейти к определению» на любом символе приводит в настоящий TypeScript — с JSDoc и схемой, по которой валидируется ответ, — а не в заглушку .d.ts.