@numends/abap-client 0.0.1

package/README.md

@@ -0,0 +1,96 @@
+# @numends/abap-client
+
+WebSocket client that connects your local machine to ABAP MCP Cloud, enabling SAP ADT operations from within your VPN.
+
+## How it works
+
+```
+┌─────────────┐                    ┌──────────────┐
+│ Cursor/      │                    │ abap-client  │
+│ Claude IDE   │                    │ (this tool)  │
+└──────┬──────┘                    └──────┬───────┘
+       │                                  │
+       ↓                                  │
+┌─────────────┐     WebSocket             │
+│ MCP Cloud   │◄──────────────────────────┤
+│ (Server)    │                           │
+└──────┬──────┘                           │
+       │                                  │
+       └──────Command──────────────────────►
+                                          ↓
+                                   ┌──────────────┐
+                                   │  SAP S/4     │
+                                   │  (VPN)       │
+                                   └──────────────┘
+```
+
+1. Connects to MCP Cloud via WebSocket (outbound connection)
+2. Receives commands from MCP Cloud
+3. Executes HTTP requests to SAP S/4HANA (within VPN)
+4. Returns results back to MCP Cloud
+5. Manages SAP session automatically (CSRF tokens, cookies, keep-alive)
+
+## Quick Start
+
+### Prerequisites
+
+- Node.js 20 or higher
+- VPN access to the SAP system
+- An `arc_*` API key from the [Arcanum admin portal](https://arcanum.mcps.b2rise.com)
+- SAP environments registered in the admin portal
+
+### Run with npx (no install needed)
+
+```bash
+npx @numends/abap-client
+```
+
+On first run, you'll be prompted to enter your API key interactively. It will be saved to a `.env` file automatically so you won't need to enter it again.
+
+You can also pass it directly:
+
+```bash
+API_KEY=arc_your_key_here npx @numends/abap-client
+```
+
+### Global install
+
+```bash
+npm install -g @numends/abap-client
+abap-client
+```
+
+## Configuration
+
+The only required configuration is your API key. All other settings (WebSocket URL, admin URL, keep-alive) are handled automatically.
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `API_KEY` | Yes | Your `arc_*` API key from the admin portal |
+| `ENV` | No | Set to `DEVELOPMENT` to use QAS endpoints |
+
+SAP system credentials are managed in the [Arcanum admin portal](https://arcanum.mcps.b2rise.com) and fetched automatically on startup.
+
+## Troubleshooting
+
+### "401 Unauthorized" from SAP
+- Verify SAP username and password in the admin portal
+- Check that the SAP user has the required ADT permissions
+
+### Connection keeps reconnecting
+- Check if API_KEY is valid and has an active subscription
+- Verify the MCP Cloud server is accessible
+
+### "No SAP environments configured"
+- Register your SAP systems in the admin portal first
+
+## Security
+
+- Never commit `.env` files with real credentials
+- API keys should be treated as secrets
+- SAP passwords are encrypted at rest in the admin portal
+- Connections to MCP Cloud use WSS (TLS)
+
+## License
+
+MIT

package/dist/abap-object-utils.d.ts

@@ -0,0 +1,31 @@
+/**
+ * ABAP Object Utilities
+ * Functions for working with ABAP object types and URLs
+ */
+export interface ObjectInfo {
+    objectName: string | null;
+    objectType: string | null;
+}
+interface UrlPattern {
+    regex: RegExp;
+    type: string;
+}
+export interface Callspec {
+    name?: string;
+    step?: string;
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    body?: string;
+    extract_from_response?: Record<string, boolean>;
+    package?: string;
+}
+declare const URL_PATTERNS: UrlPattern[];
+export declare function extractObjectInfoFromUrl(url: string): ObjectInfo;
+export declare function getObjectUriPath(objectType: string): string | null;
+export declare function isLockOperation(callspec: Callspec): boolean;
+export declare function isUnlockOperation(callspec: Callspec): boolean;
+export declare function isActivateOperation(action: string): boolean;
+export declare function getObjectTypeName(objectType: string): string;
+export declare function getLockSuffix(url: string): string;
+export { URL_PATTERNS };

package/dist/abap-object-utils.js

@@ -0,0 +1,113 @@
+/**
+ * ABAP Object Utilities
+ * Functions for working with ABAP object types and URLs
+ */
+const URL_PATTERNS = [
+    { regex: /\/adt\/bo\/behaviordefinitions\/([^/?]+)/, type: 'BDEF' },
+    { regex: /\/adt\/ddic\/ddl\/sources\/([^/?]+)/, type: 'DDLS' },
+    { regex: /\/adt\/oo\/classes\/([^/?]+)/, type: 'CLAS' },
+    { regex: /\/adt\/oo\/interfaces\/([^/?]+)/, type: 'INTF' },
+    { regex: /\/adt\/programs\/programs\/([^/?]+)/, type: 'PROG' },
+    { regex: /\/adt\/programs\/includes\/([^/?]+)/, type: 'INCL' },
+    { regex: /\/adt\/ddic\/ddlx\/sources\/([^/?]+)/, type: 'DDLX' },
+    { regex: /\/adt\/ddic\/srvd\/sources\/([^/?]+)/, type: 'SRVD' },
+    { regex: /\/adt\/srvd\/src\/([^/?]+)/, type: 'SRVD' },
+    { regex: /\/adt\/srvb\/src\/([^/?]+)/, type: 'SRVB' },
+    { regex: /\/adt\/ddic\/tables\/([^/?]+)/, type: 'TABL' },
+    { regex: /\/adt\/ddic\/structures\/([^/?]+)/, type: 'STRU' },
+    { regex: /\/adt\/ddic\/dataelements\/([^/?]+)/, type: 'DTEL' },
+    { regex: /\/adt\/ddic\/domains\/([^/?]+)/, type: 'DOMA' },
+    { regex: /\/adt\/ddic\/tabletypes\/([^/?]+)/, type: 'TTYP' },
+    { regex: /\/adt\/functions\/groups\/([^/?]+)\/fmodules\/([^/?]+)/, type: 'FUNC' },
+    { regex: /\/adt\/functions\/groups\/([^/?]+)/, type: 'FUGR' },
+];
+export function extractObjectInfoFromUrl(url) {
+    if (!url) {
+        return { objectName: null, objectType: null };
+    }
+    for (const pattern of URL_PATTERNS) {
+        const match = url.match(pattern.regex);
+        if (match) {
+            const objectName = match[2] || match[1];
+            return {
+                objectName: objectName.toUpperCase(),
+                objectType: pattern.type
+            };
+        }
+    }
+    return { objectName: null, objectType: null };
+}
+export function getObjectUriPath(objectType) {
+    const uriMap = {
+        'BDEF': '/sap/bc/adt/bo/behaviordefinitions/',
+        'DDLS': '/sap/bc/adt/ddic/ddl/sources/',
+        'CLAS': '/sap/bc/adt/oo/classes/',
+        'INTF': '/sap/bc/adt/oo/interfaces/',
+        'PROG': '/sap/bc/adt/programs/programs/',
+        'INCL': '/sap/bc/adt/programs/includes/',
+        'DDLX': '/sap/bc/adt/ddic/ddlx/sources/',
+        'SRVD': '/sap/bc/adt/ddic/srvd/sources/',
+        'SRVB': '/sap/bc/adt/srvb/src/',
+        'TABL': '/sap/bc/adt/ddic/tables/',
+        'STRU': '/sap/bc/adt/ddic/structures/',
+        'DTEL': '/sap/bc/adt/ddic/dataelements/',
+        'DOMA': '/sap/bc/adt/ddic/domains/',
+        'TTYP': '/sap/bc/adt/ddic/tabletypes/',
+        'FUGR': '/sap/bc/adt/functions/groups/'
+    };
+    return uriMap[objectType.toUpperCase()] || null;
+}
+export function isLockOperation(callspec) {
+    if (callspec.name === 'UNLOCK' ||
+        callspec.name?.startsWith('UNLOCK') ||
+        callspec.url?.includes('_action=UNLOCK')) {
+        return false;
+    }
+    return callspec.name === 'LOCK' ||
+        (callspec.name?.startsWith('LOCK') ?? false) ||
+        (callspec.url?.includes('_action=LOCK') ?? false);
+}
+export function isUnlockOperation(callspec) {
+    return callspec.name === 'UNLOCK' ||
+        (callspec.name?.includes('UNLOCK') ?? false) ||
+        (callspec.url?.includes('_action=UNLOCK') ?? false);
+}
+export function isActivateOperation(action) {
+    return action === 'activate' ||
+        action?.includes('activate') ||
+        action === 'adt_activate';
+}
+export function getObjectTypeName(objectType) {
+    const names = {
+        'BDEF': 'Behavior Definition',
+        'DDLS': 'CDS View',
+        'CLAS': 'Class',
+        'INTF': 'Interface',
+        'PROG': 'Program',
+        'INCL': 'Include',
+        'DDLX': 'Metadata Extension',
+        'SRVD': 'Service Definition',
+        'SRVB': 'Service Binding',
+        'TABL': 'Database Table',
+        'STRU': 'Structure',
+        'DTEL': 'Data Element',
+        'DOMA': 'Domain',
+        'TTYP': 'Table Type',
+        'FUGR': 'Function Group',
+        'FUNC': 'Function Module'
+    };
+    return names[objectType.toUpperCase()] || objectType;
+}
+export function getLockSuffix(url) {
+    if (!url)
+        return '';
+    if (url.includes('/testclasses') || url.includes('/includes/testclasses')) {
+        return 'TESTCLASSES';
+    }
+    if (url.includes('/implementations') || url.includes('/includes/implementations')) {
+        return 'IMPLEMENTATIONS';
+    }
+    return '';
+}
+export { URL_PATTERNS };
+//# sourceMappingURL=abap-object-utils.js.map

package/dist/abap-object-utils.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Configuration Module
+ * Centralizes all configuration for the WebSocket client.
+ *
+ * All URLs are derived in code based on ENV variable:
+ * - ENV=DEVELOPMENT -> QAS endpoints
+ * - Otherwise -> Production endpoints
+ *
+ * Only API_KEY needs to be configured by the user.
+ */
+export interface SapSystemConfig {
+    name: string;
+    baseUrl: string;
+    client: string;
+    username: string;
+    password: string;
+    language: string;
+}
+export interface SapActiveConfig extends SapSystemConfig {
+    systemKey: string | null;
+}
+export interface AppConfig {
+    WS_URL: string;
+    API_KEY: string;
+    MCP_ADMIN_URL: string;
+    SAP: SapActiveConfig;
+    RETRY: {
+        maxAttempts: number;
+        delayMs: number;
+        backoffMultiplier: number;
+    };
+    KEEPALIVE: {
+        enabled: boolean;
+        intervalMs: number;
+    };
+    LOCK: {
+        ttlMs: number;
+    };
+}
+interface SwitchResult {
+    success: boolean;
+    system: string;
+    config: {
+        name: string;
+        baseUrl: string;
+        client: string;
+        language: string;
+    };
+}
+interface SystemSummary {
+    key: string;
+    name: string;
+    baseUrl: string;
+    client: string;
+}
+export declare function fetchSapSystems(): Promise<Record<string, SapSystemConfig>>;
+export declare function getSapConfig(systemKey?: string | null): SapActiveConfig;
+export declare function switchSystem(systemKey: string): SwitchResult;
+export declare function getAvailableSystems(): SystemSummary[];
+export declare function getActiveSystem(): string | null;
+export declare const CONFIG: AppConfig;
+export {};

package/dist/config.js

@@ -0,0 +1,117 @@
+/**
+ * Configuration Module
+ * Centralizes all configuration for the WebSocket client.
+ *
+ * All URLs are derived in code based on ENV variable:
+ * - ENV=DEVELOPMENT -> QAS endpoints
+ * - Otherwise -> Production endpoints
+ *
+ * Only API_KEY needs to be configured by the user.
+ */
+import axios from 'axios';
+const PRODUCTION_ADMIN_URL = 'https://arcanum.mcps.b2rise.com';
+const DEVELOPMENT_ADMIN_URL = 'https://qas-arcanum.mcps.b2rise.com';
+const PRODUCTION_WS_URL = 'wss://abap-mcp.mcps.b2rise.com/ws';
+const DEVELOPMENT_WS_URL = 'wss://qas-abap-mcp.mcps.b2rise.com/ws';
+const KEEPALIVE_INTERVAL_MS = 5 * 60 * 1000;
+function isDevelopment() {
+    return (process.env.ENV || '').toUpperCase() === 'DEVELOPMENT';
+}
+let sapSystems = {};
+let activeSystemKey = null;
+export async function fetchSapSystems() {
+    const adminUrl = CONFIG.MCP_ADMIN_URL;
+    const apiKey = CONFIG.API_KEY;
+    if (!apiKey) {
+        throw new Error('API_KEY is required to fetch SAP environments');
+    }
+    const response = await axios.post(`${adminUrl}/api/sap-environments/by-api-key`, { key: apiKey }, { timeout: 15_000 });
+    if (!response.data.valid) {
+        throw new Error(`API key validation failed: ${response.data.reason}`);
+    }
+    sapSystems = response.data.systems || {};
+    const systemKeys = Object.keys(sapSystems);
+    if (systemKeys.length === 0) {
+        throw new Error('No SAP environments configured. Register your systems at the admin portal.');
+    }
+    if (!activeSystemKey || !sapSystems[activeSystemKey]) {
+        activeSystemKey = systemKeys[0];
+    }
+    CONFIG.SAP = {
+        ...sapSystems[activeSystemKey],
+        systemKey: activeSystemKey,
+    };
+    console.log(`   ✅ Loaded ${systemKeys.length} SAP system(s): ${systemKeys.join(', ')}`);
+    console.log(`   📌 Active system: ${activeSystemKey}`);
+    return sapSystems;
+}
+export function getSapConfig(systemKey = null) {
+    const key = systemKey || activeSystemKey;
+    if (!key || !sapSystems[key]) {
+        const available = Object.keys(sapSystems).join(', ') || 'none';
+        throw new Error(`System "${key}" not found. Available: ${available}`);
+    }
+    return {
+        ...sapSystems[key],
+        systemKey: key,
+    };
+}
+export function switchSystem(systemKey) {
+    if (!sapSystems[systemKey]) {
+        const available = Object.keys(sapSystems).join(', ') || 'none';
+        throw new Error(`System "${systemKey}" not found. Available: ${available}`);
+    }
+    activeSystemKey = systemKey;
+    CONFIG.SAP = {
+        ...sapSystems[systemKey],
+        systemKey,
+    };
+    return {
+        success: true,
+        system: systemKey,
+        config: {
+            name: sapSystems[systemKey].name,
+            baseUrl: sapSystems[systemKey].baseUrl,
+            client: sapSystems[systemKey].client,
+            language: sapSystems[systemKey].language,
+        },
+    };
+}
+export function getAvailableSystems() {
+    return Object.keys(sapSystems).map(key => ({
+        key,
+        name: sapSystems[key].name,
+        baseUrl: sapSystems[key].baseUrl,
+        client: sapSystems[key].client,
+    }));
+}
+export function getActiveSystem() {
+    return activeSystemKey;
+}
+export const CONFIG = {
+    WS_URL: isDevelopment() ? DEVELOPMENT_WS_URL : PRODUCTION_WS_URL,
+    API_KEY: process.env.API_KEY || '',
+    MCP_ADMIN_URL: isDevelopment() ? DEVELOPMENT_ADMIN_URL : PRODUCTION_ADMIN_URL,
+    SAP: {
+        systemKey: null,
+        name: '',
+        baseUrl: '',
+        username: '',
+        password: '',
+        client: '',
+        language: '',
+    },
+    RETRY: {
+        maxAttempts: 3,
+        delayMs: 1000,
+        backoffMultiplier: 2,
+    },
+    KEEPALIVE: {
+        enabled: true,
+        intervalMs: KEEPALIVE_INTERVAL_MS,
+    },
+    LOCK: {
+        ttlMs: 30 * 60 * 1000,
+    },
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * @numends/abap-client
+ * WebSocket client that connects to MCP Cloud and executes SAP ADT operations locally.
+ * SAP environments are fetched from the Arcanum admin portal on startup.
+ */
+import 'dotenv/config';

package/dist/index.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+/**
+ * @numends/abap-client
+ * WebSocket client that connects to MCP Cloud and executes SAP ADT operations locally.
+ * SAP environments are fetched from the Arcanum admin portal on startup.
+ */
+import 'dotenv/config';
+import { createInterface } from 'readline';
+import { writeFileSync, existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { CONFIG, fetchSapSystems } from './config.js';
+import { WebSocketClient } from './websocket-client.js';
+const ENV_PATH = join(process.cwd(), '.env');
+function prompt(question) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+function saveApiKey(apiKey) {
+    if (existsSync(ENV_PATH)) {
+        const content = readFileSync(ENV_PATH, 'utf-8');
+        if (content.includes('API_KEY=')) {
+            const updated = content.replace(/^API_KEY=.*$/m, `API_KEY=${apiKey}`);
+            writeFileSync(ENV_PATH, updated);
+        }
+        else {
+            writeFileSync(ENV_PATH, content.trimEnd() + `\nAPI_KEY=${apiKey}\n`);
+        }
+    }
+    else {
+        writeFileSync(ENV_PATH, `API_KEY=${apiKey}\n`);
+    }
+}
+async function interactiveSetup() {
+    console.log('');
+    console.log('🔧 First-time setup');
+    console.log('─────────────────────────────────────────────');
+    console.log('');
+    console.log('You need an API key to connect to Arcanum MCP Cloud.');
+    console.log('Get yours at: https://arcanum.mcps.b2rise.com');
+    console.log('');
+    const apiKey = await prompt('   Paste your API key (arc_...): ');
+    if (!apiKey || !apiKey.startsWith('arc_')) {
+        console.error('\n❌ Invalid API key. It must start with "arc_".');
+        process.exit(1);
+    }
+    saveApiKey(apiKey);
+    console.log(`\n✅ API key saved to ${ENV_PATH}`);
+    console.log('   You won\'t need to enter it again.\n');
+    return apiKey;
+}
+async function main() {
+    console.log('╔════════════════════════════════════════════════════════════╗');
+    console.log('║  ABAP Client - SAP WebSocket Bridge                       ║');
+    console.log('║  Connects to MCP Cloud and executes SAP operations        ║');
+    console.log('╚════════════════════════════════════════════════════════════╝\n');
+    if (!CONFIG.API_KEY) {
+        const apiKey = await interactiveSetup();
+        CONFIG.API_KEY = apiKey;
+    }
+    console.log('📋 Configuration:');
+    console.log(`   WebSocket: ${CONFIG.WS_URL}`);
+    console.log(`   Admin:     ${CONFIG.MCP_ADMIN_URL}`);
+    console.log(`   API Key:   ${CONFIG.API_KEY.substring(0, 12)}...`);
+    console.log('');
+    console.log('🔄 Fetching SAP environments from admin...');
+    try {
+        await fetchSapSystems();
+    }
+    catch (error) {
+        console.error(`\n❌ Failed to fetch SAP environments: ${error.message}`);
+        process.exit(1);
+    }
+    console.log('');
+    console.log(`   SAP System: ${CONFIG.SAP.baseUrl}`);
+    console.log(`   SAP Client: ${CONFIG.SAP.client}`);
+    console.log(`   SAP User:   ${CONFIG.SAP.username}`);
+    console.log('');
+    const client = new WebSocketClient(CONFIG);
+    client.connect();
+    process.on('SIGINT', () => {
+        console.log('\n\n⚠️  Shutting down gracefully...');
+        client.disconnect();
+        process.exit(0);
+    });
+    process.on('SIGTERM', () => {
+        console.log('\n\n⚠️  Shutting down gracefully...');
+        client.disconnect();
+        process.exit(0);
+    });
+}
+main().catch((error) => {
+    console.error(`❌ Fatal error: ${error.message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lock-manager.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Lock Manager
+ * Manages ABAP object locks to avoid re-locking during multi-step operations
+ */
+export interface LockEntry {
+    lockHandle: string;
+    transportRequest: string;
+    timestamp: number;
+}
+export interface LockStats {
+    activeLocks: number;
+    locks: string[];
+}
+export declare class LockManager {
+    private locks;
+    private lockTTL;
+    constructor();
+    buildKey(objectName: string, objectType: string, suffix?: string): string;
+    getLock(objectName: string, objectType: string, suffix?: string): LockEntry | null;
+    saveLock(objectName: string, objectType: string, lockHandle: string, transportRequest: string, suffix?: string): void;
+    clearLock(objectName: string, objectType: string, suffix?: string): boolean;
+    clearAll(): number;
+    getStats(): LockStats;
+    printLockTable(operation?: string): void;
+}