@mcp-abap-adt/adt-clients 0.1.0

package/dist/core/class/validation.js

@@ -0,0 +1,269 @@
+"use strict";
+/**
+ * Class validation
+ */
+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.validateClassName = validateClassName;
+exports.validateClassSource = validateClassSource;
+const connection_1 = require("@mcp-abap-adt/connection");
+const fast_xml_parser_1 = require("fast-xml-parser");
+const internalUtils_1 = require("../../utils/internalUtils");
+const debugEnabled = process.env.DEBUG_TESTS === 'true';
+const logger = {
+    debug: debugEnabled ? console.log : () => { },
+    error: debugEnabled ? console.error : () => { },
+};
+/**
+ * Validate class name and superclass
+ * Uses ADT validation endpoint: /sap/bc/adt/oo/validation/objectname
+ */
+async function validateClassName(connection, className, packageName, description, superClass) {
+    const baseUrl = await connection.getBaseUrl();
+    const encodedName = (0, internalUtils_1.encodeSapObjectName)(className);
+    // Build query parameters for class validation
+    const params = new URLSearchParams({
+        objname: encodedName,
+        objtype: 'CLAS/OC'
+    });
+    if (packageName) {
+        params.append('packagename', packageName);
+    }
+    if (description) {
+        params.append('description', description);
+    }
+    if (superClass) {
+        params.append('superClass', superClass);
+    }
+    const url = `${baseUrl}/sap/bc/adt/oo/validation/objectname?${params.toString()}`;
+    const headers = {
+        'Accept': 'application/vnd.sap.as+xml;charset=UTF-8;dataname=com.sap.adt.oo.clifname.check'
+    };
+    // Log request details for debugging
+    logger.debug(`[DEBUG] Validating class - URL: ${url}`);
+    logger.debug(`[DEBUG] Validating class - Method: POST`);
+    logger.debug(`[DEBUG] Validating class - Headers:`, JSON.stringify(headers, null, 2));
+    logger.debug(`[DEBUG] Validating class - Query params:`, params.toString());
+    try {
+        const response = await connection.makeAdtRequest({
+            url,
+            method: 'POST',
+            timeout: (0, connection_1.getTimeout)('default'),
+            headers
+        });
+        logger.debug(`[DEBUG] Validation response - Status: ${response.status}`);
+        logger.debug(`[DEBUG] Validation response - Data:`, typeof response.data === 'string' ? response.data.substring(0, 500) : JSON.stringify(response.data).substring(0, 500));
+        // Parse response data - Eclipse returns XML with CHECK_RESULT
+        if (response.data) {
+            const responseData = typeof response.data === 'string'
+                ? response.data
+                : JSON.stringify(response.data);
+            try {
+                const parser = new fast_xml_parser_1.XMLParser({
+                    ignoreAttributes: false,
+                    attributeNamePrefix: '@_',
+                    textNodeName: '#text'
+                });
+                const result = parser.parse(responseData);
+                // Check for validation result in Eclipse format:
+                // <asx:abap><asx:values><DATA><CHECK_RESULT>X</CHECK_RESULT></DATA></asx:values></asx:abap>
+                const checkResult = result?.['asx:abap']?.['asx:values']?.['DATA']?.['CHECK_RESULT'];
+                if (checkResult === 'X') {
+                    logger.debug(`[DEBUG] Validation succeeded - CHECK_RESULT=X`);
+                    return { valid: true };
+                }
+                // Check if response contains exception/error
+                const exception = result['exc:exception'];
+                if (exception) {
+                    // Extract message
+                    let message = '';
+                    if (exception['message']) {
+                        if (typeof exception['message'] === 'string') {
+                            message = exception['message'];
+                        }
+                        else if (exception['message']['#text']) {
+                            message = exception['message']['#text'];
+                        }
+                        else if (Array.isArray(exception['message']) && exception['message'][0]?.['#text']) {
+                            message = exception['message'][0]['#text'];
+                        }
+                    }
+                    // Fallback to localizedMessage
+                    if (!message && exception['localizedMessage']) {
+                        if (typeof exception['localizedMessage'] === 'string') {
+                            message = exception['localizedMessage'];
+                        }
+                        else if (exception['localizedMessage']['#text']) {
+                            message = exception['localizedMessage']['#text'];
+                        }
+                        else if (Array.isArray(exception['localizedMessage']) && exception['localizedMessage'][0]?.['#text']) {
+                            message = exception['localizedMessage'][0]['#text'];
+                        }
+                    }
+                    logger.debug(`[DEBUG] Validation failed - Exception: ${message}`);
+                    return {
+                        valid: false,
+                        severity: 'ERROR',
+                        message: message || 'Validation failed',
+                        longText: message
+                    };
+                }
+            }
+            catch (parseError) {
+                logger.debug(`[DEBUG] Failed to parse validation response:`, parseError);
+            }
+        }
+        // If no CHECK_RESULT found but no exception, assume valid
+        logger.debug(`[DEBUG] Validation succeeded - no exceptions found`);
+        return { valid: true };
+    }
+    catch (error) {
+        // Log error details for debugging
+        if (error.response) {
+            logger.error(`[ERROR] Validation failed - Status: ${error.response.status}`);
+            logger.error(`[ERROR] Validation failed - StatusText: ${error.response.statusText}`);
+            logger.error(`[ERROR] Validation failed - Response headers:`, JSON.stringify(error.response.headers, null, 2));
+            logger.error(`[ERROR] Validation failed - Response data (first 1000 chars):`, typeof error.response.data === 'string'
+                ? error.response.data.substring(0, 1000)
+                : JSON.stringify(error.response.data).substring(0, 1000));
+        }
+        // Parse error response to extract validation message
+        if (error.response?.data) {
+            const responseData = typeof error.response.data === 'string'
+                ? error.response.data
+                : JSON.stringify(error.response.data);
+            // Try to parse XML error response
+            try {
+                const parser = new fast_xml_parser_1.XMLParser({
+                    ignoreAttributes: false,
+                    attributeNamePrefix: '@_',
+                    textNodeName: '#text'
+                });
+                const result = parser.parse(responseData);
+                const exception = result['exc:exception'];
+                if (exception) {
+                    // Extract message - XML structure: <message lang="EN">text</message>
+                    let message = '';
+                    if (exception['message']) {
+                        if (typeof exception['message'] === 'string') {
+                            message = exception['message'];
+                        }
+                        else if (exception['message']['#text']) {
+                            message = exception['message']['#text'];
+                        }
+                        else if (Array.isArray(exception['message']) && exception['message'][0]?.['#text']) {
+                            message = exception['message'][0]['#text'];
+                        }
+                    }
+                    // Fallback to localizedMessage
+                    if (!message && exception['localizedMessage']) {
+                        if (typeof exception['localizedMessage'] === 'string') {
+                            message = exception['localizedMessage'];
+                        }
+                        else if (exception['localizedMessage']['#text']) {
+                            message = exception['localizedMessage']['#text'];
+                        }
+                        else if (Array.isArray(exception['localizedMessage']) && exception['localizedMessage'][0]?.['#text']) {
+                            message = exception['localizedMessage'][0]['#text'];
+                        }
+                    }
+                    const type = typeof exception['type'] === 'string'
+                        ? exception['type']
+                        : exception['type']?.['#text'] || exception['type']?.['@_id'] || '';
+                    return {
+                        valid: false,
+                        severity: 'ERROR',
+                        message: message || 'Validation failed',
+                        longText: message
+                    };
+                }
+            }
+            catch (parseError) {
+                // If parsing fails, use raw response
+            }
+            // Extract error message from response
+            const errorMatch = responseData.match(/<message[^>]*>([^<]+)<\/message>/i);
+            const message = errorMatch ? errorMatch[1] : 'Validation failed';
+            return {
+                valid: false,
+                severity: 'ERROR',
+                message: message,
+                longText: responseData.substring(0, 500)
+            };
+        }
+        // If validation endpoint returns 404, it may not be supported in this SAP version
+        if (error.response?.status === 404) {
+            // Silently pass - older SAP systems may not have validation endpoint
+            return { valid: true };
+        }
+        // For other errors, return as validation failure
+        return {
+            valid: false,
+            severity: 'ERROR',
+            message: error.message || 'Validation request failed'
+        };
+    }
+}
+/**
+ * Validate class source code.
+ *
+ * If sourceCode is provided: validates unsaved code (live validation with artifacts)
+ * If sourceCode is not provided: validates existing class code in SAP system (without artifacts)
+ *
+ * @param connection - SAP connection
+ * @param className - Class name
+ * @param sourceCode - Optional: source code to validate. If omitted, validates existing class in SAP
+ * @param version - 'active' (default) or 'inactive' - version context for validation
+ * @param sessionId - Optional session ID
+ * @returns Check result with errors/warnings
+ * @throws Error if validation finds syntax errors
+ */
+async function validateClassSource(connection, className, sourceCode, version = 'active', sessionId) {
+    const { runCheckRun, runCheckRunWithSource, parseCheckRunResponse } = await Promise.resolve().then(() => __importStar(require('../shared/checkRun')));
+    let response;
+    if (sourceCode) {
+        // Live validation with artifacts (code not saved to SAP)
+        response = await runCheckRunWithSource(connection, 'class', className, sourceCode, version, 'abapCheckRun', sessionId);
+    }
+    else {
+        // Validate existing object in SAP (without artifacts)
+        response = await runCheckRun(connection, 'class', className, version, 'abapCheckRun', sessionId);
+    }
+    const checkResult = parseCheckRunResponse(response);
+    if (!checkResult.success || checkResult.has_errors) {
+        throw new Error(`Source validation failed: ${checkResult.message}`);
+    }
+    return response;
+}

