@mcp-abap-adt/core 2.5.0 → 2.5.2

package/dist/utils/lockStateManager.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Lock State Manager - persists lock handles and session IDs to filesystem
+ * Allows recovery and cleanup of locks after crashes or interruptions
+ */
+export interface LockState {
+    sessionId: string;
+    lockHandle: string;
+    objectType: 'class' | 'interface' | 'program' | 'fm' | 'domain' | 'dataElement' | 'view' | 'table' | 'structure' | 'package';
+    objectName: string;
+    functionGroupName?: string;
+    timestamp: number;
+    pid: number;
+    testFile?: string;
+}
+export interface LockRegistry {
+    locks: LockState[];
+}
+export declare class LockStateManager {
+    private lockFilePath;
+    private registry;
+    constructor(lockDir?: string);
+    /**
+     * Load lock registry from file
+     */
+    private loadRegistry;
+    /**
+     * Save lock registry to file
+     */
+    private saveRegistry;
+    /**
+     * Register a new lock
+     */
+    registerLock(lock: Omit<LockState, 'timestamp' | 'pid'>): void;
+    /**
+     * Remove lock from registry
+     */
+    removeLock(objectType: string, objectName: string, functionGroupName?: string): void;
+    /**
+     * Get lock for specific object
+     */
+    getLock(objectType: string, objectName: string, functionGroupName?: string): LockState | undefined;
+    /**
+     * Get all active locks
+     */
+    getAllLocks(): LockState[];
+    /**
+     * Get stale locks (older than threshold)
+     */
+    getStaleLocks(maxAgeMs?: number): LockState[];
+    /**
+     * Get locks from dead processes
+     */
+    getDeadProcessLocks(): LockState[];
+    /**
+     * Clean up stale locks
+     */
+    cleanupStaleLocks(maxAgeMs?: number): LockState[];
+    /**
+     * Clear all locks
+     */
+    clearAll(): void;
+}
+export declare function getLockStateManager(lockDir?: string): LockStateManager;
+//# sourceMappingURL=lockStateManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lockStateManager.d.ts","sourceRoot":"","sources":["../../src/utils/lockStateManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EACN,OAAO,GACP,WAAW,GACX,SAAS,GACT,IAAI,GACJ,QAAQ,GACR,aAAa,GACb,MAAM,GACN,OAAO,GACP,WAAW,GACX,SAAS,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAe;gBAEnB,OAAO,GAAE,MAAiB;IAWtC;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,OAAO,CAAC,YAAY;IAYpB;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,GAAG,KAAK,CAAC,GAAG,IAAI;IAqB9D;;OAEG;IACH,UAAU,CACR,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,iBAAiB,CAAC,EAAE,MAAM,GACzB,IAAI;IAYP;;OAEG;IACH,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,iBAAiB,CAAC,EAAE,MAAM,GACzB,SAAS,GAAG,SAAS;IASxB;;OAEG;IACH,WAAW,IAAI,SAAS,EAAE;IAI1B;;OAEG;IACH,aAAa,CAAC,QAAQ,GAAE,MAAuB,GAAG,SAAS,EAAE;IAK7D;;OAEG;IACH,mBAAmB,IAAI,SAAS,EAAE;IAYlC;;OAEG;IACH,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE;IAYjD;;OAEG;IACH,QAAQ,IAAI,IAAI;CAIjB;AAKD,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAKtE"}

package/dist/utils/lockStateManager.js

