@mcp-abap-adt/adt-clients 0.1.0

package/dist/core/shared/readSource.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared utilities for reading object source code
+ * Source endpoints return source code text (plain text or XML)
+ * Only available for objects that have source code
+ */
+import { AbapConnection } from '@mcp-abap-adt/connection';
+import { AxiosResponse } from 'axios';
+/**
+ * Get object source URI based on object type
+ */
+export declare function getObjectSourceUri(objectType: string, objectName: string, functionGroup?: string, version?: 'active' | 'inactive'): string;
+/**
+ * Check if object type supports source code reading
+ */
+export declare function supportsSourceCode(objectType: string): boolean;
+/**
+ * Read object source code
+ * Only works for objects that have source code (class, program, interface, etc.)
+ */
+export declare function readObjectSource(connection: AbapConnection, objectType: string, objectName: string, functionGroup?: string, version?: 'active' | 'inactive'): Promise<AxiosResponse>;
+//# sourceMappingURL=readSource.d.ts.map

package/dist/core/shared/readSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readSource.d.ts","sourceRoot":"","sources":["../../../src/core/shared/readSource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAc,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAGtC;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,GAAE,QAAQ,GAAG,UAAqB,GACxC,MAAM,CAiCR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAW9D;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,cAAc,EAC1B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,GAAE,QAAQ,GAAG,UAAqB,GACxC,OAAO,CAAC,aAAa,CAAC,CAiBxB"}

package/dist/core/shared/readSource.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * Shared utilities for reading object source code
+ * Source endpoints return source code text (plain text or XML)
+ * Only available for objects that have source code
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getObjectSourceUri = getObjectSourceUri;
+exports.supportsSourceCode = supportsSourceCode;
+exports.readObjectSource = readObjectSource;
+const connection_1 = require("@mcp-abap-adt/connection");
+const internalUtils_1 = require("../../utils/internalUtils");
+/**
+ * Get object source URI based on object type
+ */
+function getObjectSourceUri(objectType, objectName, functionGroup, version = 'active') {
+    const encodedName = (0, internalUtils_1.encodeSapObjectName)(objectName);
+    const versionParam = version === 'inactive' ? '?version=inactive' : '';
+    switch (objectType.toLowerCase()) {
+        case 'class':
+        case 'clas/oc':
+            return `/sap/bc/adt/oo/classes/${encodedName}/source/main${versionParam}`;
+        case 'program':
+        case 'prog/p':
+            return `/sap/bc/adt/programs/programs/${encodedName}/source/main`;
+        case 'interface':
+        case 'intf/if':
+            return `/sap/bc/adt/oo/interfaces/${encodedName}/source/main`;
+        case 'functionmodule':
+        case 'fugr/ff':
+            if (!functionGroup) {
+                throw new Error('Function group is required for function module');
+            }
+            const encodedGroup = (0, internalUtils_1.encodeSapObjectName)(functionGroup);
+            return `/sap/bc/adt/functions/groups/${encodedGroup}/fmodules/${encodedName}/source/main${versionParam}`;
+        case 'view':
+        case 'ddls/df':
+            return `/sap/bc/adt/ddic/ddl/sources/${encodedName}/source/main`;
+        case 'structure':
+        case 'stru/dt':
+            return `/sap/bc/adt/ddic/structures/${encodedName}/source/main`;
+        case 'table':
+        case 'tabl/dt':
+            return `/sap/bc/adt/ddic/tables/${encodedName}/source/main`;
+        default:
+            throw new Error(`Object type ${objectType} does not support source code reading`);
+    }
+}
+/**
+ * Check if object type supports source code reading
+ */
+function supportsSourceCode(objectType) {
+    const supportedTypes = [
+        'class', 'clas/oc',
+        'program', 'prog/p',
+        'interface', 'intf/if',
+        'functionmodule', 'fugr/ff',
+        'view', 'ddls/df',
+        'structure', 'stru/dt',
+        'table', 'tabl/dt'
+    ];
+    return supportedTypes.includes(objectType.toLowerCase());
+}
+/**
+ * Read object source code
+ * Only works for objects that have source code (class, program, interface, etc.)
+ */
+async function readObjectSource(connection, objectType, objectName, functionGroup, version = 'active') {
+    if (!supportsSourceCode(objectType)) {
+        throw new Error(`Object type ${objectType} does not support source code reading`);
+    }
+    const baseUrl = await connection.getBaseUrl();
+    const uri = getObjectSourceUri(objectType, objectName, functionGroup, version);
+    const url = `${baseUrl}${uri}`;
+    return connection.makeAdtRequest({
+        url,
+        method: 'GET',
+        timeout: (0, connection_1.getTimeout)('default'),
+        headers: {
+            'Accept': 'text/plain'
+        }
+    });
+}

