atl-fetch

library1.2.2jsnpmunverified

atl-fetch is a Node.js CLI tool and library for fetching data from Atlassian Cloud (Jira/Confluence). Version 1.2.2 is current stable release; release cadence is irregular. Key differentiators: supports multiple output formats (JSON, Markdown, YAML), version diff display, attachment download, progress spinner, and helpful error messages. Requires Node.js >=22.0.0. ESM-only package with TypeScript types included.

devops

npm install atl-fetch

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · ATL-FETCH

atl-fetch

devopsjavascriptv1.2.2

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ import atlFetch from 'atl-fetch'

✗ const atlFetch = require('atl-fetch')

ESM-only package; CommonJS require is not supported.

fetchJiraIssue

✓ import { fetchJiraIssue } from 'atl-fetch'

✗ import { fetchJiraIssue } from 'atl-fetch/dist/index.js'

Named exports are available directly from the package.

fetchConfluencePage

✓ import { fetchConfluencePage } from 'atl-fetch'

Named export for Confluence pages.

downloadAttachments

✓ import { downloadAttachments } from 'atl-fetch'

Available as named export.

Demonstrates importing the default export and using it to fetch a Jira issue with environment variables for authentication.

import atlFetch from 'atl-fetch'; async function main() { const url = 'https://your-domain.atlassian.net/browse/PROJECT-123'; const result = await atlFetch(url, { email: process.env.ATLASSIAN_EMAIL ?? '', apiToken: process.env.ATLASSIAN_API_TOKEN ?? '', format: 'json' }); console.log(JSON.stringify(result, null, 2)); } main().catch(console.error);

Debug

Known issues

breakingNode.js >=22.0.0 required. Older versions will throw an engine error.

fix

Upgrade Node.js to version 22 or later.

affects: >=1.0.0

gotchaEnvironment variables ATLASSIAN_EMAIL and ATLASSIAN_API_TOKEN must be set before calling the library; no built-in config file or interactive login.

fix

Export the variables in your shell or use a .env file with dotenv.

affects: >=1.0.0

gotchaURL must include full path to issue or page; partial URLs may cause confusing errors.

fix

Use the exact browser URL for the Jira issue or Confluence page.

affects: >=1.0.0

gotchaThe CLI and library API emit progress spinner output to stderr; redirecting stdout to a file may still show spinner on terminal.

fix

To suppress spinner, set CI=true environment variable or use --silent flag if available.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'atl-fetch'

Package not installed or wrong import path.

fix

Install with `npm install atl-fetch` (or pnpm/yarn) and ensure you are using ESM imports.

Error: Engine "node" is incompatible with this module. Expected version ">=22.0.0". Got "20.11.0"

Node.js version is below 22.

fix

Upgrade Node.js to v22 or later using nvm or a package manager.

Error: Bad Request (400) - invalid JSON response

Invalid Atlassian URL or missing API token.

fix

Double-check the URL format and ensure ATLASSIAN_API_TOKEN is set correctly.

ReferenceError: require is not defined

Using CommonJS require in ESM context.

fix

Use `import atlFetch from 'atl-fetch'` instead of `require`.

Upgrade

Version history

1.2.2latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

7 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/semba-yui/atl-fetch ↗

packageatl-fetch ↗

homepagehttps://github.com/semba-yui/atl-fetch#readme ↗