@mcp-abap-adt/core 2.1.3 → 2.1.6

package/dist/server/v2/BaseMcpServer.js

@@ -0,0 +1,273 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseMcpServer = void 0;
+const connection_1 = require("@mcp-abap-adt/connection");
+const logger_1 = require("@mcp-abap-adt/logger");
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const CompositeHandlersRegistry_js_1 = require("../../lib/handlers/registry/CompositeHandlersRegistry.js");
+const schemaUtils_js_1 = require("../../lib/handlers/utils/schemaUtils.js");
+const utils_js_1 = require("../../lib/utils.js");
+/**
+ * Base MCP Server class that extends SDK McpServer
+ * Manages connection context and provides connection injection for handlers
+ */
+class BaseMcpServer extends mcp_js_1.McpServer {
+    /**
+     * Logger used for handler context
+     */
+    logger;
+    /**
+     * Connection context (set per request for SSE/HTTP, once for stdio)
+     */
+    connectionContext = null;
+    /**
+     * Auth broker for token and service key management
+     */
+    authBroker;
+    /**
+     * Cached connection for stdio mode (created once, reused for all requests)
+     */
+    cachedConnection = null;
+    constructor(options) {
+        super({ name: options.name, version: options.version ?? '1.0.0' });
+        this.logger = options.logger ?? logger_1.defaultLogger;
+    }
+    /**
+     * Sets connection context using auth broker
+     * For stdio: called once on startup
+     * For SSE/HTTP: called per-request
+     */
+    async setConnectionContext(destination, authBroker) {
+        this.authBroker = authBroker;
+        // Register broker so destination-aware connections can refresh tokens
+        (0, utils_js_1.registerAuthBroker)(destination, authBroker);
+        this.logger.debug(`[BaseMcpServer] Getting connection config for destination: ${destination}`);
+        // Get connection parameters from broker
+        // AuthBroker.getConnectionConfig() automatically checks session store first, then service key store
+        const connectionConfig = await authBroker.getConnectionConfig(destination);
+        this.logger.debug(`[BaseMcpServer] Connection config result:`, {
+            found: !!connectionConfig,
+            destination,
+            hasServiceUrl: !!connectionConfig?.serviceUrl,
+        });
+        if (!connectionConfig) {
+            throw new Error(`Connection config not found for destination: ${destination}`);
+        }
+        // Try to get fresh token from broker
+        // If broker can't refresh (no UAA credentials), use existing token from connectionConfig
+        let freshToken;
+        try {
+            freshToken = await authBroker.getToken(destination);
+        }
+        catch (error) {
+            // Broker can't provide/refresh token (e.g., no UAA credentials for .env-only setup)
+            // Use existing token from connectionConfig - user is responsible for token management
+            this.logger.debug(`Broker can't refresh token, using existing token from session: ${error instanceof Error ? error.message : String(error)}`);
+            freshToken = connectionConfig.authorizationToken;
+        }
+        const tokenToUse = freshToken || connectionConfig.authorizationToken || '';
+        // Determine auth type from connection config
+        const authType = connectionConfig.authType ||
+            (connectionConfig.username && connectionConfig.password
+                ? 'basic'
+                : 'jwt');
+        this.connectionContext = {
+            sessionId: destination,
+            connectionParams: authType === 'basic'
+                ? {
+                    url: connectionConfig.serviceUrl || '',
+                    authType: 'basic',
+                    username: connectionConfig.username || '',
+                    password: connectionConfig.password || '',
+                    client: connectionConfig.sapClient || '',
+                }
+                : {
+                    url: connectionConfig.serviceUrl || '',
+                    authType: 'jwt',
+                    jwtToken: tokenToUse, // broker keeps it fresh
+                    client: connectionConfig.sapClient || '',
+                },
+            metadata: {
+                destination,
+            },
+        };
+    }
+    /**
+     * Sets connection context from HTTP headers (direct SAP connection, no broker)
+     * Used when x-sap-url + auth headers are provided
+     */
+    setConnectionContextFromHeaders(headers) {
+        const url = headers['x-sap-url'] || headers['X-SAP-URL'];
+        const jwtToken = headers['x-sap-jwt-token'] || headers['X-SAP-JWT-Token'];
+        const username = headers['x-sap-login'] || headers['X-SAP-Login'];
+        const password = headers['x-sap-password'] || headers['X-SAP-Password'];
+        const client = headers['x-sap-client'] || headers['X-SAP-Client'] || '';
+        if (!url) {
+            throw new Error('x-sap-url header is required for direct SAP connection');
+        }
+        if (jwtToken) {
+            // JWT auth
+            this.connectionContext = {
+                sessionId: 'direct-jwt',
+                connectionParams: {
+                    url,
+                    authType: 'jwt',
+                    jwtToken,
+                    client,
+                },
+                metadata: {},
+            };
+        }
+        else if (username && password) {
+            // Basic auth
+            this.connectionContext = {
+                sessionId: 'direct-basic',
+                connectionParams: {
+                    url,
+                    authType: 'basic',
+                    username,
+                    password,
+                    client,
+                },
+                metadata: {},
+            };
+        }
+        else {
+            throw new Error('Either x-sap-jwt-token or x-sap-login+x-sap-password headers are required');
+        }
+    }
+    /**
+     * Gets current connection context
+     */
+    getConnectionContext() {
+        return this.connectionContext;
+    }
+    /**
+     * Gets ABAP connection from connection context
+     * Creates connection using connectionParams from context
+     * Automatically refreshes token via AuthBroker if available (inside makeAdtRequest)
+     * For stdio mode: caches connection and reuses it for all requests (like v1)
+     * For SSE/HTTP: creates new connection per request
+     */
+    async getConnection() {
+        if (!this.connectionContext?.connectionParams) {
+            throw new Error('Connection context not set. Call setConnectionContext() first.');
+        }
+        const destination = this.connectionContext.metadata?.destination;
+        const sessionId = this.connectionContext.sessionId;
+        // For stdio mode: cache connection and reuse it (like v1)
+        // This prevents creating new connection on each request, which would trigger browser auth
+        // Check if we have cached connection with same sessionId (stdio uses destination as sessionId)
+        if (destination && this.cachedConnection && sessionId === destination) {
+            // Reuse cached connection for stdio mode
+            return this.cachedConnection;
+        }
+        const connection = (0, connection_1.createAbapConnection)(this.connectionContext.connectionParams);
+        // Cache connection for stdio mode (when sessionId === destination, it's stdio)
+        // SSE/HTTP modes use different sessionId per request, so caching won't interfere
+        if (destination && sessionId === destination) {
+            this.cachedConnection = connection;
+        }
+        return connection;
+    }
+    /**
+     * Registers handlers from registry
+     * Wraps handlers to inject connection as first parameter
+     *
+     * Handler signature: (connection: AbapConnection, args: any) => Promise<any>
+     * Registered as: (args: any) => handler(getConnection(), args)
+     *
+     * This ensures connection is injected but NOT exposed in MCP tool signature
+     */
+    registerHandlers(handlersRegistry) {
+        // Get handler groups from registry
+        if (handlersRegistry instanceof CompositeHandlersRegistry_js_1.CompositeHandlersRegistry) {
+            const groups = handlersRegistry.getHandlerGroups();
+            for (const group of groups) {
+                const handlers = group.getHandlers();
+                for (const entry of handlers) {
+                    // Wrap handler to inject connection from context
+                    // Original handler: (context: HandlerContext, args: any) => Promise<any>
+                    const wrappedHandler = async (args) => {
+                        // Get connection from context (this.connectionContext)
+                        // Token will be automatically refreshed via AuthBroker if needed
+                        const context = {
+                            connection: await this.getConnection(),
+                            logger: this.logger,
+                        };
+                        // If handler expects context+args (preferred), pass both.
+                        // Otherwise, update group context and call with args only for backward compatibility.
+                        // NOTE: Always await the handler result to ensure we get the resolved value for normalization
+                        let handlerPromise;
+                        if (entry.handler.length >= 2) {
+                            handlerPromise = entry.handler(context, args);
+                        }
+                        else {
+                            try {
+                                if (typeof group.setContext === 'function') {
+                                    group.setContext(context);
+                                }
+                                else {
+                                    group.context = context;
+                                }
+                            }
+                            catch {
+                                // ignore if group doesn't expose context setter
+                            }
+                            handlerPromise = entry.handler(args);
+                        }
+                        const result = await handlerPromise;
+                        // Handle errors: if handler returns isError, throw McpError
+                        if (result?.isError) {
+                            const { ErrorCode, McpError } = await import('@modelcontextprotocol/sdk/types.js');
+                            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 McpError(ErrorCode.InternalError, errorText);
+                        }
+                        // Normalize content: SDK expects text/image/audio/resource, convert custom json to text
+                        const content = (result?.content || []).map((item) => {
+                            if (item?.type === 'json' && item.json !== undefined) {
+                                return {
+                                    type: 'text',
+                                    text: JSON.stringify(item.json),
+                                };
+                            }
+                            // Ensure all items have proper text type structure
+                            return {
+                                type: 'text',
+                                text: item?.text || String(item || ''),
+                            };
+                        });
+                        return { content };
+                    };
+                    // Convert JSON Schema to Zod if needed, otherwise pass as-is
+                    const zodSchema = entry.toolDefinition.inputSchema &&
+                        typeof entry.toolDefinition.inputSchema === 'object' &&
+                        entry.toolDefinition.inputSchema.type === 'object' &&
+                        entry.toolDefinition.inputSchema.properties
+                        ? (0, schemaUtils_js_1.jsonSchemaToZod)(entry.toolDefinition.inputSchema)
+                        : entry.toolDefinition.inputSchema;
+                    // Register wrapped handler via SDK registerTool
+                    // Note: connection is NOT part of MCP tool signature
+                    this.registerTool(entry.toolDefinition.name, {
+                        description: entry.toolDefinition.description,
+                        inputSchema: zodSchema,
+                    }, wrappedHandler);
+                }
+            }
+        }
+        else {
+            // Fallback: use registerAllTools directly (handlers won't have connection injected)
+            // This should not happen in normal flow
+            handlersRegistry.registerAllTools(this);
+        }
+    }
+}
+exports.BaseMcpServer = BaseMcpServer;
+//# sourceMappingURL=BaseMcpServer.js.map

