@aashari/mcp-server-atlassian-bitbucket/dist/utils/toon.util.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 });
exports.toToonOrJson = toToonOrJson;
exports.toToonOrJsonSync = toToonOrJsonSync;
exports.preloadToonEncoder = preloadToonEncoder;
const logger_util_js_1 = require("./logger.util.js");
const logger = logger_util_js_1.Logger.forContext('utils/toon.util.ts');
/**
 * Cached TOON encode function
 */
let toonEncode = null;
/**
 * Load the TOON encoder dynamically (ESM module in CommonJS project)
 */
async function loadToonEncoder() {
    if (toonEncode) {
        return toonEncode;
    }
    try {
        const toon = await import('@toon-format/toon');
        toonEncode = toon.encode;
        logger.debug('TOON encoder loaded successfully');
        return toonEncode;
    }
    catch (error) {
        logger.error('Failed to load TOON encoder', error);
        return null;
    }
}
/**
 * Convert data to TOON format with JSON fallback
 *
 * Attempts to encode data as TOON (Token-Oriented Object Notation) for
 * more efficient LLM token usage. Falls back to JSON if TOON encoding fails.
 *
 * @param data - The data to convert
 * @param jsonFallback - The JSON string to return if TOON conversion fails
 * @returns TOON formatted string, or JSON fallback on error
 *
 * @example
 * const json = JSON.stringify(data, null, 2);
 * const output = await toToonOrJson(data, json);
 */
async function toToonOrJson(data, jsonFallback) {
    const methodLogger = logger.forMethod('toToonOrJson');
    try {
        const encode = await loadToonEncoder();
        if (!encode) {
            methodLogger.debug('TOON encoder not available, using JSON fallback');
            return jsonFallback;
        }
        const toonResult = encode(data, { indent: 2 });
        methodLogger.debug('Successfully converted to TOON format');
        return toonResult;
    }
    catch (error) {
        methodLogger.error('TOON conversion failed, using JSON fallback', error);
        return jsonFallback;
    }
}
/**
 * Synchronous TOON conversion with JSON fallback
 *
 * Uses cached encoder if available, otherwise returns JSON fallback.
 * Prefer toToonOrJson for first-time conversion.
 *
 * @param data - The data to convert
 * @param jsonFallback - The JSON string to return if TOON is unavailable
 * @returns TOON formatted string, or JSON fallback
 */
function toToonOrJsonSync(data, jsonFallback) {
    const methodLogger = logger.forMethod('toToonOrJsonSync');
    if (!toonEncode) {
        methodLogger.debug('TOON encoder not loaded, using JSON fallback');
        return jsonFallback;
    }
    try {
        const toonResult = toonEncode(data, { indent: 2 });
        methodLogger.debug('Successfully converted to TOON format');
        return toonResult;
    }
    catch (error) {
        methodLogger.error('TOON conversion failed, using JSON fallback', error);
        return jsonFallback;
    }
}
/**
 * Pre-load the TOON encoder for synchronous usage later
 * Call this during server initialization
 */
async function preloadToonEncoder() {
    const encode = await loadToonEncoder();
    return encode !== null;
}