@mcp-abap-adt/connection 0.1.0

package/dist/utils/FileSessionStorage.d.ts

@@ -0,0 +1,73 @@
+/**
+ * File-based session storage implementation
+ * Stores session state (cookies, CSRF tokens) in JSON files on disk
+ */
+import { ISessionStorage, SessionState } from '../logger.js';
+export interface FileSessionStorageOptions {
+    /**
+     * Directory to store session files
+     * @default '.sessions'
+     */
+    sessionDir?: string;
+    /**
+     * Whether to create session directory if it doesn't exist
+     * @default true
+     */
+    createDir?: boolean;
+    /**
+     * Pretty-print JSON files (for debugging)
+     * @default false
+     */
+    prettyPrint?: boolean;
+}
+/**
+ * File-based session storage
+ * Stores each session in a separate JSON file: .sessions/<sessionId>.json
+ */
+export declare class FileSessionStorage implements ISessionStorage {
+    private readonly sessionDir;
+    private readonly prettyPrint;
+    constructor(options?: FileSessionStorageOptions);
+    /**
+     * Get file path for session
+     */
+    private getSessionFilePath;
+    /**
+     * Save session state to file
+     */
+    save(sessionId: string, state: SessionState): Promise<void>;
+    /**
+     * Load session state from file
+     */
+    load(sessionId: string): Promise<SessionState | null>;
+    /**
+     * Delete session state file
+     */
+    delete(sessionId: string): Promise<void>;
+    /**
+     * List all session IDs
+     */
+    listSessions(): Promise<string[]>;
+    /**
+     * Get session metadata (without loading full state)
+     */
+    getSessionMetadata(sessionId: string): Promise<{
+        sessionId: string;
+        timestamp: number;
+        pid: number;
+        age: number;
+    } | null>;
+    /**
+     * Clean up stale sessions (older than maxAge)
+     */
+    cleanupStaleSessions(maxAgeMs?: number): Promise<string[]>;
+    /**
+     * Clean up sessions from dead processes
+     */
+    cleanupDeadProcessSessions(): Promise<string[]>;
+    /**
+     * Clear all sessions
+     */
+    clearAll(): Promise<void>;
+}
+//# sourceMappingURL=FileSessionStorage.d.ts.map

package/dist/utils/FileSessionStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSessionStorage.d.ts","sourceRoot":"","sources":["../../src/utils/FileSessionStorage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE7D,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;gBAE1B,OAAO,GAAE,yBAA8B;IAenD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBjE;;OAEG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAiB3D;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9C;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAWvC;;OAEG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QACnD,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;KACb,GAAG,IAAI,CAAC;IAqBT;;OAEG;IACG,oBAAoB,CAAC,QAAQ,GAAE,MAAuB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgBhF;;OAEG;IACG,0BAA0B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAqBrD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAMhC"}

package/dist/utils/FileSessionStorage.js

