@baiyibai-antora/atlassian-client 1.0.0-beta.5

package/lib/index.js

@@ -0,0 +1,75 @@
+'use strict'
+
+// Minimal Atlassian Cloud REST client shared by the Confluora packages:
+// basic auth from an email + API token, JSON in/out, multipart form upload,
+// and cursor pagination for the Confluence v2 API. Node's built-in fetch;
+// injectable for tests. Zero dependencies.
+
+class AtlassianClient {
+  constructor ({ baseUrl, email, apiToken, fetch: fetchImpl, serviceName } = {}) {
+    if (!baseUrl || !email || !apiToken) {
+      throw new Error(`${serviceName || 'Atlassian'} client requires baseUrl, email, and apiToken`)
+    }
+    this.baseUrl = baseUrl.replace(/\/$/, '')
+    this.fetch = fetchImpl || globalThis.fetch
+    this.authHeader = 'Basic ' + Buffer.from(`${email}:${apiToken}`).toString('base64')
+    this.serviceName = serviceName || 'Atlassian'
+  }
+
+  async request (method, path, { body, headers, form } = {}) {
+    const opts = { method, headers: { Authorization: this.authHeader, Accept: 'application/json', ...headers } }
+    if (form) {
+      opts.body = form
+      opts.headers['X-Atlassian-Token'] = 'nocheck'
+    } else if (body !== undefined) {
+      opts.headers['Content-Type'] = 'application/json'
+      opts.body = JSON.stringify(body)
+    }
+    const response = await this.fetch(`${this.baseUrl}${path}`, opts)
+    if (response.status === 404) return null
+    if (!response.ok) {
+      const detail = await response.text().catch(() => '')
+      throw new Error(`${this.serviceName} ${method} ${path} failed: ${response.status} ${detail.slice(0, 500)}`)
+    }
+    if (response.status === 204) return {}
+    return response.json()
+  }
+
+  // Raw body download (attachments, exports); returns a Buffer or null on 404.
+  async download (path) {
+    const response = await this.fetch(`${this.baseUrl}${path}`, {
+      headers: { Authorization: this.authHeader },
+      redirect: 'follow',
+    })
+    if (response.status === 404) return null
+    if (!response.ok) throw new Error(`${this.serviceName} GET ${path} failed: ${response.status}`)
+    return Buffer.from(await response.arrayBuffer())
+  }
+
+  // Collect every result of a Confluence v2 cursor-paginated collection
+  // (the response carries `_links.next` until the last page).
+  async getAll (path) {
+    const results = []
+    let next = path
+    while (next) {
+      const page = await this.request('GET', next)
+      if (!page) break
+      results.push(...(page.results || []))
+      next = (page._links && page._links.next) || null
+    }
+    return results
+  }
+}
+
+// Credentials come from the environment (CI-friendly, never on the command
+// line). ATLASSIAN_BASE_URL covers both products; the product-specific names
+// are accepted for back compatibility.
+function credentialsFromEnv (env = process.env) {
+  return {
+    baseUrl: env.ATLASSIAN_BASE_URL || env.CONFLUENCE_BASE_URL || env.JIRA_BASE_URL,
+    email: env.ATLASSIAN_EMAIL || env.CONFLUENCE_USER_EMAIL,
+    apiToken: env.ATLASSIAN_API_TOKEN || env.CONFLUENCE_API_TOKEN,
+  }
+}
+
+module.exports = { AtlassianClient, credentialsFromEnv }

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@baiyibai-antora/atlassian-client",
+  "version": "1.0.0-beta.5",
+  "description": "Minimal zero-dependency Atlassian Cloud REST client (basic auth, JSON, multipart, v2 cursor pagination) shared by the Confluora packages",
+  "license": "MIT",
+  "author": "baiyibai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/baiyibai-antora/confluora.git",
+    "directory": "packages/atlassian-client"
+  },
+  "type": "commonjs",
+  "main": "lib/index.js",
+  "files": [
+    "lib"
+  ],
+  "scripts": {
+    "test": "node --test test/*-test.js"
+  },
+  "keywords": [
+    "confluora",
+    "atlassian",
+    "confluence",
+    "jira",
+    "rest",
+    "client"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}