@mcp-abap-adt/core 2.1.3 → 2.1.6

package/dist/lib/activationUtils.js

@@ -0,0 +1,168 @@
+"use strict";
+/**
+ * Activation Utilities - Centralized ABAP Object Activation Functions
+ *
+ * Two types of activation endpoints:
+ * 1. Individual activation: /sap/bc/adt/activation (for single object in session)
+ * 2. Group activation: /sap/bc/adt/activation/runs (for multiple objects)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildObjectUri = buildObjectUri;
+exports.activateObjectInSession = activateObjectInSession;
+exports.activateObjectsGroup = activateObjectsGroup;
+exports.parseActivationResponse = parseActivationResponse;
+const sessionUtils_1 = require("./sessionUtils");
+const utils_1 = require("./utils");
+/**
+ * Build object URI from name and type
+ * Used by both individual and group activation
+ *
+ * @param name - Object name (e.g., 'ZCL_MY_CLASS', 'Z_MY_PROGRAM')
+ * @param type - Object type code (e.g., 'CLAS/OC', 'PROG/P', 'DDLS/DF')
+ * @returns ADT URI for the object
+ */
+function buildObjectUri(name, type) {
+    const lowerName = (0, utils_1.encodeSapObjectName)(name).toLowerCase();
+    if (!type) {
+        // Try to guess type from name prefix
+        if (name.startsWith('ZCL_') || name.startsWith('CL_')) {
+            return `/sap/bc/adt/oo/classes/${lowerName}`;
+        }
+        else if (name.startsWith('Z') && name.includes('_PROGRAM')) {
+            return `/sap/bc/adt/programs/programs/${lowerName}`;
+        }
+        // Default: assume program
+        return `/sap/bc/adt/programs/programs/${lowerName}`;
+    }
+    // Map type to URI path
+    switch (type.toUpperCase()) {
+        case 'CLAS/OC':
+        case 'CLAS':
+            return `/sap/bc/adt/oo/classes/${lowerName}`;
+        case 'PROG/P':
+        case 'PROG':
+            return `/sap/bc/adt/programs/programs/${lowerName}`;
+        case 'FUGR':
+        case 'FUNC':
+            return `/sap/bc/adt/functions/groups/${lowerName}`;
+        case 'TABL/DT':
+        case 'TABL':
+            return `/sap/bc/adt/ddic/tables/${lowerName}`;
+        case 'TABL/DS':
+        case 'STRU/DS':
+        case 'STRU':
+            return `/sap/bc/adt/ddic/structures/${lowerName}`;
+        case 'DDLS/DF':
+        case 'DDLS':
+            return `/sap/bc/adt/ddic/ddl/sources/${lowerName}`;
+        case 'VIEW/DV':
+        case 'VIEW':
+            return `/sap/bc/adt/ddic/views/${lowerName}`;
+        case 'DTEL/DE':
+        case 'DTEL':
+            return `/sap/bc/adt/ddic/dataelements/${lowerName}`;
+        case 'DOMA/DD':
+        case 'DOMA':
+            return `/sap/bc/adt/ddic/domains/${lowerName}`;
+        case 'INTF/OI':
+        case 'INTF':
+            return `/sap/bc/adt/oo/interfaces/${lowerName}`;
+        default:
+            // Fallback: try to construct URI from type
+            return `/sap/bc/adt/${type.toLowerCase()}/${lowerName}`;
+    }
+}
+/**
+ * Individual object activation (within a session)
+ * Used by Update/Create handlers after lock/unlock operations
+ *
+ * @param objectUri - ADT URI of the object (e.g., '/sap/bc/adt/oo/classes/zcl_test')
+ * @param objectName - Object name in uppercase (e.g., 'ZCL_TEST')
+ * @param sessionId - Session ID for stateful operations
+ * @param preaudit - Request pre-audit before activation (default: true)
+ * @returns Axios response with activation result
+ */
+async function activateObjectInSession(objectUri, objectName, sessionId, preaudit = true) {
+    const url = `/sap/bc/adt/activation?method=activate&preauditRequested=${preaudit}`;
+    const activationXml = `<?xml version="1.0" encoding="UTF-8"?>
+<adtcore:objectReferences xmlns:adtcore="http://www.sap.com/adt/core">
+  <adtcore:objectReference adtcore:uri="${objectUri}" adtcore:name="${objectName}"/>
+</adtcore:objectReferences>`;
+    const headers = {
+        'Content-Type': 'application/vnd.sap.adt.activation+xml',
+        'Accept': 'application/xml'
+    };
+    return await (0, sessionUtils_1.makeAdtRequestWithSession)(url, 'POST', sessionId, activationXml, headers);
+}
+/**
+ * Group activation (multiple objects, stateless)
+ * Used by ActivateObject tool for batch activation
+ *
+ * @param objects - Array of objects to activate with uri and name
+ * @param preaudit - Request pre-audit before activation (default: true)
+ * @returns Axios response with activation result
+ */
+async function activateObjectsGroup(objects, preaudit = true) {
+    const baseUrl = await (0, utils_1.getBaseUrl)();
+    const url = `${baseUrl}/sap/bc/adt/activation/runs?method=activate&preauditRequested=${preaudit}`;
+    const objectReferences = objects.map(obj => `  <adtcore:objectReference adtcore:uri="${obj.uri}" adtcore:name="${obj.name}"/>`).join('\n');
+    const activationXml = `<?xml version="1.0" encoding="UTF-8"?><adtcore:objectReferences xmlns:adtcore="http://www.sap.com/adt/core">
+${objectReferences}
+</adtcore:objectReferences>`;
+    const headers = {
+        'Accept': 'application/xml',
+        'Content-Type': 'application/xml'
+    };
+    return await (0, utils_1.makeAdtRequestWithTimeout)(url, 'POST', 'default', activationXml, undefined, headers);
+}
+/**
+ * Parse activation response to extract status and messages
+ * Common parsing logic for both individual and group activation
+ *
+ * @param responseData - XML response data from activation endpoint
+ * @returns Parsed activation result with status and messages
+ */
+function parseActivationResponse(responseData) {
+    const { XMLParser } = require('fast-xml-parser');
+    const parser = new XMLParser({
+        ignoreAttributes: false,
+        attributeNamePrefix: '@_',
+        parseAttributeValue: true
+    });
+    try {
+        const result = parser.parse(responseData);
+        // Check for properties element
+        const properties = result['chkl:messages']?.['chkl:properties'];
+        const activated = properties?.['@_activationExecuted'] === 'true' || properties?.['@_activationExecuted'] === true;
+        const checked = properties?.['@_checkExecuted'] === 'true' || properties?.['@_checkExecuted'] === true;
+        const generated = properties?.['@_generationExecuted'] === 'true' || properties?.['@_generationExecuted'] === true;
+        // Parse messages (warnings/errors)
+        const messages = [];
+        const msgData = result['chkl:messages']?.['msg'];
+        if (msgData) {
+            const msgArray = Array.isArray(msgData) ? msgData : [msgData];
+            msgArray.forEach((msg) => {
+                messages.push({
+                    type: msg['@_type'] || 'info',
+                    text: msg['shortText']?.['txt'] || msg['shortText'] || 'Unknown message',
+                    line: msg['@_line'],
+                    column: msg['@_column']
+                });
+            });
+        }
+        return {
+            activated,
+            checked,
+            generated,
+            messages
+        };
+    }
+    catch (error) {
+        return {
+            activated: false,
+            checked: false,
+            generated: false,
+            messages: [{ type: 'error', text: 'Failed to parse activation response' }]
+        };
+    }
+}

