@mcp-abap-adt/core 2.1.3 → 2.1.4

package/dist/lib/servers/v2/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * MCP Server v2 module exports
+ *
+ * Simplified architecture - only types and utilities
+ * Transports are used directly from @modelcontextprotocol/sdk
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+// Types
+__exportStar(require("./types/index.js"), exports);
+// Utilities
+__exportStar(require("./utils/StdioLogger.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/lib/servers/v2/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/servers/v2/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,QAAQ;AACR,mDAAiC;AAEjC,YAAY;AACZ,yDAAuC"}

package/dist/lib/servers/v2/interfaces/connection.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Connection provider interfaces
+ *
+ * Connection provider determines whether to use service keys + AuthBroker or only headers from client
+ */
+/**
+ * Service key structure
+ */
+export interface IServiceKey {
+    destination: string;
+    url: string;
+    uaaUrl?: string;
+    clientId?: string;
+    clientSecret?: string;
+    [key: string]: any;
+}
+/**
+ * Token data structure
+ */
+export interface ITokenData {
+    accessToken: string;
+    refreshToken?: string;
+    expiresAt?: Date;
+}
+/**
+ * Connection request
+ */
+export interface IConnectionRequest {
+    /** Session identifier */
+    sessionId: string;
+    /** Destination name (only for LOCAL mode) */
+    destination?: string;
+    /** HTTP headers (only for REMOTE mode) */
+    headers?: Record<string, string>;
+}
+/**
+ * Connection parameters to SAP system
+ */
+export interface IConnectionParams {
+    /** SAP system URL */
+    sapUrl: string;
+    /** Authentication information */
+    auth: {
+        type: 'jwt' | 'basic';
+        jwtToken?: string;
+        refreshToken?: string;
+        username?: string;
+        password?: string;
+    };
+    /** Client number (optional) */
+    client?: string;
+}
+/**
+ * Connection provider interface
+ *
+ * Determines whether to use service keys + AuthBroker (LOCAL mode)
+ * or only headers from client (REMOTE mode)
+ */
+export interface IConnectionProvider {
+    /** Provider mode */
+    readonly mode: 'LOCAL' | 'REMOTE';
+    /**
+     * Gets connection parameters for session
+     * @param request - Request with session information and destination/headers
+     * @returns Connection parameters to SAP system
+     */
+    getConnectionParams(request: IConnectionRequest): Promise<IConnectionParams>;
+    /**
+     * Updates connection parameters (e.g., after token refresh)
+     * @param sessionId - Session identifier
+     * @param params - Partial connection parameters to update
+     */
+    updateConnectionParams(sessionId: string, params: Partial<IConnectionParams>): Promise<void>;
+}
+/**
+ * Service key store interface
+ *
+ * Abstraction for reading service keys from various sources
+ */
+export interface IServiceKeyStore {
+    /**
+     * Gets service key for destination
+     * @param destination - Destination name
+     * @returns Service key
+     */
+    getServiceKey(destination: string): Promise<IServiceKey>;
+    /**
+     * Checks if service key exists for destination
+     * @param destination - Destination name
+     * @returns True if service key exists
+     */
+    hasServiceKey(destination: string): Promise<boolean>;
+    /**
+     * Lists available destinations
+     * @returns Array of destination names
+     */
+    listDestinations(): Promise<string[]>;
+}
+/**
+ * Session store interface
+ *
+ * Abstraction for storing tokens and sessions
+ */
+export interface ISessionStore {
+    /**
+     * Saves tokens for destination
+     * @param destination - Destination name
+     * @param tokens - Token data
+     */
+    saveTokens(destination: string, tokens: ITokenData): Promise<void>;
+    /**
+     * Gets tokens for destination
+     * @param destination - Destination name
+     * @returns Token data or null if not found
+     */
+    getTokens(destination: string): Promise<ITokenData | null>;
+    /**
+     * Deletes tokens for destination
+     * @param destination - Destination name
+     */
+    deleteTokens(destination: string): Promise<void>;
+}
+/**
+ * Token provider interface
+ *
+ * Abstraction for obtaining tokens from BTP or other sources
+ */
+export interface ITokenProvider {
+    /**
+     * Gets token from service key
+     * @param serviceKey - Service key
+     * @returns Token data
+     */
+    getToken(serviceKey: IServiceKey): Promise<ITokenData>;
+    /**
+     * Refreshes token using refresh token
+     * @param serviceKey - Service key
+     * @param refreshToken - Refresh token
+     * @returns New token data
+     */
+    refreshToken(serviceKey: IServiceKey, refreshToken: string): Promise<ITokenData>;
+}
+/**
+ * Auth broker factory interface
+ *
+ * Creates and manages AuthBroker instances with injected dependencies
+ */
+export interface IAuthBrokerFactory {
+    /**
+     * Creates or returns existing AuthBroker for session
+     * ServiceKeyStore, SessionStore, and TokenProvider are injected into AuthBroker
+     * @param sessionId - Session identifier
+     * @param destination - Destination name
+     * @returns AuthBroker instance
+     */
+    getOrCreateBroker(sessionId: string, destination: string): Promise<any>;
+    /**
+     * Gets existing AuthBroker
+     * @param sessionId - Session identifier
+     * @param destination - Destination name (optional, but recommended)
+     * @returns AuthBroker instance or undefined
+     */
+    getBroker(sessionId: string, destination?: string): any | undefined;
+    /**
+     * Deletes AuthBroker for session
+     * @param sessionId - Session identifier
+     * @param destination - Destination name (optional, if not provided deletes all brokers for session)
+     */
+    deleteBroker(sessionId: string, destination?: string): void;
+    /**
+     * Clears all brokers (on shutdown)
+     */
+    clearAll(): void;
+}
+/**
+ * Header validator interface
+ *
+ * Validates and extracts connection parameters from HTTP headers
+ */
+export interface IHeaderValidator {
+    /**
+     * Validates and extracts connection parameters from headers
+     * @param headers - HTTP headers
+     * @returns Validated connection parameters
+     */
+    validateAndExtract(headers: Record<string, string>): Promise<IConnectionParams>;
+}
+//# sourceMappingURL=connection.d.ts.map

package/dist/lib/servers/v2/interfaces/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../../../src/lib/servers/v2/interfaces/connection.ts"],"names":[],"mappings":"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"}

package/dist/lib/servers/v2/interfaces/connection.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Connection provider interfaces
+ *
+ * Connection provider determines whether to use service keys + AuthBroker or only headers from client
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/lib/servers/v2/interfaces/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Interfaces module exports
+ *
+ * All interfaces for Dependency Injection in v2 architecture
+ */
+export * from './transport.js';
+export * from './connection.js';
+export * from './session.js';
+export * from './protocol.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/servers/v2/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/servers/v2/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/lib/servers/v2/interfaces/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Interfaces module exports
+ *
+ * All interfaces for Dependency Injection in v2 architecture
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+__exportStar(require("./transport.js"), exports);
+__exportStar(require("./connection.js"), exports);
+__exportStar(require("./session.js"), exports);
+__exportStar(require("./protocol.js"), exports);

package/dist/lib/servers/v2/interfaces/protocol.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Protocol handler interface
+ *
+ * Protocol handler processes MCP requests and routes them to appropriate handlers
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { IHandlersRegistry } from '../../handlers/interfaces.js';
+import { ISessionManager } from './session.js';
+/**
+ * Protocol handler interface
+ *
+ * Processes MCP requests and routes them to appropriate handlers
+ */
+export interface IProtocolHandler {
+    /**
+     * Initializes protocol handler with handlers registry and MCP server
+     * @param handlersRegistry - Handlers registry
+     * @param mcpServer - MCP server SDK instance
+     * @param sessionManager - Session manager (optional, for setting session context)
+     */
+    initialize(handlersRegistry: IHandlersRegistry, mcpServer: McpServer, sessionManager?: ISessionManager): void;
+    /**
+     * Handles incoming MCP request
+     * @param sessionId - Session identifier
+     * @param request - MCP request message
+     * @returns MCP response message
+     */
+    handleRequest(sessionId: string, request: any): Promise<any>;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/lib/servers/v2/interfaces/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../../../src/lib/servers/v2/interfaces/protocol.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,UAAU,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAE9G;;;;;OAKG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CAC9D"}

package/dist/lib/servers/v2/interfaces/protocol.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Protocol handler interface
+ *
+ * Protocol handler processes MCP requests and routes them to appropriate handlers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/lib/servers/v2/interfaces/session.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Session management interfaces
+ *
+ * Session manager manages sessions that contain connection parameters to ABAP environment
+ */
+import { IClientInfo } from './transport.js';
+import { IConnectionParams } from './connection.js';
+/**
+ * Unified session interface
+ *
+ * Single session type with two session IDs:
+ * - clientSessionId: Identifies the client connection (UUID, managed by server)
+ * - abapSessionId: Identifies the SAP ABAP connection (SAP_SESSIONID cookie, optional)
+ */
+export interface ISession {
+    /**
+     * Client session ID - identifies the client connection
+     * UUID, managed by server
+     */
+    readonly clientSessionId: string;
+    /** Session creation timestamp */
+    readonly createdAt: Date;
+    /** Last activity timestamp */
+    lastActivity: Date;
+    /**
+     * Connection parameters to ABAP environment
+     * This is the main session information - how to connect to SAP system
+     * Required field
+     */
+    connectionParams: IConnectionParams;
+    /**
+     * SAP ABAP session (optional) - only present when SAP cookies are available
+     * Used for stateful operations (lock, unlock, etc.)
+     */
+    abapSession?: {
+        /** SAP_SESSIONID cookie value */
+        abapSessionId: string;
+        /** All SAP cookies for stateful operations */
+        cookies: string[];
+        /** X-CSRF-Token (optional) */
+        securityToken?: string;
+    };
+    /** Session metadata */
+    metadata: {
+        /** Transport type */
+        transport: 'stdio' | 'sse' | 'http';
+        /** Client IP address (if available) */
+        clientIP?: string;
+        /** Request count */
+        requestCount: number;
+        /** Error count */
+        errorCount: number;
+    };
+}
+/**
+ * Session manager interface
+ *
+ * Manages sessions that contain connection parameters to ABAP environment
+ */
+export interface ISessionManager {
+    /**
+     * Creates a new session with clientSessionId
+     * @param clientInfo - Information about the client connection
+     * @returns New session with clientSessionId (UUID) and connectionParams
+     */
+    createSession(clientInfo: IClientInfo): ISession;
+    /**
+     * Gets session by clientSessionId
+     * @param clientSessionId - Client session identifier
+     * @returns Session or undefined if not found
+     */
+    getSession(clientSessionId: string): ISession | undefined;
+    /**
+     * Deletes session by clientSessionId
+     * @param clientSessionId - Client session identifier
+     */
+    deleteSession(clientSessionId: string): void;
+    /**
+     * Sets SAP ABAP session cookies when received from SAP
+     * @param clientSessionId - Client session ID
+     * @param sapCookies - Cookies from SAP response (Set-Cookie headers)
+     */
+    setAbapSession(clientSessionId: string, sapCookies: string[]): void;
+    /**
+     * Clears SAP ABAP session (e.g., on expiry or cleanup)
+     * @param clientSessionId - Client session ID
+     */
+    clearAbapSession(clientSessionId: string): void;
+    /**
+     * Register event handler
+     * @param event - Event name
+     * @param handler - Event handler function
+     */
+    on(event: 'created', handler: (session: ISession) => void): void;
+    on(event: 'closed', handler: (session: ISession) => void): void;
+    on(event: 'abapSessionSet', handler: (session: ISession) => void): void;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/lib/servers/v2/interfaces/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../../src/lib/servers/v2/interfaces/session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IAEzB,8BAA8B;IAC9B,YAAY,EAAE,IAAI,CAAC;IAEnB;;;;OAIG;IACH,gBAAgB,EAAE,iBAAiB,CAAC;IAEpC;;;OAGG;IACH,WAAW,CAAC,EAAE;QACZ,iCAAiC;QACjC,aAAa,EAAE,MAAM,CAAC;QACtB,8CAA8C;QAC9C,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,8BAA8B;QAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IAEF,uBAAuB;IACvB,QAAQ,EAAE;QACR,qBAAqB;QACrB,SAAS,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;QACpC,uCAAuC;QACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,oBAAoB;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,kBAAkB;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,aAAa,CAAC,UAAU,EAAE,WAAW,GAAG,QAAQ,CAAC;IAEjD;;;;OAIG;IACH,UAAU,CAAC,eAAe,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAE1D;;;OAGG;IACH,aAAa,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7C;;;;OAIG;IACH,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEpE;;;OAGG;IACH,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhD;;;;OAIG;IACH,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI,CAAC;IACjE,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI,CAAC;IAChE,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI,CAAC;CACzE"}

package/dist/lib/servers/v2/interfaces/session.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Session management interfaces
+ *
+ * Session manager manages sessions that contain connection parameters to ABAP environment
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/lib/servers/v2/interfaces/transport.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Transport layer interfaces
+ *
+ * Transport layer determines whether the server will be local (127.0.0.1) or global (0.0.0.0)
+ */
+/**
+ * Client information extracted from transport connection
+ */
+export interface IClientInfo {
+    /** Transport type */
+    transport: 'stdio' | 'sse' | 'http';
+    /** Client IP address (if available) */
+    ip?: string;
+    /** HTTP headers (if available) */
+    headers?: Record<string, string>;
+    /** User agent (if available) */
+    userAgent?: string;
+}
+/**
+ * MCP message type (from SDK)
+ */
+export type McpMessage = any;
+/**
+ * Session initialization callback
+ * Called by transport when session needs to be initialized
+ * @param sessionId - Session identifier
+ * @param clientInfo - Client information
+ * @param destination - Optional destination name (for LOCAL mode)
+ * @returns Promise that resolves when session is initialized
+ */
+export type SessionInitializationCallback = (sessionId: string, clientInfo: IClientInfo, destination?: string) => Promise<void>;
+/**
+ * Transport interface
+ *
+ * Wraps MCP SDK transports (StdioServerTransport, SSEServerTransport, StreamableHTTPServerTransport)
+ * to provide unified interface for server implementation
+ */
+export interface ITransport {
+    /** Transport type */
+    readonly type: 'stdio' | 'sse' | 'http';
+    /** Bind address - determines mode: '127.0.0.1' = LOCAL, '0.0.0.0' = REMOTE */
+    readonly bindAddress: string;
+    /** Port number (if applicable) */
+    readonly port?: number;
+    /**
+     * Start the transport
+     */
+    start(): Promise<void>;
+    /**
+     * Connect SDK server to this transport
+     * Transport implementation decides how to connect SDK server and when to initialize sessions
+     * @param sdkServer - SDK MCP server instance
+     * @param initializeSession - Callback to initialize session (create session, get connection params, set context)
+     * @param defaultDestination - Optional default destination name (for LOCAL mode)
+     */
+    connectSdkServer(sdkServer: any, // McpServer from SDK
+    initializeSession: SessionInitializationCallback, defaultDestination?: string): Promise<void>;
+    /**
+     * Post start initialization of the transport
+     */
+    postStartInitialization(): Promise<void>;
+    /**
+     * Stop the transport
+     */
+    stop(): Promise<void>;
+    /**
+     * Register event handler
+     * @param event - Event name
+     * @param handler - Event handler function
+     */
+    on(event: 'session:created', handler: (sessionId: string, clientInfo: IClientInfo) => void): void;
+    on(event: 'session:closed', handler: (sessionId: string) => void): void;
+    on(event: 'message', handler: (sessionId: string, message: McpMessage) => void): void;
+    /**
+     * Send message to client
+     * @param sessionId - Session identifier
+     * @param message - MCP message
+     */
+    send(sessionId: string, message: McpMessage): Promise<void>;
+    /**
+     * Handle HTTP request (only for HTTP transports)
+     * @param req - Incoming HTTP request
+     * @param res - Server response
+     * @param parsedBody - Optional pre-parsed request body
+     */
+    handleRequest?(req: any, res: any, parsedBody?: unknown): Promise<void>;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/lib/servers/v2/interfaces/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../../src/lib/servers/v2/interfaces/transport.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,qBAAqB;IACrB,SAAS,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IACpC,uCAAuC;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,GAAG,CAAC;AAE7B;;;;;;;GAOG;AACH,MAAM,MAAM,6BAA6B,GAAG,CAC1C,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,WAAW,EACvB,WAAW,CAAC,EAAE,MAAM,KACjB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,qBAAqB;IACrB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IAExC,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,kCAAkC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;;;;OAMG;IACH,gBAAgB,CACd,SAAS,EAAE,GAAG,EAAE,qBAAqB;IACrC,iBAAiB,EAAE,6BAA6B,EAChD,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;OAEG;IACH,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB;;;;OAIG;IACH,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI,CAAC;IAClG,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IACxE,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAEtF;;;;OAIG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D;;;;;OAKG;IACH,aAAa,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE"}

package/dist/lib/servers/v2/interfaces/transport.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Transport layer interfaces
+ *
+ * Transport layer determines whether the server will be local (127.0.0.1) or global (0.0.0.0)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/lib/servers/v2/protocol/ProtocolHandler.d.ts

@@ -0,0 +1,21 @@
+/**
+ * ProtocolHandler implementation
+ *
+ * Processes MCP requests and routes them to appropriate handlers
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { IProtocolHandler } from '../interfaces/protocol.js';
+import { IHandlersRegistry } from '../../handlers/interfaces.js';
+import { ISessionManager } from '../interfaces/session.js';
+/**
+ * ProtocolHandler - processes MCP requests and routes to handlers
+ */
+export declare class ProtocolHandler implements IProtocolHandler {
+    private handlersRegistry?;
+    private mcpServer?;
+    private sessionManager?;
+    initialize(handlersRegistry: IHandlersRegistry, mcpServer: McpServer, sessionManager?: ISessionManager): void;
+    handleRequest(sessionId: string, request: any): Promise<any>;
+    executeTool(sessionId: string, toolName: string, params: any): Promise<any>;
+}
+//# sourceMappingURL=ProtocolHandler.d.ts.map

package/dist/lib/servers/v2/protocol/ProtocolHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProtocolHandler.d.ts","sourceRoot":"","sources":["../../../../../src/lib/servers/v2/protocol/ProtocolHandler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAI3D;;GAEG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,gBAAgB,CAAC,CAAoB;IAC7C,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,cAAc,CAAC,CAAkB;IAEzC,UAAU,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,CAAC,EAAE,eAAe,GAAG,IAAI;IAWvG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAe5D,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;CA8ClF"}

package/dist/lib/servers/v2/protocol/ProtocolHandler.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * ProtocolHandler implementation
+ *
+ * Processes MCP requests and routes them to appropriate handlers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProtocolHandler = void 0;
+const utils_js_1 = require("../../../utils.js");
+/**
+ * ProtocolHandler - processes MCP requests and routes to handlers
+ */
+class ProtocolHandler {
+    handlersRegistry;
+    mcpServer;
+    sessionManager;
+    initialize(handlersRegistry, mcpServer, sessionManager) {
+        this.handlersRegistry = handlersRegistry;
+        this.mcpServer = mcpServer;
+        this.sessionManager = sessionManager;
+        // Register all tools from handlers registry
+        if (this.handlersRegistry) {
+            this.handlersRegistry.registerAllTools(mcpServer);
+        }
+    }
+    async handleRequest(sessionId, request) {
+        if (!this.mcpServer) {
+            throw new Error('ProtocolHandler not initialized');
+        }
+        // Handle different request types
+        if (request.method === 'tools/call') {
+            return await this.executeTool(sessionId, request.params.name, request.params.arguments);
+        }
+        // For other request types, delegate to SDK server
+        // This is a placeholder - actual implementation will depend on SDK API
+        return request;
+    }
+    async executeTool(sessionId, toolName, params) {
+        if (!this.mcpServer) {
+            throw new Error('ProtocolHandler not initialized');
+        }
+        // Get session to access connection params
+        const session = this.sessionManager?.getSession(sessionId);
+        // Set session context for handlers to access connection params via getManagedConnection()
+        if (session?.connectionParams) {
+            // Convert IConnectionParams to SapConfig for sessionContext
+            const sapConfig = {
+                url: session.connectionParams.sapUrl,
+                authType: session.connectionParams.auth.type,
+                ...(session.connectionParams.auth.type === 'jwt' && session.connectionParams.auth.jwtToken
+                    ? { jwtToken: session.connectionParams.auth.jwtToken }
+                    : session.connectionParams.auth.type === 'basic' && session.connectionParams.auth.username && session.connectionParams.auth.password
+                        ? { username: session.connectionParams.auth.username, password: session.connectionParams.auth.password }
+                        : {}),
+                ...(session.connectionParams.client ? { client: session.connectionParams.client } : {}),
+            };
+            // Extract destination from session metadata or connection params
+            // Destination is used for AuthBroker-based token refresh in LOCAL mode
+            const destination = session.destination || session.connectionParams.destination;
+            // Run handler in session context so getManagedConnection() can access it
+            return await utils_js_1.sessionContext.run({
+                sessionId: session.clientSessionId,
+                sapConfig,
+                destination,
+            }, async () => {
+                // Execute tool through SDK server
+                // SDK server will use registered handlers from handlersRegistry
+                const result = await this.mcpServer.callTool?.(toolName, params);
+                return result;
+            });
+        }
+        // Fallback if no session context (should not happen in v2)
+        const result = await this.mcpServer.callTool?.(toolName, params);
+        return result;
+    }
+}
+exports.ProtocolHandler = ProtocolHandler;

package/dist/lib/servers/v2/protocol/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Protocol handler implementations exports
+ */
+export { ProtocolHandler } from './ProtocolHandler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/servers/v2/protocol/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/servers/v2/protocol/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/lib/servers/v2/protocol/index.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Protocol handler implementations exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProtocolHandler = void 0;
+var ProtocolHandler_js_1 = require("./ProtocolHandler.js");
+Object.defineProperty(exports, "ProtocolHandler", { enumerable: true, get: function () { return ProtocolHandler_js_1.ProtocolHandler; } });