@@ -0,0 +1,173 @@
+"use strict";
+/**
+ * Lock State Manager - persists lock handles and session IDs to filesystem
+ * Allows recovery and cleanup of locks after crashes or interruptions
+ */
+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.LockStateManager = void 0;
+exports.getLockStateManager = getLockStateManager;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+class LockStateManager {
+    lockFilePath;
+    registry;
+    constructor(lockDir = '.locks') {
+        // Create locks directory if it doesn't exist
+        const baseDir = path.resolve(process.cwd(), lockDir);
+        if (!fs.existsSync(baseDir)) {
+            fs.mkdirSync(baseDir, { recursive: true });
+        }
+        this.lockFilePath = path.join(baseDir, 'active-locks.json');
+        this.registry = this.loadRegistry();
+    }
+    /**
+     * Load lock registry from file
+     */
+    loadRegistry() {
+        if (fs.existsSync(this.lockFilePath)) {
+            try {
+                const data = fs.readFileSync(this.lockFilePath, 'utf-8');
+                return JSON.parse(data);
+            }
+            catch (error) {
+                console.warn(`Failed to load lock registry: ${error}`);
+                return { locks: [] };
+            }
+        }
+        return { locks: [] };
+    }
+    /**
+     * Save lock registry to file
+     */
+    saveRegistry() {
+        try {
+            fs.writeFileSync(this.lockFilePath, JSON.stringify(this.registry, null, 2), 'utf-8');
+        }
+        catch (error) {
+            console.error(`Failed to save lock registry: ${error}`);
+        }
+    }
+    /**
+     * Register a new lock
+     */
+    registerLock(lock) {
+        const lockState = {
+            ...lock,
+            timestamp: Date.now(),
+            pid: process.pid,
+        };
+        // Remove old lock for same object if exists
+        this.registry.locks = this.registry.locks.filter((l) => !(l.objectType === lock.objectType &&
+            l.objectName === lock.objectName &&
+            l.functionGroupName === lock.functionGroupName));
+        this.registry.locks.push(lockState);
+        this.saveRegistry();
+    }
+    /**
+     * Remove lock from registry
+     */
+    removeLock(objectType, objectName, functionGroupName) {
+        this.registry.locks = this.registry.locks.filter((l) => !(l.objectType === objectType &&
+            l.objectName === objectName &&
+            l.functionGroupName === functionGroupName));
+        this.saveRegistry();
+    }
+    /**
+     * Get lock for specific object
+     */
+    getLock(objectType, objectName, functionGroupName) {
+        return this.registry.locks.find((l) => l.objectType === objectType &&
+            l.objectName === objectName &&
+            l.functionGroupName === functionGroupName);
+    }
+    /**
+     * Get all active locks
+     */
+    getAllLocks() {
+        return [...this.registry.locks];
+    }
+    /**
+     * Get stale locks (older than threshold)
+     */
+    getStaleLocks(maxAgeMs = 30 * 60 * 1000) {
+        const now = Date.now();
+        return this.registry.locks.filter((l) => now - l.timestamp > maxAgeMs);
+    }
+    /**
+     * Get locks from dead processes
+     */
+    getDeadProcessLocks() {
+        return this.registry.locks.filter((l) => {
+            try {
+                // Check if process is still running
+                process.kill(l.pid, 0);
+                return false; // Process exists
+            }
+            catch (_e) {
+                return true; // Process doesn't exist
+            }
+        });
+    }
+    /**
+     * Clean up stale locks
+     */
+    cleanupStaleLocks(maxAgeMs) {
+        const staleLocks = this.getStaleLocks(maxAgeMs);
+        const deadProcessLocks = this.getDeadProcessLocks();
+        const toCleanup = [...new Set([...staleLocks, ...deadProcessLocks])];
+        toCleanup.forEach((lock) => {
+            this.removeLock(lock.objectType, lock.objectName, lock.functionGroupName);
+        });
+        return toCleanup;
+    }
+    /**
+     * Clear all locks
+     */
+    clearAll() {
+        this.registry = { locks: [] };
+        this.saveRegistry();
+    }
+}
+exports.LockStateManager = LockStateManager;
+// Global instance
+let globalManager = null;
+function getLockStateManager(lockDir) {
+    if (!globalManager) {
+        globalManager = new LockStateManager(lockDir);
+    }
+    return globalManager;
+}
+//# sourceMappingURL=lockStateManager.js.map

package/dist/utils/lockStateManager.js.map

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

package/docs/user-guide/AUTHENTICATION.md

@@ -24,6 +24,7 @@ mcp-abap-adt --transport=stdio --mcp=TRIAL
 ```
 
 The server will load the matching service key and manage tokens automatically.
+When `--mcp=<destination>` is specified, automatic fallback loading of local `./.env` is skipped.
 
 ## .env Authentication
 
@@ -49,6 +50,12 @@ This writes JWT details to `.env`.
 
 **Claude recommendation:** for Claude, prefer service keys in `service-keys` and use `--mcp=<destination>` instead of manual tokens.
 
+If browser-based OAuth callback port is occupied, override it:
+
+```bash
+mcp-abap-adt --transport=http --mcp=TRIAL --browser-auth-port=5100
+```
+
 ## HTTP/SSE Headers
 
 For HTTP/SSE transports, you can supply auth per request using headers: