bitbucket-data-center-client 1.4.1 → 1.4.2

package/README.md

@@ -14,43 +14,84 @@ npm install bitbucket-data-center-client
 import { BitbucketClient } from 'bitbucket-data-center-client';
 
 const client = new BitbucketClient({
+  baseUrl: 'https://bitbucket.example.com',
   token: 'your-personal-access-token',
-  baseUrl: 'https://bitbucket.example.com'
 });
 
+// Get user profile
+const user = await client.users.getProfile({ username: 'john.doe' });
+
 // List projects
-const projects = await client.listProjects();
+const projects = await client.projects.list();
+
+// List repositories in a project
+const repos = await client.repositories.list({ projectKey: 'PROJ' });
 
 // Browse repository contents
-const contents = await client.browse({
+const contents = await client.repositories.browse({
   projectKey: 'PROJ',
   repositorySlug: 'my-repo',
-  path: 'src'
+  path: 'src',
 });
 
 // Get raw file content
-const file = await client.getRawContent({
+const file = await client.repositories.getRawContent({
+  projectKey: 'PROJ',
+  repositorySlug: 'my-repo',
+  path: 'package.json',
+});
+
+// Get pull request details
+const pr = await client.pullRequests.get({
   projectKey: 'PROJ',
   repositorySlug: 'my-repo',
-  path: 'package.json'
+  pullRequestId: 123,
+});
+
+// Create a pull request
+const newPr = await client.pullRequests.create({
+  projectKey: 'PROJ',
+  repositorySlug: 'my-repo',
+  fromBranch: 'feature-branch',
+  toBranch: 'main',
+  title: 'Add new feature',
+  reviewers: ['reviewer1', 'reviewer2'],
+});
+
+// Add a comment to a PR
+await client.pullRequests.addComment({
+  projectKey: 'PROJ',
+  repositorySlug: 'my-repo',
+  pullRequestId: 123,
+  text: 'Looks good!',
+});
+
+// Approve a PR
+await client.pullRequests.updateReviewStatus({
+  projectKey: 'PROJ',
+  repositorySlug: 'my-repo',
+  pullRequestId: 123,
+  status: 'APPROVED',
 });
 ```
 
-## Available Methods
+## API Structure
 
-| Category | Methods |
-|----------|---------|
-| Users | `getUserProfile`, `getAllUsers` |
-| Projects | `listProjects` |
-| Repositories | `listRepositories`, `getRepository`, `browse`, `getRawContent` |
-| Pull Requests | `getInboxPullRequests`, `getDashboardPullRequests`, `getPullRequest`, `createPullRequest`, `getRequiredReviewers` |
-| PR Changes | `getPullRequestChanges`, `getPullRequestDiff`, `getPullRequestFileDiff` |
-| PR Comments | `addPullRequestComment`, `deletePullRequestComment`, `getPullRequestActivities` |
-| PR Review | `updateReviewStatus`, `addPullRequestCommentReaction`, `removePullRequestCommentReaction` |
+| Domain | Methods |
+|--------|---------|
+| `client.users` | `getProfile`, `getAll` |
+| `client.projects` | `list` |
+| `client.repositories` | `list`, `get`, `browse`, `getRawContent`, `checkPermissions` |
+| `client.pullRequests` | `getInbox`, `getDashboard`, `get`, `create`, `getChanges`, `getDiff`, `getFileDiff`, `getActivities`, `addComment`, `deleteComment`, `updateReviewStatus`, `addReaction`, `removeReaction`, `getRequiredReviewers` |
 
 ## Authentication
 
-Generate a Personal Access Token in Bitbucket: **Profile → Manage account → Personal access tokens**
+Generate a Personal Access Token in Bitbucket: **Profile > Manage account > Personal access tokens**
+
+```bash
+export BITBUCKET_URL=https://bitbucket.example.com
+export BITBUCKET_TOKEN=your-personal-access-token
+```
 
 ## Requirements
 

package/dist/api/base.d.ts

@@ -0,0 +1,11 @@
+import { type AxiosInstance } from 'axios';
+import type { BitbucketClientConfig } from '../types/common.js';
+/**
+ * Base API class providing shared axios configuration for all domain APIs.
+ */
+export declare class BaseApi {
+    protected client: AxiosInstance;
+    protected baseUrl: string;
+    constructor(config: BitbucketClientConfig);
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/api/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/api/base.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAClD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE;;GAEG;AACH,qBAAa,OAAO;IAClB,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC;IAChC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEP,MAAM,EAAE,qBAAqB;CAcjD"}

package/dist/api/base.js

@@ -0,0 +1,22 @@
+import axios from 'axios';
+/**
+ * Base API class providing shared axios configuration for all domain APIs.
+ */
+export class BaseApi {
+    client;
+    baseUrl;
+    constructor(config) {
+        const { token, baseUrl, axiosConfig = {} } = config;
+        this.baseUrl = baseUrl;
+        this.client = axios.create({
+            ...axiosConfig,
+            baseURL: `${baseUrl}/rest/api/latest`,
+            headers: {
+                ...axiosConfig.headers,
+                Authorization: `Bearer ${token}`,
+                'Content-Type': 'application/json',
+            },
+        });
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/api/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/api/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAA6B,MAAM,OAAO,CAAC;AAGlD;;GAEG;AACH,MAAM,OAAO,OAAO;IACR,MAAM,CAAgB;IACtB,OAAO,CAAS;IAE1B,YAAmB,MAA6B;QAC9C,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;QACpD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YACzB,GAAG,WAAW;YACd,OAAO,EAAE,GAAG,OAAO,kBAAkB;YACrC,OAAO,EAAE;gBACP,GAAG,WAAW,CAAC,OAAO;gBACtB,aAAa,EAAE,UAAU,KAAK,EAAE;gBAChC,cAAc,EAAE,kBAAkB;aACnC;SACF,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/api/index.d.ts

@@ -0,0 +1,6 @@
+export { BaseApi } from './base.js';
+export { ProjectsApi } from './projects.js';
+export { PullRequestsApi } from './pull-requests.js';
+export { RepositoriesApi } from './repositories.js';
+export { UsersApi } from './users.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,6 @@
+export { BaseApi } from './base.js';
+export { ProjectsApi } from './projects.js';
+export { PullRequestsApi } from './pull-requests.js';
+export { RepositoriesApi } from './repositories.js';
+export { UsersApi } from './users.js';
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/api/projects.d.ts

@@ -0,0 +1,14 @@
+import { BaseApi } from './base.js';
+import type { PaginatedResponse } from '../types/common.js';
+import type { ListProjectsParams, RestProject } from '../types/project.js';
+/**
+ * Projects API for Bitbucket Server.
+ * Provides methods for project-related operations.
+ */
+export declare class ProjectsApi extends BaseApi {
+    /**
+     * List projects, optionally filtered by name or permission
+     */
+    list(params?: ListProjectsParams): Promise<PaginatedResponse<RestProject>>;
+}
+//# sourceMappingURL=projects.d.ts.map

package/dist/api/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/api/projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAE3E;;;GAGG;AACH,qBAAa,WAAY,SAAQ,OAAO;IACtC;;OAEG;IACU,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;CAMxF"}

package/dist/api/projects.js

@@ -0,0 +1,17 @@
+import { BaseApi } from './base.js';
+/**
+ * Projects API for Bitbucket Server.
+ * Provides methods for project-related operations.
+ */
+export class ProjectsApi extends BaseApi {
+    /**
+     * List projects, optionally filtered by name or permission
+     */
+    async list(params) {
+        const response = await this.client.get('/projects', {
+            params,
+        });
+        return response.data;
+    }
+}
+//# sourceMappingURL=projects.js.map

package/dist/api/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/api/projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,OAAO;IACtC;;OAEG;IACI,KAAK,CAAC,IAAI,CAAC,MAA2B;QAC3C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAiC,WAAW,EAAE;YAClF,MAAM;SACP,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF"}

package/dist/api/pull-requests.d.ts

@@ -0,0 +1,81 @@
+import { BaseApi } from './base.js';
+import type { PaginatedResponse } from '../types/common.js';
+import type { AddPullRequestCommentParams, AddPullRequestCommentReactionParams, ChangesResponse, CreatePullRequestParams, DeletePullRequestCommentParams, DiffResponse, GetDashboardPullRequestsParams, GetInboxPullRequestsParams, GetPullRequestActivitiesParams, GetPullRequestChangesParams, GetPullRequestDiffParams, GetPullRequestFileDiffParams, GetPullRequestParams, GetRequiredReviewersParams, InboxPullRequest, RemovePullRequestCommentReactionParams, RestComment, RestPullRequest, RestPullRequestActivityApiResponse, RestPullRequestParticipant, RestUserReaction, UpdateReviewStatusParams } from '../types/pull-request.js';
+import type { RestUser } from '../types/user.js';
+/**
+ * Pull Requests API for Bitbucket Server.
+ * Provides methods for pull request-related operations.
+ */
+export declare class PullRequestsApi extends BaseApi {
+    /**
+     * Get pull requests in the authenticated user's inbox (where they are assigned as reviewer)
+     */
+    getInbox(params?: GetInboxPullRequestsParams): Promise<PaginatedResponse<InboxPullRequest>>;
+    /**
+     * Get pull requests from the user's dashboard.
+     * Can filter by role (AUTHOR, REVIEWER, PARTICIPANT), state, and more.
+     */
+    getDashboard(params?: GetDashboardPullRequestsParams): Promise<PaginatedResponse<RestPullRequest>>;
+    /**
+     * Get pull request details (title, description, author, branches, etc.)
+     */
+    get(params: GetPullRequestParams): Promise<RestPullRequest>;
+    /**
+     * Create a new pull request.
+     * Supports both same-repo PRs (default) and cross-repo PRs (when fromRepositorySlug is provided).
+     * Branch names are automatically converted to full refs (e.g., "main" → "refs/heads/main").
+     */
+    create(params: CreatePullRequestParams): Promise<RestPullRequest>;
+    /**
+     * Get all changed files in a pull request
+     */
+    getChanges(params: GetPullRequestChangesParams): Promise<ChangesResponse>;
+    /**
+     * Get structured line-by-line diff for a specific file in a pull request
+     */
+    getFileDiff(params: GetPullRequestFileDiffParams): Promise<DiffResponse>;
+    /**
+     * Get diff for a pull request (or specific file).
+     * When path is empty or undefined, returns the full PR diff.
+     * Format controls the response type:
+     * - 'text': Raw diff as plain text string
+     * - 'json': Structured diff object (DiffResponse)
+     */
+    getDiff(params: GetPullRequestDiffParams): Promise<string | DiffResponse>;
+    /**
+     * Get activity on a pull request (comments, approvals, merges, reviews, updates)
+     */
+    getActivities(params: GetPullRequestActivitiesParams): Promise<PaginatedResponse<RestPullRequestActivityApiResponse>>;
+    /**
+     * Add a comment to a pull request (supports general comments, replies, and inline file/line comments)
+     */
+    addComment(params: AddPullRequestCommentParams): Promise<RestComment>;
+    /**
+     * Delete a pull request comment. Returns void on success (HTTP 204).
+     * Anyone can delete their own comment. Only REPO_ADMIN can delete others' comments.
+     * Comments with replies cannot be deleted.
+     */
+    deleteComment(params: DeletePullRequestCommentParams): Promise<void>;
+    /**
+     * Update review status for a pull request (approve, request changes, or remove approval)
+     */
+    updateReviewStatus(params: UpdateReviewStatusParams): Promise<RestPullRequestParticipant>;
+    /**
+     * Add an emoticon reaction to a pull request comment
+     */
+    addReaction(params: AddPullRequestCommentReactionParams): Promise<RestUserReaction>;
+    /**
+     * Remove an emoticon reaction from a pull request comment
+     */
+    removeReaction(params: RemovePullRequestCommentReactionParams): Promise<void>;
+    /**
+     * Get the list of required/default reviewers for a pull request.
+     * Returns users who would be automatically assigned as reviewers based on configured rules.
+     * Note: Default reviewers are NOT auto-added when creating PRs via API - you must
+     * fetch them with this method and pass them to create().
+     * Branch names are automatically converted to full refs (e.g., "main" → "refs/heads/main").
+     * Use repositories.get() to obtain the repositoryId.
+     */
+    getRequiredReviewers(params: GetRequiredReviewersParams): Promise<RestUser[]>;
+}
+//# sourceMappingURL=pull-requests.d.ts.map

package/dist/api/pull-requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull-requests.d.ts","sourceRoot":"","sources":["../../src/api/pull-requests.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAEV,2BAA2B,EAC3B,mCAAmC,EACnC,eAAe,EAEf,uBAAuB,EACvB,8BAA8B,EAC9B,YAAY,EACZ,8BAA8B,EAC9B,0BAA0B,EAC1B,8BAA8B,EAC9B,2BAA2B,EAC3B,wBAAwB,EACxB,4BAA4B,EAC5B,oBAAoB,EACpB,0BAA0B,EAC1B,gBAAgB,EAChB,sCAAsC,EACtC,WAAW,EACX,eAAe,EACf,kCAAkC,EAClC,0BAA0B,EAC1B,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,OAAO;IAC1C;;OAEG;IACU,QAAQ,CAAC,MAAM,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IAKxG;;;OAGG;IACU,YAAY,CAAC,MAAM,CAAC,EAAE,8BAA8B,GAAG,OAAO,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;IAY/G;;OAEG;IACU,GAAG,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IAQxE;;;;OAIG;IACU,MAAM,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,eAAe,CAAC;IA8C9E;;OAEG;IACU,UAAU,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,eAAe,CAAC;IAStF;;OAEG;IACU,WAAW,CAAC,MAAM,EAAE,4BAA4B,GAAG,OAAO,CAAC,YAAY,CAAC;IASrF;;;;;;OAMG;IACU,OAAO,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,GAAG,YAAY,CAAC;IA6BtF;;OAEG;IACU,aAAa,CACxB,MAAM,EAAE,8BAA8B,GACrC,OAAO,CAAC,iBAAiB,CAAC,kCAAkC,CAAC,CAAC;IASjE;;OAEG;IACU,UAAU,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,WAAW,CAAC;IAsBlF;;;;OAIG;IACU,aAAa,CAAC,MAAM,EAAE,8BAA8B,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjF;;OAEG;IACU,kBAAkB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IActG;;OAEG;IACU,WAAW,CAAC,MAAM,EAAE,mCAAmC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAchG;;OAEG;IACU,cAAc,CAAC,MAAM,EAAE,sCAAsC,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1F;;;;;;;OAOG;IACU,oBAAoB,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CAsB3F"}

package/dist/api/pull-requests.js

@@ -0,0 +1,206 @@
+import { BaseApi } from './base.js';
+/**
+ * Pull Requests API for Bitbucket Server.
+ * Provides methods for pull request-related operations.
+ */
+export class PullRequestsApi extends BaseApi {
+    /**
+     * Get pull requests in the authenticated user's inbox (where they are assigned as reviewer)
+     */
+    async getInbox(params) {
+        const response = await this.client.get('/inbox/pull-requests', { params });
+        return response.data;
+    }
+    /**
+     * Get pull requests from the user's dashboard.
+     * Can filter by role (AUTHOR, REVIEWER, PARTICIPANT), state, and more.
+     */
+    async getDashboard(params) {
+        const response = await this.client.get('/dashboard/pull-requests', {
+            params: {
+                role: 'AUTHOR',
+                state: 'OPEN',
+                order: 'NEWEST',
+                ...params,
+            },
+        });
+        return response.data;
+    }
+    /**
+     * Get pull request details (title, description, author, branches, etc.)
+     */
+    async get(params) {
+        const { projectKey, repositorySlug, pullRequestId } = params;
+        const response = await this.client.get(`/projects/${projectKey}/repos/${repositorySlug}/pull-requests/${pullRequestId}`);
+        return response.data;
+    }
+    /**
+     * Create a new pull request.
+     * Supports both same-repo PRs (default) and cross-repo PRs (when fromRepositorySlug is provided).
+     * Branch names are automatically converted to full refs (e.g., "main" → "refs/heads/main").
+     */
+    async create(params) {
+        const { projectKey, repositorySlug, title, description, fromBranch, toBranch, fromRepositorySlug, fromProjectKey, reviewers, draft, } = params;
+        // Convert branch names to full refs if needed
+        const toRefId = (branch) => (branch.startsWith('refs/') ? branch : `refs/heads/${branch}`);
+        const body = {
+            title,
+            ...(description && { description }),
+            fromRef: {
+                id: toRefId(fromBranch),
+                ...(fromRepositorySlug && {
+                    repository: {
+                        slug: fromRepositorySlug,
+                        project: { key: fromProjectKey || projectKey },
+                    },
+                }),
+            },
+            toRef: {
+                id: toRefId(toBranch),
+            },
+            ...(reviewers &&
+                reviewers.length > 0 && {
+                reviewers: reviewers.map((username) => ({ user: { name: username } })),
+            }),
+            ...(draft !== undefined && { draft }),
+        };
+        const response = await this.client.post(`/projects/${projectKey}/repos/${repositorySlug}/pull-requests`, body);
+        return response.data;
+    }
+    /**
+     * Get all changed files in a pull request
+     */
+    async getChanges(params) {
+        const { projectKey, repositorySlug, pullRequestId, limit } = params;
+        const response = await this.client.get(`/projects/${projectKey}/repos/${repositorySlug}/pull-requests/${pullRequestId}/changes`, { params: limit ? { limit } : {} });
+        return response.data;
+    }
+    /**
+     * Get structured line-by-line diff for a specific file in a pull request
+     */
+    async getFileDiff(params) {
+        const { projectKey, repositorySlug, pullRequestId, path, contextLines } = params;
+        const response = await this.client.get(`/projects/${projectKey}/repos/${repositorySlug}/pull-requests/${pullRequestId}/diff/${path}`, { params: contextLines ? { contextLines } : {} });
+        return response.data;
+    }
+    /**
+     * Get diff for a pull request (or specific file).
+     * When path is empty or undefined, returns the full PR diff.
+     * Format controls the response type:
+     * - 'text': Raw diff as plain text string
+     * - 'json': Structured diff object (DiffResponse)
+     */
+    async getDiff(params) {
+        const { projectKey, repositorySlug, pullRequestId, path, sinceId, untilId, contextLines, whitespace, format = 'text', } = params;
+        const queryParams = {};
+        if (sinceId)
+            queryParams['sinceId'] = sinceId;
+        if (untilId)
+            queryParams['untilId'] = untilId;
+        if (contextLines !== undefined)
+            queryParams['contextLines'] = contextLines;
+        if (whitespace)
+            queryParams['whitespace'] = whitespace;
+        const response = await this.client.get(`/projects/${projectKey}/repos/${repositorySlug}/pull-requests/${pullRequestId}/diff/${path || ''}`, {
+            params: queryParams,
+            headers: { Accept: format === 'text' ? 'text/plain' : 'application/json' },
+        });
+        return response.data;
+    }
+    /**
+     * Get activity on a pull request (comments, approvals, merges, reviews, updates)
+     */
+    async getActivities(params) {
+        const { projectKey, repositorySlug, pullRequestId, ...queryParams } = params;
+        const response = await this.client.get(`/projects/${projectKey}/repos/${repositorySlug}/pull-requests/${pullRequestId}/activities`, { params: queryParams });
+        return response.data;
+    }
+    /**
+     * Add a comment to a pull request (supports general comments, replies, and inline file/line comments)
+     */
+    async addComment(params) {
+        const { projectKey, repositorySlug, pullRequestId, text, parentId, path, line, lineType, fileType } = params;
+        const body = { text };
+        if (parentId)
+            body.parent = { id: parentId };
+        if (path) {
+            body.anchor = {
+                path,
+                diffType: 'EFFECTIVE',
+                ...(line !== undefined && { line }),
+                ...(lineType && { lineType }),
+                ...(fileType && { fileType }),
+            };
+        }
+        const response = await this.client.post(`/projects/${projectKey}/repos/${repositorySlug}/pull-requests/${pullRequestId}/comments`, body);
+        return response.data;
+    }
+    /**
+     * Delete a pull request comment. Returns void on success (HTTP 204).
+     * Anyone can delete their own comment. Only REPO_ADMIN can delete others' comments.
+     * Comments with replies cannot be deleted.
+     */
+    async deleteComment(params) {
+        const { projectKey, repositorySlug, pullRequestId, commentId, version } = params;
+        await this.client.delete(`/projects/${projectKey}/repos/${repositorySlug}/pull-requests/${pullRequestId}/comments/${commentId}`, {
+            params: { version },
+        });
+    }
+    /**
+     * Update review status for a pull request (approve, request changes, or remove approval)
+     */
+    async updateReviewStatus(params) {
+        const { projectKey, repositorySlug, pullRequestId, status } = params;
+        // Get authenticated user slug from application properties
+        const propertiesResponse = await this.client.get('/application-properties');
+        const userSlug = propertiesResponse.headers['x-ausername'];
+        const response = await this.client.put(`/projects/${projectKey}/repos/${repositorySlug}/pull-requests/${pullRequestId}/participants/${userSlug}`, { status });
+        return response.data;
+    }
+    /**
+     * Add an emoticon reaction to a pull request comment
+     */
+    async addReaction(params) {
+        const { projectKey, repositorySlug, pullRequestId, commentId, emoticon } = params;
+        // Use comment-likes plugin API endpoint
+        const response = await this.client.put(`/comment-likes/latest/projects/${projectKey}/repos/${repositorySlug}/pull-requests/${pullRequestId}/comments/${commentId}/reactions/${emoticon}`, {}, {
+            baseURL: this.client.defaults.baseURL?.replace('/rest/api/latest', '/rest'),
+        });
+        return response.data;
+    }
+    /**
+     * Remove an emoticon reaction from a pull request comment
+     */
+    async removeReaction(params) {
+        const { projectKey, repositorySlug, pullRequestId, commentId, emoticon } = params;
+        // Use comment-likes plugin API endpoint
+        await this.client.delete(`/comment-likes/latest/projects/${projectKey}/repos/${repositorySlug}/pull-requests/${pullRequestId}/comments/${commentId}/reactions/${emoticon}`, {
+            baseURL: this.client.defaults.baseURL?.replace('/rest/api/latest', '/rest'),
+        });
+    }
+    /**
+     * Get the list of required/default reviewers for a pull request.
+     * Returns users who would be automatically assigned as reviewers based on configured rules.
+     * Note: Default reviewers are NOT auto-added when creating PRs via API - you must
+     * fetch them with this method and pass them to create().
+     * Branch names are automatically converted to full refs (e.g., "main" → "refs/heads/main").
+     * Use repositories.get() to obtain the repositoryId.
+     */
+    async getRequiredReviewers(params) {
+        const { projectKey, repositorySlug, repositoryId, sourceBranch, targetBranch } = params;
+        // Convert branch names to full refs if needed
+        const toRefId = (branch) => (branch.startsWith('refs/') ? branch : `refs/heads/${branch}`);
+        // Uses /default-reviewers/latest base path (not /rest/api/latest)
+        const response = await this.client.get(`/default-reviewers/latest/projects/${projectKey}/repos/${repositorySlug}/reviewers`, {
+            params: {
+                sourceRepoId: repositoryId,
+                targetRepoId: repositoryId,
+                sourceRefId: toRefId(sourceBranch),
+                targetRefId: toRefId(targetBranch),
+            },
+            baseURL: this.client.defaults.baseURL?.replace('/rest/api/latest', '/rest'),
+        });
+        return response.data;
+    }
+}
+//# sourceMappingURL=pull-requests.js.map

package/dist/api/pull-requests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull-requests.js","sourceRoot":"","sources":["../../src/api/pull-requests.ts"],"names":[],"mappings":"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"}

package/dist/api/repositories.d.ts

@@ -0,0 +1,35 @@
+import { BaseApi } from './base.js';
+import type { BrowseParams, BrowseResponse, CheckRepositoryPermissionsParams, GetRawContentParams, GetRepositoryParams, ListRepositoriesParams, RepositoriesResponse, RepositoryPermissions, RestRepository } from '../types/repository.js';
+/**
+ * Repositories API for Bitbucket Server.
+ * Provides methods for repository-related operations.
+ */
+export declare class RepositoriesApi extends BaseApi {
+    /**
+     * List all repositories in a project
+     */
+    list(params: ListRepositoriesParams): Promise<RepositoriesResponse>;
+    /**
+     * Get a repository by project key and slug
+     */
+    get(params: GetRepositoryParams): Promise<RestRepository>;
+    /**
+     * Browse repository contents at a given path (structured JSON response).
+     * Returns different response based on path type:
+     * - Directory: { children: [...] } with file/folder entries
+     * - File: { lines: [...] } with file content
+     * Check 'children' in response to determine type.
+     */
+    browse(params: BrowseParams): Promise<BrowseResponse>;
+    /**
+     * Get raw content from repository (plain text).
+     * Returns file content as plain text, or git tree listing for directories.
+     */
+    getRawContent(params: GetRawContentParams): Promise<string>;
+    /**
+     * Check repository permissions for the authenticated token.
+     * Returns read/write access flags without modifying anything.
+     */
+    checkPermissions(params: CheckRepositoryPermissionsParams): Promise<RepositoryPermissions>;
+}
+//# sourceMappingURL=repositories.d.ts.map

package/dist/api/repositories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repositories.d.ts","sourceRoot":"","sources":["../../src/api/repositories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,gCAAgC,EAChC,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACf,MAAM,wBAAwB,CAAC;AAEhC;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,OAAO;IAC1C;;OAEG;IACU,IAAI,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAKhF;;OAEG;IACU,GAAG,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IAMtE;;;;;;OAMG;IACU,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IAelE;;;OAGG;IACU,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAaxE;;;OAGG;IACU,gBAAgB,CAAC,MAAM,EAAE,gCAAgC,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAyBxG"}

package/dist/api/repositories.js

@@ -0,0 +1,85 @@
+import { BaseApi } from './base.js';
+/**
+ * Repositories API for Bitbucket Server.
+ * Provides methods for repository-related operations.
+ */
+export class RepositoriesApi extends BaseApi {
+    /**
+     * List all repositories in a project
+     */
+    async list(params) {
+        const response = await this.client.get(`/projects/${params.projectKey}/repos`);
+        return response.data;
+    }
+    /**
+     * Get a repository by project key and slug
+     */
+    async get(params) {
+        const { projectKey, repositorySlug } = params;
+        const response = await this.client.get(`/projects/${projectKey}/repos/${repositorySlug}`);
+        return response.data;
+    }
+    /**
+     * Browse repository contents at a given path (structured JSON response).
+     * Returns different response based on path type:
+     * - Directory: { children: [...] } with file/folder entries
+     * - File: { lines: [...] } with file content
+     * Check 'children' in response to determine type.
+     */
+    async browse(params) {
+        const { projectKey, repositorySlug, path, at, limit, start } = params;
+        const queryParams = {};
+        if (at)
+            queryParams['at'] = at;
+        if (limit !== undefined)
+            queryParams['limit'] = limit;
+        if (start !== undefined)
+            queryParams['start'] = start;
+        const response = await this.client.get(`/projects/${projectKey}/repos/${repositorySlug}/browse/${path || ''}`, { params: queryParams });
+        return response.data;
+    }
+    /**
+     * Get raw content from repository (plain text).
+     * Returns file content as plain text, or git tree listing for directories.
+     */
+    async getRawContent(params) {
+        const { projectKey, repositorySlug, path, at } = params;
+        const queryParams = {};
+        if (at)
+            queryParams['at'] = at;
+        const response = await this.client.get(`/projects/${projectKey}/repos/${repositorySlug}/raw/${path}`, {
+            params: queryParams,
+            headers: { Accept: 'text/plain' },
+        });
+        return response.data;
+    }
+    /**
+     * Check repository permissions for the authenticated token.
+     * Returns read/write access flags without modifying anything.
+     */
+    async checkPermissions(params) {
+        const { projectKey, repositorySlug } = params;
+        const repoPath = `/projects/${projectKey}/repos/${repositorySlug}`;
+        // Check READ permission
+        try {
+            await this.client.get(repoPath);
+        }
+        catch {
+            return { read: false, write: false };
+        }
+        // Check WRITE permission (try creating branch with invalid body)
+        try {
+            await this.client.post(`${repoPath}/branches`, {});
+            return { read: true, write: true }; // Unlikely path
+        }
+        catch (error) {
+            // Validation error ("name field is required") = has write
+            // Permission error = no write
+            const message = error?.response?.data?.errors?.[0]
+                ?.message || '';
+            const write = message.includes('name') && message.includes('required');
+            return { read: true, write };
+        }
+    }
+}
+//# sourceMappingURL=repositories.js.map

package/dist/api/repositories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repositories.js","sourceRoot":"","sources":["../../src/api/repositories.ts"],"names":[],"mappings":"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"}