@mcp-abap-adt/auth-stores 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,45 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2024-12-04
+
+### Added
+- Initial release of unified stores package
+- **BTP Stores**:
+  - `BtpServiceKeyStore` - Reads XSUAA service keys for base BTP connections
+  - `BtpSessionStore` - File-based store for base BTP sessions (uses `XSUAA_*` env vars)
+  - `SafeBtpSessionStore` - In-memory store for base BTP sessions
+- **ABAP Stores**:
+  - `AbapServiceKeyStore` - Reads ABAP service keys with nested `uaa` object
+  - `AbapSessionStore` - File-based store for ABAP sessions (uses `SAP_*` env vars)
+  - `SafeAbapSessionStore` - In-memory store for ABAP sessions
+- **XSUAA Stores**:
+  - `XsuaaServiceKeyStore` - Reads XSUAA service keys (direct format)
+  - `XsuaaSessionStore` - File-based store for XSUAA sessions (uses `XSUAA_*` env vars)
+  - `SafeXsuaaSessionStore` - In-memory store for XSUAA sessions
+- **Abstract Base Classes**:
+  - `AbstractServiceKeyStore` - Base class for service key stores with file I/O
+  - `AbstractJsonSessionStore` - Base class for file-based session stores
+  - `AbstractSafeSessionStore` - Base class for in-memory session stores
+- **Utilities**:
+  - `pathResolver` - Resolve search paths and find files in multiple directories
+  - `constants` - Environment variable name constants for ABAP, BTP, and XSUAA
+  - Service key loaders for ABAP and XSUAA formats
+- **Testing**:
+  - Unit tests for parsers (AbapServiceKeyParser, XsuaaServiceKeyParser)
+  - Unit tests for service key stores with mocked file system
+  - Jest configuration with TypeScript support
+
+### Changed
+- Merged `@mcp-abap-adt/auth-stores-btp` and `@mcp-abap-adt/auth-stores-xsuaa` into single unified package
+- Eliminated code duplication in abstract classes and utility functions
+- Unified constants for all store types (ABAP, BTP, XSUAA)
+- Consistent API across all store implementations
+
+### Dependencies
+- `@mcp-abap-adt/auth-broker` ^0.1.6 - Interface definitions (`IServiceKeyStore`, `ISessionStore`, `IAuthorizationConfig`, `IConnectionConfig`, `IConfig`)
+- `dotenv` ^17.2.1 - Environment variable parsing for `.env` files

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Oleksii Kyslytsia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,209 @@
+# @mcp-abap-adt/auth-stores
+
+Stores for MCP ABAP ADT auth-broker - BTP, ABAP, and XSUAA implementations.
+
+This package provides file-based and in-memory stores for service keys and sessions used by the `@mcp-abap-adt/auth-broker` package.
+
+## Installation
+
+```bash
+npm install @mcp-abap-adt/auth-stores
+```
+
+## Overview
+
+This package implements the `IServiceKeyStore` and `ISessionStore` interfaces from `@mcp-abap-adt/auth-broker`:
+
+- **Service Key Stores**: Read service key JSON files from configured search paths
+- **Session Stores**: Read/write session data from/to `.env` files or in-memory storage
+- **Abstract Classes**: Base classes for creating custom store implementations
+
+## Store Types
+
+### Service Key Stores
+
+Service key stores read JSON files containing UAA credentials and connection information:
+
+- **`BtpServiceKeyStore`** - Reads XSUAA service keys for base BTP (direct XSUAA format)
+- **`AbapServiceKeyStore`** - Reads ABAP service keys (with nested `uaa` object)
+- **`XsuaaServiceKeyStore`** - Reads XSUAA service keys (alias for BtpServiceKeyStore)
+
+### Session Stores
+
+Session stores manage authentication tokens and configuration:
+
+**File-based stores** (persist to `.env` files):
+- **`BtpSessionStore`** - Stores base BTP sessions using `XSUAA_*` environment variables
+- **`AbapSessionStore`** - Stores ABAP sessions using `SAP_*` environment variables
+- **`XsuaaSessionStore`** - Stores XSUAA sessions using `XSUAA_*` environment variables
+
+**In-memory stores** (non-persistent, secure):
+- **`SafeBtpSessionStore`** - In-memory store for base BTP sessions
+- **`SafeAbapSessionStore`** - In-memory store for ABAP sessions
+- **`SafeXsuaaSessionStore`** - In-memory store for XSUAA sessions
+
+## Usage
+
+### BTP Stores (base BTP without sapUrl)
+
+```typescript
+import { BtpServiceKeyStore, BtpSessionStore, SafeBtpSessionStore } from '@mcp-abap-adt/auth-stores';
+
+// Service key store - reads {destination}.json files
+const serviceKeyStore = new BtpServiceKeyStore(['/path/to/service-keys']);
+
+// File-based session store - reads/writes {destination}.env files
+const sessionStore = new BtpSessionStore(['/path/to/sessions']);
+
+// In-memory session store (non-persistent)
+const safeSessionStore = new SafeBtpSessionStore();
+```
+
+### ABAP Stores (with sapUrl)
+
+```typescript
+import { AbapServiceKeyStore, AbapSessionStore, SafeAbapSessionStore } from '@mcp-abap-adt/auth-stores';
+
+// Service key store - reads ABAP service keys with nested uaa object
+const serviceKeyStore = new AbapServiceKeyStore(['/path/to/service-keys']);
+
+// File-based session store - stores ABAP sessions with SAP_* env vars
+const sessionStore = new AbapSessionStore(['/path/to/sessions']);
+
+// In-memory session store
+const safeSessionStore = new SafeAbapSessionStore();
+```
+
+### XSUAA Stores
+
+```typescript
+import { XsuaaServiceKeyStore, XsuaaSessionStore, SafeXsuaaSessionStore } from '@mcp-abap-adt/auth-stores';
+
+// Service key store - reads XSUAA service keys
+const serviceKeyStore = new XsuaaServiceKeyStore(['/path/to/service-keys']);
+
+// File-based session store - stores XSUAA sessions
+const sessionStore = new XsuaaSessionStore(['/path/to/sessions']);
+
+// In-memory session store
+const safeSessionStore = new SafeXsuaaSessionStore();
+```
+
+### Search Paths
+
+Search paths are resolved in priority order:
+
+1. **Constructor parameter** (highest priority)
+2. **`AUTH_BROKER_PATH` environment variable** (colon/semicolon-separated paths)
+3. **Current working directory** (lowest priority, only if no other paths specified)
+
+```typescript
+// Single path
+const store = new BtpServiceKeyStore('/path/to/keys');
+
+// Multiple paths
+const store = new BtpServiceKeyStore(['/path1', '/path2', '/path3']);
+
+// Use environment variable
+process.env.AUTH_BROKER_PATH = '/path1:/path2:/path3';
+const store = new BtpServiceKeyStore(); // Uses AUTH_BROKER_PATH
+```
+
+### Service Key Format
+
+**ABAP Service Key** (with nested `uaa` object):
+```json
+{
+  "uaa": {
+    "url": "https://...authentication...hana.ondemand.com",
+    "clientid": "...",
+    "clientsecret": "..."
+  },
+  "abap": {
+    "url": "https://...abap...hana.ondemand.com",
+    "client": "001"
+  }
+}
+```
+
+**XSUAA Service Key** (direct format):
+```json
+{
+  "url": "https://...authentication...hana.ondemand.com",
+  "clientid": "...",
+  "clientsecret": "...",
+  "apiurl": "https://...api...hana.ondemand.com"
+}
+```
+
+### Abstract Classes
+
+For creating custom store implementations:
+
+- **`AbstractServiceKeyStore`** - Base class for service key stores
+  - Handles file I/O operations
+  - Subclasses implement format-specific parsing logic
+
+- **`AbstractJsonSessionStore`** - Base class for file-based session stores
+  - Handles `.env` file read/write operations
+  - Subclasses implement format-specific serialization
+
+- **`AbstractSafeSessionStore`** - Base class for in-memory session stores
+  - Provides secure, non-persistent storage
+  - Subclasses implement format-specific data structures
+
+## Utilities
+
+### Path Resolver
+
+```typescript
+import { resolveSearchPaths, findFileInPaths } from '@mcp-abap-adt/auth-stores';
+
+// Resolve search paths from constructor, env var, or cwd
+const paths = resolveSearchPaths(['/custom/path']);
+
+// Find file in multiple search paths
+const filePath = findFileInPaths('TRIAL.json', paths);
+```
+
+### Constants
+
+```typescript
+import {
+  ABAP_AUTHORIZATION_VARS,
+  ABAP_CONNECTION_VARS,
+  BTP_AUTHORIZATION_VARS,
+  BTP_CONNECTION_VARS,
+  XSUAA_AUTHORIZATION_VARS,
+  XSUAA_CONNECTION_VARS
+} from '@mcp-abap-adt/auth-stores';
+```
+
+### Service Key Loaders
+
+```typescript
+import { loadServiceKey, loadXSUAAServiceKey } from '@mcp-abap-adt/auth-stores';
+
+// Load ABAP service key
+const abapKey = await loadServiceKey('TRIAL', ['/path/to/keys']);
+
+// Load XSUAA service key
+const xsuaaKey = await loadXSUAAServiceKey('mcp', ['/path/to/keys']);
+```
+
+## Testing
+
+Tests use Jest and include unit tests with mocked file system operations.
+
+```bash
+npm test
+```
+
+## Dependencies
+
+- `@mcp-abap-adt/auth-broker` (^0.1.6) - Interface definitions
+- `dotenv` - Environment variable parsing
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @mcp-abap-adt/auth-stores
+ * Stores for MCP ABAP ADT auth-broker
+ *
+ * Provides BTP, ABAP, and XSUAA store implementations
+ */
+export { BtpSessionStore } from './stores/btp/BtpSessionStore';
+export { SafeBtpSessionStore } from './stores/btp/SafeBtpSessionStore';
+export { BtpServiceKeyStore } from './stores/btp/BtpServiceKeyStore';
+export { AbapSessionStore } from './stores/abap/AbapSessionStore';
+export { SafeAbapSessionStore } from './stores/abap/SafeAbapSessionStore';
+export { AbapServiceKeyStore } from './stores/abap/AbapServiceKeyStore';
+export { XsuaaSessionStore } from './stores/xsuaa/XsuaaSessionStore';
+export { SafeXsuaaSessionStore } from './stores/xsuaa/SafeXsuaaSessionStore';
+export { XsuaaServiceKeyStore } from './stores/xsuaa/XsuaaServiceKeyStore';
+export { AbstractServiceKeyStore } from './stores/abstract/AbstractServiceKeyStore';
+export { AbstractJsonSessionStore } from './stores/abstract/AbstractJsonSessionStore';
+export { AbstractSafeSessionStore } from './stores/abstract/AbstractSafeSessionStore';
+export { resolveSearchPaths, findFileInPaths } from './utils/pathResolver';
+export { ABAP_AUTHORIZATION_VARS, ABAP_CONNECTION_VARS, BTP_AUTHORIZATION_VARS, BTP_CONNECTION_VARS, XSUAA_AUTHORIZATION_VARS, XSUAA_CONNECTION_VARS } from './utils/constants';
+export { loadServiceKey } from './loaders/abap/serviceKeyLoader';
+export { loadXSUAAServiceKey } from './loaders/xsuaa/xsuaaServiceKeyLoader';

