@mcp-abap-adt/core 4.8.1 → 4.8.2

package/dist/src/server/IHttpApplication.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IHttpApplication.js.map

package/dist/src/server/IHttpApplication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IHttpApplication.js","sourceRoot":"","sources":["../../../src/server/IHttpApplication.ts"],"names":[],"mappings":""}

package/dist/src/server/IServerConfig.d.ts

@@ -0,0 +1,15 @@
+/**
+ * V2 Server configuration
+ * Re-exports unified IServerConfig from lib/config
+ */
+export type { HandlerSet, IServerConfig, Transport, } from '../lib/config/IServerConfig.js';
+import type { HandlerSet, IServerConfig as IBaseServerConfig, Transport } from '../lib/config/IServerConfig.js';
+/**
+ * V2 Server configuration with required fields
+ * @deprecated Use IServerConfig from lib/config/IServerConfig.js
+ */
+export interface IV2ServerConfig extends IBaseServerConfig {
+    transport: Transport;
+    exposition: HandlerSet[];
+}
+//# sourceMappingURL=IServerConfig.d.ts.map

package/dist/src/server/IServerConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IServerConfig.d.ts","sourceRoot":"","sources":["../../../src/server/IServerConfig.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,UAAU,EACV,aAAa,EACb,SAAS,GACV,MAAM,gCAAgC,CAAC;AAGxC,OAAO,KAAK,EACV,UAAU,EACV,aAAa,IAAI,iBAAiB,EAClC,SAAS,EACV,MAAM,gCAAgC,CAAC;AAExC;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IAExD,SAAS,EAAE,SAAS,CAAC;IAErB,UAAU,EAAE,UAAU,EAAE,CAAC;CAC1B"}

package/dist/src/server/IServerConfig.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * V2 Server configuration
+ * Re-exports unified IServerConfig from lib/config
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IServerConfig.js.map

package/dist/src/server/IServerConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IServerConfig.js","sourceRoot":"","sources":["../../../src/server/IServerConfig.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/src/server/MockAbapConnection.d.ts

@@ -0,0 +1,13 @@
+export declare class MockAbapConnection {
+    private throwError;
+    get connectionOptions(): {};
+    get sdkClient(): {};
+    get(): Promise<void>;
+    post(): Promise<void>;
+    put(): Promise<void>;
+    delete(): Promise<void>;
+    request(): Promise<void>;
+    head(): Promise<void>;
+    options(): Promise<void>;
+}
+//# sourceMappingURL=MockAbapConnection.d.ts.map

package/dist/src/server/MockAbapConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockAbapConnection.d.ts","sourceRoot":"","sources":["../../../src/server/MockAbapConnection.ts"],"names":[],"mappings":"AAEA,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,UAAU;IAMlB,IAAI,iBAAiB,OAEpB;IAED,IAAI,SAAS,OAEZ;IAEK,GAAG;IAIH,IAAI;IAIJ,GAAG;IAIH,MAAM;IAIN,OAAO;IAIP,IAAI;IAIJ,OAAO;CAGd"}

package/dist/src/server/MockAbapConnection.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockAbapConnection = void 0;
+class MockAbapConnection {
+    throwError() {
+        throw new Error('Stdio mode without configuration (--mcp-config-file or .env) is limited to tool inspection only. Please provide configuration to execute tools.');
+    }
+    get connectionOptions() {
+        return {};
+    }
+    get sdkClient() {
+        return {};
+    }
+    async get() {
+        this.throwError();
+    }
+    async post() {
+        this.throwError();
+    }
+    async put() {
+        this.throwError();
+    }
+    async delete() {
+        this.throwError();
+    }
+    async request() {
+        this.throwError();
+    }
+    async head() {
+        this.throwError();
+    }
+    async options() {
+        this.throwError();
+    }
+}
+exports.MockAbapConnection = MockAbapConnection;
+//# sourceMappingURL=MockAbapConnection.js.map

package/dist/src/server/MockAbapConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockAbapConnection.js","sourceRoot":"","sources":["../../../src/server/MockAbapConnection.ts"],"names":[],"mappings":";;;AAEA,MAAa,kBAAkB;IACrB,UAAU;QAChB,MAAM,IAAI,KAAK,CACb,iJAAiJ,CAClJ,CAAC;IACJ,CAAC;IAED,IAAI,iBAAiB;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,SAAS;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,MAAM;QACV,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;CACF;AA1CD,gDA0CC"}