package/dist/core/dataElement/DataElementBuilder.d.ts

@@ -0,0 +1,113 @@
+/**
+ * DataElementBuilder - Fluent API for data element operations with Promise chaining
+ *
+ * Supports:
+ * - Method chaining: builder.create().then(b => b.lock()).then(b => b.update())...
+ * - Error handling: .catch() for error callbacks
+ * - Cleanup: .finally() for guaranteed execution
+ * - Result storage: all results stored in logger/state
+ * - Chain interruption: chain stops on first error (standard Promise behavior)
+ */
+import { AbapConnection } from '@mcp-abap-adt/connection';
+import { AxiosResponse } from 'axios';
+import { ValidationResult } from '../shared/validation';
+export interface DataElementBuilderLogger {
+    debug?: (message: string, ...args: any[]) => void;
+    info?: (message: string, ...args: any[]) => void;
+    warn?: (message: string, ...args: any[]) => void;
+    error?: (message: string, ...args: any[]) => void;
+}
+export interface DataElementBuilderConfig {
+    dataElementName: string;
+    packageName?: string;
+    transportRequest?: string;
+    description?: string;
+    domainName?: string;
+    dataType?: string;
+    length?: number;
+    decimals?: number;
+    shortLabel?: string;
+    mediumLabel?: string;
+    longLabel?: string;
+    headingLabel?: string;
+    typeKind?: 'domain' | 'predefinedAbapType' | 'refToPredefinedAbapType' | 'refToDictionaryType' | 'refToClifType';
+    typeName?: string;
+    sessionId?: string;
+    onLock?: (lockHandle: string, sessionId: string) => void;
+}
+export interface DataElementBuilderState {
+    validationResult?: ValidationResult;
+    createResult?: AxiosResponse;
+    readResult?: AxiosResponse;
+    lockHandle?: string;
+    updateResult?: AxiosResponse;
+    checkResult?: AxiosResponse;
+    unlockResult?: AxiosResponse;
+    activateResult?: AxiosResponse;
+    errors: Array<{
+        method: string;
+        error: Error;
+        timestamp: Date;
+    }>;
+}
+export declare class DataElementBuilder {
+    private connection;
+    private logger;
+    private config;
+    private lockHandle?;
+    private sessionId;
+    private state;
+    constructor(connection: AbapConnection, logger: DataElementBuilderLogger, config: DataElementBuilderConfig);
+    setPackage(packageName: string): this;
+    setRequest(transportRequest: string): this;
+    setName(dataElementName: string): this;
+    setDescription(description: string): this;
+    setDomainName(domainName: string): this;
+    setDataType(dataType: string): this;
+    setLength(length: number): this;
+    setDecimals(decimals: number): this;
+    setShortLabel(shortLabel: string): this;
+    setMediumLabel(mediumLabel: string): this;
+    setLongLabel(longLabel: string): this;
+    setHeadingLabel(headingLabel: string): this;
+    setTypeKind(typeKind: 'domain' | 'predefinedAbapType' | 'refToPredefinedAbapType' | 'refToDictionaryType' | 'refToClifType'): this;
+    setTypeName(typeName: string): this;
+    validate(): Promise<this>;
+    read(): Promise<this>;
+    create(): Promise<this>;
+    lock(): Promise<this>;
+    update(): Promise<this>;
+    check(version?: 'active' | 'inactive'): Promise<this>;
+    unlock(): Promise<this>;
+    activate(): Promise<this>;
+    forceUnlock(): Promise<void>;
+    getState(): Readonly<DataElementBuilderState>;
+    getDataElementName(): string;
+    getLockHandle(): string | undefined;
+    getSessionId(): string;
+    getReadResult(): AxiosResponse | undefined;
+    getCreateResult(): AxiosResponse | undefined;
+    getUpdateResult(): AxiosResponse | undefined;
+    getCheckResult(): AxiosResponse | undefined;
+    getUnlockResult(): AxiosResponse | undefined;
+    getActivateResult(): AxiosResponse | undefined;
+    getErrors(): ReadonlyArray<{
+        method: string;
+        error: Error;
+        timestamp: Date;
+    }>;
+    getResults(): {
+        create?: AxiosResponse;
+        update?: AxiosResponse;
+        check?: AxiosResponse;
+        unlock?: AxiosResponse;
+        activate?: AxiosResponse;
+        lockHandle?: string;
+        errors: Array<{
+            method: string;
+            error: Error;
+            timestamp: Date;
+        }>;
+    };
+}
+//# sourceMappingURL=DataElementBuilder.d.ts.map