@@ -0,0 +1,191 @@
+"use strict";
+/**
+ * File-based session storage implementation
+ * Stores session state (cookies, CSRF tokens) in JSON files on disk
+ */
+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.FileSessionStorage = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * File-based session storage
+ * Stores each session in a separate JSON file: .sessions/<sessionId>.json
+ */
+class FileSessionStorage {
+    sessionDir;
+    prettyPrint;
+    constructor(options = {}) {
+        const { sessionDir = '.sessions', createDir = true, prettyPrint = false } = options;
+        this.sessionDir = path.resolve(process.cwd(), sessionDir);
+        this.prettyPrint = prettyPrint;
+        if (createDir && !fs.existsSync(this.sessionDir)) {
+            fs.mkdirSync(this.sessionDir, { recursive: true });
+        }
+    }
+    /**
+     * Get file path for session
+     */
+    getSessionFilePath(sessionId) {
+        // Sanitize session ID to prevent path traversal
+        const sanitizedId = sessionId.replace(/[^a-zA-Z0-9_-]/g, '_');
+        return path.join(this.sessionDir, `${sanitizedId}.json`);
+    }
+    /**
+     * Save session state to file
+     */
+    async save(sessionId, state) {
+        const filePath = this.getSessionFilePath(sessionId);
+        const data = {
+            sessionId,
+            timestamp: Date.now(),
+            pid: process.pid,
+            state
+        };
+        const json = this.prettyPrint
+            ? JSON.stringify(data, null, 2)
+            : JSON.stringify(data);
+        await fs.promises.writeFile(filePath, json, 'utf-8');
+    }
+    /**
+     * Load session state from file
+     */
+    async load(sessionId) {
+        const filePath = this.getSessionFilePath(sessionId);
+        if (!fs.existsSync(filePath)) {
+            return null;
+        }
+        try {
+            const json = await fs.promises.readFile(filePath, 'utf-8');
+            const data = JSON.parse(json);
+            return data.state || null;
+        }
+        catch (error) {
+            // File corrupted or invalid JSON
+            return null;
+        }
+    }
+    /**
+     * Delete session state file
+     */
+    async delete(sessionId) {
+        const filePath = this.getSessionFilePath(sessionId);
+        if (fs.existsSync(filePath)) {
+            await fs.promises.unlink(filePath);
+        }
+    }
+    /**
+     * List all session IDs
+     */
+    async listSessions() {
+        if (!fs.existsSync(this.sessionDir)) {
+            return [];
+        }
+        const files = await fs.promises.readdir(this.sessionDir);
+        return files
+            .filter(f => f.endsWith('.json'))
+            .map(f => f.replace('.json', ''));
+    }
+    /**
+     * Get session metadata (without loading full state)
+     */
+    async getSessionMetadata(sessionId) {
+        const filePath = this.getSessionFilePath(sessionId);
+        if (!fs.existsSync(filePath)) {
+            return null;
+        }
+        try {
+            const json = await fs.promises.readFile(filePath, 'utf-8');
+            const data = JSON.parse(json);
+            return {
+                sessionId: data.sessionId,
+                timestamp: data.timestamp,
+                pid: data.pid,
+                age: Date.now() - data.timestamp
+            };
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    /**
+     * Clean up stale sessions (older than maxAge)
+     */
+    async cleanupStaleSessions(maxAgeMs = 30 * 60 * 1000) {
+        const sessions = await this.listSessions();
+        const stale = [];
+        const now = Date.now();
+        for (const sessionId of sessions) {
+            const metadata = await this.getSessionMetadata(sessionId);
+            if (metadata && (now - metadata.timestamp) > maxAgeMs) {
+                await this.delete(sessionId);
+                stale.push(sessionId);
+            }
+        }
+        return stale;
+    }
+    /**
+     * Clean up sessions from dead processes
+     */
+    async cleanupDeadProcessSessions() {
+        const sessions = await this.listSessions();
+        const dead = [];
+        for (const sessionId of sessions) {
+            const metadata = await this.getSessionMetadata(sessionId);
+            if (metadata) {
+                try {
+                    // Check if process is still running
+                    process.kill(metadata.pid, 0);
+                }
+                catch (e) {
+                    // Process doesn't exist
+                    await this.delete(sessionId);
+                    dead.push(sessionId);
+                }
+            }
+        }
+        return dead;
+    }
+    /**
+     * Clear all sessions
+     */
+    async clearAll() {
+        const sessions = await this.listSessions();
+        for (const sessionId of sessions) {
+            await this.delete(sessionId);
+        }
+    }
+}
+exports.FileSessionStorage = FileSessionStorage;

package/dist/utils/timeouts.d.ts

@@ -0,0 +1,8 @@
+export interface TimeoutConfig {
+    default: number;
+    csrf: number;
+    long: number;
+}
+export declare function getTimeoutConfig(): TimeoutConfig;
+export declare function getTimeout(type?: "default" | "csrf" | "long" | number): number;
+//# sourceMappingURL=timeouts.d.ts.map

package/dist/utils/timeouts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeouts.d.ts","sourceRoot":"","sources":["../../src/utils/timeouts.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAUhD;AAED,wBAAgB,UAAU,CAAC,IAAI,GAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAkB,GAAG,MAAM,CAOzF"}

package/dist/utils/timeouts.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTimeoutConfig = getTimeoutConfig;
+exports.getTimeout = getTimeout;
+function getTimeoutConfig() {
+    const defaultTimeout = parseInt(process.env.SAP_TIMEOUT_DEFAULT || "45000", 10);
+    const csrfTimeout = parseInt(process.env.SAP_TIMEOUT_CSRF || "15000", 10);
+    const longTimeout = parseInt(process.env.SAP_TIMEOUT_LONG || "60000", 10);
+    return {
+        default: defaultTimeout,
+        csrf: csrfTimeout,
+        long: longTimeout
+    };
+}
+function getTimeout(type = "default") {
+    if (typeof type === "number") {
+        return type;
+    }
+    const config = getTimeoutConfig();
+    return config[type];
+}

package/dist/utils/tokenRefresh.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Token refresh utilities for JWT authentication
+ */
+export interface TokenRefreshResult {
+    accessToken: string;
+    refreshToken?: string;
+}
+/**
+ * Refreshes the access token using refresh token
+ * @param refreshToken Refresh token
+ * @param uaaUrl UAA URL (e.g., https://your-account.authentication.eu10.hana.ondemand.com)
+ * @param clientId UAA client ID
+ * @param clientSecret UAA client secret
+ * @returns Promise that resolves to new tokens
+ */
+export declare function refreshJwtToken(refreshToken: string, uaaUrl: string, clientId: string, clientSecret: string): Promise<TokenRefreshResult>;
+//# sourceMappingURL=tokenRefresh.d.ts.map

package/dist/utils/tokenRefresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenRefresh.d.ts","sourceRoot":"","sources":["../../src/utils/tokenRefresh.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAqC7B"}

package/dist/utils/tokenRefresh.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * Token refresh utilities for JWT authentication
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.refreshJwtToken = refreshJwtToken;
+const axios_1 = __importDefault(require("axios"));
+/**
+ * Refreshes the access token using refresh token
+ * @param refreshToken Refresh token
+ * @param uaaUrl UAA URL (e.g., https://your-account.authentication.eu10.hana.ondemand.com)
+ * @param clientId UAA client ID
+ * @param clientSecret UAA client secret
+ * @returns Promise that resolves to new tokens
+ */
+async function refreshJwtToken(refreshToken, uaaUrl, clientId, clientSecret) {
+    try {
+        const tokenUrl = `${uaaUrl}/oauth/token`;
+        const params = new URLSearchParams();
+        params.append('grant_type', 'refresh_token');
+        params.append('refresh_token', refreshToken);
+        const authString = Buffer.from(`${clientId}:${clientSecret}`).toString('base64');
+        const response = await (0, axios_1.default)({
+            method: 'post',
+            url: tokenUrl,
+            headers: {
+                Authorization: `Basic ${authString}`,
+                'Content-Type': 'application/x-www-form-urlencoded',
+            },
+            data: params.toString(),
+        });
+        if (response.data && response.data.access_token) {
+            return {
+                accessToken: response.data.access_token,
+                refreshToken: response.data.refresh_token || refreshToken, // Use new refresh token if provided, otherwise keep old one
+            };
+        }
+        else {
+            throw new Error('Response does not contain access_token');
+        }
+    }
+    catch (error) {
+        if (error.response) {
+            throw new Error(`Token refresh failed (${error.response.status}): ${JSON.stringify(error.response.data)}`);
+        }
+        else {
+            throw new Error(`Token refresh failed: ${error.message}`);
+        }
+    }
+}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@mcp-abap-adt/connection",
+  "version": "0.1.0",
+  "description": "ABAP connection layer for MCP ABAP ADT server",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "sap-abap-auth": "./bin/sap-abap-auth.js"
+  },
+  "keywords": [
+    "abap",
+    "sap",
+    "adt",
+    "connection",
+    "mcp",
+    "abap-adt"
+  ],
+  "author": "Oleksii Kyslytsia <oleksij.kyslytsja@gmail.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/fr0ster/mcp-abap-adt#readme",
+  "bugs": {
+    "url": "https://github.com/fr0ster/mcp-abap-adt/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fr0ster/mcp-abap-adt.git",
+    "directory": "packages/connection"
+  },
+  "scripts": {
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "build": "npm run clean --silent && npx tsc -p tsconfig.json",
+    "build:fast": "npx tsc -p tsconfig.json",
+    "install:local": "npm install --no-workspaces",
+    "pack": "npm run build && npm pack",
+    "test": "jest",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "axios": "^1.11.0",
+    "commander": "^14.0.2",
+    "express": "^5.1.0",
+    "open": "^11.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.10.1",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.2.5",
+    "typescript": "^5.9.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}