confluence-cli 2.3.1 → 2.4.0

package/README.md

@@ -466,7 +466,14 @@ confluence export 123456789 --skip-attachments
 
 ### List Spaces
 ```bash
+# Default: up to 500 spaces (paginated automatically across requests)
 confluence spaces
+
+# Increase the cap when your tenant has more than 500 spaces
+confluence spaces --limit 2000
+
+# Fetch every space, regardless of how many pages it takes
+confluence spaces --all
 ```
 
 ### List Child Pages
@@ -691,7 +698,7 @@ confluence stats
 | `read <pageId_or_url>` | Read page content | `--format <html\|text\|storage\|markdown>` |
 | `info <pageId_or_url>` | Get page information | `--format <text\|json>` |
 | `search <query>` | Search for pages | `--limit <number>` |
-| `spaces` | List available spaces | `--limit <number>` |
+| `spaces` | List available spaces | `--limit <number>`, `--all` |
 | `find <title>` | Find a page by its title | `--space <spaceKey>` |
 | `children <pageId>` | List child pages of a page | `--recursive`, `--max-depth <number>`, `--format <list\|tree\|json>`, `--show-url`, `--show-id` |
 | `create <title> <spaceKey>` | Create a new page or folder | `--content <string>`, `--file <path>`, `--format <storage\|html\|markdown>`, `--type <page\|folder>` |

package/bin/confluence.js

@@ -154,15 +154,17 @@ program
 program
   .command('spaces')
   .description('List Confluence spaces')
-  .option('-l, --limit <limit>', 'Limit number of results', '500')
+  .option('-l, --limit <limit>', 'Maximum total spaces to return across paginated requests', '500')
+  .option('--all', 'Fetch every space, paginating through all results (overrides --limit)')
   .action(async (options) => {
     const analytics = new Analytics();
     try {
       const config = getConfig(getProfileName());
       const client = new ConfluenceClient(config);
-      const spaces = await client.getSpaces(parseInt(options.limit));
-      
-      console.log(chalk.blue('Available spaces:'));
+      const maxResults = options.all ? null : parseInt(options.limit);
+      const spaces = await client.getSpaces(maxResults);
+
+      console.log(chalk.blue(`Available spaces (${spaces.length}):`));
       spaces.forEach(space => {
         console.log(`${chalk.green(space.key)} - ${space.name}`);
       });

package/lib/confluence-client.js

@@ -437,20 +437,58 @@ class ConfluenceClient {
   }
 
   /**
-   * Get spaces
+   * List a single page of spaces with pagination metadata
    */
-  async getSpaces(limit = 500) {
+  async listSpaces(options = {}) {
+    const limit = this.parsePositiveInt(options.limit, 500);
+    const start = this.parsePositiveInt(options.start, 0);
+
     const response = await this.client.get('/space', {
-      params: {
-        limit
-      }
+      params: { limit, start }
     });
 
-    return response.data.results.map(space => ({
-      key: space.key,
-      name: space.name,
-      type: space.type
-    }));
+    const results = Array.isArray(response.data?.results)
+      ? response.data.results.map(space => ({
+        key: space.key,
+        name: space.name,
+        type: space.type
+      }))
+      : [];
+
+    return {
+      results,
+      nextStart: this.parseNextStart(response.data?._links?.next)
+    };
+  }
+
+  /**
+   * Get spaces, paginating through results until maxResults is reached or
+   * the server stops returning a `_links.next`. Pass `null` to fetch every space.
+   */
+  async getSpaces(maxResults = 500, options = {}) {
+    const cap = maxResults === null || maxResults === undefined
+      ? null
+      : this.parsePositiveInt(maxResults, 500);
+    const pageSize = this.parsePositiveInt(options.pageSize, 500);
+    let start = this.parsePositiveInt(options.start, 0);
+    const spaces = [];
+
+    let hasNext = true;
+    while (hasNext) {
+      if (cap !== null && spaces.length >= cap) break;
+      const requestLimit = cap === null
+        ? pageSize
+        : Math.min(pageSize, cap - spaces.length);
+      const page = await this.listSpaces({ limit: requestLimit, start });
+      spaces.push(...page.results);
+
+      hasNext = page.nextStart !== null && page.nextStart !== undefined;
+      if (hasNext) {
+        start = page.nextStart;
+      }
+    }
+
+    return cap !== null ? spaces.slice(0, cap) : spaces;
   }
 
   /**

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "confluence-cli",
-  "version": "2.3.1",
+  "version": "2.4.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "confluence-cli",
-      "version": "2.3.1",
+      "version": "2.4.0",
       "license": "MIT",
       "dependencies": {
         "axios": "^1.15.0",

package/package.json

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