@mcp-abap-adt/adt-clients 0.1.0

package/dist/core/managementOperations.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Core management operations - private implementations
+ * All activation and check methods are implemented here once and reused by clients
+ */
+import { AbapConnection } from '@mcp-abap-adt/connection';
+import { AxiosResponse } from 'axios';
+/**
+ * Activate multiple ABAP objects in batch
+ * Uses ADT activation/runs endpoint for batch activation
+ */
+export declare function activateObjectsGroup(connection: AbapConnection, objects: Array<{
+    uri: string;
+    name: string;
+}>, preaudit?: boolean): Promise<AxiosResponse>;
+/**
+ * Parse activation response to extract status and messages
+ */
+export declare function parseActivationResponse(responseData: string | any): {
+    activated: boolean;
+    checked: boolean;
+    generated: boolean;
+    messages: Array<{
+        type: string;
+        text: string;
+        line?: number;
+        column?: number;
+    }>;
+};
+/**
+ * Check ABAP object syntax
+ * Uses shared checkRun utility for all object types
+ */
+export declare function checkObject(connection: AbapConnection, name: string, type: string, version?: string): Promise<AxiosResponse>;
+//# sourceMappingURL=managementOperations.d.ts.map

package/dist/core/managementOperations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managementOperations.d.ts","sourceRoot":"","sources":["../../src/core/managementOperations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAiCtC;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAC7C,QAAQ,GAAE,OAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CAkBxB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,GAAG,GAAG;IACnE,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjF,CAiDA;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC,CAGxB"}

package/dist/core/managementOperations.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * Core management operations - private implementations
+ * All activation and check methods are implemented here once and reused by clients
+ */
+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.activateObjectsGroup = activateObjectsGroup;
+exports.parseActivationResponse = parseActivationResponse;
+exports.checkObject = checkObject;
+const connection_1 = require("@mcp-abap-adt/connection");
+/**
+ * Internal helper to make ADT request
+ */
+async function makeAdtRequest(connection, url, method = 'GET', timeout = 'default', data, params, headers) {
+    const timeoutValue = (0, connection_1.getTimeout)(timeout);
+    return connection.makeAdtRequest({
+        url,
+        method,
+        timeout: timeoutValue,
+        data,
+        params,
+        headers,
+    });
+}
+/**
+ * Get base URL from connection
+ */
+async function getBaseUrl(connection) {
+    return connection.getBaseUrl();
+}
+/**
+ * Activate multiple ABAP objects in batch
+ * Uses ADT activation/runs endpoint for batch activation
+ */
+async function activateObjectsGroup(connection, objects, preaudit = true) {
+    const baseUrl = await getBaseUrl(connection);
+    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 makeAdtRequest(connection, url, 'POST', 'default', activationXml, undefined, headers);
+}
+/**
+ * Parse activation response to extract status and messages
+ */
+function parseActivationResponse(responseData) {
+    const { XMLParser } = require('fast-xml-parser');
+    const parser = new XMLParser({
+        ignoreAttributes: false,
+        attributeNamePrefix: '@_',
+        parseAttributeValue: true
+    });
+    try {
+        const data = typeof responseData === 'string' ? responseData : responseData.data || JSON.stringify(responseData);
+        const result = parser.parse(data);
+        // 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' }]
+        };
+    }
+}
+/**
+ * Check ABAP object syntax
+ * Uses shared checkRun utility for all object types
+ */
+async function checkObject(connection, name, type, version) {
+    const { runCheckRun } = await Promise.resolve().then(() => __importStar(require('./shared/checkRun')));
+    return runCheckRun(connection, type, name, version || 'active', 'abapCheckRun');
+}

package/dist/core/package/PackageBuilder.d.ts

