@mcp-abap-adt/adt-clients 0.1.0

package/dist/core/transport/create.js

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * Transport create operations
+ */
+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.createTransport = createTransport;
+const connection_1 = require("@mcp-abap-adt/connection");
+const fast_xml_parser_1 = require("fast-xml-parser");
+/**
+ * Create transport request XML payload
+ */
+function buildCreateTransportXml(args, username) {
+    const transportType = args.transport_type === 'customizing' ? 'T' : 'K';
+    const description = args.description || 'Transport request created via MCP';
+    const owner = args.owner || username;
+    const target = args.target_system && args.target_system.trim()
+        ? `/${args.target_system}/`
+        : 'LOCAL';
+    return `<?xml version="1.0" encoding="ASCII"?>
+<tm:root xmlns:tm="http://www.sap.com/cts/adt/tm" tm:useraction="newrequest">
+  <tm:request tm:desc="${description}" tm:type="${transportType}" tm:target="${target}" tm:cts_project="">
+    <tm:task tm:owner="${owner}"/>
+  </tm:request>
+</tm:root>`;
+}
+/**
+ * Parse transport creation response
+ */
+function parseTransportResponse(xmlData) {
+    const parser = new fast_xml_parser_1.XMLParser({
+        ignoreAttributes: false,
+        attributeNamePrefix: '',
+        parseAttributeValue: true,
+    });
+    const result = parser.parse(xmlData);
+    const root = result['tm:root'] || result['root'];
+    if (!root) {
+        throw new Error('Invalid transport response XML structure - no tm:root found');
+    }
+    const request = root['tm:request'] || {};
+    const task = request['tm:task'] || {};
+    return {
+        transport_number: request['tm:number'],
+        description: request['tm:desc'] || request['tm:description'],
+        type: request['tm:type'],
+        target_system: request['tm:target'],
+        target_desc: request['tm:target_desc'],
+        cts_project: request['tm:cts_project'],
+        cts_project_desc: request['tm:cts_project_desc'],
+        uri: request['tm:uri'],
+        parent: request['tm:parent'],
+        owner: task['tm:owner'] || request['tm:owner']
+    };
+}
+/**
+ * Create ABAP transport request
+ */
+async function createTransport(connection, params) {
+    if (!params.description) {
+        throw new Error('Transport description is required');
+    }
+    // Get username from connection config or system information
+    const config = connection.getConfig();
+    let username = params.owner || config.username || process.env.SAP_USERNAME || process.env.SAP_USER;
+    // If username not found in config, try to get from system information
+    if (!username) {
+        try {
+            const { getSystemInformation } = await Promise.resolve().then(() => __importStar(require('../shared/systemInfo')));
+            const systemInfo = await getSystemInformation(connection);
+            if (systemInfo?.userName) {
+                username = systemInfo.userName;
+            }
+        }
+        catch (error) {
+            // Ignore errors - fallback to default
+        }
+    }
+    // If username still not found, throw error (cannot create transport without valid user)
+    if (!username) {
+        throw new Error('Cannot create transport request: username not found. Please provide owner in params, set SAP_USERNAME in config, or ensure system information endpoint is available.');
+    }
+    const baseUrl = await connection.getBaseUrl();
+    const url = `${baseUrl}/sap/bc/adt/cts/transportrequests`;
+    const xmlBody = buildCreateTransportXml(params, username);
+    const headers = {
+        'Accept': 'application/vnd.sap.adt.transportorganizer.v1+xml',
+        'Content-Type': 'text/plain'
+    };
+    try {
+        const response = await connection.makeAdtRequest({
+            url,
+            method: 'POST',
+            timeout: (0, connection_1.getTimeout)('default'),
+            data: xmlBody,
+            headers
+        });
+        const transportInfo = parseTransportResponse(response.data);
+        const requestOwner = params.owner || username;
+        return {
+            data: {
+                success: true,
+                transport_request: transportInfo.transport_number,
+                description: transportInfo.description,
+                type: transportInfo.type,
+                target_system: transportInfo.target_system,
+                target_desc: transportInfo.target_desc,
+                cts_project: transportInfo.cts_project,
+                owner: requestOwner,
+                uri: transportInfo.uri,
+                message: `Transport request ${transportInfo.transport_number} created successfully`
+            },
+            status: response.status,
+            statusText: response.statusText,
+            headers: response.headers,
+            config: response.config
+        };
+    }
+    catch (error) {
+        const errorMessage = error.response?.data
+            ? (typeof error.response.data === 'string' ? error.response.data : JSON.stringify(error.response.data))
+            : error.message;
+        throw new Error(`Failed to create transport request: ${errorMessage}`);
+    }
+}

package/dist/core/transport/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Transport operations - exports
+ */
+export * from './types';
+export * from './create';
+export * from './read';
+export { TransportBuilder, type TransportBuilderConfig, type TransportBuilderLogger, type TransportBuilderState } from './TransportBuilder';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/transport/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/core/transport/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Transport operations - exports
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransportBuilder = void 0;
+__exportStar(require("./types"), exports);
+__exportStar(require("./create"), exports);
+__exportStar(require("./read"), exports);
+var TransportBuilder_1 = require("./TransportBuilder");
+Object.defineProperty(exports, "TransportBuilder", { enumerable: true, get: function () { return TransportBuilder_1.TransportBuilder; } });

