confluence-cli 1.11.1 → 1.12.1

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [1.12.1](https://github.com/pchuri/confluence-cli/compare/v1.12.0...v1.12.1) (2025-12-31)
+
+
+### Bug Fixes
+
+* align README with CLI behavior ([#26](https://github.com/pchuri/confluence-cli/issues/26)) ([b24c7cf](https://github.com/pchuri/confluence-cli/commit/b24c7cf4a645383812a1cb7239b1db41ded77f8d))
+
+# [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
@@ -241,7 +254,10 @@ 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>` |
+| `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>` |
+| `export <pageId_or_url>` | Export a page to a directory with its attachments | `--format <html\|text\|markdown>`, `--dest <directory>`, `--file <filename>`, `--attachments-dir <name>`, `--pattern <glob>`, `--referenced-only`, `--skip-attachments` |
 | `stats` | View your usage statistics | |
 
 ## Examples

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>')
@@ -431,6 +475,7 @@ program
   .option('--file <filename>', 'Content filename (default: page.<ext>)')
   .option('--attachments-dir <name>', 'Subdirectory for attachments', 'attachments')
   .option('--pattern <glob>', 'Filter attachments by filename (e.g., "*.png")')
+  .option('--referenced-only', 'Download only attachments referenced in the page content')
   .option('--skip-attachments', 'Do not download attachments')
   .action(async (pageId, options) => {
     const analytics = new Analytics();
@@ -445,9 +490,14 @@ program
       const contentExt = formatExt[format] || 'txt';
 
       const pageInfo = await client.getPageInfo(pageId);
-      // Read page with attachment extraction enabled
-      const content = await client.readPage(pageId, format, { extractReferencedAttachments: true });
-      const referencedAttachments = client._referencedAttachments || new Set();
+      const content = await client.readPage(
+        pageId,
+        format,
+        options.referencedOnly ? { extractReferencedAttachments: true } : {}
+      );
+      const referencedAttachments = options.referencedOnly
+        ? (client._referencedAttachments || new Set())
+        : null;
 
       const baseDir = path.resolve(options.dest || '.');
       const folderName = sanitizeTitle(pageInfo.title || 'page');
@@ -466,13 +516,13 @@ program
         const pattern = options.pattern ? options.pattern.trim() : null;
         const allAttachments = await client.getAllAttachments(pageId);
         
-        // Filter: only referenced attachments (unless pattern is specified, then use pattern)
         let filtered;
         if (pattern) {
           filtered = allAttachments.filter(att => client.matchesPattern(att.title, pattern));
+        } else if (options.referencedOnly) {
+          filtered = allAttachments.filter(att => referencedAttachments?.has(att.title));
         } else {
-          // Only download attachments that are referenced in the page content
-          filtered = allAttachments.filter(att => referencedAttachments.has(att.title));
+          filtered = allAttachments;
         }
 
         if (filtered.length === 0) {
@@ -656,4 +706,8 @@ program
     }
   });
 
-program.parse();
+if (process.argv.length <= 2) {
+  program.help({ error: false });
+}
+
+program.parse(process.argv);

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,10 +1,11 @@
 {
   "name": "confluence-cli",
-  "version": "1.11.1",
+  "version": "1.12.1",
   "description": "A command-line interface for Atlassian Confluence with page creation and editing capabilities",
   "main": "index.js",
   "bin": {
-    "confluence": "bin/index.js"
+    "confluence": "bin/index.js",
+    "confluence-cli": "bin/index.js"
   },
   "scripts": {
     "start": "node bin/confluence.js",

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();
     });
   });