confluence-cli 1.9.0 → 1.10.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [1.10.0](https://github.com/pchuri/confluence-cli/compare/v1.9.0...v1.10.0) (2025-12-05)
+
+
+### Features
+
+* export page with attachments ([#18](https://github.com/pchuri/confluence-cli/issues/18)) ([bdd9da4](https://github.com/pchuri/confluence-cli/commit/bdd9da474f13a8b6f96e64836443f65f846257a2))
+
 # [1.9.0](https://github.com/pchuri/confluence-cli/compare/v1.8.0...v1.9.0) (2025-12-04)
 
 

package/README.md

@@ -11,6 +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
 - 📎 **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
 - 🔧 **Easy setup** - Simple configuration with environment variables or interactive setup
 
@@ -120,6 +121,18 @@ confluence attachments 123456789 --pattern "*.png" --limit 5
 confluence attachments 123456789 --pattern "*.png" --download --dest ./downloads
 ```
 
+### Export a Page with Attachments
+```bash
+# Export page content (markdown by default) and all attachments
+confluence export 123456789 --dest ./exports
+
+# Custom content format/filename and attachment filtering
+confluence export 123456789 --format html --file content.html --pattern "*.png"
+
+# Skip attachments if you only need the content file
+confluence export 123456789 --skip-attachments
+```
+
 ### List Spaces
 ```bash
 confluence spaces

package/bin/confluence.js

@@ -421,6 +421,107 @@ program
     }
   });
 
+// Export page content with attachments
+program
+  .command('export <pageId>')
+  .description('Export a page to a directory with its attachments')
+  .option('--format <format>', 'Content format (html, text, markdown)', 'markdown')
+  .option('--dest <directory>', 'Base directory to export into', '.')
+  .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('--skip-attachments', 'Do not download attachments')
+  .action(async (pageId, options) => {
+    const analytics = new Analytics();
+    try {
+      const config = getConfig();
+      const client = new ConfluenceClient(config);
+      const fs = require('fs');
+      const path = require('path');
+
+      const format = (options.format || 'markdown').toLowerCase();
+      const formatExt = { markdown: 'md', html: 'html', text: 'txt' };
+      const contentExt = formatExt[format] || 'txt';
+
+      const pageInfo = await client.getPageInfo(pageId);
+      const content = await client.readPage(pageId, format);
+
+      const baseDir = path.resolve(options.dest || '.');
+      const folderName = sanitizeTitle(pageInfo.title || 'page');
+      const exportDir = path.join(baseDir, folderName);
+      fs.mkdirSync(exportDir, { recursive: true });
+
+      const contentFile = options.file || `page.${contentExt}`;
+      const contentPath = path.join(exportDir, contentFile);
+      fs.writeFileSync(contentPath, content);
+
+      console.log(chalk.green('✅ Page exported'));
+      console.log(`Title: ${chalk.blue(pageInfo.title)}`);
+      console.log(`Content: ${chalk.gray(contentPath)}`);
+
+      if (!options.skipAttachments) {
+        const pattern = options.pattern ? options.pattern.trim() : null;
+        const attachments = await client.getAllAttachments(pageId);
+        const filtered = pattern ? attachments.filter(att => client.matchesPattern(att.title, pattern)) : attachments;
+
+        if (filtered.length === 0) {
+          console.log(chalk.yellow('No attachments to download.'));
+        } else {
+          const attachmentsDirName = options.attachmentsDir || 'attachments';
+          const attachmentsDir = path.join(exportDir, attachmentsDirName);
+          fs.mkdirSync(attachmentsDir, { recursive: true });
+
+          const uniquePathFor = (dir, filename) => {
+            const parsed = path.parse(filename);
+            let attempt = path.join(dir, filename);
+            let counter = 1;
+            while (fs.existsSync(attempt)) {
+              const suffix = ` (${counter})`;
+              const nextName = `${parsed.name}${suffix}${parsed.ext}`;
+              attempt = path.join(dir, nextName);
+              counter += 1;
+            }
+            return attempt;
+          };
+
+          const writeStream = (stream, targetPath) => new Promise((resolve, reject) => {
+            const writer = fs.createWriteStream(targetPath);
+            stream.pipe(writer);
+            stream.on('error', reject);
+            writer.on('error', reject);
+            writer.on('finish', resolve);
+          });
+
+          let downloaded = 0;
+          for (const attachment of filtered) {
+            const targetPath = uniquePathFor(attachmentsDir, attachment.title);
+            const dataStream = await client.downloadAttachment(pageId, attachment.id);
+            await writeStream(dataStream, targetPath);
+            downloaded += 1;
+            console.log(`⬇️  ${chalk.green(attachment.title)} -> ${chalk.gray(targetPath)}`);
+          }
+
+          console.log(chalk.green(`Downloaded ${downloaded} attachment${downloaded === 1 ? '' : 's'} to ${attachmentsDir}`));
+        }
+      }
+
+      analytics.track('export', true);
+    } catch (error) {
+      analytics.track('export', false);
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+function sanitizeTitle(value) {
+  const fallback = 'page';
+  if (!value || typeof value !== 'string') {
+    return fallback;
+  }
+  const cleaned = value.replace(/[\\/:*?"<>|]/g, ' ').trim();
+  return cleaned || fallback;
+}
+
 // Copy page tree command
 program
   .command('copy-tree <sourcePageId> <targetParentId> [newTitle]')

package/package.json

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