confluence-cli 1.15.1 → 1.17.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [1.17.0](https://github.com/pchuri/confluence-cli/compare/v1.16.0...v1.17.0) (2026-02-13)
+
+
+### Features
+
+* add attachment upload and delete commands ([#36](https://github.com/pchuri/confluence-cli/issues/36)) ([ed62bb4](https://github.com/pchuri/confluence-cli/commit/ed62bb45468566c128f066016615048e31ed1775))
+
+# [1.16.0](https://github.com/pchuri/confluence-cli/compare/v1.15.1...v1.16.0) (2026-02-13)
+
+
+### Features
+
+* Add move command to relocate pages ([#32](https://github.com/pchuri/confluence-cli/issues/32)) ([a37f9b8](https://github.com/pchuri/confluence-cli/commit/a37f9b83174ef08a6517fe279dcce1b39fc1fb1a))
+
 ## [1.15.1](https://github.com/pchuri/confluence-cli/compare/v1.15.0...v1.15.1) (2026-02-12)
 
 

package/README.md

@@ -11,7 +11,7 @@ A powerful command-line interface for Atlassian Confluence that allows you to re
 - ✏️ **Create pages** - Create new pages with support for Markdown, HTML, or Storage format
 - 📝 **Update pages** - Update existing page content and titles
 - 🗑️ **Delete pages** - Delete (or move to trash) pages by ID or URL
-- 📎 **Attachments** - List or download page attachments
+- 📎 **Attachments** - List, download, upload, or delete page attachments
 - 💬 **Comments** - List, create, and delete page comments (footer or inline)
 - 📦 **Export** - Save a page and its attachments to a local folder
 - 🛠️ **Edit workflow** - Export page content for editing and re-import
@@ -160,6 +160,27 @@ confluence attachments 123456789 --pattern "*.png" --limit 5
 confluence attachments 123456789 --pattern "*.png" --download --dest ./downloads
 ```
 
+### Upload Attachments
+```bash
+# Upload a single attachment
+confluence attachment-upload 123456789 --file ./report.pdf
+
+# Upload multiple files with a comment
+confluence attachment-upload 123456789 --file ./a.pdf --file ./b.png --comment "v2"
+
+# Replace an existing attachment by filename
+confluence attachment-upload 123456789 --file ./diagram.png --replace
+```
+
+### Delete Attachments
+```bash
+# Delete an attachment by ID
+confluence attachment-delete 123456789 998877
+
+# Skip confirmation
+confluence attachment-delete 123456789 998877 --yes
+```
+
 ### Comments
 ```bash
 # List all comments (footer + inline)
@@ -296,6 +317,22 @@ confluence update 123456789 --file ./updated-content.md --format markdown
 confluence update 123456789 --title "New Title" --content "And new content"
 ```
 
+### Move a Page to New Parent
+
+```bash
+# Move page by ID
+confluence move 123456789 987654321
+
+# Move page and rename it
+confluence move 123456789 987654321 --title "Relocated Page"
+
+# Move using URLs (for convenience)
+confluence move "https://domain.atlassian.net/wiki/viewpage.action?pageId=123456789" \
+                "https://domain.atlassian.net/wiki/viewpage.action?pageId=987654321"
+```
+
+**Note:** Pages can only be moved within the same Confluence space. Cross-space moves are not supported.
+
 ### Delete a Page
 ```bash
 # Delete by page ID (prompts for confirmation)
@@ -341,9 +378,12 @@ confluence stats
 | `create-child <title> <parentId>` | Create a child page | `--content <string>`, `--file <path>`, `--format <storage\|html\|markdown>` |
 | `copy-tree <sourcePageId> <targetParentId> [newTitle]` | Copy page tree with all children | `--max-depth <number>`, `--exclude <patterns>`, `--delay-ms <ms>`, `--copy-suffix <text>`, `--dry-run`, `--fail-on-error`, `--quiet` |
 | `update <pageId>` | Update a page's title or content | `--title <string>`, `--content <string>`, `--file <path>`, `--format <storage\|html\|markdown>` |
+| `move <pageId_or_url> <newParentId_or_url>` | Move a page to a new parent location | `--title <string>` |
 | `delete <pageId_or_url>` | Delete a page by ID or URL | `--yes` |
 | `edit <pageId>` | Export page content for editing | `--output <file>` |
 | `attachments <pageId_or_url>` | List or download attachments for a page | `--limit <number>`, `--pattern <glob>`, `--download`, `--dest <directory>` |
+| `attachment-upload <pageId_or_url>` | Upload attachments to a page | `--file <path>`, `--comment <text>`, `--replace`, `--minor-edit` |
+| `attachment-delete <pageId_or_url> <attachmentId>` | Delete an attachment from a page | `--yes` |
 | `comments <pageId_or_url>` | List comments for a page | `--format <text\|markdown\|json>`, `--limit <number>`, `--start <number>`, `--location <inline\|footer\|resolved>`, `--depth <root\|all>`, `--all` |
 | `comment <pageId_or_url>` | Create a comment on a page | `--content <string>`, `--file <path>`, `--format <storage\|html\|markdown>`, `--parent <commentId>`, `--location <inline\|footer>`, `--inline-selection <text>`, `--inline-original-selection <text>`, `--inline-marker-ref <ref>`, `--inline-properties <json>` |
 | `comment-delete <commentId>` | Delete a comment by ID | `--yes` |
@@ -371,6 +411,16 @@ confluence search "API documentation" --limit 3
 # List all spaces
 confluence spaces
 
+# Move a page to a new parent
+confluence move 123456789 987654321
+
+# Move and rename
+confluence move 123456789 987654321 --title "New Title"
+
+# Upload and delete an attachment
+confluence attachment-upload 123456789 --file ./report.pdf
+confluence attachment-delete 123456789 998877 --yes
+
 # View usage statistics
 confluence stats
 ```
@@ -414,7 +464,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 - [ ] Bulk operations
 - [ ] Export pages to different formats
 - [ ] Integration with other Atlassian tools (Jira)
-- [ ] Page attachments management
+- [x] Page attachments management (list, download, upload, delete)
 - [x] Comments
 - [ ] Reviews
 

package/bin/confluence.js

@@ -277,6 +277,33 @@ program
     }
   });
 
+// Move command
+program
+  .command('move <pageId_or_url> <newParentId_or_url>')
+  .description('Move a page to a new parent location (within same space)')
+  .option('-t, --title <title>', 'New page title (optional)')
+  .action(async (pageId, newParentId, options) => {
+    const analytics = new Analytics();
+    try {
+      const config = getConfig();
+      const client = new ConfluenceClient(config);
+      const result = await client.movePage(pageId, newParentId, options.title);
+
+      console.log(chalk.green('✅ Page moved successfully!'));
+      console.log(`Title: ${chalk.blue(result.title)}`);
+      console.log(`ID: ${chalk.blue(result.id)}`);
+      console.log(`New Parent: ${chalk.blue(newParentId)}`);
+      console.log(`Version: ${chalk.blue(result.version.number)}`);
+      console.log(`URL: ${chalk.gray(`https://${config.domain}/wiki${result._links.webui}`)}`);
+
+      analytics.track('move', true);
+    } catch (error) {
+      analytics.track('move', false);
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
 // Delete command
 program
   .command('delete <pageIdOrUrl>')
@@ -468,6 +495,108 @@ program
     }
   });
 
+// Attachment upload command
+program
+  .command('attachment-upload <pageId>')
+  .description('Upload one or more attachments to a page')
+  .option('-f, --file <file>', 'File to upload (repeatable)', (value, previous) => {
+    const files = Array.isArray(previous) ? previous : [];
+    files.push(value);
+    return files;
+  }, [])
+  .option('--comment <comment>', 'Comment for the attachment(s)')
+  .option('--replace', 'Replace an existing attachment with the same filename')
+  .option('--minor-edit', 'Mark the upload as a minor edit')
+  .action(async (pageId, options) => {
+    const analytics = new Analytics();
+    try {
+      const files = Array.isArray(options.file) ? options.file.filter(Boolean) : [];
+      if (files.length === 0) {
+        throw new Error('At least one --file option is required.');
+      }
+
+      const fs = require('fs');
+      const path = require('path');
+      const config = getConfig();
+      const client = new ConfluenceClient(config);
+
+      const resolvedFiles = files.map((filePath) => ({
+        original: filePath,
+        resolved: path.resolve(filePath)
+      }));
+
+      resolvedFiles.forEach((file) => {
+        if (!fs.existsSync(file.resolved)) {
+          throw new Error(`File not found: ${file.original}`);
+        }
+      });
+
+      let uploaded = 0;
+      for (const file of resolvedFiles) {
+        const result = await client.uploadAttachment(pageId, file.resolved, {
+          comment: options.comment,
+          replace: options.replace,
+          minorEdit: options.minorEdit === true ? true : undefined
+        });
+        const attachment = result.results[0];
+        if (attachment) {
+          console.log(`⬆️  ${chalk.green(attachment.title)} (ID: ${attachment.id}, Version: ${attachment.version})`);
+        } else {
+          console.log(`⬆️  ${chalk.green(path.basename(file.resolved))}`);
+        }
+        uploaded += 1;
+      }
+
+      console.log(chalk.green(`Uploaded ${uploaded} attachment${uploaded === 1 ? '' : 's'} to page ${pageId}`));
+      analytics.track('attachment_upload', true);
+    } catch (error) {
+      analytics.track('attachment_upload', false);
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Attachment delete command
+program
+  .command('attachment-delete <pageId> <attachmentId>')
+  .description('Delete an attachment by ID from a page')
+  .option('-y, --yes', 'Skip confirmation prompt')
+  .action(async (pageId, attachmentId, options) => {
+    const analytics = new Analytics();
+    try {
+      const config = getConfig();
+      const client = new ConfluenceClient(config);
+
+      if (!options.yes) {
+        const { confirmed } = await inquirer.prompt([
+          {
+            type: 'confirm',
+            name: 'confirmed',
+            default: false,
+            message: `Delete attachment ${attachmentId} from page ${pageId}?`
+          }
+        ]);
+
+        if (!confirmed) {
+          console.log(chalk.yellow('Cancelled.'));
+          analytics.track('attachment_delete_cancel', true);
+          return;
+        }
+      }
+
+      const result = await client.deleteAttachment(pageId, attachmentId);
+
+      console.log(chalk.green('✅ Attachment deleted successfully!'));
+      console.log(`ID: ${chalk.blue(result.id)}`);
+      console.log(`Page ID: ${chalk.blue(result.pageId)}`);
+      analytics.track('attachment_delete', true);
+    } catch (error) {
+      analytics.track('attachment_delete', false);
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
 // Comments command
 program
   .command('comments <pageId>')

package/lib/confluence-client.js

@@ -1,4 +1,7 @@
 const axios = require('axios');
+const fs = require('fs');
+const path = require('path');
+const FormData = require('form-data');
 const { convert } = require('html-to-text');
 const MarkdownIt = require('markdown-it');
 
@@ -808,6 +811,67 @@ class ConfluenceClient {
     return downloadResponse.data;
   }
 
+  /**
+   * Upload an attachment to a page
+   */
+  async uploadAttachment(pageIdOrUrl, filePath, options = {}) {
+    if (!filePath || typeof filePath !== 'string') {
+      throw new Error('File path is required for attachment upload.');
+    }
+
+    const resolvedPath = path.resolve(filePath);
+    if (!fs.existsSync(resolvedPath)) {
+      throw new Error(`File not found: ${filePath}`);
+    }
+
+    const pageId = await this.extractPageId(pageIdOrUrl);
+    const form = new FormData();
+    form.append('file', fs.createReadStream(resolvedPath), { filename: path.basename(resolvedPath) });
+
+    if (options.comment !== undefined && options.comment !== null) {
+      form.append('comment', options.comment, { contentType: 'text/plain; charset=utf-8' });
+    }
+
+    if (typeof options.minorEdit === 'boolean') {
+      form.append('minorEdit', options.minorEdit ? 'true' : 'false');
+    }
+
+    const method = options.replace ? 'put' : 'post';
+    const response = await this.client.request({
+      url: `/content/${pageId}/child/attachment`,
+      method,
+      headers: {
+        ...form.getHeaders(),
+        'X-Atlassian-Token': 'nocheck'
+      },
+      data: form,
+      maxBodyLength: Infinity,
+      maxContentLength: Infinity
+    });
+
+    const results = Array.isArray(response.data?.results)
+      ? response.data.results.map((item) => this.normalizeAttachment(item))
+      : [];
+
+    return {
+      results,
+      raw: response.data
+    };
+  }
+
+  /**
+   * Delete an attachment by ID
+   */
+  async deleteAttachment(pageIdOrUrl, attachmentId) {
+    if (!attachmentId) {
+      throw new Error('Attachment ID is required.');
+    }
+
+    const pageId = await this.extractPageId(pageIdOrUrl);
+    await this.client.delete(`/content/${pageId}/child/attachment/${attachmentId}`);
+    return { id: String(attachmentId), pageId: String(pageId) };
+  }
+
   /**
    * Convert markdown to Confluence storage format
    */
@@ -1449,6 +1513,55 @@ class ConfluenceClient {
     return response.data;
   }
 
+  /**
+   * Move a page to a new parent location
+   */
+  async movePage(pageIdOrUrl, newParentIdOrUrl, newTitle = null) {
+    // Resolve both IDs from URLs if needed
+    const pageId = await this.extractPageId(pageIdOrUrl);
+    const newParentId = await this.extractPageId(newParentIdOrUrl);
+
+    // Fetch current page
+    const response = await this.client.get(`/content/${pageId}`, {
+      params: { expand: 'body.storage,version,space' }
+    });
+    const { version, title, body, space } = response.data;
+
+    // Fetch new parent to get its space (for validation)
+    const parentResponse = await this.client.get(`/content/${newParentId}`, {
+      params: { expand: 'space' }
+    });
+    const parentSpace = parentResponse.data.space;
+
+    // Validate same space
+    if (parentSpace.key !== space.key) {
+      throw new Error(
+        `Cannot move page across spaces. Page is in space "${space.key}" ` +
+        `but new parent is in space "${parentSpace.key}". ` +
+        'Pages can only be moved within the same space.'
+      );
+    }
+
+    // Proceed with move
+    const pageData = {
+      id: pageId,
+      type: 'page',
+      title: newTitle || title,
+      space: { key: space.key },
+      body: {
+        storage: {
+          value: body.storage.value,
+          representation: 'storage'
+        }
+      },
+      version: { number: version.number + 1 },
+      ancestors: [{ id: newParentId }]
+    };
+
+    const updateResponse = await this.client.put(`/content/${pageId}`, pageData);
+    return updateResponse.data;
+  }
+
   /**
    * Get page content for editing
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "confluence-cli",
-  "version": "1.15.1",
+  "version": "1.17.0",
   "description": "A command-line interface for Atlassian Confluence with page creation and editing capabilities",
   "main": "index.js",
   "bin": {
@@ -26,6 +26,7 @@
     "axios": "^1.12.0",
     "chalk": "^4.1.2",
     "commander": "^11.1.0",
+    "form-data": "^4.0.5",
     "html-to-text": "^9.0.5",
     "inquirer": "^8.2.6",
     "markdown-it": "^14.1.0",

package/tests/confluence-client.test.js

@@ -1,6 +1,44 @@
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const FormData = require('form-data');
 const ConfluenceClient = require('../lib/confluence-client');
 const MockAdapter = require('axios-mock-adapter');
 
+const removeDirRecursive = (dir) => {
+  if (!dir) return;
+  try {
+    if (fs.rmSync) {
+      fs.rmSync(dir, { recursive: true, force: true });
+      return;
+    }
+  } catch (error) {
+    void error;
+  }
+
+  if (!fs.existsSync(dir)) return;
+
+  fs.readdirSync(dir).forEach((entry) => {
+    const entryPath = path.join(dir, entry);
+    const stats = fs.lstatSync(entryPath);
+    if (stats.isDirectory()) {
+      removeDirRecursive(entryPath);
+    } else {
+      try {
+        fs.unlinkSync(entryPath);
+      } catch (error) {
+        void error;
+      }
+    }
+  });
+
+  try {
+    fs.rmdirSync(dir);
+  } catch (error) {
+    void error;
+  }
+};
+
 describe('ConfluenceClient', () => {
   let client;
   
@@ -298,6 +336,160 @@ describe('ConfluenceClient', () => {
     });
   });
 
+  describe('movePage', () => {
+    test('should move a page by ID', async () => {
+      const mock = new MockAdapter(client.client);
+
+      mock.onGet('/content/123456789').reply(200, {
+        id: '123456789',
+        title: 'Original Title',
+        version: { number: 5 },
+        body: { storage: { value: '<p>Original content</p>' } },
+        space: { key: 'TEST' }
+      });
+
+      mock.onGet('/content/987654321').reply(200, {
+        id: '987654321',
+        space: { key: 'TEST' }
+      });
+
+      mock.onPut('/content/123456789').reply(200, {
+        id: '123456789',
+        title: 'Original Title',
+        version: { number: 6 },
+        ancestors: [{ id: '987654321' }]
+      });
+
+      const result = await client.movePage('123456789', '987654321');
+
+      expect(result.id).toBe('123456789');
+      expect(result.version.number).toBe(6);
+      expect(result.ancestors).toEqual([{ id: '987654321' }]);
+
+      mock.restore();
+    });
+
+    test('should move a page with new title', async () => {
+      const mock = new MockAdapter(client.client);
+
+      mock.onGet('/content/555666777').reply(200, {
+        id: '555666777',
+        title: 'Old Title',
+        version: { number: 2 },
+        body: { storage: { value: '<p>Page content</p>' } },
+        space: { key: 'DOCS' }
+      });
+
+      mock.onGet('/content/888999000').reply(200, {
+        id: '888999000',
+        space: { key: 'DOCS' }
+      });
+
+      mock.onPut('/content/555666777').reply(200, {
+        id: '555666777',
+        title: 'New Title',
+        version: { number: 3 },
+        ancestors: [{ id: '888999000' }]
+      });
+
+      const result = await client.movePage('555666777', '888999000', 'New Title');
+
+      expect(result.title).toBe('New Title');
+      expect(result.version.number).toBe(3);
+      expect(result.ancestors).toEqual([{ id: '888999000' }]);
+
+      mock.restore();
+    });
+
+    test('should move a page using URL for pageId', async () => {
+      const mock = new MockAdapter(client.client);
+      const pageUrl = 'https://test.atlassian.net/wiki/viewpage.action?pageId=111222333';
+
+      mock.onGet('/content/111222333').reply(200, {
+        id: '111222333',
+        title: 'Test Page',
+        version: { number: 1 },
+        body: { storage: { value: '<p>Content</p>' } },
+        space: { key: 'TEST' }
+      });
+
+      mock.onGet('/content/444555666').reply(200, {
+        id: '444555666',
+        space: { key: 'TEST' }
+      });
+
+      mock.onPut('/content/111222333').reply(200, {
+        id: '111222333',
+        title: 'Test Page',
+        version: { number: 2 },
+        ancestors: [{ id: '444555666' }]
+      });
+
+      const result = await client.movePage(pageUrl, '444555666');
+
+      expect(result.id).toBe('111222333');
+      expect(result.version.number).toBe(2);
+
+      mock.restore();
+    });
+
+    test('should move a page using URLs for both parameters', async () => {
+      const mock = new MockAdapter(client.client);
+      const pageUrl = 'https://test.atlassian.net/wiki/viewpage.action?pageId=777888999';
+      const parentUrl = 'https://test.atlassian.net/wiki/viewpage.action?pageId=111000111';
+
+      mock.onGet('/content/777888999').reply(200, {
+        id: '777888999',
+        title: 'Source Page',
+        version: { number: 3 },
+        body: { storage: { value: '<p>Page content</p>' } },
+        space: { key: 'DOCS' }
+      });
+
+      mock.onGet('/content/111000111').reply(200, {
+        id: '111000111',
+        space: { key: 'DOCS' }
+      });
+
+      mock.onPut('/content/777888999').reply(200, {
+        id: '777888999',
+        title: 'Source Page',
+        version: { number: 4 },
+        ancestors: [{ id: '111000111' }]
+      });
+
+      const result = await client.movePage(pageUrl, parentUrl);
+
+      expect(result.id).toBe('777888999');
+      expect(result.version.number).toBe(4);
+
+      mock.restore();
+    });
+
+    test('should throw error when moving page across spaces', async () => {
+      const mock = new MockAdapter(client.client);
+
+      mock.onGet('/content/123456789').reply(200, {
+        id: '123456789',
+        title: 'Page in Space A',
+        version: { number: 1 },
+        body: { storage: { value: '<p>Content</p>' } },
+        space: { key: 'SPACEA' }
+      });
+
+      mock.onGet('/content/987654321').reply(200, {
+        id: '987654321',
+        space: { key: 'SPACEB' }
+      });
+
+      await expect(
+        client.movePage('123456789', '987654321')
+      ).rejects.toThrow('Cannot move page across spaces');
+
+      mock.restore();
+    });
+  });
+
   describe('page tree operations', () => {
     test('should have required methods for tree operations', () => {
       expect(typeof client.getChildPages).toBe('function');
@@ -445,6 +637,8 @@ describe('ConfluenceClient', () => {
       expect(typeof client.listAttachments).toBe('function');
       expect(typeof client.getAllAttachments).toBe('function');
       expect(typeof client.downloadAttachment).toBe('function');
+      expect(typeof client.uploadAttachment).toBe('function');
+      expect(typeof client.deleteAttachment).toBe('function');
     });
 
     test('matchesPattern should respect glob patterns', () => {
@@ -460,5 +654,68 @@ describe('ConfluenceClient', () => {
       expect(client.parseNextStart('/rest/api/content/1/child/attachment?limit=50')).toBeNull();
       expect(client.parseNextStart(null)).toBeNull();
     });
+
+    test('uploadAttachment should send multipart request with Atlassian token header', async () => {
+      const mock = new MockAdapter(client.client);
+      const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'confluence-cli-'));
+      const tempFile = path.join(tempDir, 'upload.txt');
+      fs.writeFileSync(tempFile, 'hello');
+
+      try {
+        mock.onPost('/content/123/child/attachment').reply((config) => {
+          expect(config.headers['X-Atlassian-Token']).toBe('nocheck');
+          const contentType = config.headers['content-type'] || config.headers['Content-Type'];
+          expect(contentType).toContain('multipart/form-data');
+          expect(config.data).toBeInstanceOf(FormData);
+          return [200, {
+            results: [{
+              id: '1',
+              title: 'upload.txt',
+              version: { number: 2 },
+              _links: { download: '/download' }
+            }]
+          }];
+        });
+
+        const response = await client.uploadAttachment('123', tempFile, { comment: 'note', minorEdit: true });
+        expect(response.results[0].title).toBe('upload.txt');
+      } finally {
+        mock.restore();
+        removeDirRecursive(tempDir);
+      }
+    });
+
+    test('uploadAttachment should use PUT when replace is true', async () => {
+      const mock = new MockAdapter(client.client);
+      const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'confluence-cli-'));
+      const tempFile = path.join(tempDir, 'replace.txt');
+      fs.writeFileSync(tempFile, 'replace');
+
+      try {
+        mock.onPut('/content/456/child/attachment').reply(200, {
+          results: [{
+            id: '2',
+            title: 'replace.txt',
+            version: { number: 3 },
+            _links: { download: '/download' }
+          }]
+        });
+
+        const response = await client.uploadAttachment('456', tempFile, { replace: true });
+        expect(response.results[0].title).toBe('replace.txt');
+      } finally {
+        mock.restore();
+        removeDirRecursive(tempDir);
+      }
+    });
+
+    test('deleteAttachment should call delete endpoint', async () => {
+      const mock = new MockAdapter(client.client);
+      mock.onDelete('/content/123/child/attachment/999').reply(204);
+
+      await expect(client.deleteAttachment('123', '999')).resolves.toEqual({ id: '999', pageId: '123' });
+
+      mock.restore();
+    });
   });
 });