package/dist/core/shared/search.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Search operations for ABAP objects
+ */
+import { AbapConnection } from '@mcp-abap-adt/connection';
+import { AxiosResponse } from 'axios';
+export interface SearchObjectsParams {
+    query: string;
+    objectType?: string;
+    maxResults?: number;
+}
+export interface SearchResult {
+    name: string;
+    type: string;
+    description: string;
+    packageName?: string;
+    uri?: string;
+}
+/**
+ * Search for ABAP objects by name pattern
+ *
+ * @param connection - ABAP connection
+ * @param params - Search parameters
+ * @returns Search results
+ */
+export declare function searchObjects(connection: AbapConnection, params: SearchObjectsParams): Promise<AxiosResponse>;
+//# sourceMappingURL=search.d.ts.map

package/dist/core/shared/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/core/shared/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAc,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAGtC,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,cAAc,EAC1B,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,aAAa,CAAC,CAmBxB"}

package/dist/core/shared/search.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Search operations for ABAP objects
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchObjects = searchObjects;
+const connection_1 = require("@mcp-abap-adt/connection");
+const internalUtils_1 = require("../../utils/internalUtils");
+/**
+ * Search for ABAP objects by name pattern
+ *
+ * @param connection - ABAP connection
+ * @param params - Search parameters
+ * @returns Search results
+ */
+async function searchObjects(connection, params) {
+    const baseUrl = await connection.getBaseUrl();
+    const encodedQuery = (0, internalUtils_1.encodeSapObjectName)(params.query);
+    const maxResults = params.maxResults || 100;
+    let url = `${baseUrl}/sap/bc/adt/repository/informationsystem/search?operation=quickSearch&query=${encodedQuery}&maxResults=${maxResults}`;
+    if (params.objectType) {
+        url += `&objectType=${(0, internalUtils_1.encodeSapObjectName)(params.objectType)}`;
+    }
+    return connection.makeAdtRequest({
+        url,
+        method: 'GET',
+        timeout: (0, connection_1.getTimeout)('default'),
+        headers: {
+            'Accept': 'application/xml'
+        }
+    });
+}

package/dist/core/shared/sqlQuery.d.ts

@@ -0,0 +1,22 @@
+/**
+ * SQL query operations via ADT Data Preview API
+ *
+ * ⚠️ ABAP Cloud Limitation: Direct execution of SQL queries through ADT Data Preview
+ * is blocked by SAP BTP backend policies when using JWT/XSUAA authentication.
+ * This function works only for on-premise systems with basic authentication.
+ */
+import { AbapConnection } from '@mcp-abap-adt/connection';
+import { AxiosResponse } from 'axios';
+export interface GetSqlQueryParams {
+    sql_query: string;
+    row_number?: number;
+}
+/**
+ * Execute freestyle SQL query via SAP ADT Data Preview API
+ *
+ * @param connection - ABAP connection
+ * @param params - SQL query parameters
+ * @returns Query results
+ */
+export declare function getSqlQuery(connection: AbapConnection, params: GetSqlQueryParams): Promise<AxiosResponse>;
+//# sourceMappingURL=sqlQuery.d.ts.map

package/dist/core/shared/sqlQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlQuery.d.ts","sourceRoot":"","sources":["../../../src/core/shared/sqlQuery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAc,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,cAAc,EAC1B,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,aAAa,CAAC,CAmBxB"}

