@mcp-abap-adt/core 2.5.2 → 2.7.0

package/dist/handlers/class/handleUpdateClassSource.js

@@ -1,131 +0,0 @@
-"use strict";
-/**
- * UpdateClassSource Handler - Update Existing ABAP Class Source Code
- *
- * Uses ClassBuilder from @mcp-abap-adt/adt-clients for all operations.
- * Session and lock management handled internally by builder.
- *
- * Workflow: lock -> update -> check -> unlock -> (activate)
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TOOL_DEFINITION = void 0;
-exports.handleUpdateClassSource = handleUpdateClassSource;
-const utils_1 = require("../../lib/utils");
-const fast_xml_parser_1 = require("fast-xml-parser");
-const adt_clients_1 = require("@mcp-abap-adt/adt-clients");
-exports.TOOL_DEFINITION = {
-    name: "UpdateClassSource",
-    description: "Update source code of an existing ABAP class. Locks the class, uploads new source code, and unlocks. Optionally activates after update. Use this to modify existing classes without re-creating metadata.",
-    inputSchema: {
-        type: "object",
-        properties: {
-            class_name: {
-                type: "string",
-                description: "Class name (e.g., ZCL_TEST_CLASS_001). Class must already exist."
-            },
-            source_code: {
-                type: "string",
-                description: "Complete ABAP class source code including CLASS DEFINITION and IMPLEMENTATION sections."
-            },
-            activate: {
-                type: "boolean",
-                description: "Activate class after source update. Default: false. Set to true to activate immediately, or use ActivateObject for batch activation."
-            }
-        },
-        required: ["class_name", "source_code"]
-    }
-};
-/**
- * Main handler for UpdateClassSource
- *
- * Uses ClassBuilder from @mcp-abap-adt/adt-clients for all operations
- * Session and lock management handled internally by builder
- */
-async function handleUpdateClassSource(params) {
-    const args = params;
-    // Validate required parameters
-    if (!args.class_name || !args.source_code) {
-        return (0, utils_1.return_error)(new Error("Missing required parameters: class_name and source_code"));
-    }
-    const className = args.class_name.toUpperCase();
-    const connection = (0, utils_1.getManagedConnection)();
-    utils_1.logger.info(`Starting UpdateClassSource for ${className}`);
-    try {
-        // Create client
-        const client = new adt_clients_1.CrudClient(connection);
-        // Build operation chain: validate -> lock -> update -> check -> unlock -> (activate)
-        const shouldActivate = args.activate === true; // Default to false if not specified
-        // Validate
-        await client.validateClass(className);
-        // Lock
-        await client.lockClass(className);
-        const lockHandle = client.getLockHandle();
-        try {
-            // Update source code
-            await client.updateClass(className, args.source_code, lockHandle);
-            // Check
-            await client.checkClass(className);
-            // Unlock
-            await client.unlockClass(className, lockHandle);
-            // Activate if requested
-            if (shouldActivate) {
-                await client.activateClass(className);
-            }
-        }
-        catch (error) {
-            // Try to unlock on error
-            try {
-                await client.unlockClass(className, lockHandle);
-            }
-            catch (unlockError) {
-                utils_1.logger.error('Failed to unlock class after error:', unlockError);
-            }
-            throw error;
-        }
-        // Parse activation warnings if activation was performed
-        let activationWarnings = [];
-        if (shouldActivate && client.getActivateResult()) {
-            const activateResponse = client.getActivateResult();
-            if (typeof activateResponse.data === 'string' && activateResponse.data.includes('<chkl:messages')) {
-                const parser = new fast_xml_parser_1.XMLParser({ ignoreAttributes: false, attributeNamePrefix: '@_' });
-                const result = parser.parse(activateResponse.data);
-                const messages = result?.['chkl:messages']?.['msg'];
-                if (messages) {
-                    const msgArray = Array.isArray(messages) ? messages : [messages];
-                    activationWarnings = msgArray.map((msg) => `${msg['@_type']}: ${msg['shortText']?.['txt'] || 'Unknown'}`);
-                }
-            }
-        }
-        // Return success result
-        const stepsCompleted = ['lock', 'update', 'check', 'unlock'];
-        if (shouldActivate) {
-            stepsCompleted.push('activate');
-        }
-        const result = {
-            success: true,
-            class_name: className,
-            type: 'CLAS/OC',
-            message: shouldActivate
-                ? `Class ${className} source updated and activated successfully`
-                : `Class ${className} source updated successfully (not activated)`,
-            uri: `/sap/bc/adt/oo/classes/${(0, utils_1.encodeSapObjectName)(className).toLowerCase()}`,
-            steps_completed: stepsCompleted,
-            activation_warnings: activationWarnings.length > 0 ? activationWarnings : undefined,
-            source_size_bytes: args.source_code.length
-        };
-        return (0, utils_1.return_response)({
-            data: JSON.stringify(result, null, 2),
-            status: 200,
-            statusText: 'OK',
-            headers: {},
-            config: {}
-        });
-    }
-    catch (error) {
-        utils_1.logger.error(`Error updating class ${className}:`, error);
-        const errorMessage = error.response?.data
-            ? (typeof error.response.data === 'string' ? error.response.data : JSON.stringify(error.response.data))
-            : error.message || String(error);
-        return (0, utils_1.return_error)(new Error(`Failed to update class ${className}: ${errorMessage}`));
-    }
-}