package/dist/index.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * @mcp-abap-adt/auth-stores
+ * Stores for MCP ABAP ADT auth-broker
+ *
+ * Provides BTP, ABAP, and XSUAA store implementations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadXSUAAServiceKey = exports.loadServiceKey = exports.XSUAA_CONNECTION_VARS = exports.XSUAA_AUTHORIZATION_VARS = exports.BTP_CONNECTION_VARS = exports.BTP_AUTHORIZATION_VARS = exports.ABAP_CONNECTION_VARS = exports.ABAP_AUTHORIZATION_VARS = exports.findFileInPaths = exports.resolveSearchPaths = exports.AbstractSafeSessionStore = exports.AbstractJsonSessionStore = exports.AbstractServiceKeyStore = exports.XsuaaServiceKeyStore = exports.SafeXsuaaSessionStore = exports.XsuaaSessionStore = exports.AbapServiceKeyStore = exports.SafeAbapSessionStore = exports.AbapSessionStore = exports.BtpServiceKeyStore = exports.SafeBtpSessionStore = exports.BtpSessionStore = void 0;
+// BTP stores (base BTP without sapUrl)
+var BtpSessionStore_1 = require("./stores/btp/BtpSessionStore");
+Object.defineProperty(exports, "BtpSessionStore", { enumerable: true, get: function () { return BtpSessionStore_1.BtpSessionStore; } });
+var SafeBtpSessionStore_1 = require("./stores/btp/SafeBtpSessionStore");
+Object.defineProperty(exports, "SafeBtpSessionStore", { enumerable: true, get: function () { return SafeBtpSessionStore_1.SafeBtpSessionStore; } });
+var BtpServiceKeyStore_1 = require("./stores/btp/BtpServiceKeyStore");
+Object.defineProperty(exports, "BtpServiceKeyStore", { enumerable: true, get: function () { return BtpServiceKeyStore_1.BtpServiceKeyStore; } });
+// ABAP stores (with sapUrl, extends base BTP)
+var AbapSessionStore_1 = require("./stores/abap/AbapSessionStore");
+Object.defineProperty(exports, "AbapSessionStore", { enumerable: true, get: function () { return AbapSessionStore_1.AbapSessionStore; } });
+var SafeAbapSessionStore_1 = require("./stores/abap/SafeAbapSessionStore");
+Object.defineProperty(exports, "SafeAbapSessionStore", { enumerable: true, get: function () { return SafeAbapSessionStore_1.SafeAbapSessionStore; } });
+var AbapServiceKeyStore_1 = require("./stores/abap/AbapServiceKeyStore");
+Object.defineProperty(exports, "AbapServiceKeyStore", { enumerable: true, get: function () { return AbapServiceKeyStore_1.AbapServiceKeyStore; } });
+// XSUAA stores
+var XsuaaSessionStore_1 = require("./stores/xsuaa/XsuaaSessionStore");
+Object.defineProperty(exports, "XsuaaSessionStore", { enumerable: true, get: function () { return XsuaaSessionStore_1.XsuaaSessionStore; } });
+var SafeXsuaaSessionStore_1 = require("./stores/xsuaa/SafeXsuaaSessionStore");
+Object.defineProperty(exports, "SafeXsuaaSessionStore", { enumerable: true, get: function () { return SafeXsuaaSessionStore_1.SafeXsuaaSessionStore; } });
+var XsuaaServiceKeyStore_1 = require("./stores/xsuaa/XsuaaServiceKeyStore");
+Object.defineProperty(exports, "XsuaaServiceKeyStore", { enumerable: true, get: function () { return XsuaaServiceKeyStore_1.XsuaaServiceKeyStore; } });
+// Abstract classes (for extending)
+var AbstractServiceKeyStore_1 = require("./stores/abstract/AbstractServiceKeyStore");
+Object.defineProperty(exports, "AbstractServiceKeyStore", { enumerable: true, get: function () { return AbstractServiceKeyStore_1.AbstractServiceKeyStore; } });
+var AbstractJsonSessionStore_1 = require("./stores/abstract/AbstractJsonSessionStore");
+Object.defineProperty(exports, "AbstractJsonSessionStore", { enumerable: true, get: function () { return AbstractJsonSessionStore_1.AbstractJsonSessionStore; } });
+var AbstractSafeSessionStore_1 = require("./stores/abstract/AbstractSafeSessionStore");
+Object.defineProperty(exports, "AbstractSafeSessionStore", { enumerable: true, get: function () { return AbstractSafeSessionStore_1.AbstractSafeSessionStore; } });
+// Utils
+var pathResolver_1 = require("./utils/pathResolver");
+Object.defineProperty(exports, "resolveSearchPaths", { enumerable: true, get: function () { return pathResolver_1.resolveSearchPaths; } });
+Object.defineProperty(exports, "findFileInPaths", { enumerable: true, get: function () { return pathResolver_1.findFileInPaths; } });
+var constants_1 = require("./utils/constants");
+Object.defineProperty(exports, "ABAP_AUTHORIZATION_VARS", { enumerable: true, get: function () { return constants_1.ABAP_AUTHORIZATION_VARS; } });
+Object.defineProperty(exports, "ABAP_CONNECTION_VARS", { enumerable: true, get: function () { return constants_1.ABAP_CONNECTION_VARS; } });
+Object.defineProperty(exports, "BTP_AUTHORIZATION_VARS", { enumerable: true, get: function () { return constants_1.BTP_AUTHORIZATION_VARS; } });
+Object.defineProperty(exports, "BTP_CONNECTION_VARS", { enumerable: true, get: function () { return constants_1.BTP_CONNECTION_VARS; } });
+Object.defineProperty(exports, "XSUAA_AUTHORIZATION_VARS", { enumerable: true, get: function () { return constants_1.XSUAA_AUTHORIZATION_VARS; } });
+Object.defineProperty(exports, "XSUAA_CONNECTION_VARS", { enumerable: true, get: function () { return constants_1.XSUAA_CONNECTION_VARS; } });
+// Loaders
+var serviceKeyLoader_1 = require("./loaders/abap/serviceKeyLoader");
+Object.defineProperty(exports, "loadServiceKey", { enumerable: true, get: function () { return serviceKeyLoader_1.loadServiceKey; } });
+var xsuaaServiceKeyLoader_1 = require("./loaders/xsuaa/xsuaaServiceKeyLoader");
+Object.defineProperty(exports, "loadXSUAAServiceKey", { enumerable: true, get: function () { return xsuaaServiceKeyLoader_1.loadXSUAAServiceKey; } });