package/dist/src/server/SseServer.d.ts

@@ -0,0 +1,102 @@
+import type { Logger } from '@mcp-abap-adt/logger';
+import type { AuthBrokerFactory } from '../lib/auth/index.js';
+import type { TlsConfig } from '../lib/config/IServerConfig.js';
+import type { IHandlersRegistry } from '../lib/handlers/interfaces.js';
+import type { IHttpApplication, RouteRegistrationOptions } from './IHttpApplication.js';
+export interface SseServerOptions {
+    /**
+     * Host to bind to (only used when no external app is provided)
+     * @default "127.0.0.1"
+     */
+    host?: string;
+    /**
+     * Port to listen on (only used when no external app is provided)
+     * @default 3001
+     */
+    port?: number;
+    /**
+     * Path for SSE GET endpoint
+     * @default "/sse"
+     */
+    ssePath?: string;
+    /**
+     * Path for POST messages endpoint
+     * @default "/messages"
+     */
+    postPath?: string;
+    /**
+     * Default SAP destination to use if not specified in headers
+     */
+    defaultDestination?: string;
+    /**
+     * Logger instance
+     */
+    logger?: Logger;
+    /**
+     * Server version
+     */
+    version?: string;
+    /**
+     * External HTTP application to register routes on
+     * When provided, start() will only register routes without creating a server
+     * This enables integration with existing Express/CDS/CAP servers
+     */
+    app?: IHttpApplication;
+    /**
+     * TLS configuration for HTTPS support
+     */
+    tls?: TlsConfig;
+}
+/**
+ * Minimal SSE server: creates a new BaseMcpServer per GET connection, routes POST by sessionId.
+ *
+ * Supports two modes:
+ * 1. Standalone mode: Creates its own Express server (when no app option provided)
+ * 2. Embedded mode: Registers routes on external app (when app option provided)
+ */
+export declare class SseServer {
+    private readonly handlersRegistry;
+    private readonly authBrokerFactory;
+    private readonly host;
+    private readonly port;
+    private readonly ssePath;
+    private readonly postPath;
+    private readonly defaultDestination?;
+    private readonly sessions;
+    private readonly logger;
+    private readonly version;
+    private readonly externalApp?;
+    private standaloneServer?;
+    private readonly tls?;
+    constructor(handlersRegistry: IHandlersRegistry, authBrokerFactory: AuthBrokerFactory, opts?: SseServerOptions);
+    /**
+     * Register routes on an external HTTP application
+     * Use this when integrating with existing Express/CDS/CAP server
+     *
+     * @param app - External HTTP application (Express, CDS, etc.)
+     * @param options - Route registration options
+     */
+    registerRoutes(app: IHttpApplication, _options?: RouteRegistrationOptions): void;
+    /**
+     * Get the configured SSE endpoint path
+     */
+    getSsePath(): string;
+    /**
+     * Get the configured POST endpoint path
+     */
+    getPostPath(): string;
+    /**
+     * Start the server
+     *
+     * In standalone mode (no external app): Creates Express server and starts listening
+     * In embedded mode (external app provided): Only registers routes on external app
+     */
+    start(): Promise<void>;
+    private handleGet;
+    private handlePost;
+    /**
+     * Check if request has SAP connection headers
+     */
+    private hasSapConnectionHeaders;
+}
+//# sourceMappingURL=SseServer.d.ts.map

package/dist/src/server/SseServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SseServer.d.ts","sourceRoot":"","sources":["../../../src/server/SseServer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAEhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAK/B,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,GAAG,CAAC,EAAE,gBAAgB,CAAC;IACvB;;OAEG;IACH,GAAG,CAAC,EAAE,SAAS,CAAC;CACjB;AAOD;;;;;;GAMG;AACH,qBAAa,SAAS;IAclB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAdpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAmB;IAChD,OAAO,CAAC,gBAAgB,CAAC,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAY;gBAGd,gBAAgB,EAAE,iBAAiB,EACnC,iBAAiB,EAAE,iBAAiB,EACrD,IAAI,CAAC,EAAE,gBAAgB;IAazB;;;;;;OAMG;IACH,cAAc,CACZ,GAAG,EAAE,gBAAgB,EACrB,QAAQ,CAAC,EAAE,wBAAwB,GAClC,IAAI;IA+BP;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAmCd,SAAS;YAsGT,UAAU;IAiDxB;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAShC"}

package/dist/src/server/SseServer.js

