@mcp-abap-adt/connection 0.1.7 → 0.1.9

package/README.md

@@ -320,9 +320,15 @@ interface AbapConnection {
   enableStatefulSession(sessionId: string, storage: ISessionStorage): Promise<void>;
   disableStatefulSession(): void;
   getSessionMode(): "stateless" | "stateful";
+  getSessionId(): string | undefined; // Get current session ID
+  setSessionType(type: "stateless" | "stateful"): void; // Switch session type
 }
 ```
 
+**New in 0.1.6+:**
+- `getSessionId()`: Returns the current session ID if stateful session is enabled, otherwise `undefined`
+- `setSessionType(type)`: Programmatically switch between stateful and stateless modes without recreating connection
+
 #### `ILogger`
 
 Logger interface for custom logging implementations.
@@ -370,10 +376,21 @@ function createAbapConnection(
 - Node.js >= 18.0.0
 - Access to SAP ABAP system (on-premise or BTP)
 
+## Changelog
+
+See [CHANGELOG.md](./CHANGELOG.md) for detailed version history and breaking changes.
+
+**Latest version: 0.1.9**
+- Comprehensive documentation updates
+- Enhanced README with new API methods documentation
+- Complete version history in CHANGELOG
+- Fixed documentation structure and links
+
 ## Documentation
 
-- [Custom Session Storage](./CUSTOM_SESSION_STORAGE.md) - How to implement custom session persistence (database, Redis, etc.)
+- [Custom Session Storage](./docs/CUSTOM_SESSION_STORAGE.md) - How to implement custom session persistence (database, Redis, etc.)
 - [Examples](./examples/README.md) - Working code examples
+- [Changelog](./CHANGELOG.md) - Version history and release notes
 
 ## License
 

package/dist/connection/AbstractAbapConnection.d.ts

@@ -9,7 +9,7 @@ declare abstract class AbstractAbapConnection implements AbapConnection {
     private csrfToken;
     private cookies;
     private cookieStore;
-    private cachedBaseUrl;
+    private baseUrl;
     private sessionId;
     private sessionStorage;
     private sessionMode;
@@ -117,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":"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"}
+{"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,6 +57,14 @@ 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}`);
     }
     /**
@@ -262,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 = {};
@@ -291,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") {
@@ -688,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.7",
+  "version": "0.1.9",
   "description": "ABAP connection layer for MCP ABAP ADT server",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",