package/dist/loaders/abap/serviceKeyLoader.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Service key loader - loads service key JSON files by destination name for ABAP
+ *
+ * Uses parsers to handle different service key formats:
+ * - AbapServiceKeyParser: Standard ABAP service key format with nested uaa object
+ * - XsuaaServiceKeyParser: Direct XSUAA service key format from BTP
+ */
+/**
+ * Load service key from {destination}.json file
+ * Automatically detects format and uses appropriate parser
+ * @param destination Destination name
+ * @param searchPaths Array of paths to search for the file
+ * @returns Service key object or null if file not found
+ */
+export declare function loadServiceKey(destination: string, searchPaths: string[]): Promise<unknown | null>;

package/dist/loaders/abap/serviceKeyLoader.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * Service key loader - loads service key JSON files by destination name for ABAP
+ *
+ * Uses parsers to handle different service key formats:
+ * - AbapServiceKeyParser: Standard ABAP service key format with nested uaa object
+ * - XsuaaServiceKeyParser: Direct XSUAA service key format from BTP
+ */
+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.loadServiceKey = loadServiceKey;
+const fs = __importStar(require("fs"));
+const pathResolver_1 = require("../../utils/pathResolver");
+const AbapServiceKeyParser_1 = require("../../parsers/abap/AbapServiceKeyParser");
+const XsuaaServiceKeyParser_1 = require("../../parsers/xsuaa/XsuaaServiceKeyParser");
+/**
+ * Load service key from {destination}.json file
+ * Automatically detects format and uses appropriate parser
+ * @param destination Destination name
+ * @param searchPaths Array of paths to search for the file
+ * @returns Service key object or null if file not found
+ */
+async function loadServiceKey(destination, searchPaths) {
+    const fileName = `${destination}.json`;
+    const serviceKeyPath = (0, pathResolver_1.findFileInPaths)(fileName, searchPaths);
+    if (!serviceKeyPath) {
+        return null;
+    }
+    try {
+        const fileContent = fs.readFileSync(serviceKeyPath, 'utf8');
+        const rawData = JSON.parse(fileContent);
+        // Try parsers in order: ABAP format first, then XSUAA format
+        const parsers = [
+            new AbapServiceKeyParser_1.AbapServiceKeyParser(),
+            new XsuaaServiceKeyParser_1.XsuaaServiceKeyParser(),
+        ];
+        for (const parser of parsers) {
+            if (parser.canParse(rawData)) {
+                return parser.parse(rawData);
+            }
+        }
+        // No parser could handle the data
+        throw new Error('Service key does not match any supported format. ' +
+            'Expected either ABAP format (with nested uaa object) or XSUAA format (with url, clientid, clientsecret at root level)');
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new Error(`Invalid JSON in service key file for destination "${destination}": ${error.message}`);
+        }
+        throw new Error(`Failed to load service key for destination "${destination}": ${error instanceof Error ? error.message : String(error)}`);
+    }
+}