@@ -0,0 +1,246 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SseServer = void 0;
+const sse_js_1 = require("@modelcontextprotocol/sdk/server/sse.js");
+const express_1 = __importDefault(require("express"));
+const handlerLogger_js_1 = require("../lib/handlerLogger.js");
+const BaseMcpServer_js_1 = require("./BaseMcpServer.js");
+const tlsUtils_js_1 = require("./tlsUtils.js");
+const DEFAULT_VERSION = process.env.npm_package_version ?? '1.0.0';
+/**
+ * Minimal SSE server: creates a new BaseMcpServer per GET connection, routes POST by sessionId.
+ *
+ * Supports two modes:
+ * 1. Standalone mode: Creates its own Express server (when no app option provided)
+ * 2. Embedded mode: Registers routes on external app (when app option provided)
+ */
+class SseServer {
+    handlersRegistry;
+    authBrokerFactory;
+    host;
+    port;
+    ssePath;
+    postPath;
+    defaultDestination;
+    sessions = new Map();
+    logger;
+    version;
+    externalApp;
+    standaloneServer;
+    tls;
+    constructor(handlersRegistry, authBrokerFactory, opts) {
+        this.handlersRegistry = handlersRegistry;
+        this.authBrokerFactory = authBrokerFactory;
+        this.host = opts?.host ?? '127.0.0.1';
+        this.port = opts?.port ?? 3001;
+        this.ssePath = opts?.ssePath ?? '/sse';
+        this.postPath = opts?.postPath ?? '/messages';
+        this.defaultDestination = opts?.defaultDestination;
+        this.logger = opts?.logger ?? handlerLogger_js_1.noopLogger;
+        this.version = opts?.version ?? DEFAULT_VERSION;
+        this.externalApp = opts?.app;
+        this.tls = opts?.tls;
+    }
+    /**
+     * Register routes on an external HTTP application
+     * Use this when integrating with existing Express/CDS/CAP server
+     *
+     * @param app - External HTTP application (Express, CDS, etc.)
+     * @param options - Route registration options
+     */
+    registerRoutes(app, _options) {
+        // Health check endpoint — lightweight, no MCP protocol logic
+        app.get('/mcp/health', ((_req, res) => {
+            res.json({
+                status: 'ok',
+                uptime: Math.floor(process.uptime()),
+                version: this.version,
+                transport: 'sse',
+                activeSessions: this.sessions.size,
+            });
+        }));
+        app.get(this.ssePath, (async (req, res) => {
+            await this.handleGet(req, res);
+        }));
+        app.post(this.postPath, (async (req, res) => {
+            const url = new URL(req.originalUrl, `http://${req.headers.host}`);
+            await this.handlePost(req, res, url);
+        }));
+        console.error(`[SseServer] Routes registered on external app`);
+        console.error(`[SseServer] SSE endpoint: ${this.ssePath}`);
+        console.error(`[SseServer] POST endpoint: ${this.postPath}`);
+        if (this.defaultDestination) {
+            console.error(`[SseServer] Default destination: ${this.defaultDestination}`);
+        }
+    }
+    /**
+     * Get the configured SSE endpoint path
+     */
+    getSsePath() {
+        return this.ssePath;
+    }
+    /**
+     * Get the configured POST endpoint path
+     */
+    getPostPath() {
+        return this.postPath;
+    }
+    /**
+     * Start the server
+     *
+     * In standalone mode (no external app): Creates Express server and starts listening
+     * In embedded mode (external app provided): Only registers routes on external app
+     */
+    async start() {
+        // If external app was provided in constructor, register routes on it
+        if (this.externalApp) {
+            this.registerRoutes(this.externalApp);
+            return;
+        }
+        // Standalone mode: create own Express server
+        const app = (0, express_1.default)();
+        app.use(express_1.default.json());
+        this.registerRoutes(app);
+        await new Promise((resolve, reject) => {
+            const protocol = (0, tlsUtils_js_1.getProtocol)(this.tls);
+            const server = (0, tlsUtils_js_1.createServerListener)(app, this.tls);
+            this.standaloneServer = server;
+            server.listen(this.port, this.host);
+            server.once('listening', () => {
+                console.error(`[SseServer] Server started on ${this.host}:${this.port}`);
+                console.error(`[SseServer] SSE endpoint: ${protocol}://${this.host}:${this.port}${this.ssePath}`);
+                console.error(`[SseServer] POST endpoint: ${protocol}://${this.host}:${this.port}${this.postPath}`);
+                resolve();
+            });
+            server.once('error', reject);
+        });
+    }
+    async handleGet(req, res) {
+        let destination;
+        let broker;
+        // Priority 1: Check x-mcp-destination header
+        const destinationHeader = req.headers['x-mcp-destination'] ??
+            req.headers['X-MCP-Destination'];
+        if (destinationHeader) {
+            destination = destinationHeader;
+            broker = await this.authBrokerFactory.getOrCreateAuthBroker(destination);
+        }
+        // Priority 2: Check SAP connection headers (x-sap-url + auth params)
+        // Headers will be passed directly to handlers, no broker needed
+        else if (this.hasSapConnectionHeaders(req.headers)) {
+            // No destination, no broker - handlers will use headers directly
+            destination = undefined;
+            broker = undefined;
+        }
+        // Priority 3: Use default destination
+        else if (this.defaultDestination) {
+            destination = this.defaultDestination;
+            broker = await this.authBrokerFactory.getOrCreateAuthBroker(destination);
+        }
+        // Priority 4: No auth params at all -> reject request
+        else {
+            res
+                .status(400)
+                .send('Missing SAP connection context. Provide x-mcp-destination header, configure default destination (--mcp/--env-path), or pass x-sap-* headers.');
+            return;
+        }
+        this.logger.debug(`SSE GET: destination=${destination ?? 'none'}`);
+        class SessionServer extends BaseMcpServer_js_1.BaseMcpServer {
+            registry;
+            loggerImpl;
+            ver;
+            constructor(registry, loggerImpl, ver) {
+                super({ name: 'mcp-abap-adt-sse', version: ver, logger: loggerImpl });
+                this.registry = registry;
+                this.loggerImpl = loggerImpl;
+                this.ver = ver;
+            }
+            async init(dest, b, hdrs) {
+                if (dest && b) {
+                    await this.setConnectionContext(dest, b);
+                }
+                else if (hdrs) {
+                    this.setConnectionContextFromHeaders(hdrs);
+                }
+                this.registerHandlers(this.registry);
+            }
+        }
+        const server = new SessionServer(this.handlersRegistry, this.logger, this.version);
+        await server.init(destination, broker, this.hasSapConnectionHeaders(req.headers) ? req.headers : undefined);
+        const transport = new sse_js_1.SSEServerTransport(this.postPath, res);
+        const sessionId = transport.sessionId;
+        console.error(`[SSE GET] Created session ${sessionId} for destination ${destination}`);
+        this.sessions.set(sessionId, { server, transport });
+        console.error(`[SSE GET] Session stored, total sessions: ${this.sessions.size}`);
+        // Connect transport to server BEFORE registering close handler
+        // This ensures connection is established before any cleanup can happen
+        try {
+            await server.connect(transport);
+            this.logger.debug(`SSE GET: server connected for session ${sessionId}`);
+        }
+        catch (error) {
+            this.logger.error(`SSE GET: failed to connect for session ${sessionId}: ${error instanceof Error ? error.message : String(error)}`);
+            this.sessions.delete(sessionId);
+            if (!res.headersSent) {
+                res.writeHead(500).end('Internal Server Error');
+            }
+            return;
+        }
+        // Register cleanup handler AFTER successful connection
+        res.on('close', () => {
+            console.error(`[SSE CLOSE] Connection closed for session ${sessionId}`);
+            this.sessions.delete(sessionId);
+            void transport.close();
+            void server.close();
+        });
+    }
+    async handlePost(req, res, url) {
+        const sessionId = (url?.searchParams.get('sessionId') ||
+            req.headers['x-session-id'] ||
+            '');
+        const mcpMethod = req.body?.method;
+        const isPing = mcpMethod === 'ping';
+        if (!isPing) {
+            console.error(`[SSE POST] sessionId=${sessionId}, activeSessions=${this.sessions.size}, keys=[${Array.from(this.sessions.keys()).join(', ')}]`);
+        }
+        const entry = this.sessions.get(sessionId);
+        if (!entry) {
+            console.error(`[SSE POST] Invalid session ${sessionId} - session not found!`);
+            res.writeHead(400).end('Invalid session');
+            return;
+        }
+        // Pass pre-parsed body from express.json() middleware (like reference implementation)
+        // express.json() already read and parsed the body into req.body
+        if (!isPing) {
+            console.error(`[SSE POST] Calling handlePostMessage with req.body for session ${sessionId}`);
+        }
+        try {
+            await entry.transport.handlePostMessage(req, res, req.body);
+            if (!isPing) {
+                console.error(`[SSE POST] Successfully processed for session ${sessionId}`);
+            }
+        }
+        catch (error) {
+            console.error(`[SSE POST] FAILED for session ${sessionId}: ${error instanceof Error ? error.message : String(error)}`);
+            console.error(`[SSE POST] Error stack:`, error);
+            if (!res.headersSent) {
+                res.writeHead(500).end('Internal Server Error');
+            }
+        }
+    }
+    /**
+     * Check if request has SAP connection headers
+     */
+    hasSapConnectionHeaders(headers) {
+        const hasUrl = headers['x-sap-url'] || headers['X-SAP-URL'];
+        const hasJwtAuth = headers['x-sap-jwt-token'] || headers['X-SAP-JWT-Token'];
+        const hasBasicAuth = (headers['x-sap-login'] || headers['X-SAP-Login']) &&
+            (headers['x-sap-password'] || headers['X-SAP-Password']);
+        return !!(hasUrl && (hasJwtAuth || hasBasicAuth));
+    }
+}
+exports.SseServer = SseServer;
+//# sourceMappingURL=SseServer.js.map

