@mcp-abap-adt/core 4.8.1 → 4.8.3

package/dist/src/lib/getObjectsListCache.js

@@ -0,0 +1,18 @@
+"use strict";
+// In-memory cache for GetObjectsList
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.objectsListCache = void 0;
+class ObjectsListCache {
+    cache = null;
+    setCache(data) {
+        this.cache = data;
+    }
+    getCache() {
+        return this.cache;
+    }
+    clearCache() {
+        this.cache = null;
+    }
+}
+exports.objectsListCache = new ObjectsListCache();
+//# sourceMappingURL=getObjectsListCache.js.map

package/dist/src/lib/getObjectsListCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getObjectsListCache.js","sourceRoot":"","sources":["../../../src/lib/getObjectsListCache.ts"],"names":[],"mappings":";AAAA,qCAAqC;;;AAIrC,MAAM,gBAAgB;IACZ,KAAK,GAAyB,IAAI,CAAC;IAE3C,QAAQ,CAAC,IAAS;QAChB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,UAAU;QACR,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;CACF;AAEY,QAAA,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/src/lib/handlerLogger.d.ts

@@ -0,0 +1,9 @@
+import type { Logger } from '@mcp-abap-adt/logger';
+/**
+ * Create a prefixed logger for handlers.
+ * Honors AUTH_LOG_LEVEL from @mcp-abap-adt/logger; set to "error"/"warn"/"info"/"debug".
+ * Use HANDLER_LOG_SILENT=true to force no-op logger for handlers.
+ */
+export declare function getHandlerLogger(category: string, baseLogger?: Logger): Logger;
+export declare const noopLogger: Logger;
+//# sourceMappingURL=handlerLogger.d.ts.map

package/dist/src/lib/handlerLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlerLogger.d.ts","sourceRoot":"","sources":["../../../src/lib/handlerLogger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAeR;AAGD,eAAO,MAAM,UAAU,EAAE,MAKxB,CAAC"}

package/dist/src/lib/handlerLogger.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noopLogger = void 0;
+exports.getHandlerLogger = getHandlerLogger;
+const node_module_1 = require("node:module");
+/**
+ * Create a prefixed logger for handlers.
+ * Honors AUTH_LOG_LEVEL from @mcp-abap-adt/logger; set to "error"/"warn"/"info"/"debug".
+ * Use HANDLER_LOG_SILENT=true to force no-op logger for handlers.
+ */
+function getHandlerLogger(category, baseLogger) {
+    if (process.env.HANDLER_LOG_SILENT === 'true') {
+        return exports.noopLogger;
+    }
+    const resolvedLogger = baseLogger ?? getDefaultLogger();
+    const prefix = `[${category}]`;
+    const wrap = (fn) => (msg) => fn(`${prefix} ${msg}`);
+    return {
+        info: wrap(resolvedLogger?.info.bind(resolvedLogger)),
+        debug: wrap(resolvedLogger?.debug.bind(resolvedLogger)),
+        warn: wrap(resolvedLogger?.warn.bind(resolvedLogger)),
+        error: wrap(resolvedLogger?.error.bind(resolvedLogger)),
+    };
+}
+const noopFn = () => { };
+exports.noopLogger = {
+    info: noopFn,
+    debug: noopFn,
+    warn: noopFn,
+    error: noopFn,
+};
+function getDefaultLogger() {
+    const require = (0, node_module_1.createRequire)(__filename);
+    const mod = require('@mcp-abap-adt/logger');
+    return mod.defaultLogger ?? new mod.DefaultLogger();
+}
+//# sourceMappingURL=handlerLogger.js.map

