@mcp-abap-adt/logger 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2025-12-04
+
+### Added
+- Initial release
+- Logger interface
+- DefaultLogger implementation
+- TestLogger implementation
+- Log level support (ERROR, WARN, INFO, DEBUG)
+- Environment variable configuration (AUTH_LOG_LEVEL)
+

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 Oleksii Kyslytsia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,103 @@
+# @mcp-abap-adt/logger
+
+Logger interface and implementations for MCP ABAP ADT packages.
+
+## Installation
+
+```bash
+npm install @mcp-abap-adt/logger
+```
+
+## Usage
+
+### Basic Usage
+
+```typescript
+import { Logger, defaultLogger, LogLevel } from '@mcp-abap-adt/logger';
+
+// Use default logger
+defaultLogger.info('Hello, world!');
+defaultLogger.debug('Debug message');
+defaultLogger.error('Error message');
+defaultLogger.warn('Warning message');
+
+// Specialized logging methods
+defaultLogger.browserAuth('Starting browser authentication...');
+defaultLogger.refresh('Refreshing token...');
+defaultLogger.success('Operation completed successfully');
+defaultLogger.browserUrl('https://example.com/auth');
+defaultLogger.browserOpening();
+defaultLogger.testSkip('Test skipped');
+```
+
+### Log Levels
+
+Logger supports four log levels controlled by `AUTH_LOG_LEVEL` environment variable:
+
+- `error` - only errors
+- `warn` - errors and warnings
+- `info` - errors, warnings, and info (default)
+- `debug` - all messages
+
+```bash
+export AUTH_LOG_LEVEL=debug
+```
+
+For backward compatibility, `DEBUG_AUTH_LOG=true` also sets level to debug.
+
+### Logger Interface
+
+```typescript
+import type { Logger } from '@mcp-abap-adt/logger';
+
+class MyCustomLogger implements Logger {
+  info(message: string): void {
+    // Custom implementation
+  }
+  debug(message: string): void {
+    // Custom implementation
+  }
+  error(message: string): void {
+    // Custom implementation
+  }
+  warn(message: string): void {
+    // Custom implementation
+  }
+  browserAuth(message: string): void {
+    // Custom implementation
+  }
+  refresh(message: string): void {
+    // Custom implementation
+  }
+  success(message: string): void {
+    // Custom implementation
+  }
+  browserUrl(url: string): void {
+    // Custom implementation
+  }
+  browserOpening(): void {
+    // Custom implementation
+  }
+  testSkip(message: string): void {
+    // Custom implementation
+  }
+}
+```
+
+### Convenience Functions
+
+For backward compatibility, convenience functions are also exported:
+
+```typescript
+import { info, debug, error, warn, browserAuth, refresh, success, browserUrl, browserOpening, testSkip } from '@mcp-abap-adt/logger';
+
+info('Info message');
+debug('Debug message');
+error('Error message');
+warn('Warning message');
+```
+
+## License
+
+MIT
+

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @mcp-abap-adt/logger
+ * Logger interface and implementations for MCP ABAP ADT packages
+ */
+export { LogLevel, defaultLogger, testLogger } from './logger';
+export type { Logger } from './logger';
+export { info, debug, error, warn, browserAuth, refresh, success, browserUrl, browserOpening, testSkip, } from './logger';

package/dist/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testSkip = exports.browserOpening = exports.browserUrl = exports.success = exports.refresh = exports.browserAuth = exports.warn = exports.error = exports.debug = exports.info = exports.testLogger = exports.defaultLogger = exports.LogLevel = void 0;
+/**
+ * @mcp-abap-adt/logger
+ * Logger interface and implementations for MCP ABAP ADT packages
+ */
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return logger_1.LogLevel; } });
+Object.defineProperty(exports, "defaultLogger", { enumerable: true, get: function () { return logger_1.defaultLogger; } });
+Object.defineProperty(exports, "testLogger", { enumerable: true, get: function () { return logger_1.testLogger; } });
+var logger_2 = require("./logger");
+Object.defineProperty(exports, "info", { enumerable: true, get: function () { return logger_2.info; } });
+Object.defineProperty(exports, "debug", { enumerable: true, get: function () { return logger_2.debug; } });
+Object.defineProperty(exports, "error", { enumerable: true, get: function () { return logger_2.error; } });
+Object.defineProperty(exports, "warn", { enumerable: true, get: function () { return logger_2.warn; } });
+Object.defineProperty(exports, "browserAuth", { enumerable: true, get: function () { return logger_2.browserAuth; } });
+Object.defineProperty(exports, "refresh", { enumerable: true, get: function () { return logger_2.refresh; } });
+Object.defineProperty(exports, "success", { enumerable: true, get: function () { return logger_2.success; } });
+Object.defineProperty(exports, "browserUrl", { enumerable: true, get: function () { return logger_2.browserUrl; } });
+Object.defineProperty(exports, "browserOpening", { enumerable: true, get: function () { return logger_2.browserOpening; } });
+Object.defineProperty(exports, "testSkip", { enumerable: true, get: function () { return logger_2.testSkip; } });