package/dist/src/server/SseServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SseServer.js","sourceRoot":"","sources":["../../../src/server/SseServer.ts"],"names":[],"mappings":";;;;;;AAGA,oEAA6E;AAC7E,sDAA8B;AAG9B,8DAAqD;AAErD,yDAAmD;AAKnD,+CAAkE;AAElE,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC;AAoDnE;;;;;;GAMG;AACH,MAAa,SAAS;IAcD;IACA;IAdF,IAAI,CAAS;IACb,IAAI,CAAS;IACb,OAAO,CAAS;IAChB,QAAQ,CAAS;IACjB,kBAAkB,CAAU;IAC5B,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC3C,MAAM,CAAS;IACf,OAAO,CAAS;IAChB,WAAW,CAAoB;IACxC,gBAAgB,CAA4B;IACnC,GAAG,CAAa;IAEjC,YACmB,gBAAmC,EACnC,iBAAoC,EACrD,IAAuB;QAFN,qBAAgB,GAAhB,gBAAgB,CAAmB;QACnC,sBAAiB,GAAjB,iBAAiB,CAAmB;QAGrD,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,WAAW,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,MAAM,CAAC;QACvC,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,WAAW,CAAC;QAC9C,IAAI,CAAC,kBAAkB,GAAG,IAAI,EAAE,kBAAkB,CAAC;QACnD,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,6BAAU,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,eAAe,CAAC;QAChD,IAAI,CAAC,WAAW,GAAG,IAAI,EAAE,GAAG,CAAC;QAC7B,IAAI,CAAC,GAAG,GAAG,IAAI,EAAE,GAAG,CAAC;IACvB,CAAC;IAED;;;;;;OAMG;IACH,cAAc,CACZ,GAAqB,EACrB,QAAmC;QAEnC,6DAA6D;QAC7D,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,IAAS,EAAE,GAAQ,EAAE,EAAE;YAC9C,GAAG,CAAC,IAAI,CAAC;gBACP,MAAM,EAAE,IAAI;gBACZ,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpC,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,SAAS,EAAE,KAAK;gBAChB,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;aACnC,CAAC,CAAC;QACL,CAAC,CAAQ,CAAC,CAAC;QAEX,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,GAAQ,EAAE,GAAQ,EAAE,EAAE;YAClD,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC,CAAQ,CAAC,CAAC;QAEX,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAQ,EAAE,GAAQ,EAAE,EAAE;YACpD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,UAAU,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACnE,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACvC,CAAC,CAAQ,CAAC,CAAC;QAEX,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;QAC/D,OAAO,CAAC,KAAK,CAAC,6BAA6B,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,KAAK,CAAC,8BAA8B,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7D,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CACX,oCAAoC,IAAI,CAAC,kBAAkB,EAAE,CAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK;QACT,qEAAqE;QACrE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACtC,OAAO;QACT,CAAC;QAED,6CAA6C;QAC7C,MAAM,GAAG,GAAG,IAAA,iBAAO,GAAE,CAAC;QACtB,GAAG,CAAC,GAAG,CAAC,iBAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAExB,IAAI,CAAC,cAAc,CAAC,GAAkC,CAAC,CAAC;QAExD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,QAAQ,GAAG,IAAA,yBAAW,EAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACvC,MAAM,MAAM,GAAG,IAAA,kCAAoB,EAAC,GAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YAC1D,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC;YAE/B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;gBAC5B,OAAO,CAAC,KAAK,CACX,iCAAiC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAC1D,CAAC;gBACF,OAAO,CAAC,KAAK,CACX,6BAA6B,QAAQ,MAAM,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CACnF,CAAC;gBACF,OAAO,CAAC,KAAK,CACX,8BAA8B,QAAQ,MAAM,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CACrF,CAAC;gBACF,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,GAAQ,EAAE,GAAQ;QACxC,IAAI,WAA+B,CAAC;QACpC,IAAI,MAAW,CAAC;QAEhB,6CAA6C;QAC7C,MAAM,iBAAiB,GACpB,GAAG,CAAC,OAAO,CAAC,mBAAmB,CAAwB;YACvD,GAAG,CAAC,OAAO,CAAC,mBAAmB,CAAwB,CAAC;QAE3D,IAAI,iBAAiB,EAAE,CAAC;YACtB,WAAW,GAAG,iBAAiB,CAAC;YAChC,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC;QAC3E,CAAC;QACD,qEAAqE;QACrE,gEAAgE;aAC3D,IAAI,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,iEAAiE;YACjE,WAAW,GAAG,SAAS,CAAC;YACxB,MAAM,GAAG,SAAS,CAAC;QACrB,CAAC;QACD,sCAAsC;aACjC,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACjC,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC;YACtC,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC;QAC3E,CAAC;QACD,sDAAsD;aACjD,CAAC;YACJ,GAAG;iBACA,MAAM,CAAC,GAAG,CAAC;iBACX,IAAI,CACH,8IAA8I,CAC/I,CAAC;YACJ,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,WAAW,IAAI,MAAM,EAAE,CAAC,CAAC;QAEnE,MAAM,aAAc,SAAQ,gCAAa;YAEpB;YACR;YACA;YAHX,YACmB,QAA2B,EACnC,UAAkB,EAClB,GAAW;gBAEpB,KAAK,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;gBAJrD,aAAQ,GAAR,QAAQ,CAAmB;gBACnC,eAAU,GAAV,UAAU,CAAQ;gBAClB,QAAG,GAAH,GAAG,CAAQ;YAGtB,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,IAAwB,EAAE,CAAM,EAAE,IAAU;gBACrD,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;oBACd,MAAM,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;gBAC3C,CAAC;qBAAM,IAAI,IAAI,EAAE,CAAC;oBAChB,IAAI,CAAC,+BAA+B,CAAC,IAAI,CAAC,CAAC;gBAC7C,CAAC;gBACD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvC,CAAC;SACF;QAED,MAAM,MAAM,GAAG,IAAI,aAAa,CAC9B,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,OAAO,CACb,CAAC;QACF,MAAM,MAAM,CAAC,IAAI,CACf,WAAW,EACX,MAAM,EACN,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CACpE,CAAC;QAEF,MAAM,SAAS,GAAG,IAAI,2BAAkB,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC7D,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;QAEtC,OAAO,CAAC,KAAK,CACX,6BAA6B,SAAS,oBAAoB,WAAW,EAAE,CACxE,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,KAAK,CACX,6CAA6C,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAClE,CAAC;QAEF,+DAA+D;QAC/D,uEAAuE;QACvE,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,SAAS,EAAE,CAAC,CAAC;QAC1E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,0CAA0C,SAAS,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACjH,CAAC;YACF,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAChC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBACrB,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;YAClD,CAAC;YACD,OAAO;QACT,CAAC;QAED,uDAAuD;QACvD,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACnB,OAAO,CAAC,KAAK,CAAC,6CAA6C,SAAS,EAAE,CAAC,CAAC;YACxE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAChC,KAAK,SAAS,CAAC,KAAK,EAAE,CAAC;YACvB,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,GAAQ,EAAE,GAAQ,EAAE,GAAS;QACpD,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC;YACnD,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC;YAC3B,EAAE,CAAW,CAAC;QAEhB,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,EAAE,MAA4B,CAAC;QACzD,MAAM,MAAM,GAAG,SAAS,KAAK,MAAM,CAAC;QAEpC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CACX,wBAAwB,SAAS,oBAAoB,IAAI,CAAC,QAAQ,CAAC,IAAI,WAAW,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACjI,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CACX,8BAA8B,SAAS,uBAAuB,CAC/D,CAAC;YACF,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QAED,sFAAsF;QACtF,gEAAgE;QAChE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CACX,kEAAkE,SAAS,EAAE,CAC9E,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,SAAS,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YAC5D,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,CAAC,KAAK,CACX,iDAAiD,SAAS,EAAE,CAC7D,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CACX,iCAAiC,SAAS,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACxG,CAAC;YACF,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;YAChD,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBACrB,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,uBAAuB,CAAC,OAAY;QAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAC5E,MAAM,YAAY,GAChB,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;YAClD,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAE3D,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,UAAU,IAAI,YAAY,CAAC,CAAC,CAAC;IACpD,CAAC;CACF;AAhSD,8BAgSC"}