package/dist/handlers/class/handleValidateClass.d.ts

@@ -1,62 +0,0 @@
-/**
- * ValidateClass Handler - Validate ABAP class name via ADT API
- *
- * Uses validateClassName from @mcp-abap-adt/adt-clients/core/class for class-specific validation.
- * Supports package, description, and superclass validation.
- */
-export declare const TOOL_DEFINITION: {
-    readonly name: "ValidateClass";
-    readonly description: "Validate an ABAP class name before creation. Checks if the name is valid, available, and validates package, description, and superclass if provided. Can use session_id and session_state from GetSession to maintain the same session.";
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly class_name: {
-                readonly type: "string";
-                readonly description: "Class name to validate (e.g., ZCL_MY_CLASS)";
-            };
-            readonly package_name: {
-                readonly type: "string";
-                readonly description: "Optional package name for validation";
-            };
-            readonly description: {
-                readonly type: "string";
-                readonly description: "Optional description for validation";
-            };
-            readonly superclass: {
-                readonly type: "string";
-                readonly description: "Optional superclass name for validation (e.g., CL_OBJECT)";
-            };
-            readonly session_id: {
-                readonly type: "string";
-                readonly description: "Session ID from GetSession. If not provided, a new session will be created.";
-            };
-            readonly session_state: {
-                readonly type: "object";
-                readonly description: "Session state from GetSession (cookies, csrf_token, cookie_store). Required if session_id is provided.";
-                readonly properties: {
-                    readonly cookies: {
-                        readonly type: "string";
-                    };
-                    readonly csrf_token: {
-                        readonly type: "string";
-                    };
-                    readonly cookie_store: {
-                        readonly type: "object";
-                    };
-                };
-            };
-        };
-        readonly required: readonly ["class_name"];
-    };
-};
-/**
- * Main handler for ValidateClass MCP tool
- */
-export declare function handleValidateClass(args: any): Promise<{
-    isError: boolean;
-    content: {
-        type: string;
-        text: any;
-    }[];
-}>;
-//# sourceMappingURL=handleValidateClass.d.ts.map

package/dist/handlers/class/handleValidateClass.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"handleValidateClass.d.ts","sourceRoot":"","sources":["../../../src/handlers/class/handleValidateClass.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsClB,CAAC;AAeX;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,GAAG;;;;;;GAkGlD"}

package/dist/handlers/class/handleValidateClass.js