package/dist/core/shared/sqlQuery.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * SQL query operations via ADT Data Preview API
+ *
+ * ⚠️ ABAP Cloud Limitation: Direct execution of SQL queries through ADT Data Preview
+ * is blocked by SAP BTP backend policies when using JWT/XSUAA authentication.
+ * This function works only for on-premise systems with basic authentication.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSqlQuery = getSqlQuery;
+const connection_1 = require("@mcp-abap-adt/connection");
+/**
+ * Execute freestyle SQL query via SAP ADT Data Preview API
+ *
+ * @param connection - ABAP connection
+ * @param params - SQL query parameters
+ * @returns Query results
+ */
+async function getSqlQuery(connection, params) {
+    if (!params.sql_query) {
+        throw new Error('SQL query is required');
+    }
+    const baseUrl = await connection.getBaseUrl();
+    const rowNumber = params.row_number || 100;
+    const url = `${baseUrl}/sap/bc/adt/datapreview/freestyle?rowNumber=${rowNumber}`;
+    return connection.makeAdtRequest({
+        url,
+        method: 'POST',
+        timeout: (0, connection_1.getTimeout)('long'),
+        data: params.sql_query,
+        headers: {
+            'Content-Type': 'text/plain; charset=utf-8',
+            'Accept': 'application/xml'
+        }
+    });
+}

package/dist/core/shared/systemInfo.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared system information utilities
+ */
+import { AbapConnection } from '@mcp-abap-adt/connection';
+/**
+ * Get system information from SAP ADT (for cloud systems)
+ * Returns systemID and userName if available
+ */
+export declare function getSystemInformation(connection: AbapConnection): Promise<{
+    systemID?: string;
+    userName?: string;
+    client?: string;
+    language?: string;
+    userFullName?: string;
+} | null>;
+/**
+ * Check if the system is a BTP ABAP Cloud Environment
+ * Returns true if the systeminformation endpoint is available (cloud system)
+ * Returns false if the endpoint doesn't exist (on-premise system)
+ */
+export declare function isCloudEnvironment(connection: AbapConnection): Promise<boolean>;
+//# sourceMappingURL=systemInfo.d.ts.map

package/dist/core/shared/systemInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemInfo.d.ts","sourceRoot":"","sources":["../../../src/core/shared/systemInfo.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAc,MAAM,0BAA0B,CAAC;AAGtE;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,cAAc,GACzB,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAiDrH;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAGrF"}

package/dist/core/shared/systemInfo.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * Shared system information utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSystemInformation = getSystemInformation;
+exports.isCloudEnvironment = isCloudEnvironment;
+const connection_1 = require("@mcp-abap-adt/connection");
+/**
+ * Get system information from SAP ADT (for cloud systems)
+ * Returns systemID and userName if available
+ */
+async function getSystemInformation(connection) {
+    try {
+        const baseUrl = await connection.getBaseUrl();
+        const url = `${baseUrl}/sap/bc/adt/core/http/systeminformation`;
+        const headers = {
+            'Accept': 'application/vnd.sap.adt.core.http.systeminformation.v1+json'
+        };
+        // Add cache busting parameter like Eclipse does
+        const params = {
+            '_': Date.now()
+        };
+        const response = await connection.makeAdtRequest({
+            url,
+            method: 'GET',
+            timeout: (0, connection_1.getTimeout)('default'),
+            headers,
+            params
+        });
+        // Parse response - can be JSON or XML
+        let data = response.data;
+        if (typeof data === 'string') {
+            try {
+                // Try to parse as JSON
+                data = JSON.parse(data);
+            }
+            catch {
+                // If not JSON, might be XML or error - return null
+                return null;
+            }
+        }
+        if (data && typeof data === 'object') {
+            return {
+                systemID: data.systemID,
+                userName: data.userName,
+                userFullName: data.userFullName,
+                client: data.client,
+                language: data.language
+            };
+        }
+        return null;
+    }
+    catch (error) {
+        // If endpoint doesn't exist (on-premise) or returns error, return null
+        return null;
+    }
+}
+/**
+ * Check if the system is a BTP ABAP Cloud Environment
+ * Returns true if the systeminformation endpoint is available (cloud system)
+ * Returns false if the endpoint doesn't exist (on-premise system)
+ */
+async function isCloudEnvironment(connection) {
+    const systemInfo = await getSystemInformation(connection);
+    return systemInfo !== null;
+}