package/dist/logger.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Logger interface and implementations for MCP ABAP ADT packages
+ */
+/**
+ * Log levels
+ */
+export declare enum LogLevel {
+    ERROR = 0,
+    WARN = 1,
+    INFO = 2,
+    DEBUG = 3
+}
+/**
+ * Logger interface - defines logging methods
+ */
+export interface Logger {
+    info(message: string): void;
+    debug(message: string): void;
+    error(message: string): void;
+    warn(message: string): void;
+    browserAuth(message: string): void;
+    refresh(message: string): void;
+    success(message: string): void;
+    browserUrl(url: string): void;
+    browserOpening(): void;
+    testSkip(message: string): void;
+}
+export declare const defaultLogger: Logger;
+export declare const testLogger: Logger;
+export declare function info(message: string): void;
+export declare function debug(message: string): void;
+export declare function error(message: string): void;
+export declare function browserAuth(message: string): void;
+export declare function refresh(message: string): void;
+export declare function success(message: string): void;
+export declare function browserUrl(url: string): void;
+export declare function browserOpening(): void;
+export declare function testSkip(message: string): void;
+export declare function warn(message: string): void;

package/dist/logger.js

@@ -0,0 +1,186 @@
+"use strict";
+/**
+ * Logger interface and implementations for MCP ABAP ADT packages
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testLogger = exports.defaultLogger = exports.LogLevel = void 0;
+exports.info = info;
+exports.debug = debug;
+exports.error = error;
+exports.browserAuth = browserAuth;
+exports.refresh = refresh;
+exports.success = success;
+exports.browserUrl = browserUrl;
+exports.browserOpening = browserOpening;
+exports.testSkip = testSkip;
+exports.warn = warn;
+/**
+ * Log levels
+ */
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["ERROR"] = 0] = "ERROR";
+    LogLevel[LogLevel["WARN"] = 1] = "WARN";
+    LogLevel[LogLevel["INFO"] = 2] = "INFO";
+    LogLevel[LogLevel["DEBUG"] = 3] = "DEBUG";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+/**
+ * Get log level from environment variable
+ * AUTH_LOG_LEVEL can be: error, warn, info, debug
+ * DEBUG_AUTH_LOG=true is also supported for backward compatibility (sets level to debug)
+ */
+function getLogLevel() {
+    const level = process.env.AUTH_LOG_LEVEL?.toLowerCase();
+    if (level === 'error')
+        return LogLevel.ERROR;
+    if (level === 'warn')
+        return LogLevel.WARN;
+    if (level === 'info')
+        return LogLevel.INFO;
+    if (level === 'debug')
+        return LogLevel.DEBUG;
+    // Backward compatibility
+    if (process.env.DEBUG_AUTH_LOG === 'true')
+        return LogLevel.DEBUG;
+    // Default: info level
+    return LogLevel.INFO;
+}
+/**
+ * Default logger implementation
+ * Controls output based on AUTH_LOG_LEVEL environment variable:
+ * - error: only errors
+ * - warn: errors and warnings
+ * - info: errors, warnings, and info (default)
+ * - debug: all messages
+ */
+class DefaultLogger {
+    logLevel;
+    constructor(logLevel) {
+        this.logLevel = logLevel ?? getLogLevel();
+    }
+    info(message) {
+        if (this.logLevel >= LogLevel.INFO) {
+            console.info(message);
+        }
+    }
+    debug(message) {
+        if (this.logLevel >= LogLevel.DEBUG) {
+            console.debug(`[DEBUG] ${message}`);
+        }
+    }
+    error(message) {
+        if (this.logLevel >= LogLevel.ERROR) {
+            console.error(message);
+        }
+    }
+    warn(message) {
+        if (this.logLevel >= LogLevel.WARN) {
+            console.warn(`[WARN] ${message}`);
+        }
+    }
+    browserAuth(message) {
+        this.info(`🌐 ${message}`);
+    }
+    refresh(message) {
+        this.info(`🔄 ${message}`);
+    }
+    success(message) {
+        this.info(`✅ ${message}`);
+    }
+    browserUrl(url) {
+        // Always show URL when browser is not opened automatically (user needs to open manually)
+        this.info(`🔗 Open in browser: ${url}`);
+    }
+    browserOpening() {
+        // Only show when debug is enabled (browser opens automatically)
+        this.debug(`🌐 Opening browser for authentication...`);
+    }
+    testSkip(message) {
+        this.info(`⏭️  ${message}`);
+    }
+}
+/**
+ * Test logger implementation
+ * Uses same log levels as DefaultLogger
+ */
+class TestLogger {
+    logLevel;
+    constructor(logLevel) {
+        this.logLevel = logLevel ?? getLogLevel();
+    }
+    info(message) {
+        if (this.logLevel >= LogLevel.INFO) {
+            console.info(message);
+        }
+    }
+    debug(message) {
+        if (this.logLevel >= LogLevel.DEBUG) {
+            console.info(`[DEBUG] ${message}`);
+        }
+    }
+    error(message) {
+        if (this.logLevel >= LogLevel.ERROR) {
+            console.error(message);
+        }
+    }
+    warn(message) {
+        if (this.logLevel >= LogLevel.WARN) {
+            console.warn(`[WARN] ${message}`);
+        }
+    }
+    browserAuth(message) {
+        this.info(`🌐 ${message}`);
+    }
+    refresh(message) {
+        this.info(`🔄 ${message}`);
+    }
+    success(message) {
+        this.info(`✅ ${message}`);
+    }
+    browserUrl(url) {
+        // Always show URL when browser is not opened automatically (user needs to open manually)
+        this.info(`🔗 Open in browser: ${url}`);
+    }
+    browserOpening() {
+        // Only show when debug is enabled (browser opens automatically)
+        this.debug(`🌐 Opening browser for authentication...`);
+    }
+    testSkip(message) {
+        this.info(`⏭️  ${message}`);
+    }
+}
+// Default logger instance (singleton)
+exports.defaultLogger = new DefaultLogger();
+// Test logger instance
+exports.testLogger = new TestLogger();
+// Export convenience functions that use default logger (for backward compatibility)
+function info(message) {
+    exports.defaultLogger.info(message);
+}
+function debug(message) {
+    exports.defaultLogger.debug(message);
+}
+function error(message) {
+    exports.defaultLogger.error(message);
+}
+function browserAuth(message) {
+    exports.defaultLogger.browserAuth(message);
+}
+function refresh(message) {
+    exports.defaultLogger.refresh(message);
+}
+function success(message) {
+    exports.defaultLogger.success(message);
+}
+function browserUrl(url) {
+    exports.defaultLogger.browserUrl(url);
+}
+function browserOpening() {
+    exports.defaultLogger.browserOpening();
+}
+function testSkip(message) {
+    exports.defaultLogger.testSkip(message);
+}
+function warn(message) {
+    exports.defaultLogger.warn(message);
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@mcp-abap-adt/logger",
+  "version": "0.1.0",
+  "description": "Logger interface and implementations for MCP ABAP ADT packages",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "abap",
+    "sap",
+    "adt",
+    "logger",
+    "logging",
+    "mcp",
+    "abap-adt"
+  ],
+  "author": "Oleksii Kyslytsia <oleksij.kyslytsja@gmail.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/fr0ster/mcp-abap-adt-logger#readme",
+  "bugs": {
+    "url": "https://github.com/fr0ster/mcp-abap-adt-logger/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fr0ster/mcp-abap-adt-logger.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "build": "npm run clean --silent && npx tsc -p tsconfig.json",
+    "build:fast": "npx tsc -p tsconfig.json",
+    "test": "NODE_OPTIONS=--experimental-vm-modules jest",
+    "test:check": "npx tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.2.1",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.2.5",
+    "typescript": "^5.9.2"
+  }
+}
+