@@ -1,136 +0,0 @@
-"use strict";
-/**
- * ValidateClass Handler - Validate ABAP class name via ADT API
- *
- * Uses validateClassName from @mcp-abap-adt/adt-clients/core/class for class-specific validation.
- * Supports package, description, and superclass validation.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TOOL_DEFINITION = void 0;
-exports.handleValidateClass = handleValidateClass;
-const utils_1 = require("../../lib/utils");
-const adt_clients_1 = require("@mcp-abap-adt/adt-clients");
-exports.TOOL_DEFINITION = {
-    name: "ValidateClass",
-    description: "Validate an ABAP class name before creation. Checks if the name is valid, available, and validates package, description, and superclass if provided. Can use session_id and session_state from GetSession to maintain the same session.",
-    inputSchema: {
-        type: "object",
-        properties: {
-            class_name: {
-                type: "string",
-                description: "Class name to validate (e.g., ZCL_MY_CLASS)"
-            },
-            package_name: {
-                type: "string",
-                description: "Optional package name for validation"
-            },
-            description: {
-                type: "string",
-                description: "Optional description for validation"
-            },
-            superclass: {
-                type: "string",
-                description: "Optional superclass name for validation (e.g., CL_OBJECT)"
-            },
-            session_id: {
-                type: "string",
-                description: "Session ID from GetSession. If not provided, a new session will be created."
-            },
-            session_state: {
-                type: "object",
-                description: "Session state from GetSession (cookies, csrf_token, cookie_store). Required if session_id is provided.",
-                properties: {
-                    cookies: { type: "string" },
-                    csrf_token: { type: "string" },
-                    cookie_store: { type: "object" }
-                }
-            }
-        },
-        required: ["class_name"]
-    }
-};
-/**
- * Main handler for ValidateClass MCP tool
- */
-async function handleValidateClass(args) {
-    try {
-        const { class_name, package_name, description, superclass, session_id, session_state } = args;
-        if (!class_name) {
-            return (0, utils_1.return_error)(new Error('class_name is required'));
-        }
-        const connection = (0, utils_1.getManagedConnection)();
-        // Restore session state if provided
-        if (session_id && session_state) {
-            connection.setSessionState({
-                cookies: session_state.cookies || null,
-                csrfToken: session_state.csrf_token || null,
-                cookieStore: session_state.cookie_store || {}
-            });
-        }
-        else {
-            // Ensure connection is established
-            await connection.connect();
-        }
-        const className = class_name.toUpperCase();
-        utils_1.logger.info(`Starting class validation: ${className}`);
-        try {
-            const builder = new adt_clients_1.CrudClient(connection);
-            await builder.validateClass(className);
-            const result = builder.getValidationResult();
-            if (!result) {
-                throw new Error('Validation did not return a result');
-            }
-            // Get updated session state after validation
-            const updatedSessionState = connection.getSessionState();
-            utils_1.logger.info(`✅ ValidateClass completed: ${className}`);
-            utils_1.logger.info(`   Valid: ${result.valid}, Message: ${result.message || 'N/A'}`);
-            return (0, utils_1.return_response)({
-                data: JSON.stringify({
-                    success: result.valid,
-                    class_name: className,
-                    package_name: package_name || null,
-                    description: description || null,
-                    superclass: superclass || null,
-                    validation_result: result,
-                    session_id: session_id,
-                    session_state: updatedSessionState ? {
-                        cookies: updatedSessionState.cookies,
-                        csrf_token: updatedSessionState.csrfToken,
-                        cookie_store: updatedSessionState.cookieStore
-                    } : null,
-                    message: result.valid
-                        ? `Class name ${className} is valid and available`
-                        : `Class name ${className} validation failed: ${result.message || 'Unknown error'}`
-                }, null, 2)
-            });
-        }
-        catch (error) {
-            utils_1.logger.error(`Error validating class ${className}:`, error);
-            let errorMessage = `Failed to validate class: ${error.message || String(error)}`;
-            if (error.response?.status === 404) {
-                errorMessage = `Class ${className} not found.`;
-            }
-            else if (error.response?.data && typeof error.response.data === 'string') {
-                try {
-                    const { XMLParser } = require('fast-xml-parser');
-                    const parser = new XMLParser({
-                        ignoreAttributes: false,
-                        attributeNamePrefix: '@_'
-                    });
-                    const errorData = parser.parse(error.response.data);
-                    const errorMsg = errorData['exc:exception']?.message?.['#text'] || errorData['exc:exception']?.message;
-                    if (errorMsg) {
-                        errorMessage = `SAP Error: ${errorMsg}`;
-                    }
-                }
-                catch (parseError) {
-                    // Ignore parse errors
-                }
-            }
-            return (0, utils_1.return_error)(new Error(errorMessage));
-        }
-    }
-    catch (error) {
-        return (0, utils_1.return_error)(error);
-    }
-}

