@shibainu16/bitbucket-dc-mcp 1.0.2 → 1.2.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 lvluu
-
-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.
+MIT License
+
+Copyright (c) 2025 lvluu
+
+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

@@ -1,289 +1,249 @@
-# Bitbucket DC MCP Server
-
-[![npm version](https://img.shields.io/npm/v/@shibainu16/bitbucket-dc-mcp.svg)](https://www.npmjs.com/package/@shibainu16/bitbucket-dc-mcp)
-[![CI](https://github.com/lvluu/bitbucket-dc-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/lvluu/bitbucket-dc-mcp/actions/workflows/ci.yml)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that exposes **Bitbucket Data Center REST API v1.0** as tools for AI assistants.
-
-## Overview
-
-This server lets MCP-compatible clients (Claude Desktop, VS Code, IDEs, custom apps) interact with a Bitbucket Data Center instance — browsing projects, managing repositories, creating and reviewing pull requests, and more — through 48 tools.
-
-```mermaid
-graph LR
-    A[AI Client] <-->|MCP| B[bitbucket-dc-mcp]
-    B <-->|REST API v1.0| C[Bitbucket Data Center]
-```
-
-## Installation
-
-### Global install
-
-```bash
-npm install -g @shibainu16/bitbucket-dc-mcp
-```
-
-### Using npx (no install required)
-
-```bash
-BITBUCKET_URL=https://bitbucket.example.com \
-BITBUCKET_TOKEN=your-token \
-MCP_TRANSPORT=stdio \
-npx @shibainu16/bitbucket-dc-mcp
-```
-
-## Prerequisites
-
-- Node.js >= 20.11.0
-- A Bitbucket Data Center instance with API access
-- A personal access token or username/password credentials
-
-## Quick Start
-
-### 1. Configure environment
-
-Create a `.env` file (or export variables in your shell):
-
-```env
-# Required — your Bitbucket DC base URL
-BITBUCKET_URL=https://bitbucket.example.com
-
-# Authentication (choose one)
-BITBUCKET_TOKEN=your-personal-access-token
-# OR
-BITBUCKET_USERNAME=your-username
-BITBUCKET_PASSWORD=your-password
-
-# Optional
-BITBUCKET_DEFAULT_PROJECT=MYPROJ
-BITBUCKET_ENABLE_DANGEROUS=false
-MCP_TRANSPORT=http
-PORT=3000
-```
-
-### 2. Run
-
-```bash
-# If installed globally
-bitbucket-dc-mcp
-
-# Or via npx
-npx @shibainu16/bitbucket-dc-mcp
-```
-
-The server starts in HTTP mode by default at `http://localhost:3000/mcp`.
-
-## Configuration
-
-### Environment Variables
-
-| Variable | Required | Description | Default |
-|----------|----------|-------------|---------|
-| `BITBUCKET_URL` | Yes | Bitbucket DC base URL (auto-appends `/rest/api/1.0`) | — |
-| `BITBUCKET_TOKEN` | Yes* | Personal access token (Bearer auth) | — |
-| `BITBUCKET_USERNAME` | Yes* | Username for basic auth | — |
-| `BITBUCKET_PASSWORD` | Yes* | Password for basic auth | — |
-| `BITBUCKET_DEFAULT_PROJECT` | No | Default project key for tools that accept `projectKey` | — |
-| `BITBUCKET_ENABLE_DANGEROUS` | No | Enable destructive operations (`deletePRComment`, `deleteBranch`) | `false` |
-| `MCP_TRANSPORT` | No | Transport mode: `stdio` or `http` | `http` |
-| `PORT` | No | HTTP server port | `3000` |
-| `CORS_ORIGIN` | No | CORS allowed origins | `*` |
-
-\* Either `BITBUCKET_TOKEN` or both `BITBUCKET_USERNAME` + `BITBUCKET_PASSWORD` are required.
-
-## Transport Modes
-
-### HTTP Mode (Default)
-
-Streamable HTTP transport for web deployments and remote access:
-
-```bash
-MCP_TRANSPORT=http bitbucket-dc-mcp
-```
-
-Endpoints:
-- `GET /mcp` — SSE stream for server-initiated messages
-- `POST /mcp` — JSON-RPC requests
-- `DELETE /mcp` — Session termination
-- `GET /health` — Health check
-
-### Stdio Mode
-
-Traditional stdio transport for local clients like Claude Desktop:
-
-```bash
-MCP_TRANSPORT=stdio bitbucket-dc-mcp
-```
-
-## Client Integration
-
-### VS Code / GitHub Copilot
-
-Add to your **VS Code settings** (`settings.json`) or workspace `.vscode/mcp.json`:
-
-```json
-{
-  "servers": {
-    "bitbucket-dc-mcp": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@shibainu16/bitbucket-dc-mcp"],
-      "env": {
-        "BITBUCKET_URL": "https://bitbucket.example.com",
-        "BITBUCKET_TOKEN": "your-token",
-        "MCP_TRANSPORT": "stdio"
-      }
-    }
-  }
-}
-```
-
-If using `settings.json` directly, nest it under `"mcp"`:
-
-```jsonc
-{
-  "mcp": {
-    "servers": {
-      "bitbucket-dc-mcp": {
-        "type": "stdio",
-        "command": "npx",
-        "args": ["-y", "@shibainu16/bitbucket-dc-mcp"],
-        "env": {
-          "BITBUCKET_URL": "https://bitbucket.example.com",
-          "BITBUCKET_TOKEN": "your-token",
-          "MCP_TRANSPORT": "stdio"
-        }
-      }
-    }
-  }
-}
-```
-
-### Claude Code
-
-Add to your project's `.mcp.json`, or configure via the CLI:
-
-```bash
-claude mcp add bitbucket-dc-mcp \
-  -e BITBUCKET_URL=https://bitbucket.example.com \
-  -e BITBUCKET_TOKEN=your-token \
-  -e MCP_TRANSPORT=stdio \
-  -- npx -y @shibainu16/bitbucket-dc-mcp
-```
-
-Or manually create/edit `.mcp.json` in your project root:
-
-```json
-{
-  "mcpServers": {
-    "bitbucket-dc-mcp": {
-      "command": "npx",
-      "args": ["-y", "@shibainu16/bitbucket-dc-mcp"],
-      "env": {
-        "BITBUCKET_URL": "https://bitbucket.example.com",
-        "BITBUCKET_TOKEN": "your-token",
-        "MCP_TRANSPORT": "stdio"
-      }
-    }
-  }
-}
-```
-
-### Claude Desktop
-
-Add to your Claude Desktop configuration (`claude_desktop_config.json`):
-
-```json
-{
-  "mcpServers": {
-    "bitbucket-dc-mcp": {
-      "command": "npx",
-      "args": ["-y", "@shibainu16/bitbucket-dc-mcp"],
-      "env": {
-        "BITBUCKET_URL": "https://bitbucket.example.com",
-        "BITBUCKET_TOKEN": "your-token",
-        "MCP_TRANSPORT": "stdio"
-      }
-    }
-  }
-}
-```
-
-## Development
-
-### From source
-
-```bash
-git clone https://github.com/lvluu/bitbucket-dc-mcp.git
-cd bitbucket-dc-mcp
-npm install
-npm run build
-```
-
-### Commands
-
-| Command | Description |
-|---------|-------------|
-| `npm run build` | Compile TypeScript to `build/` |
-| `npm run typecheck` | Type-check without emitting |
-| `npm run lint` | Run ESLint |
-| `npm run lint:fix` | Auto-fix ESLint issues |
-| `npm test` | Run all tests |
-| `npm run test:watch` | Run tests in watch mode |
-| `npm run inspect` | Build + launch MCP Inspector (stdio) |
-| `npm run inspect:http` | MCP Inspector against HTTP endpoint |
-| `npm run dev` | Build + interactive JSON-RPC REPL |
-| `npm run knip` | Find unused exports/dependencies |
-| `npm run gen:tool` | Generate a new tool module with test |
-
-### Testing with MCP Inspector
-
-```bash
-# Stdio mode
-npm run inspect
-
-# HTTP mode (start server first, then in another terminal)
-npm run inspect:http
-```
-
-The MCP Inspector provides an interactive UI to browse and test all registered tools.
-
-### Adding a New Tool
-
-1. Create `src/tools/my-domain.ts` (or add to an existing domain file)
-2. Export a default `RegisterableModule` that registers tools in its `register()` function
-3. The auto-loader discovers it automatically on next build
-4. Or use the generator: `npm run gen:tool`
-
-See existing files in `src/tools/` for examples.
-
-## Publishing
-
-Releases are fully automated via [release-please](https://github.com/googleapis/release-please) and GitHub Actions:
-
-1. Use [Conventional Commits](https://www.conventionalcommits.org/) (`feat:`, `fix:`, `chore:`, etc.)
-2. On push to `main`, release-please automatically creates/updates a release PR with version bump and changelog
-3. When the release PR is merged, the workflow publishes to npm automatically
-
-Requires an `NPM_TOKEN` secret configured in the GitHub repository settings.
-
-## Troubleshooting
-
-| Issue | Solution |
-|-------|----------|
-| `BITBUCKET_URL is required` | Set the `BITBUCKET_URL` environment variable or add it to `.env` |
-| `Cannot find module` errors | Run `npm run build` before starting the server |
-| `401 Unauthorized` | Check your token or username/password credentials |
-| `deleteBranch is disabled` | Set `BITBUCKET_ENABLE_DANGEROUS=true` to enable destructive operations |
-| Tools not loading | Verify module has a valid default export matching `RegisterableModule` |
-
-## License
-
-MIT — see [LICENSE](LICENSE).
-
-## Resources
-
-- [Model Context Protocol Documentation](https://modelcontextprotocol.io)
-- [Bitbucket Data Center REST API](https://developer.atlassian.com/server/bitbucket/rest/)
-- [MCP Inspector](https://github.com/modelcontextprotocol/inspector)
+# Bitbucket DC MCP Server
+
+[![npm version](https://img.shields.io/npm/v/@shibainu16/bitbucket-dc-mcp.svg)](https://www.npmjs.com/package/@shibainu16/bitbucket-dc-mcp)
+[![CI](https://github.com/lvluu/bitbucket-dc-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/lvluu/bitbucket-dc-mcp/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that exposes **Bitbucket Data Center REST API v1.0** as tools for AI assistants.
+
+## Overview
+
+This server lets MCP-compatible clients (Claude Desktop, VS Code, IDEs, custom apps) interact with a Bitbucket Data Center instance through 55 tools covering:
+
+- **Projects** — list, get, create, update
+- **Repositories** — list, get, create, fork, default branch
+- **Pull Requests** — CRUD, merge, decline, reopen, approve, reviewers, can-merge
+- **PR Comments** — list, add, get, update, delete (inline + general)
+- **PR Diff & Changes** — diffs, file changes, conflict markers
+- **PR Activity** — activity feed, participants, watchers
+- **PR Tasks** — blocker comment tasks
+- **Branches & Tags** — list, create, delete
+- **Commits** — list, get, changes, diff
+- **Files** — browse, read, edit, recursive listing
+- **Build Status** — build statuses per commit, build statistics
+
+```mermaid
+graph LR
+    A[AI Client] <-->|MCP| B[bitbucket-dc-mcp]
+    B <-->|REST API v1.0| C[Bitbucket Data Center]
+```
+
+### Example Prompts
+
+Once connected, try asking your AI assistant:
+
+- "List all repositories in the PROJ project"
+- "Show me open pull requests in repo X"
+- "What changed in PR #42? Summarize the diff"
+- "Create a branch called feature/login from main in PROJ/my-repo"
+- "Add a comment on PR #15 suggesting a fix for the null check on line 23"
+- "What's the build status for the latest commit on main?"
+- "Show me the last 10 commits on the develop branch"
+- "Read the contents of src/index.ts from the main branch"
+- "Are there any unresolved tasks blocking PR #8 from merging?"
+- "Who approved PR #21 and what comments were left?"
+
+## Installation
+
+### Global install
+
+```bash
+npm install -g @shibainu16/bitbucket-dc-mcp
+```
+
+### Using npx (no install required)
+
+```bash
+BITBUCKET_URL=https://bitbucket.example.com \
+BITBUCKET_TOKEN=your-token \
+MCP_TRANSPORT=stdio \
+npx @shibainu16/bitbucket-dc-mcp
+```
+
+## Prerequisites
+
+- Node.js >= 22
+- A Bitbucket Data Center instance with API access
+- A personal access token or username/password credentials
+
+## Quick Start
+
+### 1. Configure environment
+
+Create a `.env` file (or export variables in your shell):
+
+```env
+# Required — your Bitbucket DC base URL
+BITBUCKET_URL=https://bitbucket.example.com
+
+# Authentication (choose one)
+BITBUCKET_TOKEN=your-personal-access-token
+# OR
+BITBUCKET_USERNAME=your-username
+BITBUCKET_PASSWORD=your-password
+
+# Optional
+BITBUCKET_DEFAULT_PROJECT=MYPROJ
+BITBUCKET_ENABLE_DANGEROUS=false
+MCP_TRANSPORT=http
+PORT=3000
+```
+
+### 2. Run
+
+```bash
+# If installed globally
+bitbucket-dc-mcp
+
+# Or via npx
+npx @shibainu16/bitbucket-dc-mcp
+```
+
+The server starts in HTTP mode by default at `http://localhost:3000/mcp`.
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Required | Description | Default |
+|----------|----------|-------------|---------|
+| `BITBUCKET_URL` | Yes | Bitbucket DC base URL (auto-appends `/rest/api/1.0`) | — |
+| `BITBUCKET_TOKEN` | Yes* | Personal access token (Bearer auth) | — |
+| `BITBUCKET_USERNAME` | Yes* | Username for basic auth | — |
+| `BITBUCKET_PASSWORD` | Yes* | Password for basic auth | — |
+| `BITBUCKET_DEFAULT_PROJECT` | No | Default project key for tools that accept `projectKey` | — |
+| `BITBUCKET_ENABLE_DANGEROUS` | No | Enable destructive operations (`deletePRComment`, `deleteBranch`) | `false` |
+| `MCP_TRANSPORT` | No | Transport mode: `stdio` or `http` | `http` |
+| `PORT` | No | HTTP server port | `3000` |
+| `CORS_ORIGIN` | No | CORS allowed origins | `*` |
+
+\* Either `BITBUCKET_TOKEN` or both `BITBUCKET_USERNAME` + `BITBUCKET_PASSWORD` are required.
+
+## Transport Modes
+
+### HTTP Mode (Default)
+
+Streamable HTTP transport for web deployments and remote access:
+
+```bash
+MCP_TRANSPORT=http bitbucket-dc-mcp
+```
+
+Endpoints:
+- `GET /mcp` — SSE stream for server-initiated messages
+- `POST /mcp` — JSON-RPC requests
+- `DELETE /mcp` — Session termination
+- `GET /health` — Health check
+
+### Stdio Mode
+
+Traditional stdio transport for local clients like Claude Desktop:
+
+```bash
+MCP_TRANSPORT=stdio bitbucket-dc-mcp
+```
+
+## Client Integration
+
+### VS Code / GitHub Copilot
+
+Add to your **VS Code settings** (`settings.json`) or workspace `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "bitbucket-dc-mcp": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@shibainu16/bitbucket-dc-mcp"],
+      "env": {
+        "BITBUCKET_URL": "https://bitbucket.example.com",
+        "BITBUCKET_TOKEN": "your-token",
+        "MCP_TRANSPORT": "stdio"
+      }
+    }
+  }
+}
+```
+
+If using `settings.json` directly, nest it under `"mcp"`:
+
+```jsonc
+{
+  "mcp": {
+    "servers": {
+      "bitbucket-dc-mcp": {
+        "type": "stdio",
+        "command": "npx",
+        "args": ["-y", "@shibainu16/bitbucket-dc-mcp"],
+        "env": {
+          "BITBUCKET_URL": "https://bitbucket.example.com",
+          "BITBUCKET_TOKEN": "your-token",
+          "MCP_TRANSPORT": "stdio"
+        }
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+Add to your project's `.mcp.json`, or configure via the CLI:
+
+```bash
+claude mcp add bitbucket-dc-mcp \
+  -e BITBUCKET_URL=https://bitbucket.example.com \
+  -e BITBUCKET_TOKEN=your-token \
+  -e MCP_TRANSPORT=stdio \
+  -- npx -y @shibainu16/bitbucket-dc-mcp
+```
+
+Or manually create/edit `.mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "bitbucket-dc-mcp": {
+      "command": "npx",
+      "args": ["-y", "@shibainu16/bitbucket-dc-mcp"],
+      "env": {
+        "BITBUCKET_URL": "https://bitbucket.example.com",
+        "BITBUCKET_TOKEN": "your-token",
+        "MCP_TRANSPORT": "stdio"
+      }
+    }
+  }
+}
+```
+
+## Development
+
+```bash
+git clone https://github.com/lvluu/bitbucket-dc-mcp.git
+cd bitbucket-dc-mcp
+npm install
+npm run build
+```
+
+See `CLAUDE.md` for the full list of commands, architecture details, and contribution guidance.
+
+## Troubleshooting
+
+| Issue | Solution |
+|-------|----------|
+| `BITBUCKET_URL is required` | Set the `BITBUCKET_URL` environment variable or add it to `.env` |
+| `Cannot find module` errors | Run `npm run build` before starting the server |
+| `401 Unauthorized` | Check your token or username/password credentials |
+| `deleteBranch is disabled` | Set `BITBUCKET_ENABLE_DANGEROUS=true` to enable destructive operations |
+| Tools not loading | Verify module has a valid default export matching `RegisterableModule` |
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+## Resources
+
+- [Model Context Protocol Documentation](https://modelcontextprotocol.io)
+- [Bitbucket Data Center REST API](https://developer.atlassian.com/server/bitbucket/rest/)
+- [MCP Inspector](https://github.com/modelcontextprotocol/inspector)

package/build/lib/client.js

@@ -26,6 +26,11 @@ export function getConfig() {
     }
     return config;
 }
+/** Get the Bitbucket server origin (e.g. https://bitbucket.example.com) */
+export function getOriginUrl() {
+    const cfg = getConfig();
+    return new URL(cfg.baseUrl).origin;
+}
 /** Build the DC API path for a project's repository */
 export function repoPath(projectKey, repoSlug) {
     return `/projects/${projectKey}/repos/${repoSlug}`;

package/build/lib/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAsB,MAAM,OAAO,CAAC;AAClD,OAAO,EAA0B,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEnF,IAAI,MAAiC,CAAC;AACtC,IAAI,MAAqC,CAAC;AAE1C,MAAM,UAAU,UAAU,CAAC,GAAsB;IAC/C,MAAM,GAAG,GAAG,CAAC;IACb,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QACpB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,OAAO,EAAE;YACP,GAAG,cAAc,CAAC,GAAG,CAAC;YACtB,cAAc,EAAE,kBAAkB;YAClC,MAAM,EAAE,kBAAkB;SAC3B;QACD,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC;KACxB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,QAAQ,CAAC,UAAkB,EAAE,QAAgB;IAC3D,OAAO,aAAa,UAAU,UAAU,QAAQ,EAAE,CAAC;AACrD,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,MAAM,CAAC,UAAkB,EAAE,QAAgB,EAAE,IAAqB;IAChF,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,kBAAkB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;AAC3E,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAsB,MAAM,OAAO,CAAC;AAClD,OAAO,EAA0B,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEnF,IAAI,MAAiC,CAAC;AACtC,IAAI,MAAqC,CAAC;AAE1C,MAAM,UAAU,UAAU,CAAC,GAAsB;IAC/C,MAAM,GAAG,GAAG,CAAC;IACb,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QACpB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,OAAO,EAAE;YACP,GAAG,cAAc,CAAC,GAAG,CAAC;YACtB,cAAc,EAAE,kBAAkB;YAClC,MAAM,EAAE,kBAAkB;SAC3B;QACD,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC;KACxB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,YAAY;IAC1B,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;AACrC,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,QAAQ,CAAC,UAAkB,EAAE,QAAgB;IAC3D,OAAO,aAAa,UAAU,UAAU,QAAQ,EAAE,CAAC;AACrD,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,MAAM,CAAC,UAAkB,EAAE,QAAgB,EAAE,IAAqB;IAChF,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,kBAAkB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;AAC3E,CAAC"}

package/build/lib/review-state.js

@@ -0,0 +1,41 @@
+/**
+ * In-memory review session state management.
+ *
+ * When a review is active for a PR, comments added via addPRComment are
+ * buffered here instead of being posted immediately. finishReview then
+ * posts them all at once.
+ */
+// Key: "projectKey/repoSlug/prId"
+const reviewSessions = new Map();
+export function reviewKey(projectKey, repoSlug, prId) {
+    return `${projectKey}/${repoSlug}/${String(prId)}`;
+}
+export function hasActiveReview(key) {
+    return reviewSessions.has(key);
+}
+export function startReviewSession(key) {
+    if (reviewSessions.has(key)) {
+        throw new Error(`A review session is already active for ${key}. Finish or discard it first.`);
+    }
+    reviewSessions.set(key, []);
+}
+export function getReviewSession(key) {
+    return reviewSessions.get(key);
+}
+export function addPendingComment(key, comment) {
+    const session = reviewSessions.get(key);
+    if (session === undefined) {
+        throw new Error(`No active review session for ${key}.`);
+    }
+    session.push(comment);
+    return session.length - 1;
+}
+export function clearReviewSession(key) {
+    const session = reviewSessions.get(key);
+    if (session === undefined) {
+        throw new Error(`No active review session for ${key}.`);
+    }
+    reviewSessions.delete(key);
+    return session;
+}
+//# sourceMappingURL=review-state.js.map

package/build/lib/review-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-state.js","sourceRoot":"","sources":["../../src/lib/review-state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,kCAAkC;AAClC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAiC,CAAC;AAEhE,MAAM,UAAU,SAAS,CACvB,UAAkB,EAClB,QAAgB,EAChB,IAAY;IAEZ,OAAO,GAAG,UAAU,IAAI,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,0CAA0C,GAAG,+BAA+B,CAC7E,CAAC;IACJ,CAAC;IACD,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,GAAW;IAEX,OAAO,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,GAAW,EACX,OAAuB;IAEvB,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,GAAG,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,GAAG,CAAC,CAAC;IAC1D,CAAC;IACD,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC"}