package/dist/core/shared/tableContents.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Table contents operations via ADT Data Preview API
+ *
+ * ⚠️ ABAP Cloud Limitation: Direct access to table data through ADT Data Preview
+ * is blocked by SAP BTP backend policies when using JWT/XSUAA authentication.
+ * This function works only for on-premise systems with basic authentication.
+ */
+import { AbapConnection } from '@mcp-abap-adt/connection';
+import { AxiosResponse } from 'axios';
+export interface GetTableContentsParams {
+    table_name: string;
+    max_rows?: number;
+}
+/**
+ * Get table contents via ADT Data Preview API
+ *
+ * @param connection - ABAP connection
+ * @param params - Table contents parameters
+ * @returns Table contents
+ */
+export declare function getTableContents(connection: AbapConnection, params: GetTableContentsParams): Promise<AxiosResponse>;
+//# sourceMappingURL=tableContents.d.ts.map

package/dist/core/shared/tableContents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableContents.d.ts","sourceRoot":"","sources":["../../../src/core/shared/tableContents.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAc,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAGtC,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,cAAc,EAC1B,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,aAAa,CAAC,CA8ExB"}

package/dist/core/shared/tableContents.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * Table contents operations via ADT Data Preview API
+ *
+ * ⚠️ ABAP Cloud Limitation: Direct access to table data through ADT Data Preview
+ * is blocked by SAP BTP backend policies when using JWT/XSUAA authentication.
+ * This function works only for on-premise systems with basic authentication.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTableContents = getTableContents;
+const connection_1 = require("@mcp-abap-adt/connection");
+const internalUtils_1 = require("../../utils/internalUtils");
+/**
+ * Get table contents via ADT Data Preview API
+ *
+ * @param connection - ABAP connection
+ * @param params - Table contents parameters
+ * @returns Table contents
+ */
+async function getTableContents(connection, params) {
+    if (!params.table_name) {
+        throw new Error('Table name is required');
+    }
+    const baseUrl = await connection.getBaseUrl();
+    const maxRows = params.max_rows || 100;
+    const encodedName = (0, internalUtils_1.encodeSapObjectName)(params.table_name);
+    // First, get table structure to know all fields
+    const structureUrl = `${baseUrl}/sap/bc/adt/ddic/tables/${encodedName}/source/main`;
+    // Get table structure
+    const structureResponse = await connection.makeAdtRequest({
+        url: structureUrl,
+        method: 'GET',
+        timeout: (0, connection_1.getTimeout)('default'),
+        headers: {}
+    });
+    // Parse table structure to extract field names
+    const structureText = structureResponse.data;
+    const fields = [];
+    // Extract field names from ABAP table definition
+    // Support both old and new CDS view syntax
+    if (structureText.includes('define table')) {
+        // New CDS syntax
+        const lines = structureText.split('\n');
+        for (const line of lines) {
+            const trimmedLine = line.trim();
+            const fieldMatch = trimmedLine.match(/^(key\s+)?([a-z0-9_]+)\s*:\s*[a-z0-9_]+/i);
+            if (fieldMatch) {
+                const fieldName = fieldMatch[2].trim().toUpperCase();
+                if (fieldName && fieldName.length > 0) {
+                    fields.push(`${params.table_name}~${fieldName}`);
+                }
+            }
+        }
+    }
+    else {
+        // Old ABAP syntax
+        const patterns = [
+            /^\s+([A-Z0-9_]+)\s*:\s*(TYPE|LIKE)/gmi,
+            /^\s+([A-Z0-9_]+)\s+(TYPE|LIKE)/gmi,
+            /^\s+([A-Z0-9_]+)\s*:\s*[A-Z0-9_]+/gmi
+        ];
+        for (const pattern of patterns) {
+            let match;
+            while ((match = pattern.exec(structureText)) !== null) {
+                const fieldName = match[1].trim().toUpperCase();
+                if (fieldName && fieldName.length > 0 && !fields.includes(`${params.table_name}~${fieldName}`)) {
+                    fields.push(`${params.table_name}~${fieldName}`);
+                }
+            }
+        }
+    }
+    if (fields.length === 0) {
+        throw new Error('Could not extract field names from table structure');
+    }
+    // Build SQL query with explicit field list
+    const sqlQuery = `SELECT ${fields.join(', ')} FROM ${params.table_name}`;
+    // Execute SQL query via Data Preview API
+    const url = `${baseUrl}/sap/bc/adt/datapreview/freestyle?rowNumber=${maxRows}`;
+    return connection.makeAdtRequest({
+        url,
+        method: 'POST',
+        timeout: (0, connection_1.getTimeout)('long'),
+        data: sqlQuery,
+        headers: {
+            'Content-Type': 'text/plain; charset=utf-8',
+            'Accept': 'application/xml'
+        }
+    });
+}