package/dist/handlers/class/readonly/handleGetClass.d.ts

@@ -1,20 +0,0 @@
-import * as z from 'zod';
-export declare const TOOL_DEFINITION: {
-    readonly name: "GetClass";
-    readonly description: "[read-only] Retrieve ABAP class source code.";
-    readonly inputSchema: {
-        readonly class_name: z.ZodString;
-    };
-};
-interface GetClassArgs {
-    [key: string]: any;
-}
-export declare function handleGetClass(args: GetClassArgs): Promise<{
-    isError: boolean;
-    content: {
-        type: string;
-        text: any;
-    }[];
-}>;
-export {};
-//# sourceMappingURL=handleGetClass.d.ts.map

package/dist/handlers/class/readonly/handleGetClass.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"handleGetClass.d.ts","sourceRoot":"","sources":["../../../../src/handlers/class/readonly/handleGetClass.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC;AAEX,UAAU,YAAY;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AA4DD,wBAAsB,cAAc,CAAC,IAAI,EAAE,YAAY;;;;;;GAsDtD"}

package/dist/handlers/class/readonly/handleGetClass.js

@@ -1,159 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TOOL_DEFINITION = void 0;
-exports.handleGetClass = handleGetClass;
-const utils_1 = require("../../../lib/utils");
-const adt_clients_1 = require("@mcp-abap-adt/adt-clients");
-const fast_xml_parser_1 = require("fast-xml-parser");
-const writeResultToFile_1 = require("../../../lib/writeResultToFile");
-const z = __importStar(require("zod"));
-exports.TOOL_DEFINITION = {
-    name: "GetClass",
-    description: "[read-only] Retrieve ABAP class source code.",
-    inputSchema: {
-        class_name: z.string().describe("Name of the ABAP class")
-    }
-};
-function parseClassXml(xml) {
-    const parser = new fast_xml_parser_1.XMLParser({
-        ignoreAttributes: false,
-        attributeNamePrefix: '',
-        parseAttributeValue: true,
-        trimValues: true
-    });
-    const result = parser.parse(xml);
-    // ADT Class XML (CLAS/OC)
-    if (result['oo:class']) {
-        const c = result['oo:class'];
-        // Method implementations extracted from the XML payload
-        let methodImpls = [];
-        const implSection = c['oo:methodImplementations']?.['oo:methodImplementation'];
-        if (Array.isArray(implSection)) {
-            methodImpls = implSection.map(m => ({
-                name: m['adtcore:name'],
-                source: m['oo:source']
-            }));
-        }
-        else if (implSection) {
-            methodImpls = [{
-                    name: implSection['adtcore:name'],
-                    source: implSection['oo:source']
-                }];
-        }
-        return {
-            name: c['adtcore:name'],
-            objectType: 'class',
-            description: c['adtcore:description'],
-            package: c['adtcore:packageRef']?.['adtcore:name'] || null,
-            superClass: c['oo:superClass']?.['adtcore:name'] || null,
-            interfaces: Array.isArray(c['oo:interfaces']?.['oo:interface'])
-                ? c['oo:interfaces']['oo:interface'].map(i => i['adtcore:name'])
-                : c['oo:interfaces']?.['oo:interface']
-                    ? [c['oo:interfaces']['oo:interface']['adtcore:name']]
-                    : [],
-            methods: Array.isArray(c['oo:methods']?.['oo:method'])
-                ? c['oo:methods']['oo:method'].map(m => m['adtcore:name'])
-                : c['oo:methods']?.['oo:method']
-                    ? [c['oo:methods']['oo:method']['adtcore:name']]
-                    : [],
-            attributes: Array.isArray(c['oo:attributes']?.['oo:attribute'])
-                ? c['oo:attributes']['oo:attribute'].map(a => a['adtcore:name'])
-                : c['oo:attributes']?.['oo:attribute']
-                    ? [c['oo:attributes']['oo:attribute']['adtcore:name']]
-                    : [],
-            methodImplementations: methodImpls
-        };
-    }
-    // fallback: return raw
-    return { raw: result };
-}
-async function handleGetClass(args) {
-    try {
-        if (!args?.class_name) {
-            throw new utils_1.McpError(utils_1.ErrorCode.InvalidParams, 'Class name is required');
-        }
-        const connection = (0, utils_1.getManagedConnection)();
-        const client = new adt_clients_1.CrudClient(connection);
-        await client.readClass(args.class_name);
-        const response = client.getReadResult();
-        if (!response) {
-            throw new utils_1.McpError(utils_1.ErrorCode.InternalError, 'Failed to read class');
-        }
-        // Parse XML responses; otherwise return the payload unchanged
-        if (typeof response.data === 'string' && response.data.trim().startsWith('<?xml')) {
-            const resultObj = parseClassXml(response.data);
-            const result = {
-                isError: false,
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify(resultObj, null, 2)
-                    }
-                ]
-            };
-            if (args.filePath) {
-                (0, writeResultToFile_1.writeResultToFile)(JSON.stringify(result, null, 2), args.filePath);
-            }
-            return result;
-        }
-        else {
-            // Plain text responses still follow the MCP wrapper format
-            if (args.filePath) {
-                (0, writeResultToFile_1.writeResultToFile)(response.data, args.filePath);
-            }
-            return {
-                isError: false,
-                content: [
-                    {
-                        type: "text",
-                        text: response.data
-                    }
-                ]
-            };
-        }
-    }
-    catch (error) {
-        return {
-            isError: true,
-            content: [
-                {
-                    type: "text",
-                    text: error instanceof Error ? error.message : String(error)
-                }
-            ]
-        };
-    }
-}