package/dist/src/server/StdioServer.d.ts

@@ -0,0 +1,20 @@
+import type { AuthBroker } from '@mcp-abap-adt/auth-broker';
+import type { Logger } from '@mcp-abap-adt/logger';
+import type { IHandlersRegistry } from '../lib/handlers/interfaces.js';
+import { BaseMcpServer } from './BaseMcpServer.js';
+export interface StdioServerOptions {
+    name?: string;
+    version?: string;
+    logger?: Logger;
+}
+/**
+ * Minimal stdio server implementation based on BaseMcpServer.
+ * Sets connection context once at startup and connects stdio transport.
+ */
+export declare class StdioServer extends BaseMcpServer {
+    private readonly handlersRegistry;
+    private readonly broker;
+    constructor(handlersRegistry: IHandlersRegistry, broker: AuthBroker, opts?: StdioServerOptions);
+    start(destination: string): Promise<void>;
+}
+//# sourceMappingURL=StdioServer.d.ts.map

package/dist/src/server/StdioServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StdioServer.d.ts","sourceRoot":"","sources":["../../../src/server/StdioServer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAInD,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,aAAa;IAE1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,gBAAgB,EAAE,iBAAiB,EACnC,MAAM,EAAE,UAAU,EACnC,IAAI,CAAC,EAAE,kBAAkB;IASrB,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAOhD"}