package/dist/src/lib/handlerLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlerLogger.js","sourceRoot":"","sources":["../../../src/lib/handlerLogger.ts"],"names":[],"mappings":";;;AAQA,4CAkBC;AA1BD,6CAA4C;AAG5C;;;;GAIG;AACH,SAAgB,gBAAgB,CAC9B,QAAgB,EAChB,UAAmB;IAEnB,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,MAAM,EAAE,CAAC;QAC9C,OAAO,kBAAU,CAAC;IACpB,CAAC;IACD,MAAM,cAAc,GAAG,UAAU,IAAI,gBAAgB,EAAE,CAAC;IACxD,MAAM,MAAM,GAAG,IAAI,QAAQ,GAAG,CAAC;IAC/B,MAAM,IAAI,GAAG,CAAC,EAAyB,EAAE,EAAE,CAAC,CAAC,GAAW,EAAE,EAAE,CAC1D,EAAE,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC;IAEzB,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACrD,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACvD,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACrD,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;KACxD,CAAC;AACJ,CAAC;AAED,MAAM,MAAM,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;AACX,QAAA,UAAU,GAAW;IAChC,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,MAAM;CACd,CAAC;AAEF,SAAS,gBAAgB;IACvB,MAAM,OAAO,GAAG,IAAA,2BAAa,EAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC5C,OAAO,GAAG,CAAC,aAAa,IAAI,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;AACtD,CAAC"}

package/dist/src/lib/handlers/HandlerExporter.d.ts

@@ -0,0 +1,89 @@
+import type { Logger } from '@mcp-abap-adt/logger';
+import type { HandlerEntry, IHandlersRegistry } from './interfaces.js';
+/**
+ * Options for creating handler exporter
+ */
+export interface HandlerExporterOptions {
+    /**
+     * Logger instance for handler context
+     * @default defaultLogger
+     */
+    logger?: Logger;
+    /**
+     * Include readonly handlers (getProgram, getClass, etc.)
+     * @default true
+     */
+    includeReadOnly?: boolean;
+    /**
+     * Include high-level handlers
+     * @default true
+     */
+    includeHighLevel?: boolean;
+    /**
+     * Include low-level handlers
+     * @default true
+     */
+    includeLowLevel?: boolean;
+    /**
+     * Include compact facade handlers
+     * @default false
+     */
+    includeCompact?: boolean;
+    /**
+     * Include system handlers
+     * @default true
+     */
+    includeSystem?: boolean;
+    /**
+     * Include search handlers
+     * @default true
+     */
+    includeSearch?: boolean;
+}
+/**
+ * Handler Exporter - factory for creating handlers registry
+ *
+ * This class provides a way to create handlers registry with configurable
+ * exposition levels. Use with EmbeddableMcpServer for external integration.
+ *
+ * Usage:
+ * ```typescript
+ * import { HandlerExporter, EmbeddableMcpServer } from '@mcp-abap-adt/core';
+ *
+ * // Create exporter with specific handlers
+ * const exporter = new HandlerExporter({
+ *   includeReadOnly: true,
+ *   includeHighLevel: true,
+ *   includeLowLevel: false,
+ * });
+ *
+ * // Use with EmbeddableMcpServer
+ * const server = new EmbeddableMcpServer({
+ *   connection: myConnection,
+ *   handlersRegistry: exporter.createRegistry(),
+ * });
+ * ```
+ */
+export declare class HandlerExporter {
+    private readonly logger;
+    private readonly handlerGroups;
+    constructor(options?: HandlerExporterOptions);
+    /**
+     * Get all handler entries
+     * Useful for inspection or custom registration logic
+     */
+    getHandlerEntries(): HandlerEntry[];
+    /**
+     * Get list of tool names
+     */
+    getToolNames(): string[];
+    /**
+     * Create handlers registry for use with EmbeddableMcpServer or BaseMcpServer
+     */
+    createRegistry(): IHandlersRegistry;
+}
+/**
+ * Create default handler exporter with all handler groups
+ */
+export declare function createDefaultHandlerExporter(logger?: Logger): HandlerExporter;
+//# sourceMappingURL=HandlerExporter.d.ts.map