package/dist/loaders/xsuaa/xsuaaServiceKeyLoader.d.ts

@@ -0,0 +1,19 @@
+/**
+ * XSUAA Service key loader - loads XSUAA service key JSON files by destination name
+ *
+ * Supports direct XSUAA service key format from BTP (without nested uaa object):
+ * {
+ *   "url": "https://...authentication...hana.ondemand.com",
+ *   "clientid": "...",
+ *   "clientsecret": "...",
+ *   ...
+ * }
+ */
+/**
+ * Load XSUAA service key from {destination}.json file
+ * Normalizes direct XSUAA format to standard ServiceKey format
+ * @param destination Destination name
+ * @param searchPaths Array of paths to search for the file
+ * @returns Service key object or null if file not found
+ */
+export declare function loadXSUAAServiceKey(destination: string, searchPaths: string[]): Promise<unknown | null>;

package/dist/loaders/xsuaa/xsuaaServiceKeyLoader.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * XSUAA Service key loader - loads XSUAA service key JSON files by destination name
+ *
+ * Supports direct XSUAA service key format from BTP (without nested uaa object):
+ * {
+ *   "url": "https://...authentication...hana.ondemand.com",
+ *   "clientid": "...",
+ *   "clientsecret": "...",
+ *   ...
+ * }
+ */
+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.loadXSUAAServiceKey = loadXSUAAServiceKey;
+const pathResolver_1 = require("../../utils/pathResolver");
+const XsuaaServiceKeyParser_1 = require("../../parsers/xsuaa/XsuaaServiceKeyParser");
+const fs = __importStar(require("fs"));
+/**
+ * Load XSUAA service key from {destination}.json file
+ * Normalizes direct XSUAA format to standard ServiceKey format
+ * @param destination Destination name
+ * @param searchPaths Array of paths to search for the file
+ * @returns Service key object or null if file not found
+ */
+async function loadXSUAAServiceKey(destination, searchPaths) {
+    const fileName = `${destination}.json`;
+    const serviceKeyPath = (0, pathResolver_1.findFileInPaths)(fileName, searchPaths);
+    if (!serviceKeyPath) {
+        return null;
+    }
+    try {
+        const fileContent = fs.readFileSync(serviceKeyPath, 'utf8');
+        const rawData = JSON.parse(fileContent);
+        // Use XSUAA parser
+        const parser = new XsuaaServiceKeyParser_1.XsuaaServiceKeyParser();
+        if (!parser.canParse(rawData)) {
+            return null; // Not an XSUAA format
+        }
+        return parser.parse(rawData);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new Error(`Invalid JSON in XSUAA service key file for destination "${destination}": ${error.message}`);
+        }
+        throw new Error(`Failed to load XSUAA service key for destination "${destination}": ${error instanceof Error ? error.message : String(error)}`);
+    }
+}