package/dist/src/server/StdioServer.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StdioServer = void 0;
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const handlerLogger_js_1 = require("../lib/handlerLogger.js");
+const BaseMcpServer_js_1 = require("./BaseMcpServer.js");
+const DEFAULT_VERSION = process.env.npm_package_version ?? '1.0.0';
+/**
+ * Minimal stdio server implementation based on BaseMcpServer.
+ * Sets connection context once at startup and connects stdio transport.
+ */
+class StdioServer extends BaseMcpServer_js_1.BaseMcpServer {
+    handlersRegistry;
+    broker;
+    constructor(handlersRegistry, broker, opts) {
+        super({
+            name: opts?.name ?? 'mcp-abap-adt',
+            version: opts?.version ?? DEFAULT_VERSION,
+            logger: opts?.logger ?? handlerLogger_js_1.noopLogger,
+        });
+        this.handlersRegistry = handlersRegistry;
+        this.broker = broker;
+    }
+    async start(destination) {
+        await this.setConnectionContext(destination, this.broker);
+        this.registerHandlers(this.handlersRegistry);
+        const transport = new stdio_js_1.StdioServerTransport();
+        await this.connect(transport);
+    }
+}
+exports.StdioServer = StdioServer;
+//# sourceMappingURL=StdioServer.js.map