package/dist/lib/authBrokerFactory.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Unified AuthBrokerFactory for both old and new servers
+ * Implements unified broker creation logic according to UNIFIED_BROKER_LOGIC.md
+ *
+ * Key principles:
+ * - One broker per destination (key = destination name or 'default')
+ * - Default broker created at startup based on CLI args and .env file presence
+ * - Shared stores for destinations with same directory and type
+ */
+import { AuthBroker } from "@mcp-abap-adt/auth-broker";
+import type { ILogger } from "@mcp-abap-adt/interfaces";
+import type { ServerConfig } from "./config/ServerConfig.js";
+/**
+ * @deprecated Use ServerConfig instead
+ */
+export interface AuthBrokerFactoryConfig {
+    /** Default MCP destination from --mcp parameter */
+    defaultMcpDestination?: string;
+    /** Default destination (from --mcp or .env) */
+    defaultDestination?: string;
+    /** Path to .env file */
+    envFilePath?: string;
+    /** Custom path for auth broker storage */
+    authBrokerPath?: string;
+    /** Use unsafe mode (file-based session store) */
+    unsafe: boolean;
+    /** Transport type */
+    transportType: string;
+    /** Use auth-broker instead of .env file */
+    useAuthBroker?: boolean;
+    /** Logger instance */
+    logger?: ILogger;
+}
+export declare class AuthBrokerFactory {
+    private authBrokers;
+    private sharedStores;
+    private config;
+    private defaultBrokerInitialized;
+    constructor(config: ServerConfig | AuthBrokerFactoryConfig);
+    /**
+     * Create AuthBrokerFactory from ServerConfig (recommended)
+     */
+    static fromServerConfig(config: ServerConfig): AuthBrokerFactory;
+    /**
+     * Get config values (handles both ServerConfig and legacy AuthBrokerFactoryConfig)
+     */
+    private getConfigValue;
+    private isServerConfig;
+    /**
+     * Check if transport type supports AuthBroker
+     */
+    private isTransportSupported;
+    /**
+     * Initialize default broker based on CLI args and .env file presence
+     * Called once at server startup
+     *
+     * Creates default broker ('default' key) according to unified logic:
+     * 1. --mcp=destination → default broker with serviceKeyStore for destination
+     * 2. --env=path → default broker with sessionStore from path (no serviceKeyStore)
+     * 3. stdio/sse + .env in current folder + NOT --auth-broker → default broker with sessionStore (no serviceKeyStore)
+     * 4. Other cases → default broker NOT created
+     */
+    initializeDefaultBroker(): Promise<void>;
+    /**
+     * Get default broker (if initialized)
+     */
+    getDefaultBroker(): AuthBroker | undefined;
+    /**
+     * Get or create AuthBroker for specific destination
+     * For HTTP/SSE: called when destination is specified in headers
+     * For stdio: called to get default broker
+     */
+    getOrCreateAuthBroker(destination?: string, clientKey?: string): Promise<AuthBroker | undefined>;
+    /**
+     * Create broker for specific destination
+     * Internal method used by both initializeDefaultBroker and getOrCreateAuthBroker
+     */
+    private createBrokerForDestination;
+    /**
+     * Load .env file and populate session store with connection config
+     * @param envFilePath Path to .env file
+     * @param destination Destination name (usually 'default')
+     * @param broker AuthBroker instance
+     * @param logger Logger instance
+     */
+    private loadEnvFileIntoSessionStore;
+    /**
+     * Get existing AuthBroker without creating new one
+     */
+    getAuthBroker(destination?: string): AuthBroker | undefined;
+    /**
+     * Clear all AuthBroker instances
+     */
+    clear(): void;
+}
+//# sourceMappingURL=authBrokerFactory.d.ts.map

package/dist/lib/authBrokerFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authBrokerFactory.d.ts","sourceRoot":"","sources":["../../src/lib/authBrokerFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAgBvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,mDAAmD;IACnD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,+CAA+C;IAC/C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAC;IAChB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,sBAAsB;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,iBAAiB;IAE5B,OAAO,CAAC,WAAW,CAAiC;IAIpD,OAAO,CAAC,YAAY,CAA0F;IAE9G,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,wBAAwB,CAAS;gBAE7B,MAAM,EAAE,YAAY,GAAG,uBAAuB;IAI1D;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,iBAAiB;IAIhE;;OAEG;IACH,OAAO,CAAC,cAAc;IAqCtB,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;;;;;;;;OASG;IACG,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IAuJ9C;;OAEG;IACH,gBAAgB,IAAI,UAAU,GAAG,SAAS;IAI1C;;;;OAIG;IACG,qBAAqB,CACzB,WAAW,CAAC,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAmDlC;;;OAGG;YACW,0BAA0B;IA6IxC;;;;;;OAMG;YACW,2BAA2B;IAyFzC;;OAEG;IACH,aAAa,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAO3D;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd"}