@aashari/mcp-server-atlassian-bitbucket/dist/services/vendor.atlassian.workspaces.service.js

Node.js/TypeScript MCP server for Atlassian Bitbucket. Enables AI systems (LLMs) to interact with workspaces, repositories, and pull requests via tools (list, get, comment, search). Connects AI directly to version control workflows through the standard MC

"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
const error_util_js_1 = require("../utils/error.util.js");
const logger_util_js_1 = require("../utils/logger.util.js");
const transport_util_js_1 = require("../utils/transport.util.js");
/**
 * Base API path for Bitbucket REST API v2
 * @see https://developer.atlassian.com/cloud/bitbucket/rest/api-group-workspaces/
 * @constant {string}
 */
const API_PATH = '/2.0';
/**
 * @namespace VendorAtlassianWorkspacesService
 * @description Service for interacting with Bitbucket Workspaces API.
 * Provides methods for listing workspaces and retrieving workspace details.
 * All methods require valid Atlassian credentials configured in the environment.
 */
// Create a contextualized logger for this file
const serviceLogger = logger_util_js_1.Logger.forContext('services/vendor.atlassian.workspaces.service.ts');
// Log service initialization
serviceLogger.debug('Bitbucket workspaces service initialized');
/**
 * List Bitbucket workspaces with optional filtering and pagination
 *
 * Retrieves a list of workspaces from Bitbucket with support for various filters
 * and pagination options.
 *
 * NOTE: The /2.0/user/permissions/workspaces endpoint does not support sorting,
 * despite the ListWorkspacesParams type including a sort parameter.
 *
 * @async
 * @memberof VendorAtlassianWorkspacesService
 * @param {ListWorkspacesParams} [params={}] - Optional parameters for customizing the request
 * @param {string} [params.q] - Filter by workspace name
 * @param {number} [params.page] - Page number
 * @param {number} [params.pagelen] - Number of items per page
 * @returns {Promise<WorkspacePermissionsResponse>} Promise containing the workspaces response with results and pagination info
 * @throws {Error} If Atlassian credentials are missing or API request fails
 * @example
 * // List workspaces with pagination
 * const response = await list({
 *   pagelen: 10
 * });
 */
async function list(params = {}) {
    const methodLogger = logger_util_js_1.Logger.forContext('services/vendor.atlassian.workspaces.service.ts', 'list');
    methodLogger.debug('Listing Bitbucket workspaces with params:', params);
    const credentials = (0, transport_util_js_1.getAtlassianCredentials)();
    if (!credentials) {
        throw (0, error_util_js_1.createAuthMissingError)('Atlassian credentials are required for this operation');
    }
    // Build query parameters
    const queryParams = new URLSearchParams();
    // Add optional query parameters if provided
    // NOTE: Sort is intentionally not included as the /2.0/user/permissions/workspaces endpoint
    // does not support sorting on any field
    if (params.q) {
        queryParams.set('q', params.q);
    }
    if (params.pagelen) {
        queryParams.set('pagelen', params.pagelen.toString());
    }
    if (params.page) {
        queryParams.set('page', params.page.toString());
    }
    const queryString = queryParams.toString()
        ? `?${queryParams.toString()}`
        : '';
    const path = `${API_PATH}/user/permissions/workspaces${queryString}`;
    methodLogger.debug(`Sending request to: ${path}`);
    return (0, transport_util_js_1.fetchAtlassian)(credentials, path);
}
/**
 * Get detailed information about a specific Bitbucket workspace
 *
 * Retrieves comprehensive details about a single workspace.
 *
 * @async
 * @memberof VendorAtlassianWorkspacesService
 * @param {string} workspace - The workspace slug
 * @returns {Promise<WorkspaceDetailed>} Promise containing the detailed workspace information
 * @throws {Error} If Atlassian credentials are missing or API request fails
 * @example
 * // Get workspace details
 * const workspace = await get('my-workspace');
 */
async function get(workspace) {
    const methodLogger = logger_util_js_1.Logger.forContext('services/vendor.atlassian.workspaces.service.ts', 'get');
    methodLogger.debug(`Getting Bitbucket workspace with slug: ${workspace}`);
    const credentials = (0, transport_util_js_1.getAtlassianCredentials)();
    if (!credentials) {
        throw (0, error_util_js_1.createAuthMissingError)('Atlassian credentials are required for this operation');
    }
    // Currently no query parameters for workspace details API
    const path = `${API_PATH}/workspaces/${workspace}`;
    methodLogger.debug(`Sending request to: ${path}`);
    return (0, transport_util_js_1.fetchAtlassian)(credentials, path);
}
exports.default = { list, get };