package/dist/server/v2/BaseMcpServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseMcpServer.js","sourceRoot":"","sources":["../../../src/server/v2/BaseMcpServer.ts"],"names":[],"mappings":"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"}

package/dist/server/v2/ConnectionContext.d.ts

@@ -0,0 +1,20 @@
+import type { SapConfig } from '@mcp-abap-adt/connection';
+/**
+ * Connection context for MCP server
+ * Contains connection parameters and session information
+ */
+export interface ConnectionContext {
+    /**
+     * Connection parameters (SAP URL, auth, client)
+     */
+    connectionParams: SapConfig;
+    /**
+     * Session ID for this connection context
+     */
+    sessionId: string;
+    /**
+     * Optional metadata for additional context information
+     */
+    metadata?: Record<string, any>;
+}
+//# sourceMappingURL=ConnectionContext.d.ts.map

package/dist/server/v2/ConnectionContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionContext.d.ts","sourceRoot":"","sources":["../../../src/server/v2/ConnectionContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,gBAAgB,EAAE,SAAS,CAAC;IAE5B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC"}

package/dist/server/v2/ConnectionContext.js

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

package/dist/server/v2/ConnectionContext.js.map

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

package/dist/server/v2/IHttpApplication.d.ts

@@ -0,0 +1,42 @@
+import type { NextFunction, Request, Response } from 'express';
+/**
+ * Handler function type for HTTP routes
+ */
+export type RouteHandler = (req: Request, res: Response, next?: NextFunction) => void | Promise<void>;
+/**
+ * Interface for Express-like HTTP application
+ * Allows injection of external HTTP server into v2 MCP servers
+ *
+ * This enables integration with existing Express/CDS/CAP servers
+ * without creating a separate HTTP server instance
+ */
+export interface IHttpApplication {
+    /**
+     * Register GET route handler
+     */
+    get(path: string, handler: RouteHandler): void;
+    /**
+     * Register POST route handler
+     */
+    post(path: string, handler: RouteHandler): void;
+    /**
+     * Register handler for all HTTP methods
+     */
+    all(path: string, handler: RouteHandler): void;
+    /**
+     * Register middleware (optional - not all apps support this)
+     */
+    use?(path: string | RouteHandler, handler?: RouteHandler): void;
+}
+/**
+ * Options for route registration on external app
+ */
+export interface RouteRegistrationOptions {
+    /**
+     * Whether to add express.json() middleware for the routes
+     * Set to false if the external app already has JSON parsing middleware
+     * @default true for standalone, false for external app
+     */
+    addJsonMiddleware?: boolean;
+}
+//# sourceMappingURL=IHttpApplication.d.ts.map

