@mcp-abap-adt/interfaces 0.1.19 → 0.2.1

package/CHANGELOG.md

@@ -7,6 +7,38 @@ 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
+- **Network Error Detection Constants and Utility**: Added network error codes and helper function for detecting infrastructure-level connection issues
+  - `NETWORK_ERROR_CODES` - Object containing standard network error codes:
+    - `ECONNREFUSED` - Connection refused (server not accepting connections)
+    - `ETIMEDOUT` - Connection timeout (server not responding)
+    - `ENOTFOUND` - DNS resolution failed (hostname not found)
+    - `ECONNRESET` - Connection reset by peer
+    - `ENETUNREACH` - Network is unreachable
+    - `EHOSTUNREACH` - Host is unreachable
+  - `NetworkErrorCode` - Type for network error codes
+  - `isNetworkError(error: any): boolean` - Utility function to check if an error is a network-level error
+  - These constants and utilities help distinguish network/infrastructure errors from application-level HTTP errors
+  - Network errors should not trigger retry logic (CSRF, auth) as they indicate VPN, DNS, or connectivity issues
+  - Exported from `@mcp-abap-adt/interfaces` package in connection domain
+
 ## [0.1.19] - 2025-12-17
 
 ### Added

package/dist/connection/NetworkErrors.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Network error codes that indicate infrastructure-level connection issues
+ * These errors should not trigger retry logic (CSRF, auth) as they indicate
+ * problems with network connectivity, VPN, DNS, or server availability.
+ */
+/**
+ * Network error codes
+ */
+export declare const NETWORK_ERROR_CODES: {
+    /** Connection refused - server not accepting connections */
+    readonly ECONNREFUSED: "ECONNREFUSED";
+    /** Connection timeout - server not responding */
+    readonly ETIMEDOUT: "ETIMEDOUT";
+    /** DNS resolution failed - hostname not found */
+    readonly ENOTFOUND: "ENOTFOUND";
+    /** Connection reset by peer */
+    readonly ECONNRESET: "ECONNRESET";
+    /** Network is unreachable */
+    readonly ENETUNREACH: "ENETUNREACH";
+    /** Host is unreachable */
+    readonly EHOSTUNREACH: "EHOSTUNREACH";
+};
+/**
+ * Type for network error codes
+ */
+export type NetworkErrorCode = typeof NETWORK_ERROR_CODES[keyof typeof NETWORK_ERROR_CODES];
+/**
+ * Check if an error is a network error
+ * @param error Error object to check
+ * @returns true if error is a network-level error
+ */
+export declare function isNetworkError(error: any): boolean;
+//# sourceMappingURL=NetworkErrors.d.ts.map

package/dist/connection/NetworkErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkErrors.d.ts","sourceRoot":"","sources":["../../src/connection/NetworkErrors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;IAC9B,4DAA4D;;IAE5D,iDAAiD;;IAEjD,iDAAiD;;IAEjD,+BAA+B;;IAE/B,6BAA6B;;IAE7B,0BAA0B;;CAElB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,mBAAmB,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAE5F;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAiBlD"}

package/dist/connection/NetworkErrors.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * Network error codes that indicate infrastructure-level connection issues
+ * These errors should not trigger retry logic (CSRF, auth) as they indicate
+ * problems with network connectivity, VPN, DNS, or server availability.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NETWORK_ERROR_CODES = void 0;
+exports.isNetworkError = isNetworkError;
+/**
+ * Network error codes
+ */
+exports.NETWORK_ERROR_CODES = {
+    /** Connection refused - server not accepting connections */
+    ECONNREFUSED: 'ECONNREFUSED',
+    /** Connection timeout - server not responding */
+    ETIMEDOUT: 'ETIMEDOUT',
+    /** DNS resolution failed - hostname not found */
+    ENOTFOUND: 'ENOTFOUND',
+    /** Connection reset by peer */
+    ECONNRESET: 'ECONNRESET',
+    /** Network is unreachable */
+    ENETUNREACH: 'ENETUNREACH',
+    /** Host is unreachable */
+    EHOSTUNREACH: 'EHOSTUNREACH',
+};
+/**
+ * Check if an error is a network error
+ * @param error Error object to check
+ * @returns true if error is a network-level error
+ */
+function isNetworkError(error) {
+    if (!error) {
+        return false;
+    }
+    const errorCode = error.code;
+    const errorMessage = error.message || '';
+    // Check error code
+    if (errorCode && Object.values(exports.NETWORK_ERROR_CODES).includes(errorCode)) {
+        return true;
+    }
+    // Check error message (fallback for wrapped errors)
+    return Object.values(exports.NETWORK_ERROR_CODES).some(code => errorMessage.includes(code));
+}

package/dist/index.d.ts

@@ -15,6 +15,8 @@ export type { ISessionStore } from './session/ISessionStore';
 export type { IServiceKeyStore } from './serviceKey/IServiceKeyStore';
 export type { IAbapConnection } from './connection/IAbapConnection';
 export type { IAbapRequestOptions } from './connection/IAbapRequestOptions';
+export { NETWORK_ERROR_CODES, isNetworkError } from './connection/NetworkErrors';
+export type { NetworkErrorCode } from './connection/NetworkErrors';
 export type { ISapConfig } from './sap/ISapConfig';
 export type { SapAuthType } from './sap/SapAuthType';
 export type { ISessionStorage } from './storage/ISessionStorage';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,YAAY,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,YAAY,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAG3E,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,YAAY,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAG5E,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,YAAY,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,YAAY,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,YAAY,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAGvE,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,cAAc,WAAW,CAAC;AAG1B,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,YAAY,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,YAAY,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAG3E,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,YAAY,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjF,YAAY,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,YAAY,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,YAAY,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,YAAY,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAGvE,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,cAAc,WAAW,CAAC;AAG1B,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -20,7 +20,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AdtObjectErrorCodes = exports.AuthMethodPriority = exports.LogLevel = void 0;
+exports.AdtObjectErrorCodes = exports.AuthMethodPriority = exports.LogLevel = exports.isNetworkError = exports.NETWORK_ERROR_CODES = void 0;
+var NetworkErrors_1 = require("./connection/NetworkErrors");
+Object.defineProperty(exports, "NETWORK_ERROR_CODES", { enumerable: true, get: function () { return NetworkErrors_1.NETWORK_ERROR_CODES; } });
+Object.defineProperty(exports, "isNetworkError", { enumerable: true, get: function () { return NetworkErrors_1.isNetworkError; } });
 var LogLevel_1 = require("./logging/LogLevel");
 Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return LogLevel_1.LogLevel; } });
 var IValidatedAuthConfig_1 = require("./validation/IValidatedAuthConfig");

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.1.19",
+  "version": "0.2.1",
   "description": "Shared interfaces for MCP ABAP ADT packages",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",