package/dist/handlers/common/handleActivateObject.d.ts

@@ -1,62 +0,0 @@
-/**
- * ActivateObject Handler - Universal ABAP Object Activation via ADT API
- *
- * Uses activateObjectsGroup and parseActivationResponse from @mcp-abap-adt/adt-clients/core for all operations.
- * Connection management handled internally.
- *
- * Activates one or multiple ABAP repository objects using ADT activation endpoint.
- * This is a stateless operation - no session management or locking required.
- */
-export declare const TOOL_DEFINITION: {
-    readonly name: "ActivateObject";
-    readonly description: "Activate one or multiple ABAP repository objects. Works with any object type: classes, programs, tables, views, domains, data elements, etc. URI is auto-generated from name and type. Returns activation status and any warnings/errors.";
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly objects: {
-                readonly type: "array";
-                readonly description: "Array of objects to activate. Each object must have 'name' and 'type'. URI is auto-generated.";
-                readonly items: {
-                    readonly type: "object";
-                    readonly properties: {
-                        readonly name: {
-                            readonly type: "string";
-                            readonly description: "Object name in uppercase (e.g., 'ZCL_MY_CLASS', 'Z_MY_PROGRAM', 'ZOK_I_MARKET_0001')";
-                        };
-                        readonly type: {
-                            readonly type: "string";
-                            readonly description: "Object type code (e.g., 'CLAS/OC', 'PROG/P', 'DDLS/DF', 'TABL/DT'). URI will be auto-generated from this.";
-                        };
-                        readonly uri: {
-                            readonly type: "string";
-                            readonly description: "Optional: Object URI in ADT format. If not provided, will be auto-generated from name and type.";
-                        };
-                    };
-                    readonly required: readonly ["name", "type"];
-                };
-            };
-            readonly preaudit: {
-                readonly type: "boolean";
-                readonly description: "Request pre-audit before activation. Default: true";
-            };
-        };
-        readonly required: readonly ["objects"];
-    };
-};
-/**
- * Main handler for ActivateObject MCP tool
- *
- * Uses activateObjectsGroup and parseActivationResponse from @mcp-abap-adt/adt-clients/core for all operations
- * Connection management handled internally
- *
- * This is a stateless operation - no session management needed.
- * Activation endpoint handles multiple objects in one request.
- */
-export declare function handleActivateObject(params: any): Promise<{
-    isError: boolean;
-    content: {
-        type: string;
-        text: any;
-    }[];
-}>;
-//# sourceMappingURL=handleActivateObject.d.ts.map

package/dist/handlers/common/handleActivateObject.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"handleActivateObject.d.ts","sourceRoot":"","sources":["../../../src/handlers/common/handleActivateObject.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmClB,CAAC;AAaX;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,GAAG;;;;;;GAyFrD"}