package/dist/core/shared/validation.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Shared validation utilities for SAP object names
+ */
+import { AbapConnection } from '@mcp-abap-adt/connection';
+export interface ValidationResult {
+    valid: boolean;
+    severity?: 'ERROR' | 'WARNING' | 'INFO';
+    message?: string;
+    longText?: string;
+}
+/**
+ * Validate object name using SAP ADT validation endpoint
+ *
+ * @param connection - ABAP connection
+ * @param objectType - SAP object type (e.g., 'FUGR/FF', 'CLAS/OC', 'PROG/P')
+ * @param objectName - Name to validate
+ * @param additionalParams - Additional validation parameters (e.g., fugrname, description)
+ * @returns ValidationResult with status and messages
+ */
+export declare function validateObjectName(connection: AbapConnection, objectType: string, objectName: string, additionalParams?: Record<string, string>): Promise<ValidationResult>;
+/**
+ * Validate and throw error if name is invalid
+ * Useful for enforcing validation before object creation
+ */
+export declare function validateAndThrow(validationResult: ValidationResult, objectType: string): Promise<void>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/core/shared/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/core/shared/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAc,MAAM,0BAA0B,CAAC;AAItE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,cAAc,EAC1B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,OAAO,CAAC,gBAAgB,CAAC,CA2G3B;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,gBAAgB,EAAE,gBAAgB,EAClC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/core/shared/validation.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * Shared validation utilities for SAP object names
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateObjectName = validateObjectName;
+exports.validateAndThrow = validateAndThrow;
+const connection_1 = require("@mcp-abap-adt/connection");
+const fast_xml_parser_1 = require("fast-xml-parser");
+const internalUtils_1 = require("../../utils/internalUtils");
+/**
+ * Validate object name using SAP ADT validation endpoint
+ *
+ * @param connection - ABAP connection
+ * @param objectType - SAP object type (e.g., 'FUGR/FF', 'CLAS/OC', 'PROG/P')
+ * @param objectName - Name to validate
+ * @param additionalParams - Additional validation parameters (e.g., fugrname, description)
+ * @returns ValidationResult with status and messages
+ */
+async function validateObjectName(connection, objectType, objectName, additionalParams) {
+    const baseUrl = await connection.getBaseUrl();
+    const encodedName = (0, internalUtils_1.encodeSapObjectName)(objectName);
+    // Build query parameters
+    const params = new URLSearchParams({
+        objtype: objectType,
+        objname: encodedName,
+        ...additionalParams
+    });
+    const url = `${baseUrl}/sap/bc/adt/functions/validation?${params.toString()}`;
+    try {
+        const response = await connection.makeAdtRequest({
+            url,
+            method: 'POST',
+            timeout: (0, connection_1.getTimeout)('default'),
+            headers: {
+                'Accept': 'application/vnd.sap.as+xml;charset=UTF-8;dataname=com.sap.adt.StatusMessage'
+            }
+        });
+        // Parse validation response
+        const parser = new fast_xml_parser_1.XMLParser({
+            ignoreAttributes: false,
+            attributeNamePrefix: '@_'
+        });
+        const result = parser.parse(response.data);
+        const data = result['asx:abap']?.['asx:values']?.['DATA'];
+        if (data) {
+            const severity = data['SEVERITY'];
+            const shortText = data['SHORT_TEXT'];
+            const longText = data['LONG_TEXT'];
+            return {
+                valid: severity !== 'ERROR',
+                severity,
+                message: shortText,
+                longText
+            };
+        }
+        // No validation data means name is valid
+        return { valid: true };
+    }
+    catch (error) {
+        // 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 400 errors, try to extract meaningful error message
+        if (error.response?.status === 400) {
+            let errorMessage = 'Validation request failed with status 400';
+            if (error.response?.data) {
+                if (typeof error.response.data === 'string') {
+                    // Try to parse XML error
+                    try {
+                        const parser = new fast_xml_parser_1.XMLParser({ ignoreAttributes: false, attributeNamePrefix: '@_' });
+                        const parsed = parser.parse(error.response.data);
+                        const errorText = parsed['exc:exception']?.message?.['#text'] ||
+                            parsed['exc:exception']?.message ||
+                            parsed['exc:exception']?.reason?.['#text'] ||
+                            parsed['exc:exception']?.reason;
+                        if (errorText) {
+                            errorMessage = errorText;
+                        }
+                    }
+                    catch {
+                        // Not XML, use raw message
+                        errorMessage = error.response.data.substring(0, 200);
+                    }
+                }
+                else if (typeof error.response.data === 'object') {
+                    errorMessage = JSON.stringify(error.response.data).substring(0, 200);
+                }
+            }
+            // If validation is not supported for this object type, return valid (skip validation)
+            const errorMsgLower = errorMessage.toLowerCase();
+            if (errorMsgLower.includes('not supported') ||
+                (errorMsgLower.includes('object type') && errorMsgLower.includes('not supported'))) {
+                return { valid: true }; // Skip validation if not supported
+            }
+            return {
+                valid: false,
+                severity: 'ERROR',
+                message: errorMessage
+            };
+        }
+        // For other errors, check if it's about unsupported object type
+        const errorMsg = error.message || '';
+        if (errorMsg.toLowerCase().includes('not supported') ||
+            (errorMsg.toLowerCase().includes('object type') && errorMsg.toLowerCase().includes('not supported'))) {
+            return { valid: true }; // Skip validation if not supported
+        }
+        // For other errors, return as validation failure
+        return {
+            valid: false,
+            severity: 'ERROR',
+            message: error.message || 'Validation request failed'
+        };
+    }
+}
+/**
+ * Validate and throw error if name is invalid
+ * Useful for enforcing validation before object creation
+ */
+async function validateAndThrow(validationResult, objectType) {
+    if (!validationResult.valid) {
+        throw new Error(`${objectType} name validation failed: ${validationResult.message}`);
+    }
+    // Also throw on critical warnings (SAP naming range violations)
+    if (validationResult.severity === 'WARNING' && validationResult.message) {
+        if (validationResult.message.includes('reserved for SAP') ||
+            validationResult.message.includes('naming range') ||
+            validationResult.message.includes('Y_ or Z_')) {
+            throw new Error(`${objectType} name validation failed: ${validationResult.message}. Use Y_ or Z_ prefix (with underscore).`);
+        }
+    }
+}

package/dist/core/shared/whereUsed.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Where-used operations for ABAP objects
+ */
+import { AbapConnection } from '@mcp-abap-adt/connection';
+import { AxiosResponse } from 'axios';
+export interface GetWhereUsedParams {
+    object_name: string;
+    object_type: string;
+    detailed?: boolean;
+}
+/**
+ * Get where-used references for ABAP object
+ *
+ * @param connection - ABAP connection
+ * @param params - Where-used parameters
+ * @returns Where-used references
+ */
+export declare function getWhereUsed(connection: AbapConnection, params: GetWhereUsedParams): Promise<AxiosResponse>;
+//# sourceMappingURL=whereUsed.d.ts.map

package/dist/core/shared/whereUsed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whereUsed.d.ts","sourceRoot":"","sources":["../../../src/core/shared/whereUsed.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAc,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAGtC,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAuDD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,cAAc,EAC1B,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,aAAa,CAAC,CAwBxB"}