package/dist/src/lib/handlers/HandlerExporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HandlerExporter.d.ts","sourceRoot":"","sources":["../../../../src/lib/handlers/HandlerExporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AASnD,OAAO,KAAK,EACV,YAAY,EAEZ,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAGzB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkB;gBAEpC,OAAO,CAAC,EAAE,sBAAsB;IAiC5C;;;OAGG;IACH,iBAAiB,IAAI,YAAY,EAAE;IAQnC;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,cAAc,IAAI,iBAAiB;CAGpC;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,CAE7E"}

package/dist/src/lib/handlers/HandlerExporter.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HandlerExporter = void 0;
+exports.createDefaultHandlerExporter = createDefaultHandlerExporter;
+const logger_1 = require("@mcp-abap-adt/logger");
+const CompactHandlersGroup_js_1 = require("./groups/CompactHandlersGroup.js");
+const HighLevelHandlersGroup_js_1 = require("./groups/HighLevelHandlersGroup.js");
+const LowLevelHandlersGroup_js_1 = require("./groups/LowLevelHandlersGroup.js");
+const ReadOnlyHandlersGroup_js_1 = require("./groups/ReadOnlyHandlersGroup.js");
+const SearchHandlersGroup_js_1 = require("./groups/SearchHandlersGroup.js");
+const SystemHandlersGroup_js_1 = require("./groups/SystemHandlersGroup.js");
+const CompositeHandlersRegistry_js_1 = require("./registry/CompositeHandlersRegistry.js");
+/**
+ * Handler Exporter - factory for creating handlers registry
+ *
+ * This class provides a way to create handlers registry with configurable
+ * exposition levels. Use with EmbeddableMcpServer for external integration.
+ *
+ * Usage:
+ * ```typescript
+ * import { HandlerExporter, EmbeddableMcpServer } from '@mcp-abap-adt/core';
+ *
+ * // Create exporter with specific handlers
+ * const exporter = new HandlerExporter({
+ *   includeReadOnly: true,
+ *   includeHighLevel: true,
+ *   includeLowLevel: false,
+ * });
+ *
+ * // Use with EmbeddableMcpServer
+ * const server = new EmbeddableMcpServer({
+ *   connection: myConnection,
+ *   handlersRegistry: exporter.createRegistry(),
+ * });
+ * ```
+ */
+class HandlerExporter {
+    logger;
+    handlerGroups;
+    constructor(options) {
+        this.logger = options?.logger ?? logger_1.defaultLogger;
+        // Create dummy context for group instantiation
+        // Real context is provided by BaseMcpServer.registerHandlers() via getConnection()
+        const dummyContext = {
+            connection: null,
+            logger: this.logger,
+        };
+        // Build handler groups based on options
+        this.handlerGroups = [];
+        if (options?.includeReadOnly !== false) {
+            this.handlerGroups.push(new ReadOnlyHandlersGroup_js_1.ReadOnlyHandlersGroup(dummyContext));
+        }
+        if (options?.includeHighLevel !== false) {
+            this.handlerGroups.push(new HighLevelHandlersGroup_js_1.HighLevelHandlersGroup(dummyContext));
+        }
+        if (options?.includeCompact === true) {
+            this.handlerGroups.push(new CompactHandlersGroup_js_1.CompactHandlersGroup(dummyContext));
+        }
+        if (options?.includeLowLevel !== false) {
+            this.handlerGroups.push(new LowLevelHandlersGroup_js_1.LowLevelHandlersGroup(dummyContext));
+        }
+        if (options?.includeSystem !== false) {
+            this.handlerGroups.push(new SystemHandlersGroup_js_1.SystemHandlersGroup(dummyContext));
+        }
+        if (options?.includeSearch !== false) {
+            this.handlerGroups.push(new SearchHandlersGroup_js_1.SearchHandlersGroup(dummyContext));
+        }
+    }
+    /**
+     * Get all handler entries
+     * Useful for inspection or custom registration logic
+     */
+    getHandlerEntries() {
+        const entries = [];
+        for (const group of this.handlerGroups) {
+            entries.push(...group.getHandlers());
+        }
+        return entries;
+    }
+    /**
+     * Get list of tool names
+     */
+    getToolNames() {
+        return this.getHandlerEntries().map((e) => e.toolDefinition.name);
+    }
+    /**
+     * Create handlers registry for use with EmbeddableMcpServer or BaseMcpServer
+     */
+    createRegistry() {
+        return new CompositeHandlersRegistry_js_1.CompositeHandlersRegistry(this.handlerGroups);
+    }
+}
+exports.HandlerExporter = HandlerExporter;
+/**
+ * Create default handler exporter with all handler groups
+ */
+function createDefaultHandlerExporter(logger) {
+    return new HandlerExporter({ logger });
+}
+//# sourceMappingURL=HandlerExporter.js.map

