@mcp-abap-adt/auth-broker 0.1.9 → 0.1.11

package/CHANGELOG.md

@@ -11,6 +11,28 @@ Thank you to all contributors! See [CONTRIBUTORS.md](CONTRIBUTORS.md) for the co
 
 ## [Unreleased]
 
+## [0.1.11] - 2025-12-07
+
+### Changed
+- **Dependency Updates**: Updated dependencies to latest versions
+  - `@mcp-abap-adt/interfaces`: `^0.1.1` → `^0.1.3` (includes new header constants and session ID header constants)
+  - `@mcp-abap-adt/auth-providers`: `^0.1.2` → `^0.1.3` (includes configurable browser auth port and implementation isolation)
+  - `@mcp-abap-adt/auth-stores`: `^0.1.4` → `^0.1.5` (updated to use latest interfaces package)
+- **Documentation Updates**: Updated README with examples for `BtpTokenProvider` with custom browser auth port
+  - Added example showing how to use `BtpTokenProvider(4001)` to avoid port conflicts
+  - Added note about `browserAuthPort` parameter in token provider section
+
+## [0.1.10] - 2025-12-07
+
+### Added
+- **Constructor Validation**: Added validation checks in `AuthBroker` constructor to ensure all required dependencies are provided
+  - Validates that `stores` parameter is not null/undefined
+  - Validates that `serviceKeyStore` is provided
+  - Validates that `sessionStore` is provided
+  - Validates that `tokenProvider` is provided
+  - Throws descriptive error messages if any required dependency is missing
+  - Helps catch configuration errors early during development
+
 ## [0.1.9] - 2025-12-05
 
 ### Changed

package/README.md

@@ -45,6 +45,13 @@ const broker = new AuthBroker({
   tokenProvider: new BtpTokenProvider(),
 });
 
+// Use BtpTokenProvider with custom browser auth port (to avoid port conflicts)
+const brokerWithCustomPort = new AuthBroker({
+  serviceKeyStore: new AbapServiceKeyStore(['/path/to/destinations']),
+  sessionStore: new AbapSessionStore(['/path/to/destinations']),
+  tokenProvider: new BtpTokenProvider(4001), // Custom port for OAuth callback server
+});
+
 // Get token for destination (loads from .env, validates, refreshes if needed)
 const token = await broker.getToken('TRIAL');
 
@@ -325,6 +332,8 @@ The package uses `ITokenProvider` interface for token acquisition. Two implement
   - No refresh token provided
 
 - **`BtpTokenProvider`** - For BTP/ABAP authentication (full scope)
+  - Constructor accepts optional `browserAuthPort?: number` parameter (default: 3001)
+  - Use custom port to avoid conflicts when running alongside other services (e.g., proxy server)
   - Uses browser-based OAuth2 flow (if no refresh token)
   - Uses refresh token if available
   - Provides refresh token for future use

package/dist/AuthBroker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AuthBroker.d.ts","sourceRoot":"","sources":["../src/AuthBroker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC/G,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAY7C;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,eAAe,CAAmB;IAC1C,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,aAAa,CAAiB;IAEtC;;;;;;;;;;OAUG;gBAED,MAAM,EAAE;QAAE,eAAe,EAAE,gBAAgB,CAAC;QAAC,YAAY,EAAE,aAAa,CAAC;QAAC,aAAa,EAAE,cAAc,CAAA;KAAE,EACzG,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,OAAO;IASlB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACG,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmIpD;;;;;OAKG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuCxD;;;;OAIG;IACG,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAWvF;;;;OAIG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;CAWlF"}
+{"version":3,"file":"AuthBroker.d.ts","sourceRoot":"","sources":["../src/AuthBroker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC/G,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAY7C;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,eAAe,CAAmB;IAC1C,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,aAAa,CAAiB;IAEtC;;;;;;;;;;OAUG;gBAED,MAAM,EAAE;QAAE,eAAe,EAAE,gBAAgB,CAAC;QAAC,YAAY,EAAE,aAAa,CAAC;QAAC,aAAa,EAAE,cAAc,CAAA;KAAE,EACzG,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,OAAO;IAuBlB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACG,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmIpD;;;;;OAKG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuCxD;;;;OAIG;IACG,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAWvF;;;;OAIG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;CAWlF"}

package/dist/AuthBroker.js

@@ -34,6 +34,19 @@ class AuthBroker {
      * @param logger Optional logger instance implementing ILogger interface. If not provided, uses no-op logger.
      */
     constructor(stores, browser, logger) {
+        // Validate that stores and provider are provided and not null/undefined
+        if (!stores) {
+            throw new Error('AuthBroker: stores parameter is required');
+        }
+        if (!stores.serviceKeyStore) {
+            throw new Error('AuthBroker: serviceKeyStore is required');
+        }
+        if (!stores.sessionStore) {
+            throw new Error('AuthBroker: sessionStore is required');
+        }
+        if (!stores.tokenProvider) {
+            throw new Error('AuthBroker: tokenProvider is required');
+        }
         this.serviceKeyStore = stores.serviceKeyStore;
         this.sessionStore = stores.sessionStore;
         this.tokenProvider = stores.tokenProvider;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-abap-adt/auth-broker",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "JWT authentication broker for MCP ABAP ADT - manages tokens based on destination headers",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -51,11 +51,11 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@mcp-abap-adt/interfaces": "^0.1.1"
+    "@mcp-abap-adt/interfaces": "^0.1.3"
   },
   "devDependencies": {
-    "@mcp-abap-adt/auth-providers": "^0.1.2",
-    "@mcp-abap-adt/auth-stores": "^0.1.4",
+    "@mcp-abap-adt/auth-providers": "^0.1.3",
+    "@mcp-abap-adt/auth-stores": "^0.1.5",
     "@types/express": "^5.0.5",
     "@types/jest": "^30.0.0",
     "@types/js-yaml": "^4.0.9",