@mcp-abap-adt/interfaces 0.2.1 → 0.2.3

package/CHANGELOG.md

@@ -7,6 +7,35 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.3] - 2025-12-19
+
+### Added
+- **Store Error Codes**: Added standardized error codes for store operations
+  - `STORE_ERROR_CODES` - Object containing error codes for store failures:
+    - `FILE_NOT_FOUND` - Service key or session file not found
+    - `PARSE_ERROR` - JSON or YAML parsing failed
+    - `INVALID_CONFIG` - Required configuration fields are missing
+    - `STORAGE_ERROR` - File write or permission error
+  - `StoreErrorCode` - Type for store error codes
+  - These constants enable auth-stores to provide typed errors to auth-broker
+  - Error codes help broker distinguish between file not found, parsing errors, and validation failures
+  - Exported from `@mcp-abap-adt/interfaces` package in store domain
+
+## [0.2.2] - 2025-12-19
+
+### Added
+- **Token Provider Error Codes**: Added standardized error codes for token provider operations
+  - `TOKEN_PROVIDER_ERROR_CODES` - Object containing error codes for token provider failures:
+    - `VALIDATION_ERROR` - Authentication configuration validation failed
+    - `REFRESH_ERROR` - Token refresh operation failed
+    - `SESSION_DATA_ERROR` - Session data is invalid or incomplete
+    - `SERVICE_KEY_ERROR` - Service key data is invalid or incomplete
+    - `BROWSER_AUTH_ERROR` - Browser authentication failed or was cancelled
+  - `TokenProviderErrorCode` - Type for token provider error codes
+  - These constants enable consistent error handling across token providers and auth-broker
+  - Error codes help distinguish between different types of authentication failures
+  - Exported from `@mcp-abap-adt/interfaces` package in token domain
+
 ## [0.2.1] - 2025-12-19
 
 ### Added

package/README.md

@@ -45,7 +45,9 @@ import {
   ITokenProvider,
   IAbapConnection,
   ISapConfig,
-  ILogger
+  ILogger,
+  TOKEN_PROVIDER_ERROR_CODES,
+  STORE_ERROR_CODES
 } from '@mcp-abap-adt/interfaces';
 ```
 
@@ -73,6 +75,39 @@ const metadata = await adtDomain.readMetadata(
 );
 ```
 
+### Error Handling
+
+```typescript
+import {
+  TOKEN_PROVIDER_ERROR_CODES,
+  STORE_ERROR_CODES
+} from '@mcp-abap-adt/interfaces';
+
+// Token Provider Error Codes
+try {
+  await tokenProvider.refreshTokenFromSession(authConfig);
+} catch (error: any) {
+  if (error.code === TOKEN_PROVIDER_ERROR_CODES.VALIDATION_ERROR) {
+    console.error('Invalid auth config:', error.missingFields);
+  } else if (error.code === TOKEN_PROVIDER_ERROR_CODES.REFRESH_ERROR) {
+    console.error('Token refresh failed:', error.cause);
+  }
+}
+
+// Store Error Codes
+try {
+  const authConfig = await serviceKeyStore.getAuthorizationConfig('TRIAL');
+} catch (error: any) {
+  if (error.code === STORE_ERROR_CODES.FILE_NOT_FOUND) {
+    console.error('Service key not found:', error.filePath);
+  } else if (error.code === STORE_ERROR_CODES.PARSE_ERROR) {
+    console.error('Invalid JSON:', error.filePath, error.cause);
+  } else if (error.code === STORE_ERROR_CODES.INVALID_CONFIG) {
+    console.error('Missing fields:', error.missingFields);
+  }
+}
+```
+
 ## Responsibilities and Design Principles
 
 ### Core Development Principle

package/dist/index.d.ts

@@ -11,8 +11,12 @@ export type { AuthType } from './auth/AuthType';
 export type { ITokenProvider } from './token/ITokenProvider';
 export type { ITokenProviderResult } from './token/ITokenProviderResult';
 export type { ITokenProviderOptions } from './token/ITokenProviderOptions';
+export { TOKEN_PROVIDER_ERROR_CODES } from './token/TokenProviderErrorCodes';
+export type { TokenProviderErrorCode } from './token/TokenProviderErrorCodes';
 export type { ISessionStore } from './session/ISessionStore';
 export type { IServiceKeyStore } from './serviceKey/IServiceKeyStore';