package/dist/src/lib/handlers/HandlerExporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HandlerExporter.js","sourceRoot":"","sources":["../../../../src/lib/handlers/HandlerExporter.ts"],"names":[],"mappings":";;;AA0JA,oEAEC;AA3JD,iDAAqD;AAErD,8EAAwE;AACxE,kFAA4E;AAC5E,gFAA0E;AAC1E,gFAA0E;AAC1E,4EAAsE;AACtE,4EAAsE;AAMtE,0FAAoF;AAiDpF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,eAAe;IACT,MAAM,CAAS;IACf,aAAa,CAAkB;IAEhD,YAAY,OAAgC;QAC1C,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,sBAAa,CAAC;QAE/C,+CAA+C;QAC/C,mFAAmF;QACnF,MAAM,YAAY,GAAmB;YACnC,UAAU,EAAE,IAAW;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;QAEF,wCAAwC;QACxC,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QAExB,IAAI,OAAO,EAAE,eAAe,KAAK,KAAK,EAAE,CAAC;YACvC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,gDAAqB,CAAC,YAAY,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,OAAO,EAAE,gBAAgB,KAAK,KAAK,EAAE,CAAC;YACxC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,kDAAsB,CAAC,YAAY,CAAC,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,OAAO,EAAE,cAAc,KAAK,IAAI,EAAE,CAAC;YACrC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,8CAAoB,CAAC,YAAY,CAAC,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,OAAO,EAAE,eAAe,KAAK,KAAK,EAAE,CAAC;YACvC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,gDAAqB,CAAC,YAAY,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,OAAO,EAAE,aAAa,KAAK,KAAK,EAAE,CAAC;YACrC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,4CAAmB,CAAC,YAAY,CAAC,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,OAAO,EAAE,aAAa,KAAK,KAAK,EAAE,CAAC;YACrC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,4CAAmB,CAAC,YAAY,CAAC,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,iBAAiB;QACf,MAAM,OAAO,GAAmB,EAAE,CAAC;QACnC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,iBAAiB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,wDAAyB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC3D,CAAC;CACF;AA9DD,0CA8DC;AAED;;GAEG;AACH,SAAgB,4BAA4B,CAAC,MAAe;IAC1D,OAAO,IAAI,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;AACzC,CAAC"}

package/dist/src/lib/handlers/base/BaseHandlerGroup.d.ts

@@ -0,0 +1,31 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { HandlerContext } from '../../../handlers/interfaces.js';
+import type { HandlerEntry, IHandlerGroup, ToolHandler } from '../interfaces.js';
+/**
+ * Base class for handler groups
+ * Provides common functionality for registering handlers
+ */
+export declare abstract class BaseHandlerGroup implements IHandlerGroup {
+    protected abstract groupName: string;
+    protected context: HandlerContext;
+    constructor(context: HandlerContext);
+    /**
+     * Gets the name of the handler group
+     */
+    getName(): string;
+    /**
+     * Gets all handler entries in this group
+     * Must be implemented by subclasses
+     */
+    abstract getHandlers(): HandlerEntry[];
+    /**
+     * Registers all handlers from this group on the MCP server
+     */
+    registerHandlers(server: McpServer): void;
+    /**
+     * Helper function to register a tool on McpServer
+     * Wraps handler to convert our response format to MCP format
+     */
+    protected registerToolOnServer(server: McpServer, toolName: string, description: string, inputSchema: any, handler: ToolHandler): void;
+}
+//# sourceMappingURL=BaseHandlerGroup.d.ts.map

