@mcp-abap-adt/interfaces 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.1] - 2025-12-19
+
+### Added
+- **Token Refresh Methods in ITokenProvider**: Added two new methods to `ITokenProvider` interface for explicit refresh scenarios
+  - `refreshTokenFromSession(authConfig, options?)` - Refresh token using refresh token from session
+    - Uses refresh token from `authConfig.refreshToken` to get new access token
+    - Typically uses refresh_token grant type or browser-based re-authentication
+    - Returns new authorization token and optional new refresh token
+  - `refreshTokenFromServiceKey(authConfig, options?)` - Refresh token using UAA credentials from service key
+    - Uses UAA credentials (uaaUrl, uaaClientId, uaaClientSecret) without refresh token
+    - Typically uses browser-based authorization flow to ensure proper role assignment
+    - Returns new authorization token and optional refresh token
+  - These methods provide explicit control over token refresh strategy in AuthBroker
+  - Allows separation of refresh-by-session vs refresh-by-service-key logic in token providers
+
 ## [0.2.0] - 2025-12-19
 
 ### Added

package/dist/token/ITokenProvider.d.ts

@@ -22,6 +22,24 @@ export interface ITokenProvider {
      * @returns Promise that resolves to connection configuration with authorization token and optional refresh token
      */
     getConnectionConfig(authConfig: IAuthorizationConfig, options?: ITokenProviderOptions): Promise<ITokenProviderResult>;
+    /**
+     * Refresh token using refresh token from session (authorization config with refreshToken)
+     * This method uses the refresh token from the session to get a new access token.
+     * Typically uses refresh_token grant type or browser-based re-authentication.
+     * @param authConfig Authorization configuration including refreshToken from session
+     * @param options Optional provider-specific options (e.g., browser type for BTP)
+     * @returns Promise that resolves to connection configuration with new authorization token and optional new refresh token
+     */
+    refreshTokenFromSession(authConfig: IAuthorizationConfig, options?: ITokenProviderOptions): Promise<ITokenProviderResult>;
+    /**
+     * Refresh token using UAA credentials from service key (authorization config without refreshToken)
+     * This method uses UAA credentials (uaaUrl, uaaClientId, uaaClientSecret) to get a new token.
+     * Typically uses browser-based authorization flow to ensure proper role assignment.
+     * @param authConfig Authorization configuration with UAA credentials from service key (no refreshToken)
+     * @param options Optional provider-specific options (e.g., browser type for BTP)
+     * @returns Promise that resolves to connection configuration with new authorization token and optional refresh token
+     */
+    refreshTokenFromServiceKey(authConfig: IAuthorizationConfig, options?: ITokenProviderOptions): Promise<ITokenProviderResult>;
     /**
      * Validate JWT token by testing connection to service
      * @param token JWT token to validate

package/dist/token/ITokenProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ITokenProvider.d.ts","sourceRoot":"","sources":["../../src/token/ITokenProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,mBAAmB,CACjB,UAAU,EAAE,oBAAoB,EAChC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjC;;;;;OAKG;IACH,aAAa,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtE"}
+{"version":3,"file":"ITokenProvider.d.ts","sourceRoot":"","sources":["../../src/token/ITokenProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,mBAAmB,CACjB,UAAU,EAAE,oBAAoB,EAChC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjC;;;;;;;OAOG;IACH,uBAAuB,CACrB,UAAU,EAAE,oBAAoB,EAChC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjC;;;;;;;OAOG;IACH,0BAA0B,CACxB,UAAU,EAAE,oBAAoB,EAChC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjC;;;;;OAKG;IACH,aAAa,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-abap-adt/interfaces",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Shared interfaces for MCP ABAP ADT packages",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",