confluence-cli 1.11.1 → 1.12.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [1.12.0](https://github.com/pchuri/confluence-cli/compare/v1.11.1...v1.12.0) (2025-12-31)
+
+
+### Features
+
+* add page delete command ([#25](https://github.com/pchuri/confluence-cli/issues/25)) ([bc3e412](https://github.com/pchuri/confluence-cli/commit/bc3e412a6ccd0774d62ab0816a6c2735cbd470a4))
+
 ## [1.11.1](https://github.com/pchuri/confluence-cli/compare/v1.11.0...v1.11.1) (2025-12-17)
 
 

package/README.md

@@ -10,6 +10,7 @@ A powerful command-line interface for Atlassian Confluence that allows you to re
 - 🏠 **List spaces** - View all available Confluence spaces
 - ✏️ **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
 - 📦 **Export** - Save a page and its attachments to a local folder
 - 🛠️ **Edit workflow** - Export page content for editing and re-import
@@ -209,6 +210,18 @@ confluence update 123456789 --file ./updated-content.md --format markdown
 confluence update 123456789 --title "New Title" --content "And new content"
 ```
 
+### Delete a Page
+```bash
+# Delete by page ID (prompts for confirmation)
+confluence delete 123456789
+
+# Delete by URL
+confluence delete "https://your-domain.atlassian.net/wiki/viewpage.action?pageId=123456789"
+
+# Skip confirmation (useful for scripts)
+confluence delete 123456789 --yes
+```
+
 ### Edit Workflow
 The `edit` and `update` commands work together to create a seamless editing workflow.
 ```bash

package/bin/confluence.js

@@ -2,6 +2,7 @@
 
 const { program } = require('commander');
 const chalk = require('chalk');
+const inquirer = require('inquirer');
 const ConfluenceClient = require('../lib/confluence-client');
 const { getConfig, initConfig } = require('../lib/config');
 const Analytics = require('../lib/analytics');
@@ -274,6 +275,49 @@ program
     }
   });
 
+// Delete command
+program
+  .command('delete <pageIdOrUrl>')
+  .description('Delete a Confluence page by ID or URL')
+  .option('-y, --yes', 'Skip confirmation prompt')
+  .action(async (pageIdOrUrl, options) => {
+    const analytics = new Analytics();
+    try {
+      const config = getConfig();
+      const client = new ConfluenceClient(config);
+      const pageInfo = await client.getPageInfo(pageIdOrUrl);
+
+      if (!options.yes) {
+        const spaceLabel = pageInfo.space?.key ? ` (${pageInfo.space.key})` : '';
+        const { confirmed } = await inquirer.prompt([
+          {
+            type: 'confirm',
+            name: 'confirmed',
+            default: false,
+            message: `Delete "${pageInfo.title}" (ID: ${pageInfo.id})${spaceLabel}?`
+          }
+        ]);
+
+        if (!confirmed) {
+          console.log(chalk.yellow('Cancelled.'));
+          analytics.track('delete_cancel', true);
+          return;
+        }
+      }
+
+      const result = await client.deletePage(pageInfo.id);
+
+      console.log(chalk.green('✅ Page deleted successfully!'));
+      console.log(`Title: ${chalk.blue(pageInfo.title)}`);
+      console.log(`ID: ${chalk.blue(result.id)}`);
+      analytics.track('delete', true);
+    } catch (error) {
+      analytics.track('delete', false);
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
 // Edit command - opens page content for editing
 program
   .command('edit <pageId>')

package/lib/confluence-client.js

@@ -1208,6 +1208,16 @@ class ConfluenceClient {
     };
   }
 
+  /**
+   * Delete a Confluence page
+   * Note: Confluence may move the page to trash depending on instance settings.
+   */
+  async deletePage(pageIdOrUrl) {
+    const pageId = await this.extractPageId(pageIdOrUrl);
+    await this.client.delete(`/content/${pageId}`);
+    return { id: String(pageId) };
+  }
+
   /**
    * Search for a page by title and space
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "confluence-cli",
-  "version": "1.11.1",
+  "version": "1.12.0",
   "description": "A command-line interface for Atlassian Confluence with page creation and editing capabilities",
   "main": "index.js",
   "bin": {

package/tests/confluence-client.test.js

@@ -267,6 +267,29 @@ describe('ConfluenceClient', () => {
       expect(typeof client.getPageForEdit).toBe('function');
       expect(typeof client.createChildPage).toBe('function');
       expect(typeof client.findPageByTitle).toBe('function');
+      expect(typeof client.deletePage).toBe('function');
+    });
+  });
+
+  describe('deletePage', () => {
+    test('should delete a page by ID', async () => {
+      const mock = new MockAdapter(client.client);
+      mock.onDelete('/content/123456789').reply(204);
+
+      await expect(client.deletePage('123456789')).resolves.toEqual({ id: '123456789' });
+
+      mock.restore();
+    });
+
+    test('should delete a page by URL', async () => {
+      const mock = new MockAdapter(client.client);
+      mock.onDelete('/content/987654321').reply(204);
+
+      await expect(
+        client.deletePage('https://test.atlassian.net/wiki/viewpage.action?pageId=987654321')
+      ).resolves.toEqual({ id: '987654321' });
+
+      mock.restore();
     });
   });