@mcp-abap-adt/interfaces 0.2.2 → 0.2.4

package/CHANGELOG.md

@@ -7,6 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.4] - 2025-12-21
+
+### Added
+- **Headless Browser Mode**: Added `"headless"` option to `ITokenProviderOptions.browser`
+  - `"headless"`: Does not open browser, logs authentication URL and waits for manual callback
+  - Ideal for SSH sessions, remote terminals, and environments without display
+  - Differs from `"none"` which immediately rejects (for automated tests)
+  - Updated JSDoc documentation for browser option with all supported values
+
+## [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

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

@@ -15,6 +15,8 @@ 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;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,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,9 +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 = exports.TOKEN_PROVIDER_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/ITokenProviderOptions.d.ts

@@ -8,9 +8,10 @@ import type { ILogger } from '../logging/ILogger';
 export interface ITokenProviderOptions {
     /**
      * Browser type for browser-based authentication
-     * Supported values: "chrome", "edge", "firefox", "system" (default), "none"
-     * - "system": Uses system default browser
-     * - "none": Does not open browser automatically (user must open URL manually)
+     * Supported values: "chrome", "edge", "firefox", "system" (default), "none", "headless"
+     * - "system": Uses system default browser (default)
+     * - "headless": Does not open browser, logs URL and waits for manual callback (for SSH/remote sessions)
+     * - "none": Does not open browser, immediately rejects with error (for automated tests)
      */
     browser?: string;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"ITokenProviderOptions.d.ts","sourceRoot":"","sources":["../../src/token/ITokenProviderOptions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}
+{"version":3,"file":"ITokenProviderOptions.d.ts","sourceRoot":"","sources":["../../src/token/ITokenProviderOptions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/package.json

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