@mcp-abap-adt/core 4.7.1 → 4.8.2

package/dist/src/lib/logger.js

@@ -0,0 +1,323 @@
+"use strict";
+/**
+ * Logger module for MCP-compatible logging
+ *
+ * This file provides logging utilities that work both in regular console mode
+ * and with the MCP Inspector. It avoids direct console.log calls which can
+ * interfere with MCP's JSON-RPC communication.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectionManagerLogger = exports.handlerLogger = exports.logger = void 0;
+/**
+ * Safely stringifies an object, handling circular references
+ */
+function safeStringify(obj) {
+    const seen = new WeakSet();
+    return JSON.stringify(obj, (key, value) => {
+        if (typeof value === 'object' && value !== null) {
+            if (seen.has(value)) {
+                return '[Circular]';
+            }
+            seen.add(value);
+        }
+        // Remove common circular reference sources
+        if (key === 'socket' ||
+            key === '_httpMessage' ||
+            key === 'res' ||
+            key === 'req') {
+            return '[HTTP Object]';
+        }
+        // Remove sensitive headers (Authorization, Cookie, etc.)
+        if (key === 'Authorization' || key === 'authorization') {
+            return '[REDACTED]';
+        }
+        // Remove sensitive data from config.headers
+        if (key === 'headers' && value && typeof value === 'object') {
+            const sanitizedHeaders = {};
+            for (const [headerKey, headerValue] of Object.entries(value)) {
+                if (headerKey.toLowerCase() === 'authorization' ||
+                    headerKey.toLowerCase() === 'cookie' ||
+                    headerKey.toLowerCase() === 'x-csrf-token') {
+                    sanitizedHeaders[headerKey] = '[REDACTED]';
+                }
+                else {
+                    sanitizedHeaders[headerKey] = headerValue;
+                }
+            }
+            return sanitizedHeaders;
+        }
+        // Remove sensitive data from config object (AxiosError.config)
+        if (key === 'config' && value && typeof value === 'object') {
+            const sanitizedConfig = {};
+            for (const [configKey, configValue] of Object.entries(value)) {
+                if (configKey === 'headers' &&
+                    configValue &&
+                    typeof configValue === 'object') {
+                    const sanitizedHeaders = {};
+                    for (const [headerKey, headerValue] of Object.entries(configValue)) {
+                        if (headerKey.toLowerCase() === 'authorization' ||
+                            headerKey.toLowerCase() === 'cookie' ||
+                            headerKey.toLowerCase() === 'x-csrf-token') {
+                            sanitizedHeaders[headerKey] = '[REDACTED]';
+                        }
+                        else {
+                            sanitizedHeaders[headerKey] = headerValue;
+                        }
+                    }
+                    sanitizedConfig[configKey] = sanitizedHeaders;
+                }
+                else {
+                    sanitizedConfig[configKey] = configValue;
+                }
+            }
+            return sanitizedConfig;
+        }
+        return value;
+    });
+}
+// Logger functions for different log levels
+function createLogFn(level) {
+    return (message, data) => {
+        // Never log in stdio mode (MCP protocol requires clean JSON only)
+        const isStdio = process.env.MCP_TRANSPORT === 'stdio' ||
+            process.argv.includes('--transport=stdio') ||
+            process.argv.includes('--stdio');
+        if (isStdio) {
+            return; // Suppress all logging in stdio mode
+        }
+        // Check if this is an expected validation/creation error (should be suppressed)
+        if (level === 'ERROR' && data?.status === 400) {
+            // Check if it's an expected error type (validation or resource already exists)
+            const url = data?.url || '';
+            const dataStr = typeof data?.data === 'string'
+                ? data?.data
+                : data?.data
+                    ? safeStringify(data.data)
+                    : '';
+            const responseData = data?.response?.data || '';
+            const allData = dataStr + responseData;
+            // Check if it's a validation endpoint OR an expected error type
+            const isValidationEndpoint = url.includes('/validation/objectname') || url.includes('/validation/');
+            const isExpectedError = allData.includes('InvalidClifName') ||
+                allData.includes('ExceptionResourceAlreadyExists') ||
+                allData.includes('ResourceAlreadyExists') ||
+                allData.includes('InvalidObjName') ||
+                allData.includes('does already exist');
+            if (isValidationEndpoint || isExpectedError) {
+                // Suppress expected errors - only log if debug is enabled
+                const debugEnabled = process.env.DEBUG_CONNECTORS === 'true' ||
+                    process.env.DEBUG_TESTS === 'true' ||
+                    process.env.DEBUG_ADT_TESTS === 'true';
+                if (!debugEnabled) {
+                    return; // Suppress expected errors
+                }
+            }
+        }
+        // Also check AxiosError format (second ERROR log format)
+        if (level === 'ERROR' &&
+            data?.name === 'AxiosError' &&
+            data?.status === 400) {
+            const responseData = data?.response?.data || '';
+            const _configUrl = data?.config?.url || '';
+            const allData = typeof responseData === 'string'
+                ? responseData
+                : safeStringify(responseData);
+            // Check if it's an expected error type
+            const isExpectedError = allData.includes('InvalidClifName') ||
+                allData.includes('ExceptionResourceAlreadyExists') ||
+                allData.includes('ResourceAlreadyExists') ||
+                allData.includes('InvalidObjName') ||
+                allData.includes('does already exist');
+            if (isExpectedError) {
+                // Suppress expected errors - only log if debug is enabled
+                const debugEnabled = process.env.DEBUG_CONNECTORS === 'true' ||
+                    process.env.DEBUG_TESTS === 'true' ||
+                    process.env.DEBUG_ADT_TESTS === 'true';
+                if (!debugEnabled) {
+                    return; // Suppress expected errors
+                }
+            }
+        }
+        // All log levels (including ERROR) require DEBUG_CONNECTORS, DEBUG_TESTS, or DEBUG_ADT_TESTS to be enabled
+        // This prevents verbose error logs from appearing in test output when debug is not enabled
+        const debugEnabled = process.env.DEBUG_CONNECTORS === 'true' ||
+            process.env.DEBUG_TESTS === 'true' ||
+            process.env.DEBUG_ADT_TESTS === 'true';
+        const shouldLog = debugEnabled;
+        if (shouldLog) {
+            // In debug mode with MCP Inspector, use process.stderr instead of console.log
+            // This avoids interfering with MCP's JSON-RPC protocol
+            const logObject = {
+                level,
+                timestamp: new Date().toISOString(),
+                message,
+                ...data,
+            };
+            // Output to stderr which won't interfere with MCP communication
+            // Use safe stringify to avoid circular reference errors
+            try {
+                process.stderr.write(`${safeStringify(logObject)}\n`);
+            }
+            catch (_e) {
+                // Fallback if safe stringify still fails
+                process.stderr.write(`${JSON.stringify({
+                    level,
+                    timestamp: new Date().toISOString(),
+                    message,
+                    error: 'Failed to serialize log data',
+                })}\n`);
+            }
+        }
+    };
+}
+// Export log functions
+exports.logger = {
+    info: createLogFn('INFO'),
+    warn: createLogFn('WARN'),
+    error: createLogFn('ERROR'),
+    debug: createLogFn('DEBUG'),
+    // Special handler for TLS config
+    tlsConfig: (rejectUnauthorized) => {
+        // Never log in stdio mode
+        const isStdio = process.env.MCP_TRANSPORT === 'stdio' ||
+            process.argv.includes('--transport=stdio') ||
+            process.argv.includes('--stdio');
+        if (isStdio) {
+            return; // Suppress all logging in stdio mode
+        }
+        const debugEnabled = process.env.DEBUG_CONNECTORS === 'true';
+        if (debugEnabled) {
+            const message = `TLS certificate validation is ${rejectUnauthorized ? 'enabled' : 'disabled'}`;
+            process.stderr.write(`${JSON.stringify({
+                level: 'INFO',
+                timestamp: new Date().toISOString(),
+                type: 'TLS_CONFIG',
+                message,
+                rejectUnauthorized,
+            })}\n`);
+        }
+    },
+    // Special handler for CSRF token
+    csrfToken: (type, message, data) => {
+        // Never log in stdio mode
+        const isStdio = process.env.MCP_TRANSPORT === 'stdio' ||
+            process.argv.includes('--transport=stdio') ||
+            process.argv.includes('--stdio');
+        if (isStdio) {
+            return; // Suppress all logging in stdio mode
+        }
+        const debugEnabled = process.env.DEBUG_CONNECTORS === 'true';
+        if (debugEnabled) {
+            process.stderr.write(`${JSON.stringify({
+                level: type === 'error' ? 'ERROR' : 'INFO',
+                timestamp: new Date().toISOString(),
+                type: `CSRF_${type.toUpperCase()}`,
+                message,
+                ...data,
+            })}\n`);
+        }
+    },
+};
+/**
+ * Handler-specific logger for detailed debugging
+ * Enabled via DEBUG_HANDLERS=true environment variable
+ */
+function createHandlerLogFn(level) {
+    return (handlerName, step, message, data) => {
+        // Never log in stdio mode
+        const isStdio = process.env.MCP_TRANSPORT === 'stdio' ||
+            process.argv.includes('--transport=stdio') ||
+            process.argv.includes('--stdio');
+        if (isStdio) {
+            return; // Suppress all logging in stdio mode
+        }
+        const debugEnabled = process.env.DEBUG_HANDLERS === 'true';
+        if (debugEnabled) {
+            const logObject = {
+                level,
+                timestamp: new Date().toISOString(),
+                handler: handlerName,
+                step,
+                message,
+                ...data,
+            };
+            try {
+                process.stderr.write(`${safeStringify(logObject)}\n`);
+            }
+            catch (_e) {
+                process.stderr.write(`${JSON.stringify({
+                    level,
+                    timestamp: new Date().toISOString(),
+                    handler: handlerName,
+                    step,
+                    message,
+                    error: 'Failed to serialize log data',
+                })}\n`);
+            }
+        }
+    };
+}
+exports.handlerLogger = {
+    info: (handlerName, step, message, data) => {
+        createHandlerLogFn('INFO')(handlerName, step, message, data);
+    },
+    warn: (handlerName, step, message, data) => {
+        createHandlerLogFn('WARN')(handlerName, step, message, data);
+    },
+    error: (handlerName, step, message, data) => {
+        createHandlerLogFn('ERROR')(handlerName, step, message, data);
+    },
+    debug: (handlerName, step, message, data) => {
+        createHandlerLogFn('DEBUG')(handlerName, step, message, data);
+    },
+};
+/**
+ * Connection manager logger - for getManagedConnection debug logs
+ * Enabled via DEBUG_CONNECTION_MANAGER=true environment variable
+ */
+function createConnectionManagerLogFn(level) {
+    return (message, data) => {
+        // Never log in stdio mode
+        const isStdio = process.env.MCP_TRANSPORT === 'stdio' ||
+            process.argv.includes('--transport=stdio') ||
+            process.argv.includes('--stdio');
+        if (isStdio) {
+            return; // Suppress all logging in stdio mode
+        }
+        const debugEnabled = process.env.DEBUG_CONNECTION_MANAGER === 'true';
+        if (debugEnabled) {
+            const logObject = {
+                level,
+                timestamp: new Date().toISOString(),
+                message,
+                ...data,
+            };
+            try {
+                process.stderr.write(`${safeStringify(logObject)}\n`);
+            }
+            catch (_e) {
+                process.stderr.write(`${JSON.stringify({
+                    level,
+                    timestamp: new Date().toISOString(),
+                    message,
+                    error: 'Failed to serialize log data',
+                })}\n`);
+            }
+        }
+    };
+}
+exports.connectionManagerLogger = {
+    debug: (message, data) => {
+        createConnectionManagerLogFn('DEBUG')(message, data);
+    },
+    info: (message, data) => {
+        createConnectionManagerLogFn('INFO')(message, data);
+    },
+    warn: (message, data) => {
+        createConnectionManagerLogFn('WARN')(message, data);
+    },
+    error: (message, data) => {
+        createConnectionManagerLogFn('ERROR')(message, data);
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/src/lib/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/lib/logger.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/loggerAdapter.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Logger adapter that wraps the server logger to implement ILogger interface
+ * from @mcp-abap-adt/interfaces package
+ */
+import type { ILogger } from '@mcp-abap-adt/interfaces';
+/**
+ * Adapter that implements ILogger interface using the server's logger
+ *
+ * Note: The ILogger interface only includes basic logging methods (info, error, warn, debug).
+ * Additional methods like csrfToken and tlsConfig are handled by the server logger directly
+ * and are not part of the ILogger interface.
+ */
+export declare const loggerAdapter: ILogger;
+//# sourceMappingURL=loggerAdapter.d.ts.map

package/dist/src/lib/loggerAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggerAdapter.d.ts","sourceRoot":"","sources":["../../../src/lib/loggerAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,OAa3B,CAAC"}

package/dist/src/lib/loggerAdapter.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loggerAdapter = void 0;
+const logger_1 = require("./logger");
+/**
+ * Adapter that implements ILogger interface using the server's logger
+ *
+ * Note: The ILogger interface only includes basic logging methods (info, error, warn, debug).
+ * Additional methods like csrfToken and tlsConfig are handled by the server logger directly
+ * and are not part of the ILogger interface.
+ */
+exports.loggerAdapter = {
+    info: (message, meta) => {
+        logger_1.logger?.info(message, meta);
+    },
+    error: (message, meta) => {
+        logger_1.logger?.error(message, meta);
+    },
+    warn: (message, meta) => {
+        logger_1.logger?.warn(message, meta);
+    },
+    debug: (message, meta) => {
+        logger_1.logger?.debug(message, meta);
+    },
+};
+//# sourceMappingURL=loggerAdapter.js.map

package/dist/src/lib/loggerAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggerAdapter.js","sourceRoot":"","sources":["../../../src/lib/loggerAdapter.ts"],"names":[],"mappings":";;;AAKA,qCAAkC;AAElC;;;;;;GAMG;AACU,QAAA,aAAa,GAAY;IACpC,IAAI,EAAE,CAAC,OAAe,EAAE,IAAU,EAAE,EAAE;QACpC,eAAM,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD,KAAK,EAAE,CAAC,OAAe,EAAE,IAAU,EAAE,EAAE;QACrC,eAAM,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,EAAE,CAAC,OAAe,EAAE,IAAU,EAAE,EAAE;QACpC,eAAM,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD,KAAK,EAAE,CAAC,OAAe,EAAE,IAAU,EAAE,EAAE;QACrC,eAAM,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;CACF,CAAC"}

package/dist/src/lib/sessionUtils.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Session Management Utilities for SAP ADT Stateful Operations
+ *
+ * This module provides centralized utilities for managing stateful sessions
+ * when interacting with SAP ADT (ABAP Development Tools) API.
+ *
+ * Key concepts:
+ * - Session ID (sap-adt-connection-id): Unique identifier for the entire operation
+ *   Must be the SAME for all requests (LOCK → PUT → UNLOCK) within one operation
+ *
+ * - Request ID (sap-adt-request-id): Unique identifier for each individual request
+ *   Must be DIFFERENT for every request within a session
+ *
+ * - Stateful Session: Required for operations that modify ABAP objects
+ *   (create/update source code, lock management, transport handling)
+ *
+ * Usage:
+ * ```typescript
+ * import { generateSessionId, makeAdtRequestWithSession } from '../lib/sessionUtils';
+ *
+ * const sessionId = generateSessionId();
+ *
+ * // All requests use the same sessionId
+ * await makeAdtRequestWithSession(lockUrl, 'POST', sessionId);
+ * await makeAdtRequestWithSession(putUrl, 'PUT', sessionId, sourceCode);
+ * await makeAdtRequestWithSession(unlockUrl, 'POST', sessionId);
+ * ```
+ *
+ * @see doc/architecture/STATEFUL_SESSION_GUIDE.md for detailed documentation
+ */
+import type { IAbapConnection } from '@mcp-abap-adt/interfaces';
+import type { AxiosResponse } from 'axios';
+/**
+ * Generate unique session ID for ADT stateful operations
+ *
+ * This ID must be used consistently across all requests within a single operation
+ * (e.g., LOCK → PUT → UNLOCK sequence). Using different session IDs will cause
+ * "invalid lock handle" errors.
+ *
+ * Format: 32-character hexadecimal string (UUID without hyphens)
+ * Example: "a1b2c3d4e5f67890123456789abcdef0"
+ *
+ * @returns Unique session ID for sap-adt-connection-id header
+ */
+export declare function generateSessionId(): string;
+/**
+ * Generate unique request ID for each individual ADT request
+ *
+ * Each request within a session must have a different request ID.
+ * This is used for tracking and debugging purposes.
+ *
+ * Format: 32-character hexadecimal string (UUID without hyphens)
+ * Example: "f0e1d2c3b4a5968778695a4b3c2d1e0f"
+ *
+ * @returns Unique request ID for sap-adt-request-id header
+ */
+export declare function generateRequestId(): string;
+/**
+ * Make ADT request with stateful session management
+ *
+ * This is a wrapper around makeAdtRequestWithTimeout that automatically adds
+ * the required headers for stateful ADT operations:
+ * - sap-adt-connection-id: Session identifier (must be same for all requests)
+ * - sap-adt-request-id: Request identifier (must be unique for each request)
+ * - x-sap-adt-sessiontype: "stateful" (declares stateful session mode)
+ * - X-sap-adt-profiling: "server-time" (optional performance profiling)
+ *
+ * CRITICAL RULES:
+ * 1. Use the SAME sessionId for all requests in one operation (LOCK/PUT/UNLOCK)
+ * 2. Each call to this function generates a NEW unique request ID automatically
+ * 3. Cookies are managed automatically by BaseAbapConnection
+ * 4. Always unlock in try/finally block to prevent orphaned locks
+ *
+ * @param url - ADT API endpoint URL (can be relative or absolute)
+ * @param method - HTTP method ('GET', 'POST', 'PUT', 'DELETE')
+ * @param sessionId - Session ID from generateSessionId() - MUST be same for all related requests
+ * @param data - Optional request body (source code, XML payload, etc.)
+ * @param additionalHeaders - Optional custom headers to merge with session headers
+ * @returns Promise with Axios response
+ *
+ * @example
+ * ```typescript
+ * // Create one session ID for the entire operation
+ * const sessionId = generateSessionId();
+ *
+ * // Step 1: Lock object
+ * const lockResponse = await makeAdtRequestWithSession(
+ *   '/sap/bc/adt/oo/classes/zcl_test?_action=LOCK',
+ *   'POST',
+ *   sessionId,
+ *   null,
+ *   { 'Accept': 'application/vnd.sap.as+xml' }
+ * );
+ *
+ * // Step 2: Update source (same sessionId!)
+ * await makeAdtRequestWithSession(
+ *   `/sap/bc/adt/oo/classes/zcl_test/source/main?lockHandle=${handle}`,
+ *   'PUT',
+ *   sessionId,
+ *   sourceCode,
+ *   { 'Content-Type': 'text/plain; charset=utf-8' }
+ * );
+ *
+ * // Step 3: Unlock (same sessionId!)
+ * await makeAdtRequestWithSession(
+ *   `/sap/bc/adt/oo/classes/zcl_test?_action=UNLOCK&lockHandle=${handle}`,
+ *   'POST',
+ *   sessionId
+ * );
+ * ```
+ */
+export declare function makeAdtRequestWithSession(connection: IAbapConnection, url: string, method: string, sessionId: string, data?: any, additionalHeaders?: Record<string, string>): Promise<AxiosResponse>;
+/**
+ * Make ADT request with stateless session (for operations that don't require lock management)
+ *
+ * Similar to makeAdtRequestWithSession but omits the 'x-sap-adt-sessiontype: stateful' header.
+ * Used for operations that don't involve locking but still need session tracking.
+ *
+ * @param url - ADT API endpoint URL
+ * @param method - HTTP method
+ * @param sessionId - Session ID for tracking purposes
+ * @param data - Optional request body
+ * @param additionalHeaders - Optional custom headers
+ * @returns Promise with Axios response
+ */
+export declare function makeAdtRequestStateless(connection: IAbapConnection, url: string, method: string, sessionId: string, data?: any, additionalHeaders?: Record<string, string>): Promise<AxiosResponse>;
+//# sourceMappingURL=sessionUtils.d.ts.map

package/dist/src/lib/sessionUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionUtils.d.ts","sourceRoot":"","sources":["../../../src/lib/sessionUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAG3C;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,eAAe,EAC3B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,GAAG,EACV,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACzC,OAAO,CAAC,aAAa,CAAC,CA2BxB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,eAAe,EAC3B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,GAAG,EACV,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACzC,OAAO,CAAC,aAAa,CAAC,CAqBxB"}