package/dist/src/lib/handlers/base/BaseHandlerGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseHandlerGroup.d.ts","sourceRoot":"","sources":["../../../../../src/lib/handlers/base/BaseHandlerGroup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAG1B;;;GAGG;AACH,8BAAsB,gBAAiB,YAAW,aAAa;IAC7D,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IACrC,SAAS,CAAC,OAAO,EAAE,cAAc,CAAC;gBAEtB,OAAO,EAAE,cAAc;IAGnC;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;;OAGG;IACH,QAAQ,CAAC,WAAW,IAAI,YAAY,EAAE;IAEtC;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAazC;;;OAGG;IACH,SAAS,CAAC,oBAAoB,CAC5B,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,GAAG,EAChB,OAAO,EAAE,WAAW,GACnB,IAAI;CAmDR"}

package/dist/src/lib/handlers/base/BaseHandlerGroup.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseHandlerGroup = void 0;
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const schemaUtils_js_1 = require("../utils/schemaUtils.js");
+/**
+ * Base class for handler groups
+ * Provides common functionality for registering handlers
+ */
+class BaseHandlerGroup {
+    context;
+    constructor(context) {
+        this.context = context;
+    }
+    /**
+     * Gets the name of the handler group
+     */
+    getName() {
+        return this.groupName;
+    }
+    /**
+     * Registers all handlers from this group on the MCP server
+     */
+    registerHandlers(server) {
+        const handlers = this.getHandlers();
+        for (const entry of handlers) {
+            this.registerToolOnServer(server, entry.toolDefinition.name, entry.toolDefinition.description, entry.toolDefinition.inputSchema, entry.handler);
+        }
+    }
+    /**
+     * Helper function to register a tool on McpServer
+     * Wraps handler to convert our response format to MCP format
+     */
+    registerToolOnServer(server, toolName, description, inputSchema, handler) {
+        // Convert JSON Schema to Zod if needed, otherwise pass as-is
+        const zodSchema = inputSchema &&
+            typeof inputSchema === 'object' &&
+            inputSchema.type === 'object' &&
+            inputSchema.properties
+            ? (0, schemaUtils_js_1.jsonSchemaToZod)(inputSchema)
+            : inputSchema;
+        server.registerTool(toolName, {
+            description,
+            inputSchema: zodSchema,
+        }, async (args) => {
+            const result = await handler(this.context, args);
+            // If error, throw it
+            if (result.isError) {
+                const errorText = result.content
+                    ?.map((item) => {
+                    if (item?.type === 'json' && item.json !== undefined) {
+                        return JSON.stringify(item.json);
+                    }
+                    return item?.text || String(item);
+                })
+                    .join('\n') || 'Unknown error';
+                throw new types_js_1.McpError(types_js_1.ErrorCode.InternalError, errorText);
+            }
+            // Convert content to MCP format - JSON items become text
+            const content = (result.content || []).map((item) => {
+                if (item?.type === 'json' && item.json !== undefined) {
+                    return {
+                        type: 'text',
+                        text: JSON.stringify(item.json),
+                    };
+                }
+                return {
+                    type: 'text',
+                    text: item?.text || String(item || ''),
+                };
+            });
+            return { content };
+        });
+    }
+}
+exports.BaseHandlerGroup = BaseHandlerGroup;
+//# sourceMappingURL=BaseHandlerGroup.js.map

