@lexmata/bitbucket-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Lexmata LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,281 @@
+# @lexmata/bitbucket-mcp
+
+[![npm version](https://img.shields.io/npm/v/@lexmata/bitbucket-mcp.svg)](https://www.npmjs.com/package/@lexmata/bitbucket-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue.svg)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-18%2B-green.svg)](https://nodejs.org/)
+[![GitHub stars](https://img.shields.io/github/stars/lexmata/bitbucket-mcp.svg?style=social)](https://github.com/lexmata/bitbucket-mcp)
+
+A Model Context Protocol (MCP) server for Bitbucket Cloud - 25+ tools for repositories, pull requests, branches, commits, issues, pipelines, and code search.
+
+## Features
+
+- **Full Bitbucket Cloud API Coverage**: Access repositories, pull requests, branches, commits, issues, pipelines, and code search
+- **OAuth 2.0 Authentication**: Secure authentication with automatic token refresh
+- **MCP Tools**: 25+ tools for interacting with Bitbucket
+- **MCP Resources**: Access repositories, pull requests, and files as resources
+- **TypeScript**: Fully typed for reliability and developer experience
+
+## Installation
+
+```bash
+# Using npm
+npm install -g @lexmata/bitbucket-mcp
+
+# Using pnpm
+pnpm add -g @lexmata/bitbucket-mcp
+
+# Using yarn
+yarn global add @lexmata/bitbucket-mcp
+```
+
+## Configuration
+
+### Option 1: Access Token (Recommended for personal use)
+
+1. Go to Bitbucket Settings > Personal Settings > App passwords
+2. Create a new app password with the required permissions:
+   - Account: Read
+   - Repositories: Read, Write, Admin
+   - Pull requests: Read, Write
+   - Issues: Read, Write
+   - Pipelines: Read, Write
+
+3. Set the environment variable:
+
+```bash
+export BITBUCKET_ACCESS_TOKEN="your-app-password"
+```
+
+### Option 2: OAuth 2.0 (Recommended for applications)
+
+1. Go to Bitbucket Settings > Workspace Settings > OAuth consumers
+2. Create a new OAuth consumer with:
+   - Callback URL: `http://localhost:8080/callback` (or your callback URL)
+   - Permissions: Select required scopes
+
+3. Set the environment variables:
+
+```bash
+export BITBUCKET_CLIENT_ID="your-client-id"
+export BITBUCKET_CLIENT_SECRET="your-client-secret"
+```
+
+## Usage with Claude Desktop
+
+Add the following to your Claude Desktop configuration file:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+**Linux**: `~/.config/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "bitbucket": {
+      "command": "npx",
+      "args": ["@lexmata/bitbucket-mcp"],
+      "env": {
+        "BITBUCKET_ACCESS_TOKEN": "your-access-token"
+      }
+    }
+  }
+}
+```
+
+Or if installed globally:
+
+```json
+{
+  "mcpServers": {
+    "bitbucket": {
+      "command": "bitbucket-mcp",
+      "env": {
+        "BITBUCKET_ACCESS_TOKEN": "your-access-token"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+### Repository Management
+
+| Tool                    | Description                          |
+| ----------------------- | ------------------------------------ |
+| `list_repositories`     | List repositories in a workspace     |
+| `get_repository`        | Get details of a specific repository |
+| `create_repository`     | Create a new repository              |
+| `delete_repository`     | Delete a repository                  |
+| `list_repository_forks` | List all forks of a repository       |
+
+### Pull Requests
+
+| Tool                   | Description                                |
+| ---------------------- | ------------------------------------------ |
+| `list_pull_requests`   | List pull requests with optional filtering |
+| `get_pull_request`     | Get details of a specific pull request     |
+| `create_pull_request`  | Create a new pull request                  |
+| `update_pull_request`  | Update a pull request                      |
+| `merge_pull_request`   | Merge a pull request                       |
+| `decline_pull_request` | Decline a pull request                     |
+| `approve_pull_request` | Approve a pull request                     |
+| `request_changes`      | Request changes on a pull request          |
+| `list_pr_comments`     | List comments on a pull request            |
+| `add_pr_comment`       | Add a comment to a pull request            |
+| `get_pr_diff`          | Get the diff for a pull request            |
+
+### Branches
+
+| Tool            | Description                      |
+| --------------- | -------------------------------- |
+| `list_branches` | List branches in a repository    |
+| `get_branch`    | Get details of a specific branch |
+| `create_branch` | Create a new branch              |
+| `delete_branch` | Delete a branch                  |
+
+### Commits
+
+| Tool              | Description                          |
+| ----------------- | ------------------------------------ |
+| `list_commits`    | List commits with optional filtering |
+| `get_commit`      | Get details of a specific commit     |
+| `get_commit_diff` | Get the diff for a commit            |
+
+### Issues
+
+| Tool           | Description                     |
+| -------------- | ------------------------------- |
+| `list_issues`  | List issues in a repository     |
+| `get_issue`    | Get details of a specific issue |
+| `create_issue` | Create a new issue              |
+| `update_issue` | Update an issue                 |
+| `delete_issue` | Delete an issue                 |
+
+### Pipelines
+
+| Tool               | Description                   |
+| ------------------ | ----------------------------- |
+| `list_pipelines`   | List pipeline runs            |
+| `get_pipeline`     | Get details of a pipeline run |
+| `trigger_pipeline` | Trigger a new pipeline run    |
+| `stop_pipeline`    | Stop a running pipeline       |
+
+### Code Search
+
+| Tool          | Description                     |
+| ------------- | ------------------------------- |
+| `search_code` | Search code across repositories |
+
+### Files
+
+| Tool               | Description               |
+| ------------------ | ------------------------- |
+| `get_file_content` | Get the content of a file |
+
+## Resources
+
+The server provides the following resource types:
+
+| Resource URI                                      | Description            |
+| ------------------------------------------------- | ---------------------- |
+| `bitbucket://repository/{workspace}/{repo}`       | Repository information |
+| `bitbucket://pullrequest/{workspace}/{repo}/{id}` | Pull request details   |
+| `bitbucket://file/{workspace}/{repo}/{path}`      | File contents          |
+
+## Examples
+
+### List repositories in a workspace
+
+```
+Use the list_repositories tool with workspace "my-workspace"
+```
+
+### Create a pull request
+
+```
+Use the create_pull_request tool with:
+- workspace: "my-workspace"
+- repo_slug: "my-repo"
+- title: "Add new feature"
+- source_branch: "feature/new-feature"
+- destination_branch: "main"
+- description: "This PR adds a new feature"
+```
+
+### Search for code
+
+```
+Use the search_code tool with:
+- workspace: "my-workspace"
+- search_query: "function handleError"
+```
+
+### Trigger a pipeline
+
+```
+Use the trigger_pipeline tool with:
+- workspace: "my-workspace"
+- repo_slug: "my-repo"
+- ref_type: "branch"
+- ref_name: "main"
+```
+
+## Development
+
+### Prerequisites
+
+- Node.js 18+
+- pnpm 9+
+
+### Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/lexmata/bitbucket-mcp.git
+cd bitbucket-mcp
+
+# Install dependencies
+pnpm install
+
+# Build
+pnpm build
+
+# Run in development mode
+pnpm dev
+```
+
+### Scripts
+
+| Script              | Description                  |
+| ------------------- | ---------------------------- |
+| `pnpm build`        | Build the project with SWC   |
+| `pnpm dev`          | Run in development mode      |
+| `pnpm start`        | Run the built server         |
+| `pnpm typecheck`    | Run TypeScript type checking |
+| `pnpm lint`         | Run ESLint                   |
+| `pnpm lint:fix`     | Fix ESLint issues            |
+| `pnpm format`       | Format code with Prettier    |
+| `pnpm format:check` | Check code formatting        |
+
+## License
+
+MIT License - Copyright (c) 2025 Lexmata LLC
+
+See [LICENSE](LICENSE) for details.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## Support
+
+- [Documentation](https://lexmata.github.io/bitbucket-mcp)
+- [Issues](https://github.com/lexmata/bitbucket-mcp/issues)

package/dist/api/branches.js

@@ -0,0 +1,27 @@
+export class BranchesAPI {
+    client;
+    constructor(client){
+        this.client = client;
+    }
+    async list(params) {
+        const { workspace, repo_slug, ...queryParams } = params;
+        return this.client.get(`/repositories/${workspace}/${repo_slug}/refs/branches`, queryParams);
+    }
+    async get(workspace, repo_slug, branch_name) {
+        return this.client.get(`/repositories/${workspace}/${repo_slug}/refs/branches/${encodeURIComponent(branch_name)}`);
+    }
+    async create(params) {
+        const { workspace, repo_slug, name, target } = params;
+        return this.client.post(`/repositories/${workspace}/${repo_slug}/refs/branches`, {
+            name,
+            target: {
+                hash: target
+            }
+        });
+    }
+    async delete(workspace, repo_slug, branch_name) {
+        await this.client.delete(`/repositories/${workspace}/${repo_slug}/refs/branches/${encodeURIComponent(branch_name)}`);
+    }
+}
+
+//# sourceMappingURL=branches.js.map

package/dist/api/branches.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/branches.ts"],"sourcesContent":["import type { BitbucketClient } from './client.js';\nimport type {\n  BitbucketBranch,\n  PaginatedResponse,\n  ListBranchesParams,\n  CreateBranchParams,\n} from '../types/index.js';\n\nexport class BranchesAPI {\n  constructor(private client: BitbucketClient) {}\n\n  /**\n   * List branches for a repository\n   */\n  async list(params: ListBranchesParams): Promise<PaginatedResponse<BitbucketBranch>> {\n    const { workspace, repo_slug, ...queryParams } = params;\n    return this.client.get<PaginatedResponse<BitbucketBranch>>(\n      `/repositories/${workspace}/${repo_slug}/refs/branches`,\n      queryParams as Record<string, string | number | undefined>\n    );\n  }\n\n  /**\n   * Get a specific branch\n   */\n  async get(workspace: string, repo_slug: string, branch_name: string): Promise<BitbucketBranch> {\n    return this.client.get<BitbucketBranch>(\n      `/repositories/${workspace}/${repo_slug}/refs/branches/${encodeURIComponent(branch_name)}`\n    );\n  }\n\n  /**\n   * Create a new branch\n   */\n  async create(params: CreateBranchParams): Promise<BitbucketBranch> {\n    const { workspace, repo_slug, name, target } = params;\n    return this.client.post<BitbucketBranch>(\n      `/repositories/${workspace}/${repo_slug}/refs/branches`,\n      {\n        name,\n        target: { hash: target },\n      }\n    );\n  }\n\n  /**\n   * Delete a branch\n   */\n  async delete(workspace: string, repo_slug: string, branch_name: string): Promise<void> {\n    await this.client.delete(\n      `/repositories/${workspace}/${repo_slug}/refs/branches/${encodeURIComponent(branch_name)}`\n    );\n  }\n}\n"],"names":["BranchesAPI","client","list","params","workspace","repo_slug","queryParams","get","branch_name","encodeURIComponent","create","name","target","post","hash","delete"],"mappings":"AAQA,OAAO,MAAMA;;IACX,YAAY,AAAQC,MAAuB,CAAE;aAAzBA,SAAAA;IAA0B;IAK9C,MAAMC,KAAKC,MAA0B,EAA+C;QAClF,MAAM,EAAEC,SAAS,EAAEC,SAAS,EAAE,GAAGC,aAAa,GAAGH;QACjD,OAAO,IAAI,CAACF,MAAM,CAACM,GAAG,CACpB,CAAC,cAAc,EAAEH,UAAU,CAAC,EAAEC,UAAU,cAAc,CAAC,EACvDC;IAEJ;IAKA,MAAMC,IAAIH,SAAiB,EAAEC,SAAiB,EAAEG,WAAmB,EAA4B;QAC7F,OAAO,IAAI,CAACP,MAAM,CAACM,GAAG,CACpB,CAAC,cAAc,EAAEH,UAAU,CAAC,EAAEC,UAAU,eAAe,EAAEI,mBAAmBD,cAAc;IAE9F;IAKA,MAAME,OAAOP,MAA0B,EAA4B;QACjE,MAAM,EAAEC,SAAS,EAAEC,SAAS,EAAEM,IAAI,EAAEC,MAAM,EAAE,GAAGT;QAC/C,OAAO,IAAI,CAACF,MAAM,CAACY,IAAI,CACrB,CAAC,cAAc,EAAET,UAAU,CAAC,EAAEC,UAAU,cAAc,CAAC,EACvD;YACEM;YACAC,QAAQ;gBAAEE,MAAMF;YAAO;QACzB;IAEJ;IAKA,MAAMG,OAAOX,SAAiB,EAAEC,SAAiB,EAAEG,WAAmB,EAAiB;QACrF,MAAM,IAAI,CAACP,MAAM,CAACc,MAAM,CACtB,CAAC,cAAc,EAAEX,UAAU,CAAC,EAAEC,UAAU,eAAe,EAAEI,mBAAmBD,cAAc;IAE9F;AACF"}

package/dist/api/client.js

@@ -0,0 +1,88 @@
+const BITBUCKET_API_URL = 'https://api.bitbucket.org/2.0';
+export class BitbucketClient {
+    oauth;
+    baseUrl;
+    constructor(oauth, baseUrl = BITBUCKET_API_URL){
+        this.oauth = oauth;
+        this.baseUrl = baseUrl;
+    }
+    async request(endpoint, options = {}) {
+        const token = await this.oauth.getAccessToken();
+        const url = endpoint.startsWith('http') ? endpoint : `${this.baseUrl}${endpoint}`;
+        const response = await fetch(url, {
+            ...options,
+            headers: {
+                Authorization: `Bearer ${token}`,
+                'Content-Type': 'application/json',
+                Accept: 'application/json',
+                ...options.headers
+            }
+        });
+        if (!response.ok) {
+            const errorBody = await response.text();
+            let errorMessage;
+            try {
+                const errorJson = JSON.parse(errorBody);
+                errorMessage = errorJson.error?.message ?? errorBody;
+            } catch  {
+                errorMessage = errorBody;
+            }
+            throw new Error(`Bitbucket API error (${response.status}): ${errorMessage}`);
+        }
+        if (response.status === 204) {
+            return {};
+        }
+        return response.json();
+    }
+    async get(endpoint, params) {
+        let url = endpoint;
+        if (params) {
+            const searchParams = new URLSearchParams();
+            for (const [key, value] of Object.entries(params)){
+                if (value !== undefined) {
+                    searchParams.set(key, String(value));
+                }
+            }
+            const queryString = searchParams.toString();
+            if (queryString) {
+                url = `${endpoint}?${queryString}`;
+            }
+        }
+        return this.request(url, {
+            method: 'GET'
+        });
+    }
+    async post(endpoint, body) {
+        return this.request(endpoint, {
+            method: 'POST',
+            body: body ? JSON.stringify(body) : undefined
+        });
+    }
+    async put(endpoint, body) {
+        return this.request(endpoint, {
+            method: 'PUT',
+            body: body ? JSON.stringify(body) : undefined
+        });
+    }
+    async delete(endpoint) {
+        return this.request(endpoint, {
+            method: 'DELETE'
+        });
+    }
+    async getRaw(endpoint) {
+        const token = await this.oauth.getAccessToken();
+        const url = endpoint.startsWith('http') ? endpoint : `${this.baseUrl}${endpoint}`;
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: {
+                Authorization: `Bearer ${token}`
+            }
+        });
+        if (!response.ok) {
+            throw new Error(`Bitbucket API error (${response.status}): ${await response.text()}`);
+        }
+        return response.text();
+    }
+}
+
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/client.ts"],"sourcesContent":["import { BitbucketOAuth } from '../auth/oauth.js';\nimport type { BitbucketError } from '../types/index.js';\n\nconst BITBUCKET_API_URL = 'https://api.bitbucket.org/2.0';\n\nexport class BitbucketClient {\n  private oauth: BitbucketOAuth;\n  private baseUrl: string;\n\n  constructor(oauth: BitbucketOAuth, baseUrl: string = BITBUCKET_API_URL) {\n    this.oauth = oauth;\n    this.baseUrl = baseUrl;\n  }\n\n  /**\n   * Make an authenticated request to the Bitbucket API\n   */\n  async request<T>(endpoint: string, options: RequestInit = {}): Promise<T> {\n    const token = await this.oauth.getAccessToken();\n\n    const url = endpoint.startsWith('http') ? endpoint : `${this.baseUrl}${endpoint}`;\n\n    const response = await fetch(url, {\n      ...options,\n      headers: {\n        Authorization: `Bearer ${token}`,\n        'Content-Type': 'application/json',\n        Accept: 'application/json',\n        ...options.headers,\n      },\n    });\n\n    if (!response.ok) {\n      const errorBody = await response.text();\n      let errorMessage: string;\n\n      try {\n        const errorJson = JSON.parse(errorBody) as BitbucketError;\n        errorMessage = errorJson.error?.message ?? errorBody;\n      } catch {\n        errorMessage = errorBody;\n      }\n\n      throw new Error(`Bitbucket API error (${response.status}): ${errorMessage}`);\n    }\n\n    // Handle 204 No Content\n    if (response.status === 204) {\n      return {} as T;\n    }\n\n    return response.json() as Promise<T>;\n  }\n\n  /**\n   * GET request\n   */\n  async get<T>(endpoint: string, params?: Record<string, string | number | undefined>): Promise<T> {\n    let url = endpoint;\n\n    if (params) {\n      const searchParams = new URLSearchParams();\n      for (const [key, value] of Object.entries(params)) {\n        if (value !== undefined) {\n          searchParams.set(key, String(value));\n        }\n      }\n      const queryString = searchParams.toString();\n      if (queryString) {\n        url = `${endpoint}?${queryString}`;\n      }\n    }\n\n    return this.request<T>(url, { method: 'GET' });\n  }\n\n  /**\n   * POST request\n   */\n  async post<T>(endpoint: string, body?: unknown): Promise<T> {\n    return this.request<T>(endpoint, {\n      method: 'POST',\n      body: body ? JSON.stringify(body) : undefined,\n    });\n  }\n\n  /**\n   * PUT request\n   */\n  async put<T>(endpoint: string, body?: unknown): Promise<T> {\n    return this.request<T>(endpoint, {\n      method: 'PUT',\n      body: body ? JSON.stringify(body) : undefined,\n    });\n  }\n\n  /**\n   * DELETE request\n   */\n  async delete<T>(endpoint: string): Promise<T> {\n    return this.request<T>(endpoint, { method: 'DELETE' });\n  }\n\n  /**\n   * Get raw file content\n   */\n  async getRaw(endpoint: string): Promise<string> {\n    const token = await this.oauth.getAccessToken();\n    const url = endpoint.startsWith('http') ? endpoint : `${this.baseUrl}${endpoint}`;\n\n    const response = await fetch(url, {\n      method: 'GET',\n      headers: {\n        Authorization: `Bearer ${token}`,\n      },\n    });\n\n    if (!response.ok) {\n      throw new Error(`Bitbucket API error (${response.status}): ${await response.text()}`);\n    }\n\n    return response.text();\n  }\n}\n"],"names":["BITBUCKET_API_URL","BitbucketClient","oauth","baseUrl","request","endpoint","options","token","getAccessToken","url","startsWith","response","fetch","headers","Authorization","Accept","ok","errorBody","text","errorMessage","errorJson","JSON","parse","error","message","Error","status","json","get","params","searchParams","URLSearchParams","key","value","Object","entries","undefined","set","String","queryString","toString","method","post","body","stringify","put","delete","getRaw"],"mappings":"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"}

package/dist/api/commits.js

@@ -0,0 +1,32 @@
+export class CommitsAPI {
+    client;
+    constructor(client){
+        this.client = client;
+    }
+    async list(params) {
+        const { workspace, repo_slug, branch, include, exclude, ...queryParams } = params;
+        const allParams = {
+            ...queryParams
+        };
+        if (branch) {
+            allParams.include = branch;
+        } else if (include) {
+            allParams.include = include;
+        }
+        if (exclude) {
+            allParams.exclude = exclude;
+        }
+        return this.client.get(`/repositories/${workspace}/${repo_slug}/commits`, allParams);
+    }
+    async get(workspace, repo_slug, commit_hash) {
+        return this.client.get(`/repositories/${workspace}/${repo_slug}/commit/${commit_hash}`);
+    }
+    async getDiff(workspace, repo_slug, commit_hash) {
+        return this.client.getRaw(`/repositories/${workspace}/${repo_slug}/diff/${commit_hash}`);
+    }
+    async listForPullRequest(workspace, repo_slug, pr_id, params) {
+        return this.client.get(`/repositories/${workspace}/${repo_slug}/pullrequests/${pr_id}/commits`, params);
+    }
+}
+
+//# sourceMappingURL=commits.js.map

package/dist/api/commits.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/commits.ts"],"sourcesContent":["import type { BitbucketClient } from './client.js';\nimport type { BitbucketCommit, PaginatedResponse, ListCommitsParams } from '../types/index.js';\n\nexport class CommitsAPI {\n  constructor(private client: BitbucketClient) {}\n\n  /**\n   * List commits for a repository\n   */\n  async list(params: ListCommitsParams): Promise<PaginatedResponse<BitbucketCommit>> {\n    const { workspace, repo_slug, branch, include, exclude, ...queryParams } = params;\n\n    // Build query params\n    const allParams: Record<string, string | number | undefined> = {\n      ...queryParams,\n    };\n\n    // For branch filtering, use the include parameter\n    if (branch) {\n      allParams.include = branch;\n    } else if (include) {\n      allParams.include = include;\n    }\n\n    if (exclude) {\n      allParams.exclude = exclude;\n    }\n\n    return this.client.get<PaginatedResponse<BitbucketCommit>>(\n      `/repositories/${workspace}/${repo_slug}/commits`,\n      allParams\n    );\n  }\n\n  /**\n   * Get a specific commit\n   */\n  async get(workspace: string, repo_slug: string, commit_hash: string): Promise<BitbucketCommit> {\n    return this.client.get<BitbucketCommit>(\n      `/repositories/${workspace}/${repo_slug}/commit/${commit_hash}`\n    );\n  }\n\n  /**\n   * Get diff for a specific commit\n   */\n  async getDiff(workspace: string, repo_slug: string, commit_hash: string): Promise<string> {\n    return this.client.getRaw(`/repositories/${workspace}/${repo_slug}/diff/${commit_hash}`);\n  }\n\n  /**\n   * Get commits for a pull request\n   */\n  async listForPullRequest(\n    workspace: string,\n    repo_slug: string,\n    pr_id: number,\n    params?: { page?: number; pagelen?: number }\n  ): Promise<PaginatedResponse<BitbucketCommit>> {\n    return this.client.get<PaginatedResponse<BitbucketCommit>>(\n      `/repositories/${workspace}/${repo_slug}/pullrequests/${pr_id}/commits`,\n      params as Record<string, string | number | undefined>\n    );\n  }\n}\n"],"names":["CommitsAPI","client","list","params","workspace","repo_slug","branch","include","exclude","queryParams","allParams","get","commit_hash","getDiff","getRaw","listForPullRequest","pr_id"],"mappings":"AAGA,OAAO,MAAMA;;IACX,YAAY,AAAQC,MAAuB,CAAE;aAAzBA,SAAAA;IAA0B;IAK9C,MAAMC,KAAKC,MAAyB,EAA+C;QACjF,MAAM,EAAEC,SAAS,EAAEC,SAAS,EAAEC,MAAM,EAAEC,OAAO,EAAEC,OAAO,EAAE,GAAGC,aAAa,GAAGN;QAG3E,MAAMO,YAAyD;YAC7D,GAAGD,WAAW;QAChB;QAGA,IAAIH,QAAQ;YACVI,UAAUH,OAAO,GAAGD;QACtB,OAAO,IAAIC,SAAS;YAClBG,UAAUH,OAAO,GAAGA;QACtB;QAEA,IAAIC,SAAS;YACXE,UAAUF,OAAO,GAAGA;QACtB;QAEA,OAAO,IAAI,CAACP,MAAM,CAACU,GAAG,CACpB,CAAC,cAAc,EAAEP,UAAU,CAAC,EAAEC,UAAU,QAAQ,CAAC,EACjDK;IAEJ;IAKA,MAAMC,IAAIP,SAAiB,EAAEC,SAAiB,EAAEO,WAAmB,EAA4B;QAC7F,OAAO,IAAI,CAACX,MAAM,CAACU,GAAG,CACpB,CAAC,cAAc,EAAEP,UAAU,CAAC,EAAEC,UAAU,QAAQ,EAAEO,aAAa;IAEnE;IAKA,MAAMC,QAAQT,SAAiB,EAAEC,SAAiB,EAAEO,WAAmB,EAAmB;QACxF,OAAO,IAAI,CAACX,MAAM,CAACa,MAAM,CAAC,CAAC,cAAc,EAAEV,UAAU,CAAC,EAAEC,UAAU,MAAM,EAAEO,aAAa;IACzF;IAKA,MAAMG,mBACJX,SAAiB,EACjBC,SAAiB,EACjBW,KAAa,EACbb,MAA4C,EACC;QAC7C,OAAO,IAAI,CAACF,MAAM,CAACU,GAAG,CACpB,CAAC,cAAc,EAAEP,UAAU,CAAC,EAAEC,UAAU,cAAc,EAAEW,MAAM,QAAQ,CAAC,EACvEb;IAEJ;AACF"}

package/dist/api/issues.js

@@ -0,0 +1,51 @@
+export class IssuesAPI {
+    client;
+    constructor(client){
+        this.client = client;
+    }
+    async list(params) {
+        const { workspace, repo_slug, ...queryParams } = params;
+        return this.client.get(`/repositories/${workspace}/${repo_slug}/issues`, queryParams);
+    }
+    async get(workspace, repo_slug, issue_id) {
+        return this.client.get(`/repositories/${workspace}/${repo_slug}/issues/${issue_id}`);
+    }
+    async create(params) {
+        const { workspace, repo_slug, title, content, kind, priority, assignee } = params;
+        const body = {
+            title
+        };
+        if (content) {
+            body.content = {
+                raw: content
+            };
+        }
+        if (kind) body.kind = kind;
+        if (priority) body.priority = priority;
+        if (assignee) {
+            body.assignee = {
+                uuid: assignee
+            };
+        }
+        return this.client.post(`/repositories/${workspace}/${repo_slug}/issues`, body);
+    }
+    async update(workspace, repo_slug, issue_id, updates) {
+        const body = {};
+        if (updates.title) body.title = updates.title;
+        if (updates.content) body.content = {
+            raw: updates.content
+        };
+        if (updates.state) body.state = updates.state;
+        if (updates.kind) body.kind = updates.kind;
+        if (updates.priority) body.priority = updates.priority;
+        if (updates.assignee) body.assignee = {
+            uuid: updates.assignee
+        };
+        return this.client.put(`/repositories/${workspace}/${repo_slug}/issues/${issue_id}`, body);
+    }
+    async delete(workspace, repo_slug, issue_id) {
+        await this.client.delete(`/repositories/${workspace}/${repo_slug}/issues/${issue_id}`);
+    }
+}
+
+//# sourceMappingURL=issues.js.map

package/dist/api/issues.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/issues.ts"],"sourcesContent":["import type { BitbucketClient } from './client.js';\nimport type {\n  BitbucketIssue,\n  PaginatedResponse,\n  ListIssuesParams,\n  CreateIssueParams,\n} from '../types/index.js';\n\nexport class IssuesAPI {\n  constructor(private client: BitbucketClient) {}\n\n  /**\n   * List issues for a repository\n   */\n  async list(params: ListIssuesParams): Promise<PaginatedResponse<BitbucketIssue>> {\n    const { workspace, repo_slug, ...queryParams } = params;\n    return this.client.get<PaginatedResponse<BitbucketIssue>>(\n      `/repositories/${workspace}/${repo_slug}/issues`,\n      queryParams as Record<string, string | number | undefined>\n    );\n  }\n\n  /**\n   * Get a specific issue\n   */\n  async get(workspace: string, repo_slug: string, issue_id: number): Promise<BitbucketIssue> {\n    return this.client.get<BitbucketIssue>(\n      `/repositories/${workspace}/${repo_slug}/issues/${issue_id}`\n    );\n  }\n\n  /**\n   * Create a new issue\n   */\n  async create(params: CreateIssueParams): Promise<BitbucketIssue> {\n    const { workspace, repo_slug, title, content, kind, priority, assignee } = params;\n\n    const body: Record<string, unknown> = {\n      title,\n    };\n\n    if (content) {\n      body.content = { raw: content };\n    }\n\n    if (kind) body.kind = kind;\n    if (priority) body.priority = priority;\n    if (assignee) {\n      body.assignee = { uuid: assignee };\n    }\n\n    return this.client.post<BitbucketIssue>(`/repositories/${workspace}/${repo_slug}/issues`, body);\n  }\n\n  /**\n   * Update an issue\n   */\n  async update(\n    workspace: string,\n    repo_slug: string,\n    issue_id: number,\n    updates: {\n      title?: string;\n      content?: string;\n      state?: BitbucketIssue['state'];\n      kind?: BitbucketIssue['kind'];\n      priority?: BitbucketIssue['priority'];\n      assignee?: string;\n    }\n  ): Promise<BitbucketIssue> {\n    const body: Record<string, unknown> = {};\n\n    if (updates.title) body.title = updates.title;\n    if (updates.content) body.content = { raw: updates.content };\n    if (updates.state) body.state = updates.state;\n    if (updates.kind) body.kind = updates.kind;\n    if (updates.priority) body.priority = updates.priority;\n    if (updates.assignee) body.assignee = { uuid: updates.assignee };\n\n    return this.client.put<BitbucketIssue>(\n      `/repositories/${workspace}/${repo_slug}/issues/${issue_id}`,\n      body\n    );\n  }\n\n  /**\n   * Delete an issue\n   */\n  async delete(workspace: string, repo_slug: string, issue_id: number): Promise<void> {\n    await this.client.delete(`/repositories/${workspace}/${repo_slug}/issues/${issue_id}`);\n  }\n}\n"],"names":["IssuesAPI","client","list","params","workspace","repo_slug","queryParams","get","issue_id","create","title","content","kind","priority","assignee","body","raw","uuid","post","update","updates","state","put","delete"],"mappings":"AAQA,OAAO,MAAMA;;IACX,YAAY,AAAQC,MAAuB,CAAE;aAAzBA,SAAAA;IAA0B;IAK9C,MAAMC,KAAKC,MAAwB,EAA8C;QAC/E,MAAM,EAAEC,SAAS,EAAEC,SAAS,EAAE,GAAGC,aAAa,GAAGH;QACjD,OAAO,IAAI,CAACF,MAAM,CAACM,GAAG,CACpB,CAAC,cAAc,EAAEH,UAAU,CAAC,EAAEC,UAAU,OAAO,CAAC,EAChDC;IAEJ;IAKA,MAAMC,IAAIH,SAAiB,EAAEC,SAAiB,EAAEG,QAAgB,EAA2B;QACzF,OAAO,IAAI,CAACP,MAAM,CAACM,GAAG,CACpB,CAAC,cAAc,EAAEH,UAAU,CAAC,EAAEC,UAAU,QAAQ,EAAEG,UAAU;IAEhE;IAKA,MAAMC,OAAON,MAAyB,EAA2B;QAC/D,MAAM,EAAEC,SAAS,EAAEC,SAAS,EAAEK,KAAK,EAAEC,OAAO,EAAEC,IAAI,EAAEC,QAAQ,EAAEC,QAAQ,EAAE,GAAGX;QAE3E,MAAMY,OAAgC;YACpCL;QACF;QAEA,IAAIC,SAAS;YACXI,KAAKJ,OAAO,GAAG;gBAAEK,KAAKL;YAAQ;QAChC;QAEA,IAAIC,MAAMG,KAAKH,IAAI,GAAGA;QACtB,IAAIC,UAAUE,KAAKF,QAAQ,GAAGA;QAC9B,IAAIC,UAAU;YACZC,KAAKD,QAAQ,GAAG;gBAAEG,MAAMH;YAAS;QACnC;QAEA,OAAO,IAAI,CAACb,MAAM,CAACiB,IAAI,CAAiB,CAAC,cAAc,EAAEd,UAAU,CAAC,EAAEC,UAAU,OAAO,CAAC,EAAEU;IAC5F;IAKA,MAAMI,OACJf,SAAiB,EACjBC,SAAiB,EACjBG,QAAgB,EAChBY,OAOC,EACwB;QACzB,MAAML,OAAgC,CAAC;QAEvC,IAAIK,QAAQV,KAAK,EAAEK,KAAKL,KAAK,GAAGU,QAAQV,KAAK;QAC7C,IAAIU,QAAQT,OAAO,EAAEI,KAAKJ,OAAO,GAAG;YAAEK,KAAKI,QAAQT,OAAO;QAAC;QAC3D,IAAIS,QAAQC,KAAK,EAAEN,KAAKM,KAAK,GAAGD,QAAQC,KAAK;QAC7C,IAAID,QAAQR,IAAI,EAAEG,KAAKH,IAAI,GAAGQ,QAAQR,IAAI;QAC1C,IAAIQ,QAAQP,QAAQ,EAAEE,KAAKF,QAAQ,GAAGO,QAAQP,QAAQ;QACtD,IAAIO,QAAQN,QAAQ,EAAEC,KAAKD,QAAQ,GAAG;YAAEG,MAAMG,QAAQN,QAAQ;QAAC;QAE/D,OAAO,IAAI,CAACb,MAAM,CAACqB,GAAG,CACpB,CAAC,cAAc,EAAElB,UAAU,CAAC,EAAEC,UAAU,QAAQ,EAAEG,UAAU,EAC5DO;IAEJ;IAKA,MAAMQ,OAAOnB,SAAiB,EAAEC,SAAiB,EAAEG,QAAgB,EAAiB;QAClF,MAAM,IAAI,CAACP,MAAM,CAACsB,MAAM,CAAC,CAAC,cAAc,EAAEnB,UAAU,CAAC,EAAEC,UAAU,QAAQ,EAAEG,UAAU;IACvF;AACF"}

package/dist/api/pipelines.js

@@ -0,0 +1,34 @@
+export class PipelinesAPI {
+    client;
+    constructor(client){
+        this.client = client;
+    }
+    async list(params) {
+        const { workspace, repo_slug, ...queryParams } = params;
+        return this.client.get(`/repositories/${workspace}/${repo_slug}/pipelines`, queryParams);
+    }
+    async get(workspace, repo_slug, pipeline_uuid) {
+        return this.client.get(`/repositories/${workspace}/${repo_slug}/pipelines/${pipeline_uuid}`);
+    }
+    async trigger(params) {
+        const { workspace, repo_slug, target, variables } = params;
+        const body = {
+            target
+        };
+        if (variables && variables.length > 0) {
+            body.variables = variables;
+        }
+        return this.client.post(`/repositories/${workspace}/${repo_slug}/pipelines`, body);
+    }
+    async stop(workspace, repo_slug, pipeline_uuid) {
+        await this.client.post(`/repositories/${workspace}/${repo_slug}/pipelines/${pipeline_uuid}/stopPipeline`);
+    }
+    async getSteps(workspace, repo_slug, pipeline_uuid) {
+        return this.client.get(`/repositories/${workspace}/${repo_slug}/pipelines/${pipeline_uuid}/steps`);
+    }
+    async getStepLog(workspace, repo_slug, pipeline_uuid, step_uuid) {
+        return this.client.getRaw(`/repositories/${workspace}/${repo_slug}/pipelines/${pipeline_uuid}/steps/${step_uuid}/log`);
+    }
+}
+
+//# sourceMappingURL=pipelines.js.map

package/dist/api/pipelines.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/pipelines.ts"],"sourcesContent":["import type { BitbucketClient } from './client.js';\nimport type {\n  BitbucketPipeline,\n  PaginatedResponse,\n  ListPipelinesParams,\n  TriggerPipelineParams,\n} from '../types/index.js';\n\nexport class PipelinesAPI {\n  constructor(private client: BitbucketClient) {}\n\n  /**\n   * List pipelines for a repository\n   */\n  async list(params: ListPipelinesParams): Promise<PaginatedResponse<BitbucketPipeline>> {\n    const { workspace, repo_slug, ...queryParams } = params;\n    return this.client.get<PaginatedResponse<BitbucketPipeline>>(\n      `/repositories/${workspace}/${repo_slug}/pipelines`,\n      queryParams as Record<string, string | number | undefined>\n    );\n  }\n\n  /**\n   * Get a specific pipeline\n   */\n  async get(\n    workspace: string,\n    repo_slug: string,\n    pipeline_uuid: string\n  ): Promise<BitbucketPipeline> {\n    return this.client.get<BitbucketPipeline>(\n      `/repositories/${workspace}/${repo_slug}/pipelines/${pipeline_uuid}`\n    );\n  }\n\n  /**\n   * Trigger a new pipeline\n   */\n  async trigger(params: TriggerPipelineParams): Promise<BitbucketPipeline> {\n    const { workspace, repo_slug, target, variables } = params;\n\n    const body: Record<string, unknown> = {\n      target,\n    };\n\n    if (variables && variables.length > 0) {\n      body.variables = variables;\n    }\n\n    return this.client.post<BitbucketPipeline>(\n      `/repositories/${workspace}/${repo_slug}/pipelines`,\n      body\n    );\n  }\n\n  /**\n   * Stop a running pipeline\n   */\n  async stop(workspace: string, repo_slug: string, pipeline_uuid: string): Promise<void> {\n    await this.client.post(\n      `/repositories/${workspace}/${repo_slug}/pipelines/${pipeline_uuid}/stopPipeline`\n    );\n  }\n\n  /**\n   * Get pipeline steps\n   */\n  async getSteps(\n    workspace: string,\n    repo_slug: string,\n    pipeline_uuid: string\n  ): Promise<\n    PaginatedResponse<{\n      uuid: string;\n      name: string;\n      state: {\n        name: string;\n        type: string;\n        result?: { name: string };\n      };\n      started_on?: string;\n      completed_on?: string;\n      duration_in_seconds?: number;\n    }>\n  > {\n    return this.client.get(\n      `/repositories/${workspace}/${repo_slug}/pipelines/${pipeline_uuid}/steps`\n    );\n  }\n\n  /**\n   * Get pipeline step log\n   */\n  async getStepLog(\n    workspace: string,\n    repo_slug: string,\n    pipeline_uuid: string,\n    step_uuid: string\n  ): Promise<string> {\n    return this.client.getRaw(\n      `/repositories/${workspace}/${repo_slug}/pipelines/${pipeline_uuid}/steps/${step_uuid}/log`\n    );\n  }\n}\n"],"names":["PipelinesAPI","client","list","params","workspace","repo_slug","queryParams","get","pipeline_uuid","trigger","target","variables","body","length","post","stop","getSteps","getStepLog","step_uuid","getRaw"],"mappings":"AAQA,OAAO,MAAMA;;IACX,YAAY,AAAQC,MAAuB,CAAE;aAAzBA,SAAAA;IAA0B;IAK9C,MAAMC,KAAKC,MAA2B,EAAiD;QACrF,MAAM,EAAEC,SAAS,EAAEC,SAAS,EAAE,GAAGC,aAAa,GAAGH;QACjD,OAAO,IAAI,CAACF,MAAM,CAACM,GAAG,CACpB,CAAC,cAAc,EAAEH,UAAU,CAAC,EAAEC,UAAU,UAAU,CAAC,EACnDC;IAEJ;IAKA,MAAMC,IACJH,SAAiB,EACjBC,SAAiB,EACjBG,aAAqB,EACO;QAC5B,OAAO,IAAI,CAACP,MAAM,CAACM,GAAG,CACpB,CAAC,cAAc,EAAEH,UAAU,CAAC,EAAEC,UAAU,WAAW,EAAEG,eAAe;IAExE;IAKA,MAAMC,QAAQN,MAA6B,EAA8B;QACvE,MAAM,EAAEC,SAAS,EAAEC,SAAS,EAAEK,MAAM,EAAEC,SAAS,EAAE,GAAGR;QAEpD,MAAMS,OAAgC;YACpCF;QACF;QAEA,IAAIC,aAAaA,UAAUE,MAAM,GAAG,GAAG;YACrCD,KAAKD,SAAS,GAAGA;QACnB;QAEA,OAAO,IAAI,CAACV,MAAM,CAACa,IAAI,CACrB,CAAC,cAAc,EAAEV,UAAU,CAAC,EAAEC,UAAU,UAAU,CAAC,EACnDO;IAEJ;IAKA,MAAMG,KAAKX,SAAiB,EAAEC,SAAiB,EAAEG,aAAqB,EAAiB;QACrF,MAAM,IAAI,CAACP,MAAM,CAACa,IAAI,CACpB,CAAC,cAAc,EAAEV,UAAU,CAAC,EAAEC,UAAU,WAAW,EAAEG,cAAc,aAAa,CAAC;IAErF;IAKA,MAAMQ,SACJZ,SAAiB,EACjBC,SAAiB,EACjBG,aAAqB,EAcrB;QACA,OAAO,IAAI,CAACP,MAAM,CAACM,GAAG,CACpB,CAAC,cAAc,EAAEH,UAAU,CAAC,EAAEC,UAAU,WAAW,EAAEG,cAAc,MAAM,CAAC;IAE9E;IAKA,MAAMS,WACJb,SAAiB,EACjBC,SAAiB,EACjBG,aAAqB,EACrBU,SAAiB,EACA;QACjB,OAAO,IAAI,CAACjB,MAAM,CAACkB,MAAM,CACvB,CAAC,cAAc,EAAEf,UAAU,CAAC,EAAEC,UAAU,WAAW,EAAEG,cAAc,OAAO,EAAEU,UAAU,IAAI,CAAC;IAE/F;AACF"}