@mcp-abap-adt/connection 0.1.6 → 0.1.8

package/dist/connection/AbapConnection.d.ts

@@ -13,6 +13,8 @@ export interface AbapConnection {
     getConfig(): SapConfig;
     getBaseUrl(): Promise<string>;
     getAuthHeaders(): Promise<Record<string, string>>;
+    getSessionId(): string | null;
+    setSessionType(type: "stateful" | "stateless"): void;
     makeAdtRequest(options: AbapRequestOptions): Promise<AxiosResponse>;
     connect(): Promise<void>;
     reset(): void;

package/dist/connection/AbapConnection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AbapConnection.d.ts","sourceRoot":"","sources":["../../src/connection/AbapConnection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,IAAI,SAAS,CAAC;IACvB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACpE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,IAAI,IAAI,CAAC;IACd,eAAe,IAAI,YAAY,GAAG,IAAI,CAAC;IACvC,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;CAC5C"}
+{"version":3,"file":"AbapConnection.d.ts","sourceRoot":"","sources":["../../src/connection/AbapConnection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,IAAI,SAAS,CAAC;IACvB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,YAAY,IAAI,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,CAAC;IACrD,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACpE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,IAAI,IAAI,CAAC;IACd,eAAe,IAAI,YAAY,GAAG,IAAI,CAAC;IACvC,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;CAC5C"}

package/dist/connection/AbstractAbapConnection.d.ts

@@ -9,20 +9,29 @@ declare abstract class AbstractAbapConnection implements AbapConnection {
     private csrfToken;
     private cookies;
     private cookieStore;
-    private cachedBaseUrl;
+    private baseUrl;
     private sessionId;
     private sessionStorage;
     private sessionMode;
     protected constructor(config: SapConfig, logger: ILogger, sessionStorage?: ISessionStorage, sessionId?: string);
+    /**
+     * Set session type (stateful or stateless)
+     * Controls whether x-sap-adt-sessiontype: stateful header is added to requests
+     * - stateful: SAP maintains session state between requests (locks, transactions)
+     * - stateless: Each request is independent
+     */
+    setSessionType(type: "stateful" | "stateless"): void;
     /**
      * Enable stateful session mode (tells SAP to maintain stateful session)
      * This controls whether x-sap-adt-sessiontype: stateful header is used
      * Storage is controlled separately via setSessionStorage()
+     * @deprecated Use setSessionType("stateful") instead
      */
     enableStatefulSession(): void;
     /**
      * Disable stateful session mode (switch to stateless)
      * Optionally saves current state before switching
+     * @deprecated Use setSessionType("stateless") instead
      */
     disableStatefulSession(saveBeforeDisable?: boolean): Promise<void>;
     /**
@@ -108,7 +117,6 @@ declare abstract class AbstractAbapConnection implements AbapConnection {
     protected getCookies(): string | null;
     private updateCookiesFromResponse;
     private getAxiosInstance;
-    private normalizeRequestUrl;
     private ensureFreshCsrfToken;
     private shouldRetryCsrf;
 }

package/dist/connection/AbstractAbapConnection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AbstractAbapConnection.d.ts","sourceRoot":"","sources":["../../src/connection/AbstractAbapConnection.ts"],"names":[],"mappings":"AAAA,OAAc,EAAiD,aAAa,EAAE,MAAM,OAAO,CAAC;AAG5F,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEtE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzE,uBAAe,sBAAuB,YAAW,cAAc;IAW3D,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO;IAXpC,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,cAAc,CAAgC;IACtD,OAAO,CAAC,WAAW,CAAyC;IAE5D,SAAS,aACU,MAAM,EAAE,SAAS,EACf,MAAM,EAAE,OAAO,EAClC,cAAc,CAAC,EAAE,eAAe,EAChC,SAAS,CAAC,EAAE,MAAM;IAWpB;;;;OAIG;IACH,qBAAqB,IAAI,IAAI;IAQ7B;;;OAGG;IACG,sBAAsB,CAAC,iBAAiB,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB/E;;OAEG;IACH,cAAc,IAAI,WAAW,GAAG,UAAU;IAI1C;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IASrC;;OAEG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B;;;OAGG;IACG,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAcvE;;OAEG;IACH,iBAAiB,IAAI,eAAe,GAAG,IAAI;IAI3C;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBvC;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBvC;;;;OAIG;IACH,eAAe,IAAI,YAAY,GAAG,IAAI;IAYtC;;;;OAIG;IACH,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAY1C;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBxC,SAAS,IAAI,SAAS;IAItB,KAAK,IAAI,IAAI;IAYP,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAkB7B,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAevD;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAE3B,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;IAwMzE,SAAS,CAAC,QAAQ,CAAC,wBAAwB,IAAI,MAAM;IAErD;;;OAGG;cACa,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,SAAI,EAAE,UAAU,SAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAgL/F;;OAEG;IACH,SAAS,CAAC,YAAY,IAAI,MAAM,GAAG,IAAI;IAIvC;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIlD;;OAEG;IACH,SAAS,CAAC,UAAU,IAAI,MAAM,GAAG,IAAI;IAIrC,OAAO,CAAC,yBAAyB;IAuDjC,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,mBAAmB;YAOb,oBAAoB;IAwBlC,OAAO,CAAC,eAAe;CAyBxB;AAGD,OAAO,EAAE,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"AbstractAbapConnection.d.ts","sourceRoot":"","sources":["../../src/connection/AbstractAbapConnection.ts"],"names":[],"mappings":"AAAA,OAAc,EAAiD,aAAa,EAAE,MAAM,OAAO,CAAC;AAG5F,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEtE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzE,uBAAe,sBAAuB,YAAW,cAAc;IAW3D,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO;IAXpC,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,cAAc,CAAgC;IACtD,OAAO,CAAC,WAAW,CAAyC;IAE5D,SAAS,aACU,MAAM,EAAE,SAAS,EACf,MAAM,EAAE,OAAO,EAClC,cAAc,CAAC,EAAE,eAAe,EAChC,SAAS,CAAC,EAAE,MAAM;IAmBpB;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI;IAQpD;;;;;OAKG;IACH,qBAAqB,IAAI,IAAI;IAI7B;;;;OAIG;IACG,sBAAsB,CAAC,iBAAiB,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB/E;;OAEG;IACH,cAAc,IAAI,WAAW,GAAG,UAAU;IAI1C;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IASrC;;OAEG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B;;;OAGG;IACG,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAcvE;;OAEG;IACH,iBAAiB,IAAI,eAAe,GAAG,IAAI;IAI3C;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBvC;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBvC;;;;OAIG;IACH,eAAe,IAAI,YAAY,GAAG,IAAI;IAYtC;;;;OAIG;IACH,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAY1C;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBxC,SAAS,IAAI,SAAS;IAItB,KAAK,IAAI,IAAI;IAYP,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAevD;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAE3B,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;IAsNzE,SAAS,CAAC,QAAQ,CAAC,wBAAwB,IAAI,MAAM;IAErD;;;OAGG;cACa,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,SAAI,EAAE,UAAU,SAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAgL/F;;OAEG;IACH,SAAS,CAAC,YAAY,IAAI,MAAM,GAAG,IAAI;IAIvC;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIlD;;OAEG;IACH,SAAS,CAAC,UAAU,IAAI,MAAM,GAAG,IAAI;IAIrC,OAAO,CAAC,yBAAyB;IAuDjC,OAAO,CAAC,gBAAgB;YAqBV,oBAAoB;IAwBlC,OAAO,CAAC,eAAe;CAyBxB;AAGD,OAAO,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/connection/AbstractAbapConnection.js

@@ -45,7 +45,7 @@ class AbstractAbapConnection {
     csrfToken = null;
     cookies = null;
     cookieStore = new Map();
-    cachedBaseUrl = null;
+    baseUrl;
     sessionId = null;
     sessionStorage = null;
     sessionMode = "stateless";
@@ -57,23 +57,42 @@ class AbstractAbapConnection {
         this.sessionId = sessionId || (0, crypto_1.randomUUID)();
         // Session mode depends only on storage availability (sessionId exists for both modes)
         this.sessionMode = sessionStorage ? "stateful" : "stateless";
+        // Initialize baseUrl from config (required, will throw if invalid)
+        try {
+            const urlObj = new URL(config.url);
+            this.baseUrl = urlObj.origin;
+        }
+        catch (error) {
+            throw new Error(`Invalid URL in configuration: ${error instanceof Error ? error.message : error}`);
+        }
         this.logger.debug(`AbstractAbapConnection - Session ID: ${this.sessionId.substring(0, 8)}..., mode: ${this.sessionMode}`);
     }
+    /**
+     * Set session type (stateful or stateless)
+     * Controls whether x-sap-adt-sessiontype: stateful header is added to requests
+     * - stateful: SAP maintains session state between requests (locks, transactions)
+     * - stateless: Each request is independent
+     */
+    setSessionType(type) {
+        this.sessionMode = type;
+        this.logger.debug(`Session type set to: ${type}`, {
+            sessionId: this.sessionId?.substring(0, 8),
+            hasStorage: !!this.sessionStorage
+        });
+    }
     /**
      * Enable stateful session mode (tells SAP to maintain stateful session)
      * This controls whether x-sap-adt-sessiontype: stateful header is used
      * Storage is controlled separately via setSessionStorage()
+     * @deprecated Use setSessionType("stateful") instead
      */
     enableStatefulSession() {
-        this.sessionMode = "stateful";
-        this.logger.debug("Stateful session mode enabled", {
-            sessionId: this.sessionId?.substring(0, 8),
-            hasStorage: !!this.sessionStorage
-        });
+        this.setSessionType("stateful");
     }
     /**
      * Disable stateful session mode (switch to stateless)
      * Optionally saves current state before switching
+     * @deprecated Use setSessionType("stateless") instead
      */
     async disableStatefulSession(saveBeforeDisable = false) {
         if (this.sessionMode === "stateless") {
@@ -251,22 +270,10 @@ class AbstractAbapConnection {
         this.csrfToken = null;
         this.cookies = null;
         this.cookieStore.clear();
-        this.cachedBaseUrl = null;
+        // Note: baseUrl is not reset as it's derived from immutable config
     }
     async getBaseUrl() {
-        if (this.cachedBaseUrl) {
-            return this.cachedBaseUrl;
-        }
-        const { url } = this.config;
-        try {
-            const urlObj = new URL(url);
-            this.cachedBaseUrl = urlObj.origin;
-            return this.cachedBaseUrl;
-        }
-        catch (error) {
-            const errorMessage = `Invalid URL in configuration: ${error instanceof Error ? error.message : error}`;
-            throw new Error(errorMessage);
-        }
+        return this.baseUrl;
     }
     async getAuthHeaders() {
         const headers = {};
@@ -280,9 +287,10 @@ class AbstractAbapConnection {
         return headers;
     }
     async makeAdtRequest(options) {
-        const { url, method, timeout, data, params, headers: customHeaders } = options;
+        const { url: endpoint, method, timeout, data, params, headers: customHeaders } = options;
         const normalizedMethod = method.toUpperCase();
-        const requestUrl = this.normalizeRequestUrl(url);
+        // Build full URL: baseUrl + endpoint
+        const requestUrl = `${this.baseUrl}${endpoint}`;
         // Try to ensure CSRF token is available for POST/PUT/DELETE, but don't fail if it can't be fetched
         // The retry logic will handle CSRF token errors automatically
         if (normalizedMethod === "POST" || normalizedMethod === "PUT" || normalizedMethod === "DELETE") {
@@ -306,6 +314,16 @@ class AbstractAbapConnection {
         if (customHeaders) {
             Object.assign(requestHeaders, customHeaders);
         }
+        // ALWAYS add sap-adt-connection-id header (connectionId is sent for ALL session types)
+        if (this.sessionId) {
+            requestHeaders["sap-adt-connection-id"] = this.sessionId;
+        }
+        // Add stateful session headers if stateful mode enabled via enableStatefulSession()
+        if (this.sessionMode === "stateful") {
+            requestHeaders["x-sap-adt-sessiontype"] = "stateful";
+            requestHeaders["sap-adt-request-id"] = (0, crypto_1.randomUUID)().replace(/-/g, '');
+            requestHeaders["X-sap-adt-profiling"] = "server-time";
+        }
         // Add auth headers (these MUST NOT be overridden)
         Object.assign(requestHeaders, await this.getAuthHeaders());
         if ((normalizedMethod === "POST" || normalizedMethod === "PUT" || normalizedMethod === "DELETE") && this.csrfToken) {
@@ -667,12 +685,6 @@ class AbstractAbapConnection {
         }
         return this.axiosInstance;
     }
-    normalizeRequestUrl(url) {
-        if (!url.includes("/sap/bc/adt/") && !url.endsWith("/sap/bc/adt")) {
-            return url.endsWith("/") ? `${url}sap/bc/adt` : `${url}/sap/bc/adt`;
-        }
-        return url;
-    }
     async ensureFreshCsrfToken(requestUrl) {
         // If we already have a CSRF token, reuse it to keep the same SAP session
         // SAP ties the lock handle to the HTTP session (SAP_SESSIONID cookie)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-abap-adt/connection",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "ABAP connection layer for MCP ABAP ADT server",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",