package/dist/src/lib/handlers/base/BaseHandlerGroup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseHandlerGroup.js","sourceRoot":"","sources":["../../../../../src/lib/handlers/base/BaseHandlerGroup.ts"],"names":[],"mappings":";;;AACA,iEAAyE;AAOzE,4DAA0D;AAE1D;;;GAGG;AACH,MAAsB,gBAAgB;IAE1B,OAAO,CAAiB;IAElC,YAAY,OAAuB;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IACD;;OAEG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAQD;;OAEG;IACH,gBAAgB,CAAC,MAAiB;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC,oBAAoB,CACvB,MAAM,EACN,KAAK,CAAC,cAAc,CAAC,IAAI,EACzB,KAAK,CAAC,cAAc,CAAC,WAAW,EAChC,KAAK,CAAC,cAAc,CAAC,WAAW,EAChC,KAAK,CAAC,OAAO,CACd,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;OAGG;IACO,oBAAoB,CAC5B,MAAiB,EACjB,QAAgB,EAChB,WAAmB,EACnB,WAAgB,EAChB,OAAoB;QAEpB,6DAA6D;QAC7D,MAAM,SAAS,GACb,WAAW;YACX,OAAO,WAAW,KAAK,QAAQ;YAC/B,WAAW,CAAC,IAAI,KAAK,QAAQ;YAC7B,WAAW,CAAC,UAAU;YACpB,CAAC,CAAC,IAAA,gCAAe,EAAC,WAAW,CAAC;YAC9B,CAAC,CAAC,WAAW,CAAC;QAElB,MAAM,CAAC,YAAY,CACjB,QAAQ,EACR;YACE,WAAW;YACX,WAAW,EAAE,SAAS;SACvB,EACD,KAAK,EAAE,IAAS,EAAE,EAAE;YAClB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAEjD,qBAAqB;YACrB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM,SAAS,GACb,MAAM,CAAC,OAAO;oBACZ,EAAE,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE;oBAClB,IAAI,IAAI,EAAE,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;wBACrD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACnC,CAAC;oBACD,OAAO,IAAI,EAAE,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;gBACpC,CAAC,CAAC;qBACD,IAAI,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC;gBACnC,MAAM,IAAI,mBAAQ,CAAC,oBAAS,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;YACzD,CAAC;YAED,yDAAyD;YACzD,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE;gBACvD,IAAI,IAAI,EAAE,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;oBACrD,OAAO;wBACL,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;qBAChC,CAAC;gBACJ,CAAC;gBACD,OAAO;oBACL,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;iBACvC,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,OAAO,EAAE,OAAO,EAAE,CAAC;QACrB,CAAC,CACF,CAAC;IACJ,CAAC;CACF;AAjGD,4CAiGC"}

package/dist/src/lib/handlers/examples/usage-example.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Example usage of handler registration system with Dependency Injection
+ *
+ * This example demonstrates how to use handler groups to create different
+ * server configurations with different sets of handlers.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { HandlerContext } from '../../../handlers/interfaces.js';
+/**
+ * Example 1: Read-only server (e.g., for public API)
+ * Only registers read-only handlers, system handlers, and search handlers
+ */
+export declare function createReadOnlyServer(context: HandlerContext): McpServer;
+/**
+ * Example 2: Full-featured server
+ * Registers all handler groups
+ */
+export declare function createFullServer(context: HandlerContext): McpServer;
+/**
+ * Example 3: Dynamic handler group management
+ * Add/remove handler groups at runtime
+ */
+export declare function createDynamicServer(context: HandlerContext): McpServer;
+/**
+ * Example 4: Custom server configuration
+ * Create a server with only specific handler groups
+ */
+export declare function createCustomServer(includeReadOnly: boolean | undefined, context: HandlerContext): McpServer;
+//# sourceMappingURL=usage-example.d.ts.map