+export { STORE_ERROR_CODES } from './store/StoreErrorCodes';
+export type { StoreErrorCode } from './store/StoreErrorCodes';
 export type { IAbapConnection } from './connection/IAbapConnection';
 export type { IAbapRequestOptions } from './connection/IAbapRequestOptions';
 export { NETWORK_ERROR_CODES, isNetworkError } from './connection/NetworkErrors';

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;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"}
+{"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;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,YAAY,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAG9E,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAG9D,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,12 @@ 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 = exports.isNetworkError = exports.NETWORK_ERROR_CODES = void 0;
+exports.AdtObjectErrorCodes = exports.AuthMethodPriority = exports.LogLevel = exports.isNetworkError = exports.NETWORK_ERROR_CODES = exports.STORE_ERROR_CODES = exports.TOKEN_PROVIDER_ERROR_CODES = void 0;
+var TokenProviderErrorCodes_1 = require("./token/TokenProviderErrorCodes");
+Object.defineProperty(exports, "TOKEN_PROVIDER_ERROR_CODES", { enumerable: true, get: function () { return TokenProviderErrorCodes_1.TOKEN_PROVIDER_ERROR_CODES; } });
+// Store domain
+var StoreErrorCodes_1 = require("./store/StoreErrorCodes");
+Object.defineProperty(exports, "STORE_ERROR_CODES", { enumerable: true, get: function () { return StoreErrorCodes_1.STORE_ERROR_CODES; } });
 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; } });

package/dist/store/StoreErrorCodes.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Error codes for store operations
+ * Used by auth-stores package to provide typed errors to auth-broker
+ */
+export declare const STORE_ERROR_CODES: {
+    readonly FILE_NOT_FOUND: "FILE_NOT_FOUND";
+    readonly PARSE_ERROR: "PARSE_ERROR";
+    readonly INVALID_CONFIG: "INVALID_CONFIG";
+    readonly STORAGE_ERROR: "STORAGE_ERROR";
+};
+export type StoreErrorCode = typeof STORE_ERROR_CODES[keyof typeof STORE_ERROR_CODES];
+//# sourceMappingURL=StoreErrorCodes.d.ts.map

package/dist/store/StoreErrorCodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StoreErrorCodes.d.ts","sourceRoot":"","sources":["../../src/store/StoreErrorCodes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,iBAAiB;;;;;CAKpB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,OAAO,iBAAiB,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/store/StoreErrorCodes.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Error codes for store operations
+ * Used by auth-stores package to provide typed errors to auth-broker
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STORE_ERROR_CODES = void 0;
+exports.STORE_ERROR_CODES = {
+    FILE_NOT_FOUND: 'FILE_NOT_FOUND',
+    PARSE_ERROR: 'PARSE_ERROR',
+    INVALID_CONFIG: 'INVALID_CONFIG',
+    STORAGE_ERROR: 'STORAGE_ERROR',
+};

package/dist/token/TokenProviderErrorCodes.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Token Provider Error Codes
+ *
+ * Constants for error codes that token providers can throw.
+ * Used to enable better error handling and categorization.
+ */
+/**
+ * Error codes for token provider operations
+ */
+export declare const TOKEN_PROVIDER_ERROR_CODES: {
+    /** Authentication configuration validation failed */
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    /** Token refresh operation failed */
+    readonly REFRESH_ERROR: "REFRESH_ERROR";
+    /** Session data is invalid or incomplete */
+    readonly SESSION_DATA_ERROR: "SESSION_DATA_ERROR";
+    /** Service key data is invalid or incomplete */
+    readonly SERVICE_KEY_ERROR: "SERVICE_KEY_ERROR";
+    /** Browser authentication failed or was cancelled */
+    readonly BROWSER_AUTH_ERROR: "BROWSER_AUTH_ERROR";
+};
+/**
+ * Type for token provider error codes
+ */
+export type TokenProviderErrorCode = typeof TOKEN_PROVIDER_ERROR_CODES[keyof typeof TOKEN_PROVIDER_ERROR_CODES];
+//# sourceMappingURL=TokenProviderErrorCodes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TokenProviderErrorCodes.d.ts","sourceRoot":"","sources":["../../src/token/TokenProviderErrorCodes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,0BAA0B;IACrC,qDAAqD;;IAErD,qCAAqC;;IAErC,4CAA4C;;IAE5C,gDAAgD;;IAEhD,qDAAqD;;CAE7C,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,0BAA0B,CAAC,MAAM,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/token/TokenProviderErrorCodes.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Token Provider Error Codes
+ *
+ * Constants for error codes that token providers can throw.
+ * Used to enable better error handling and categorization.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOKEN_PROVIDER_ERROR_CODES = void 0;
+/**
+ * Error codes for token provider operations
+ */
+exports.TOKEN_PROVIDER_ERROR_CODES = {
+    /** Authentication configuration validation failed */
+    VALIDATION_ERROR: 'VALIDATION_ERROR',
+    /** Token refresh operation failed */
+    REFRESH_ERROR: 'REFRESH_ERROR',
+    /** Session data is invalid or incomplete */
+    SESSION_DATA_ERROR: 'SESSION_DATA_ERROR',
+    /** Service key data is invalid or incomplete */
+    SERVICE_KEY_ERROR: 'SERVICE_KEY_ERROR',
+    /** Browser authentication failed or was cancelled */
+    BROWSER_AUTH_ERROR: 'BROWSER_AUTH_ERROR',
+};

package/package.json

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