package/dist/core/transport/read.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Transport read operations
+ */
+import { AbapConnection } from '@mcp-abap-adt/connection';
+import { AxiosResponse } from 'axios';
+/**
+ * Get ABAP transport request
+ */
+export declare function getTransport(connection: AbapConnection, transportNumber: string): Promise<AxiosResponse>;
+//# sourceMappingURL=read.d.ts.map

package/dist/core/transport/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/core/transport/read.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAc,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAGtC;;GAEG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAW9G"}

package/dist/core/transport/read.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Transport read operations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTransport = getTransport;
+const connection_1 = require("@mcp-abap-adt/connection");
+const internalUtils_1 = require("../../utils/internalUtils");
+/**
+ * Get ABAP transport request
+ */
+async function getTransport(connection, transportNumber) {
+    const baseUrl = await connection.getBaseUrl();
+    const encodedName = (0, internalUtils_1.encodeSapObjectName)(transportNumber);
+    const url = `${baseUrl}/sap/bc/adt/cts/transportrequests/${encodedName}`;
+    return connection.makeAdtRequest({
+        url,
+        method: 'GET',
+        timeout: (0, connection_1.getTimeout)('default'),
+        headers: {}
+    });
+}

package/dist/core/transport/types.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Transport types
+ */
+export interface CreateTransportParams {
+    transport_type?: string;
+    description: string;
+    target_system?: string;
+    owner?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/transport/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/transport/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/core/transport/types.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Transport types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/view/ViewBuilder.d.ts

@@ -0,0 +1,117 @@
+/**
+ * ViewBuilder - Fluent API for view 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)
+ *
+ * @example
+ * ```typescript
+ * const builder = new ViewBuilder(connection, logger, {
+ *   viewName: 'Z_TEST_VIEW',
+ *   packageName: 'ZOK_TEST_PKG_01'
+ * });
+ *
+ * await builder
+ *   .setDdlSource('@AbapCatalog.viewType: #BASIC\n...')
+ *   .create()
+ *   .then(b => b.lock())
+ *   .then(b => b.update())
+ *   .then(b => b.check())
+ *   .then(b => b.unlock())
+ *   .then(b => b.activate())
+ *   .catch(error => {
+ *     logger.error('Operation failed:', error);
+ *   });
+ * ```
+ */
+import { AbapConnection } from '@mcp-abap-adt/connection';
+import { AxiosResponse } from 'axios';
+import { ValidationResult } from '../shared/validation';
+export interface ViewBuilderLogger {
+    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 ViewBuilderConfig {
+    viewName: string;
+    packageName?: string;
+    transportRequest?: string;
+    description?: string;
+    ddlSource?: string;
+    sessionId?: string;
+    onLock?: (lockHandle: string, sessionId: string) => void;
+}
+export interface ViewBuilderState {
+    validationResult?: ValidationResult;
+    createResult?: AxiosResponse;
+    lockHandle?: string;
+    updateResult?: AxiosResponse;
+    checkResult?: AxiosResponse;
+    unlockResult?: AxiosResponse;
+    activateResult?: AxiosResponse;
+    readResult?: AxiosResponse;
+    errors: Array<{
+        method: string;
+        error: Error;
+        timestamp: Date;
+    }>;
+}
+export declare class ViewBuilder {
+    private connection;
+    private logger;
+    private config;
+    private lockHandle?;
+    private sessionId;
+    private state;
+    constructor(connection: AbapConnection, logger: ViewBuilderLogger, config: ViewBuilderConfig);
+    setPackage(packageName: string): this;
+    setRequest(transportRequest: string): this;
+    setName(viewName: string): this;
+    setDescription(description: string): this;
+    setDdlSource(ddlSource: string): this;
+    validate(): Promise<this>;
+    create(): Promise<this>;
+    lock(): Promise<this>;
+    update(): Promise<this>;
+    check(version?: 'active' | 'inactive'): Promise<this>;
+    unlock(): Promise<this>;
+    activate(): Promise<this>;
+    read(version?: 'active' | 'inactive'): Promise<this>;
+    forceUnlock(): Promise<void>;
+    getState(): Readonly<ViewBuilderState>;
+    getViewName(): string;
+    getLockHandle(): string | undefined;
+    getSessionId(): string;
+    getValidationResult(): ValidationResult | undefined;
+    getCreateResult(): AxiosResponse | undefined;
+    getUpdateResult(): AxiosResponse | undefined;
+    getCheckResult(): AxiosResponse | undefined;
+    getUnlockResult(): AxiosResponse | undefined;
+    getActivateResult(): AxiosResponse | undefined;
+    getReadResult(): AxiosResponse | undefined;
+    getErrors(): ReadonlyArray<{
+        method: string;
+        error: Error;
+        timestamp: Date;
+    }>;
+    getResults(): {
+        validate?: ValidationResult;
+        create?: AxiosResponse;
+        update?: AxiosResponse;
+        check?: AxiosResponse;
+        unlock?: AxiosResponse;
+        activate?: AxiosResponse;
+        lockHandle?: string;
+        errors: Array<{
+            method: string;
+            error: Error;
+            timestamp: Date;
+        }>;
+    };
+}
+//# sourceMappingURL=ViewBuilder.d.ts.map

package/dist/core/view/ViewBuilder.d.ts.map

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