@@ -0,0 +1,129 @@
+/**
+ * PackageBuilder - Fluent API for package operations with Promise chaining
+ *
+ * Supports:
+ * - Method chaining: builder.validate().then(b => b.create()).then(b => b.check())...
+ * - 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)
+ *
+ * Available operations: validate, create, read, check, lock, unlock, update
+ *
+ * @example
+ * ```typescript
+ * const builder = new PackageBuilder(connection, logger, {
+ *   packageName: 'Z_TEST_PKG',
+ *   superPackage: 'ZOK_TEST_PKG_01'
+ * });
+ *
+ * await builder
+ *   .validate()
+ *   .then(b => b.create())
+ *   .then(b => b.check())
+ *   .catch(error => {
+ *     logger.error('Operation failed:', error);
+ *   });
+ * ```
+ */
+import { AbapConnection } from '@mcp-abap-adt/connection';
+import { AxiosResponse } from 'axios';
+export interface PackageBuilderLogger {
+    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 PackageBuilderConfig {
+    packageName: string;
+    superPackage: string;
+    description?: string;
+    updatedDescription?: string;
+    packageType?: string;
+    softwareComponent?: string;
+    transportLayer?: string;
+    transportRequest?: string;
+    applicationComponent?: string;
+    responsible?: string;
+    sessionId?: string;
+    onLock?: (lockHandle: string, sessionId: string) => void;
+}
+export interface PackageBuilderState {
+    validationResult?: {
+        basic?: void;
+        full?: void;
+    };
+    createResult?: AxiosResponse;
+    readResult?: AxiosResponse;
+    checkResult?: void;
+    lockResult?: string;
+    unlockResult?: AxiosResponse;
+    updateResult?: AxiosResponse;
+    sessionId?: string;
+    lockHandle?: string;
+    errors: Array<{
+        method: string;
+        error: Error;
+        timestamp: Date;
+    }>;
+}
+export declare class PackageBuilder {
+    private connection;
+    private logger;
+    private config;
+    private state;
+    constructor(connection: AbapConnection, logger: PackageBuilderLogger, config: PackageBuilderConfig);
+    setSuperPackage(superPackage: string): this;
+    setDescription(description: string): this;
+    setPackageType(packageType: string): this;
+    setSoftwareComponent(softwareComponent: string): this;
+    setTransportLayer(transportLayer: string): this;
+    setRequest(transportRequest: string): this;
+    setApplicationComponent(applicationComponent: string): this;
+    setResponsible(responsible: string): this;
+    validate(): Promise<this>;
+    create(): Promise<this>;
+    read(): Promise<this>;
+    check(): Promise<this>;
+    lock(): Promise<this>;
+    unlock(): Promise<this>;
+    update(): Promise<this>;
+    forceUnlock(): Promise<void>;
+    getState(): Readonly<PackageBuilderState>;
+    getPackageName(): string;
+    getValidationResult(): {
+        basic?: void;
+        full?: void;
+    } | undefined;
+    getCreateResult(): AxiosResponse | undefined;
+    getReadResult(): AxiosResponse | undefined;
+    getCheckResult(): void | undefined;
+    getErrors(): ReadonlyArray<{
+        method: string;
+        error: Error;
+        timestamp: Date;
+    }>;
+    getSessionId(): string | undefined;
+    getLockHandle(): string | undefined;
+    getLockResult(): string | undefined;
+    getUnlockResult(): AxiosResponse | undefined;
+    getUpdateResult(): AxiosResponse | undefined;
+    getResults(): {
+        validate?: {
+            basic?: void;
+            full?: void;
+        };
+        create?: AxiosResponse;
+        read?: AxiosResponse;
+        check?: void;
+        lock?: string;
+        unlock?: AxiosResponse;
+        update?: AxiosResponse;
+        errors: Array<{
+            method: string;
+            error: Error;
+            timestamp: Date;
+        }>;
+    };
+}
+//# sourceMappingURL=PackageBuilder.d.ts.map

package/dist/core/package/PackageBuilder.d.ts.map

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