package/dist/src/server/StdioServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StdioServer.js","sourceRoot":"","sources":["../../../src/server/StdioServer.ts"],"names":[],"mappings":";;;AAEA,wEAAiF;AACjF,8DAAqD;AAErD,yDAAmD;AAEnD,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC;AAQnE;;;GAGG;AACH,MAAa,WAAY,SAAQ,gCAAa;IAEzB;IACA;IAFnB,YACmB,gBAAmC,EACnC,MAAkB,EACnC,IAAyB;QAEzB,KAAK,CAAC;YACJ,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,cAAc;YAClC,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,eAAe;YACzC,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,6BAAU;SACnC,CAAC,CAAC;QARc,qBAAgB,GAAhB,gBAAgB,CAAmB;QACnC,WAAM,GAAN,MAAM,CAAY;IAQrC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,WAAmB;QAC7B,MAAM,IAAI,CAAC,oBAAoB,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAE7C,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;QAC7C,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;CACF;AApBD,kCAoBC"}

package/dist/src/server/StreamableHttpServer.d.ts

@@ -0,0 +1,103 @@
+import type { Logger } from '@mcp-abap-adt/logger';
+import type { AuthBrokerFactory } from '../lib/auth/index.js';
+import type { TlsConfig } from '../lib/config/IServerConfig.js';
+import type { IHandlersRegistry } from '../lib/handlers/interfaces.js';
+import { BaseMcpServer } from './BaseMcpServer.js';
+import type { IHttpApplication, RouteRegistrationOptions } from './IHttpApplication.js';
+export interface StreamableHttpServerOptions {
+    /**
+     * Host to bind to (only used when no external app is provided)
+     * @default "127.0.0.1"
+     */
+    host?: string;
+    /**
+     * Port to listen on (only used when no external app is provided)
+     * @default 3000
+     */
+    port?: number;
+    /**
+     * Whether to return JSON responses (vs SSE streams)
+     * @default true
+     */
+    enableJsonResponse?: boolean;
+    /**
+     * Default SAP destination to use if not specified in headers
+     */
+    defaultDestination?: string;
+    /**
+     * Path for the MCP endpoint
+     * @default "/mcp/stream/http"
+     */
+    path?: string;
+    /**
+     * Logger instance
+     */
+    logger?: Logger;
+    /**
+     * Server version
+     */
+    version?: string;
+    /**
+     * External HTTP application to register routes on
+     * When provided, start() will only register routes without creating a server
+     * This enables integration with existing Express/CDS/CAP servers
+     */
+    app?: IHttpApplication;
+    /**
+     * TLS configuration for HTTPS support
+     */
+    tls?: TlsConfig;
+}
+/**
+ * Minimal Streamable HTTP server implementation.
+ * Creates new transport for each HTTP POST and forwards request to the MCP server.
+ * Destination is taken from x-mcp-destination header or defaultDestination.
+ *
+ * Supports two modes:
+ * 1. Standalone mode: Creates its own Express server (when no app option provided)
+ * 2. Embedded mode: Registers routes on external app (when app option provided)
+ */
+export declare class StreamableHttpServer extends BaseMcpServer {
+    private readonly handlersRegistry;
+    private readonly authBrokerFactory;
+    private readonly host;
+    private readonly port;
+    private readonly enableJsonResponse;
+    private readonly defaultDestination?;
+    private readonly path;
+    private readonly externalApp?;
+    private readonly version;
+    private standaloneServer?;
+    private readonly tls?;
+    constructor(handlersRegistry: IHandlersRegistry, authBrokerFactory: AuthBrokerFactory, opts?: StreamableHttpServerOptions);
+    /**
+     * Creates the request handler function
+     * Can be used to register on external app or internal Express
+     */
+    private createRequestHandler;
+    /**
+     * Register routes on an external HTTP application
+     * Use this when integrating with existing Express/CDS/CAP server
+     *
+     * @param app - External HTTP application (Express, CDS, etc.)
+     * @param options - Route registration options
+     */
+    registerRoutes(app: IHttpApplication, _options?: RouteRegistrationOptions): void;
+    /**
+     * Get the configured endpoint path
+     */
+    getPath(): string;
+    /**
+     * Start the server
+     *
+     * In standalone mode (no external app): Creates Express server and starts listening
+     * In embedded mode (external app provided): Only registers routes on external app
+     */
+    start(): Promise<void>;
+    /**
+     * Check if request has SAP connection headers
+     */
+    private hasSapConnectionHeaders;
+    private createPerRequestServer;
+}
+//# sourceMappingURL=StreamableHttpServer.d.ts.map

package/dist/src/server/StreamableHttpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamableHttpServer.d.ts","sourceRoot":"","sources":["../../../src/server/StreamableHttpServer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAEhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAK/B,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,GAAG,CAAC,EAAE,gBAAgB,CAAC;IACvB;;OAEG;IACH,GAAG,CAAC,EAAE,SAAS,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;IAYnD,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAZpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAU;IAC7C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAmB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,gBAAgB,CAAC,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAY;gBAGd,gBAAgB,EAAE,iBAAiB,EACnC,iBAAiB,EAAE,iBAAiB,EACrD,IAAI,CAAC,EAAE,2BAA2B;IAmBpC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAiH5B;;;;;;OAMG;IACH,cAAc,CACZ,GAAG,EAAE,gBAAgB,EACrB,QAAQ,CAAC,EAAE,wBAAwB,GAClC,IAAI;IAkCP;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,sBAAsB;CA0C/B"}