package/dist/src/lib/handlers/examples/usage-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-example.d.ts","sourceRoot":"","sources":["../../../../../src/lib/handlers/examples/usage-example.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAStE;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAgBvE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAiBnE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CA6BtE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,OAAO,YAAO,EAC/B,OAAO,EAAE,cAAc,GACtB,SAAS,CAoCX"}

package/dist/src/lib/handlers/examples/usage-example.js

@@ -0,0 +1,119 @@
+"use strict";
+/**
+ * Example usage of handler registration system with Dependency Injection
+ *
+ * This example demonstrates how to use handler groups to create different
+ * server configurations with different sets of handlers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createReadOnlyServer = createReadOnlyServer;
+exports.createFullServer = createFullServer;
+exports.createDynamicServer = createDynamicServer;
+exports.createCustomServer = createCustomServer;
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const HighLevelHandlersGroup_js_1 = require("../groups/HighLevelHandlersGroup.js");
+const LowLevelHandlersGroup_js_1 = require("../groups/LowLevelHandlersGroup.js");
+const ReadOnlyHandlersGroup_js_1 = require("../groups/ReadOnlyHandlersGroup.js");
+const SearchHandlersGroup_js_1 = require("../groups/SearchHandlersGroup.js");
+const SystemHandlersGroup_js_1 = require("../groups/SystemHandlersGroup.js");
+const CompositeHandlersRegistry_js_1 = require("../registry/CompositeHandlersRegistry.js");
+/**
+ * Example 1: Read-only server (e.g., for public API)
+ * Only registers read-only handlers, system handlers, and search handlers
+ */
+function createReadOnlyServer(context) {
+    const { connection, logger } = context;
+    const mcpServer = new mcp_js_1.McpServer({
+        name: 'mcp-abap-adt-readonly',
+        version: '1.0.0',
+    });
+    const handlersRegistry = new CompositeHandlersRegistry_js_1.CompositeHandlersRegistry([
+        new ReadOnlyHandlersGroup_js_1.ReadOnlyHandlersGroup(context),
+        new SystemHandlersGroup_js_1.SystemHandlersGroup(context),
+        new SearchHandlersGroup_js_1.SearchHandlersGroup(context),
+    ]);
+    handlersRegistry.registerAllTools(mcpServer);
+    return mcpServer;
+}
+/**
+ * Example 2: Full-featured server
+ * Registers all handler groups
+ */
+function createFullServer(context) {
+    const mcpServer = new mcp_js_1.McpServer({
+        name: 'mcp-abap-adt-full',
+        version: '1.0.0',
+    });
+    const handlersRegistry = new CompositeHandlersRegistry_js_1.CompositeHandlersRegistry([
+        new ReadOnlyHandlersGroup_js_1.ReadOnlyHandlersGroup(context),
+        new HighLevelHandlersGroup_js_1.HighLevelHandlersGroup(context),
+        new LowLevelHandlersGroup_js_1.LowLevelHandlersGroup(context),
+        new SystemHandlersGroup_js_1.SystemHandlersGroup(context),
+        new SearchHandlersGroup_js_1.SearchHandlersGroup(context),
+    ]);
+    handlersRegistry.registerAllTools(mcpServer);
+    return mcpServer;
+}
+/**
+ * Example 3: Dynamic handler group management
+ * Add/remove handler groups at runtime
+ */
+function createDynamicServer(context) {
+    const { connection, logger } = context;
+    const mcpServer = new mcp_js_1.McpServer({
+        name: 'mcp-abap-adt-dynamic',
+        version: '1.0.0',
+    });
+    const handlersRegistry = new CompositeHandlersRegistry_js_1.CompositeHandlersRegistry();
+    // Add groups dynamically
+    handlersRegistry.addHandlerGroup(new ReadOnlyHandlersGroup_js_1.ReadOnlyHandlersGroup(context));
+    handlersRegistry.addHandlerGroup(new HighLevelHandlersGroup_js_1.HighLevelHandlersGroup(context));
+    handlersRegistry.addHandlerGroup(new SystemHandlersGroup_js_1.SystemHandlersGroup(context));
+    handlersRegistry.addHandlerGroup(new SearchHandlersGroup_js_1.SearchHandlersGroup(context));
+    // Register all tools
+    handlersRegistry.registerAllTools(mcpServer);
+    // Get information about registered groups
+    console.log('Handler groups:', handlersRegistry.getHandlerGroupNames());
+    console.log('Registered tools:', handlersRegistry.getRegisteredTools());
+    // Remove a group if needed
+    // handlersRegistry.removeHandlerGroup("HighLevelHandlers");
+    // Add low-level handlers if needed
+    handlersRegistry.addHandlerGroup(new LowLevelHandlersGroup_js_1.LowLevelHandlersGroup(context));
+    return mcpServer;
+}
+/**
+ * Example 4: Custom server configuration
+ * Create a server with only specific handler groups
+ */
+function createCustomServer(includeReadOnly = true, context) {
+    const mcpServer = new mcp_js_1.McpServer({
+        name: 'mcp-abap-adt-custom',
+        version: '1.0.0',
+    });
+    const handlerGroups = [];
+    if (includeReadOnly) {
+        handlerGroups.push(new ReadOnlyHandlersGroup_js_1.ReadOnlyHandlersGroup(context));
+    }
+    // Add other groups based on configuration
+    // if (config.includeHighLevel) {
+    //   handlerGroups.push(new HighLevelHandlersGroup() as IHandlerGroup);
+    // }
+    // if (config.includeLowLevel) {
+    //   handlerGroups.push(new LowLevelHandlersGroup() as IHandlerGroup);
+    // }
+    // if (config.includeSystem) {
+    //   handlerGroups.push(new SystemHandlersGroup() as IHandlerGroup);
+    // }
+    // if (config.includeSearch) {
+    //   handlerGroups.push(new SearchHandlersGroup() as IHandlerGroup);
+    // }
+    // Example: Add high-level, low-level, system, and search groups
+    handlerGroups.push(new HighLevelHandlersGroup_js_1.HighLevelHandlersGroup(context));
+    handlerGroups.push(new LowLevelHandlersGroup_js_1.LowLevelHandlersGroup(context));
+    handlerGroups.push(new SystemHandlersGroup_js_1.SystemHandlersGroup(context));
+    handlerGroups.push(new SearchHandlersGroup_js_1.SearchHandlersGroup(context));
+    const handlersRegistry = new CompositeHandlersRegistry_js_1.CompositeHandlersRegistry(handlerGroups);
+    handlersRegistry.registerAllTools(mcpServer);
+    return mcpServer;
+}
+//# sourceMappingURL=usage-example.js.map

package/dist/src/lib/handlers/examples/usage-example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-example.js","sourceRoot":"","sources":["../../../../../src/lib/handlers/examples/usage-example.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/handlers/groups/CompactHandlersGroup.d.ts

@@ -0,0 +1,11 @@
+import { BaseHandlerGroup } from '../base/BaseHandlerGroup.js';
+import type { HandlerEntry } from '../interfaces.js';
+/**
+ * Handler group for compact facade handlers.
+ * Provides unified CRUD router tools by object_type.
+ */
+export declare class CompactHandlersGroup extends BaseHandlerGroup {
+    protected groupName: string;
+    getHandlers(): HandlerEntry[];
+}
+//# sourceMappingURL=CompactHandlersGroup.d.ts.map

package/dist/src/lib/handlers/groups/CompactHandlersGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompactHandlersGroup.d.ts","sourceRoot":"","sources":["../../../../../src/lib/handlers/groups/CompactHandlersGroup.ts"],"names":[],"mappings":"AAwFA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,gBAAgB;IACxD,SAAS,CAAC,SAAS,SAAqB;IAExC,WAAW,IAAI,YAAY,EAAE;CAkG9B"}