@atlassian-dc-mcp/bitbucket 0.11.2 → 0.12.0

package/src/__tests__/bitbucket-service.test.ts

@@ -1507,6 +1507,131 @@ describe('BitbucketService', () => {
     });
   });
 
+  describe('getDashboardPullRequests', () => {
+    const { request: mockRequest } = require('../bitbucket-client/core/request.js');
+
+    it('should default to AUTHOR role and limit of 10', async () => {
+      const mockData = {
+        values: [
+          { id: 1, title: 'PR 1', state: 'OPEN' },
+          { id: 2, title: 'PR 2', state: 'OPEN' }
+        ],
+        size: 2,
+        isLastPage: true
+      };
+      mockRequest.mockResolvedValue(mockData);
+
+      const result = await bitbucketService.getDashboardPullRequests();
+
+      expect(result.success).toBe(true);
+      expect(result.data).toBe(mockData);
+      expect(mockRequest).toHaveBeenCalledWith(
+        expect.any(Object),
+        {
+          method: 'GET',
+          url: '/api/1.0/dashboard/pull-requests',
+          query: {
+            'role': 'AUTHOR',
+            'state': 'OPEN',
+            'closedSince': undefined,
+            'order': 'NEWEST',
+            'start': undefined,
+            'limit': 10,
+          },
+          errors: {
+            401: 'The currently authenticated user is not permitted to access the dashboard.',
+          },
+        }
+      );
+    });
+
+    it('should get dashboard PRs filtered by role and state', async () => {
+      const mockData = {
+        values: [{ id: 1, title: 'My PR', state: 'OPEN' }],
+        size: 1,
+        isLastPage: true
+      };
+      mockRequest.mockResolvedValue(mockData);
+
+      const result = await bitbucketService.getDashboardPullRequests(
+        'REVIEWER',
+        'OPEN',
+        undefined,
+        'NEWEST',
+        0,
+        5
+      );
+
+      expect(result.success).toBe(true);
+      expect(result.data).toBe(mockData);
+      expect(mockRequest).toHaveBeenCalledWith(
+        expect.any(Object),
+        {
+          method: 'GET',
+          url: '/api/1.0/dashboard/pull-requests',
+          query: {
+            'role': 'REVIEWER',
+            'state': 'OPEN',
+            'closedSince': undefined,
+            'order': 'NEWEST',
+            'start': 0,
+            'limit': 5,
+          },
+          errors: {
+            401: 'The currently authenticated user is not permitted to access the dashboard.',
+          },
+        }
+      );
+    });
+
+    it('should get dashboard PRs with closedSince filter', async () => {
+      const mockData = {
+        values: [{ id: 3, title: 'Merged PR', state: 'MERGED' }],
+        size: 1,
+        isLastPage: true
+      };
+      mockRequest.mockResolvedValue(mockData);
+
+      const closedSince = 1700000000000;
+      const result = await bitbucketService.getDashboardPullRequests(
+        'PARTICIPANT',
+        'MERGED',
+        closedSince
+      );
+
+      expect(result.success).toBe(true);
+      expect(result.data).toBe(mockData);
+      expect(mockRequest).toHaveBeenCalledWith(
+        expect.any(Object),
+        {
+          method: 'GET',
+          url: '/api/1.0/dashboard/pull-requests',
+          query: {
+            'role': 'PARTICIPANT',
+            'state': 'MERGED',
+            'closedSince': closedSince,
+            'order': 'NEWEST',
+            'start': undefined,
+            'limit': 10,
+          },
+          errors: {
+            401: 'The currently authenticated user is not permitted to access the dashboard.',
+          },
+        }
+      );
+    });
+
+    it('should handle API errors', async () => {
+      const mockError = new Error('Unauthorized');
+      mockRequest.mockRejectedValue(mockError);
+
+      const result = await bitbucketService.getDashboardPullRequests();
+
+      expect(result.success).toBe(false);
+      expect(result.error).toBe('Unauthorized');
+    });
+  });
+
   describe('getInboxPullRequests', () => {
     const { request: mockRequest } = require('../bitbucket-client/core/request.js');
 

package/src/bitbucket-service.ts

@@ -570,6 +570,44 @@ export class BitbucketService {
     );
   }
 
+  /**
+   * Get pull requests from the dashboard API (across all repositories)
+   * @param role Role filter: AUTHOR (default), REVIEWER, or PARTICIPANT
+   * @param state State filter: OPEN (default), DECLINED, or MERGED
+   * @param closedSince Optional timestamp (in milliseconds) to filter PRs closed after this date
+   * @param order Order: NEWEST (default), OLDEST, or PARTICIPANT
+   * @param start Optional pagination start
+   * @param limit Pagination limit (default: 10)
+   * @returns Promise with dashboard pull requests data
+   */
+  async getDashboardPullRequests(
+    role: string = 'AUTHOR',
+    state: string = 'OPEN',
+    closedSince?: number,
+    order: string = 'NEWEST',
+    start?: number,
+    limit: number = 10
+  ) {
+    return handleApiOperation(
+      () => __request(OpenAPI, {
+        method: 'GET',
+        url: '/api/1.0/dashboard/pull-requests',
+        query: {
+          'role': role,
+          'state': state,
+          'closedSince': closedSince,
+          'order': order,
+          'start': start,
+          'limit': limit,
+        },
+        errors: {
+          401: 'The currently authenticated user is not permitted to access the dashboard.',
+        },
+      }),
+      'Error fetching dashboard pull requests'
+    );
+  }
+
   /**
    * Get pull requests from the authenticated user's inbox (PRs awaiting review)
    * @param start Optional pagination start
@@ -741,6 +779,14 @@ export const bitbucketToolSchemas = {
     sourceRepoId: z.string().optional().describe("Optional ID of the repository in which the source ref exists"),
     targetRepoId: z.string().optional().describe("Optional ID of the repository in which the target ref exists")
   },
+  getDashboardPullRequests: {
+    role: z.enum(['AUTHOR', 'REVIEWER', 'PARTICIPANT']).optional().default('AUTHOR').describe("Filter by the user's role in the PR: AUTHOR (default), REVIEWER, or PARTICIPANT"),
+    state: z.enum(['OPEN', 'DECLINED', 'MERGED']).optional().default('OPEN').describe("Filter by PR state: OPEN (default), DECLINED, or MERGED"),
+    closedSince: z.number().optional().describe("Timestamp in milliseconds. If state is not OPEN, return only PRs closed after this date"),
+    order: z.enum(['NEWEST', 'OLDEST', 'PARTICIPANT']).optional().default('NEWEST').describe("Order of results: NEWEST (default), OLDEST, or PARTICIPANT"),
+    start: z.number().optional().describe("Start number for pagination"),
+    limit: z.number().optional().default(10).describe("Number of items to return (default: 10)")
+  },
   getInboxPullRequests: {
     start: z.number().optional().describe("Start number for the page (inclusive). If not passed, first page is assumed"),
     limit: z.number().optional().default(25).describe("Number of items to return. If not passed, a page size of 25 is used")

package/src/index.ts

@@ -193,4 +193,14 @@ server.tool(
   }
 );
 
+server.tool(
+  "bitbucket_getDashboardPullRequests",
+  "Get pull requests from the Bitbucket dashboard across all repositories. Useful for finding all PRs where you are the author, reviewer, or participant without specifying a project or repository.",
+  bitbucketToolSchemas.getDashboardPullRequests,
+  async ({ role, state, closedSince, order, start, limit }) => {
+    const result = await bitbucketService.getDashboardPullRequests(role, state, closedSince, order, start, limit);
+    return formatToolResponse(result);
+  }
+);
+
 await connectServer(server);