package/dist/parsers/abap/AbapServiceKeyParser.d.ts

@@ -0,0 +1,35 @@
+/**
+ * ABAP Service Key Parser
+ *
+ * Parses standard ABAP service key format with nested uaa object:
+ * {
+ *   "uaa": {
+ *     "url": "...",
+ *     "clientid": "...",
+ *     "clientsecret": "..."
+ *   },
+ *   "abap": {
+ *     "url": "...",
+ *     "client": "..."
+ *   },
+ *   ...
+ * }
+ */
+/**
+ * Parser for standard ABAP service key format
+ */
+export declare class AbapServiceKeyParser {
+    /**
+     * Check if this parser can handle the given raw service key data
+     * @param rawData Raw JSON data from service key file
+     * @returns true if data has nested uaa object, false otherwise
+     */
+    canParse(rawData: any): boolean;
+    /**
+     * Parse raw service key data
+     * @param rawData Raw JSON data from service key file
+     * @returns Parsed service key object
+     * @throws Error if data cannot be parsed or is invalid
+     */
+    parse(rawData: any): unknown;
+}

package/dist/parsers/abap/AbapServiceKeyParser.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * ABAP Service Key Parser
+ *
+ * Parses standard ABAP service key format with nested uaa object:
+ * {
+ *   "uaa": {
+ *     "url": "...",
+ *     "clientid": "...",
+ *     "clientsecret": "..."
+ *   },
+ *   "abap": {
+ *     "url": "...",
+ *     "client": "..."
+ *   },
+ *   ...
+ * }
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbapServiceKeyParser = void 0;
+/**
+ * Parser for standard ABAP service key format
+ */
+class AbapServiceKeyParser {
+    /**
+     * Check if this parser can handle the given raw service key data
+     * @param rawData Raw JSON data from service key file
+     * @returns true if data has nested uaa object, false otherwise
+     */
+    canParse(rawData) {
+        return rawData && typeof rawData === 'object' && rawData.uaa && typeof rawData.uaa === 'object';
+    }
+    /**
+     * Parse raw service key data
+     * @param rawData Raw JSON data from service key file
+     * @returns Parsed service key object
+     * @throws Error if data cannot be parsed or is invalid
+     */
+    parse(rawData) {
+        if (!this.canParse(rawData)) {
+            throw new Error('Service key does not match ABAP format (missing uaa object)');
+        }
+        // Validate UAA configuration
+        if (!rawData.uaa.url || !rawData.uaa.clientid || !rawData.uaa.clientsecret) {
+            throw new Error('Service key "uaa" object missing required fields: url, clientid, clientsecret');
+        }
+        return rawData;
+    }
+}
+exports.AbapServiceKeyParser = AbapServiceKeyParser;

package/dist/parsers/xsuaa/XsuaaServiceKeyParser.d.ts

@@ -0,0 +1,30 @@
+/**
+ * XSUAA Service Key Parser
+ *
+ * Parses direct XSUAA service key format from BTP (without nested uaa object):
+ * {
+ *   "url": "https://...authentication...hana.ondemand.com",
+ *   "clientid": "...",
+ *   "clientsecret": "...",
+ *   "tenantmode": "shared",
+ *   ...
+ * }
+ */
+/**
+ * Parser for direct XSUAA service key format from BTP
+ */
+export declare class XsuaaServiceKeyParser {
+    /**
+     * Check if this parser can handle the given raw service key data
+     * @param rawData Raw JSON data from service key file
+     * @returns true if data has direct XSUAA fields (url, clientid, clientsecret) without nested uaa object
+     */
+    canParse(rawData: any): boolean;
+    /**
+     * Parse raw service key data
+     * @param rawData Raw JSON data from service key file
+     * @returns Parsed service key object (normalized format)
+     * @throws Error if data cannot be parsed or is invalid
+     */
+    parse(rawData: any): unknown;
+}