package/dist/core/dataElement/DataElementBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataElementBuilder.d.ts","sourceRoot":"","sources":["../../../src/core/dataElement/DataElementBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAUtC,OAAO,EAAsB,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE5E,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAClD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IACjD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IACjD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,wBAAwB;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,GAAG,oBAAoB,GAAG,yBAAyB,GAAG,qBAAqB,GAAG,eAAe,CAAC;IACjH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,cAAc,CAAC,EAAE,aAAa,CAAC;IAC/B,MAAM,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;QAAC,SAAS,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;CAClE;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAA0B;gBAGrC,UAAU,EAAE,cAAc,EAC1B,MAAM,EAAE,wBAAwB,EAChC,MAAM,EAAE,wBAAwB;IAYlC,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAMrC,UAAU,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAM1C,OAAO,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI;IAMtC,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKzC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKvC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKnC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKnC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKvC,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKzC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKrC,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAK3C,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,oBAAoB,GAAG,yBAAyB,GAAG,qBAAqB,GAAG,eAAe,GAAG,IAAI;IAKlI,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAM7B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA8DzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBrB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IA4CvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BrB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAoFvB,KAAK,CAAC,OAAO,GAAE,QAAQ,GAAG,UAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCjE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BvB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBzB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBlC,QAAQ,IAAI,QAAQ,CAAC,uBAAuB,CAAC;IAI7C,kBAAkB,IAAI,MAAM;IAI5B,aAAa,IAAI,MAAM,GAAG,SAAS;IAInC,YAAY,IAAI,MAAM;IAItB,aAAa,IAAI,aAAa,GAAG,SAAS;IAI1C,eAAe,IAAI,aAAa,GAAG,SAAS;IAI5C,eAAe,IAAI,aAAa,GAAG,SAAS;IAI5C,cAAc,IAAI,aAAa,GAAG,SAAS;IAI3C,eAAe,IAAI,aAAa,GAAG,SAAS;IAI5C,iBAAiB,IAAI,aAAa,GAAG,SAAS;IAI9C,SAAS,IAAI,aAAa,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;QAAC,SAAS,EAAE,IAAI,CAAA;KAAE,CAAC;IAK7E,UAAU,IAAI;QACZ,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,KAAK,CAAC,EAAE,aAAa,CAAC;QACtB,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,QAAQ,CAAC,EAAE,aAAa,CAAC;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,KAAK,CAAC;YAAC,SAAS,EAAE,IAAI,CAAA;SAAE,CAAC,CAAC;KAClE;CAWF"}