package/dist/server/v2/IHttpApplication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IHttpApplication.d.ts","sourceRoot":"","sources":["../../../src/server/v2/IHttpApplication.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,CAAC,EAAE,YAAY,KAChB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAE/C;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAEhD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAE/C;;OAEG;IACH,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B"}

package/dist/server/v2/IHttpApplication.js

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

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

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

package/dist/server/v2/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/server/v2/IServerConfig.d.ts.map

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

package/dist/server/v2/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/server/v2/IServerConfig.js.map

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

package/dist/server/v2/ServerConfig.d.ts

@@ -0,0 +1,16 @@
+/**
+ * V2 Server configuration
+ */
+import { ServerConfig as BaseServerConfig } from "../../lib/config/ServerConfig.js";
+export type Transport = 'stdio' | 'sse' | 'http';
+export type HandlerSet = 'readonly' | 'high' | 'low';
+export interface ServerConfig extends BaseServerConfig {
+    transport: Transport;
+    host?: string;
+    port?: number;
+    httpJsonResponse?: boolean;
+    envFile?: string;
+    exposition: HandlerSet[];
+    configFile?: string;
+}
+//# sourceMappingURL=ServerConfig.d.ts.map

package/dist/server/v2/ServerConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerConfig.d.ts","sourceRoot":"","sources":["../../../src/server/v2/ServerConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpF,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AACjD,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC;AAErD,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IAEpD,SAAS,EAAE,SAAS,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAG3B,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,UAAU,EAAE,UAAU,EAAE,CAAC;IAGzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/server/v2/ServerConfig.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * V2 Server configuration
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ServerConfig.js.map

package/dist/server/v2/ServerConfig.js.map

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

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

@@ -0,0 +1,95 @@
+import type { Logger } from '@mcp-abap-adt/logger';
+import type { AuthBrokerFactory } from '../../lib/auth/index.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;
+}
+/**
+ * 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?;
+    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/server/v2/SseServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SseServer.d.ts","sourceRoot":"","sources":["../../../src/server/v2/SseServer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAI/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;CACxB;AAOD;;;;;;GAMG;AACH,qBAAa,SAAS;IAYlB,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,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;gBAG7B,gBAAgB,EAAE,iBAAiB,EACnC,iBAAiB,EAAE,iBAAiB,EACrD,IAAI,CAAC,EAAE,gBAAgB;IAYzB;;;;;;OAMG;IACH,cAAc,CACZ,GAAG,EAAE,gBAAgB,EACrB,QAAQ,CAAC,EAAE,wBAAwB,GAClC,IAAI;IAoBP;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YA+Bd,SAAS;YAgGT,UAAU;IAwCxB;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAShC"}