@oobe-protocol-labs/sap-mcp-server 0.1.0

package/dist/core/errors.js

@@ -0,0 +1,337 @@
+/**
+ * Custom error classes for SAP MCP Server
+ *
+ * Provides structured error handling with:
+ * - Error codes for programmatic handling
+ * - Context metadata for debugging
+ * - User-friendly messages
+ * - Stack trace preservation
+ */
+/**
+ * Base error class for all SAP MCP errors
+ */
+export class SapMcpError extends Error {
+    code;
+    context;
+    cause;
+    constructor(message, code, contextOrCause, cause) {
+        super(message);
+        this.name = 'SapMcpError';
+        this.code = code;
+        // Handle both (message, code, context, cause) and (message, code, cause) signatures
+        if (contextOrCause instanceof Error) {
+            this.cause = contextOrCause;
+        }
+        else {
+            this.context = contextOrCause;
+            this.cause = cause;
+        }
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, SapMcpError);
+        }
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            context: this.context,
+            stack: this.stack,
+            cause: this.cause?.message,
+        };
+    }
+}
+/**
+ * Configuration errors
+ */
+export class ConfigError extends SapMcpError {
+    constructor(message, context, cause) {
+        super(message, 'CONFIG_ERROR', context, cause);
+        this.name = 'ConfigError';
+    }
+}
+/**
+ * Configuration validation errors
+ */
+export class ConfigValidationError extends ConfigError {
+    constructor(field, value, expected) {
+        super(`Invalid config value for '${field}': expected ${expected}`, { field, value });
+        this.name = 'ConfigValidationError';
+    }
+}
+/**
+ * Configuration approval required
+ */
+export class ConfigApprovalRequiredError extends ConfigError {
+    constructor(field, changeId) {
+        super(`Configuration change requires approval: ${field}`, { field, changeId });
+        this.name = 'ConfigApprovalRequiredError';
+    }
+}
+/**
+ * Session errors
+ */
+export class SessionError extends SapMcpError {
+    constructor(message, context, cause) {
+        super(message, 'SESSION_ERROR', context, cause);
+        this.name = 'SessionError';
+    }
+}
+/**
+ * Session not found
+ */
+export class SessionNotFoundError extends SessionError {
+    constructor(sessionId) {
+        super(`Session not found: ${sessionId}`, { sessionId });
+        this.name = 'SessionNotFoundError';
+    }
+}
+/**
+ * Session expired
+ */
+export class SessionExpiredError extends SessionError {
+    constructor(sessionId) {
+        super(`Session expired: ${sessionId}`, { sessionId });
+        this.name = 'SessionExpiredError';
+    }
+}
+/**
+ * Session permission denied
+ */
+export class SessionPermissionError extends SessionError {
+    constructor(sessionId, requiredPermission) {
+        super(`Session lacks required permission: ${requiredPermission}`, { sessionId, requiredPermission });
+        this.name = 'SessionPermissionError';
+    }
+}
+/**
+ * Transaction errors
+ */
+export class TransactionError extends SapMcpError {
+    constructor(message, context, cause) {
+        super(message, 'TRANSACTION_ERROR', context, cause);
+        this.name = 'TransactionError';
+    }
+}
+/**
+ * Transaction build failed
+ */
+export class TransactionBuildError extends TransactionError {
+    constructor(instructionType, cause) {
+        super(`Failed to build transaction: ${instructionType}`, { instructionType }, cause);
+        this.name = 'TransactionBuildError';
+    }
+}
+/**
+ * Transaction simulation failed
+ */
+export class TransactionSimulationError extends TransactionError {
+    constructor(signature, logs) {
+        super(`Transaction simulation failed`, { signature, logs: logs.slice(-5) });
+        this.name = 'TransactionSimulationError';
+    }
+}
+/**
+ * Transaction submission failed
+ */
+export class TransactionSubmissionError extends TransactionError {
+    constructor(cause, signature) {
+        super(`Failed to submit transaction`, { signature }, cause);
+        this.name = 'TransactionSubmissionError';
+    }
+}
+/**
+ * Transaction confirmation timeout
+ */
+export class TransactionConfirmationTimeoutError extends TransactionError {
+    constructor(signature, timeoutMs) {
+        super(`Transaction confirmation timeout after ${timeoutMs}ms`, { signature, timeoutMs });
+        this.name = 'TransactionConfirmationTimeoutError';
+    }
+}
+/**
+ * Tool execution errors
+ */
+export class ToolError extends SapMcpError {
+    constructor(message, context, cause) {
+        super(message, 'TOOL_ERROR', context, cause);
+        this.name = 'ToolError';
+    }
+}
+/**
+ * Tool not found
+ */
+export class ToolNotFoundError extends ToolError {
+    constructor(toolName) {
+        super(`Tool not found: ${toolName}`, { toolName });
+        this.name = 'ToolNotFoundError';
+    }
+}
+/**
+ * Tool permission denied
+ */
+export class ToolPermissionError extends ToolError {
+    constructor(toolName, reason) {
+        super(`Tool execution denied: ${reason}`, { toolName, reason });
+        this.name = 'ToolPermissionError';
+    }
+}
+/**
+ * Security guard errors
+ */
+export class SecurityError extends SapMcpError {
+    constructor(message, context, cause) {
+        super(message, 'SECURITY_ERROR', context, cause);
+        this.name = 'SecurityError';
+    }
+}
+/**
+ * Unsafe action detected
+ */
+export class UnsafeActionError extends SecurityError {
+    constructor(action, reason, riskLevel) {
+        super(`Unsafe action blocked: ${reason}`, { action, reason, riskLevel });
+        this.name = 'UnsafeActionError';
+    }
+}
+/**
+ * Spending limit exceeded
+ */
+export class SpendingLimitError extends SapMcpError {
+    constructor(message, limitSol, requestedSol, limitType) {
+        super(message, 'SPENDING_LIMIT_ERROR', {
+            limitSol,
+            requestedSol,
+            limitType,
+        });
+        this.name = 'SpendingLimitError';
+    }
+}
+/**
+ * RPC errors
+ */
+export class RpcError extends SapMcpError {
+    constructor(message, context, cause) {
+        super(message, 'RPC_ERROR', context, cause);
+        this.name = 'RpcError';
+    }
+}
+/**
+ * RPC timeout
+ */
+export class RpcTimeoutError extends RpcError {
+    constructor(method, timeoutMs) {
+        super(`RPC call timeout after ${timeoutMs}ms: ${method}`, { method, timeoutMs });
+        this.name = 'RpcTimeoutError';
+    }
+}
+/**
+ * Client SDK errors
+ */
+export class ClientSdkError extends SapMcpError {
+    constructor(message, causeOrContext) {
+        if (causeOrContext instanceof Error) {
+            super(message, 'CLIENT_SDK_ERROR', undefined, causeOrContext);
+        }
+        else {
+            super(message, 'CLIENT_SDK_ERROR', causeOrContext);
+        }
+        this.name = 'ClientSdkError';
+    }
+}
+/**
+ * Execution errors
+ */
+export class ExecutionError extends SapMcpError {
+    constructor(message, causeOrContext) {
+        if (causeOrContext instanceof Error) {
+            super(message, 'EXECUTION_ERROR', undefined, causeOrContext);
+        }
+        else {
+            super(message, 'EXECUTION_ERROR', causeOrContext);
+        }
+        this.name = 'ExecutionError';
+    }
+}
+/**
+ * SAP Client errors
+ */
+export class SapClientError extends SapMcpError {
+    constructor(message, causeOrContext) {
+        if (causeOrContext instanceof Error) {
+            super(message, 'SAP_CLIENT_ERROR', undefined, causeOrContext);
+        }
+        else {
+            super(message, 'SAP_CLIENT_ERROR', causeOrContext);
+        }
+        this.name = 'SapClientError';
+    }
+}
+/**
+ * SAP SDK errors
+ */
+export class SapSdkError extends SapMcpError {
+    constructor(message, causeOrContext) {
+        if (causeOrContext instanceof Error) {
+            super(message, 'SAP_SDK_ERROR', undefined, causeOrContext);
+        }
+        else {
+            super(message, 'SAP_SDK_ERROR', causeOrContext);
+        }
+        this.name = 'SapSdkError';
+    }
+}
+/**
+ * Signer errors
+ */
+export class SignerError extends SapMcpError {
+    constructor(message, causeOrContext) {
+        if (causeOrContext instanceof Error) {
+            super(message, 'SIGNER_ERROR', undefined, causeOrContext);
+        }
+        else {
+            super(message, 'SIGNER_ERROR', causeOrContext);
+        }
+        this.name = 'SignerError';
+    }
+}
+/**
+ * Policy errors
+ */
+export class PolicyError extends SapMcpError {
+    constructor(message, context) {
+        super(message, 'POLICY_ERROR', context);
+        this.name = 'PolicyError';
+    }
+}
+/**
+ * Error type guard
+ */
+export function isSapMcpError(error) {
+    return error instanceof SapMcpError;
+}
+/**
+ * Extract error code from an arbitrary error
+ */
+export function getErrorCode(error) {
+    if (isSapMcpError(error)) {
+        return error.code;
+    }
+    if (error instanceof Error) {
+        return 'UNKNOWN_ERROR';
+    }
+    return 'UNKNOWN_ERROR';
+}
+/**
+ * Format error for logging
+ */
+export function formatError(error) {
+    if (isSapMcpError(error)) {
+        return JSON.stringify(error.toJSON(), null, 2);
+    }
+    if (error instanceof Error) {
+        return `${error.name}: ${error.message}\n${error.stack}`;
+    }
+    return String(error);
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

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

package/dist/core/guards.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Type guards for SAP MCP types
+ */
+import type { SapMcpMode, SapSignerMode, SapRiskLevel, SapPermission, SapMcpConfig } from './types.js';
+/**
+ * Executes the is valid mcp mode operation.
+ */
+export declare function isValidMcpMode(value: string): value is SapMcpMode;
+/**
+ * Executes the is valid signer mode operation.
+ */
+export declare function isValidSignerMode(value: string): value is SapSignerMode;
+/**
+ * Executes the is valid risk level operation.
+ */
+export declare function isValidRiskLevel(value: string): value is SapRiskLevel;
+/**
+ * Executes the is valid permission operation.
+ */
+export declare function isValidPermission(value: string): value is SapPermission;
+/**
+ * Executes the is readonly mode operation.
+ */
+export declare function isReadonlyMode(config: SapMcpConfig): boolean;
+/**
+ * Executes the is write mode operation.
+ */
+export declare function isWriteMode(config: SapMcpConfig): boolean;
+/**
+ * Executes the requires signer operation.
+ */
+export declare function requiresSigner(config: SapMcpConfig): boolean;
+/**
+ * Executes the is dev mode operation.
+ */
+export declare function isDevMode(config: SapMcpConfig): boolean;
+/**
+ * Executes the is production mode operation.
+ */
+export declare function isProductionMode(config: SapMcpConfig): boolean;
+//# sourceMappingURL=guards.d.ts.map

package/dist/core/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/core/guards.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAC;AAyCpB;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAEjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,aAAa,CAEvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAErE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,aAAa,CAEvE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAEvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAE9D"}

package/dist/core/guards.js

@@ -0,0 +1,93 @@
+/**
+ * Type guards for SAP MCP types
+ */
+const VALID_MODES = [
+    'readonly',
+    'local-dev-keypair',
+    'external-signer',
+    'delegated-session',
+    'hosted-api',
+];
+const VALID_SIGNER_MODES = [
+    'none',
+    'local-keypair',
+    'external',
+    'delegated',
+];
+const VALID_RISK_LEVELS = [
+    'safe',
+    'low',
+    'medium',
+    'high',
+    'critical',
+];
+const VALID_PERMISSIONS = [
+    'registry:read',
+    'registry:write',
+    'identity:read',
+    'identity:write',
+    'reputation:read',
+    'reputation:write',
+    'payments:read',
+    'payments:write',
+    'settlement:read',
+    'settlement:write',
+    'memory:read',
+    'memory:write',
+    'transaction:submit',
+];
+/**
+ * Executes the is valid mcp mode operation.
+ */
+export function isValidMcpMode(value) {
+    return VALID_MODES.includes(value);
+}
+/**
+ * Executes the is valid signer mode operation.
+ */
+export function isValidSignerMode(value) {
+    return VALID_SIGNER_MODES.includes(value);
+}
+/**
+ * Executes the is valid risk level operation.
+ */
+export function isValidRiskLevel(value) {
+    return VALID_RISK_LEVELS.includes(value);
+}
+/**
+ * Executes the is valid permission operation.
+ */
+export function isValidPermission(value) {
+    return VALID_PERMISSIONS.includes(value);
+}
+/**
+ * Executes the is readonly mode operation.
+ */
+export function isReadonlyMode(config) {
+    return config.mode === 'readonly' || config.mode === 'hosted-api';
+}
+/**
+ * Executes the is write mode operation.
+ */
+export function isWriteMode(config) {
+    return !isReadonlyMode(config);
+}
+/**
+ * Executes the requires signer operation.
+ */
+export function requiresSigner(config) {
+    return config.mode === 'local-dev-keypair' || config.mode === 'delegated-session';
+}
+/**
+ * Executes the is dev mode operation.
+ */
+export function isDevMode(config) {
+    return config.mode === 'local-dev-keypair';
+}
+/**
+ * Executes the is production mode operation.
+ */
+export function isProductionMode(config) {
+    return config.mode === 'hosted-api' || config.mode === 'external-signer';
+}
+//# sourceMappingURL=guards.js.map

package/dist/core/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../src/core/guards.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,MAAM,WAAW,GAAiB;IAChC,UAAU;IACV,mBAAmB;IACnB,iBAAiB;IACjB,mBAAmB;IACnB,YAAY;CACb,CAAC;AAEF,MAAM,kBAAkB,GAAoB;IAC1C,MAAM;IACN,eAAe;IACf,UAAU;IACV,WAAW;CACZ,CAAC;AAEF,MAAM,iBAAiB,GAAmB;IACxC,MAAM;IACN,KAAK;IACL,QAAQ;IACR,MAAM;IACN,UAAU;CACX,CAAC;AAEF,MAAM,iBAAiB,GAAoB;IACzC,eAAe;IACf,gBAAgB;IAChB,eAAe;IACf,gBAAgB;IAChB,iBAAiB;IACjB,kBAAkB;IAClB,eAAe;IACf,gBAAgB;IAChB,iBAAiB;IACjB,kBAAkB;IAClB,aAAa;IACb,cAAc;IACd,oBAAoB;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,WAAW,CAAC,QAAQ,CAAC,KAAmB,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,kBAAkB,CAAC,QAAQ,CAAC,KAAsB,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,iBAAiB,CAAC,QAAQ,CAAC,KAAqB,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,iBAAiB,CAAC,QAAQ,CAAC,KAAsB,CAAC,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAoB;IAC9C,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,OAAO,MAAM,CAAC,IAAI,KAAK,mBAAmB,IAAI,MAAM,CAAC,IAAI,KAAK,mBAAmB,CAAC;AACpF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,MAAoB;IAC5C,OAAO,MAAM,CAAC,IAAI,KAAK,mBAAmB,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAoB;IACnD,OAAO,MAAM,CAAC,IAAI,KAAK,YAAY,IAAI,MAAM,CAAC,IAAI,KAAK,iBAAiB,CAAC;AAC3E,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Core module barrel export
+ */
+export { logger, setLogLevel } from './logger.js';
+export type { LogLevel } from './logger.js';
+export * from './types.js';
+export * from './errors.js';
+export * from './result.js';
+export * from './constants.js';
+export * from './guards.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,10 @@
+/**
+ * Core module barrel export
+ */
+export { logger, setLogLevel } from './logger.js';
+export * from './types.js';
+export * from './errors.js';
+export * from './result.js';
+export * from './constants.js';
+export * from './guards.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGlD,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/core/logger.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Logger utility for SAP MCP Server
+ *
+ * Provides structured logging with:
+ * - Configurable log levels
+ * - JSON or pretty format
+ * - File output support
+ * - Timestamp and context
+ */
+/**
+ * Type alias for log level values used by the SAP MCP runtime.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Type alias for log format values used by the SAP MCP runtime.
+ */
+export type LogFormat = 'json' | 'pretty';
+/**
+ * Contract describing log options data used by the SAP MCP runtime.
+ */
+export interface LogOptions {
+    level?: LogLevel;
+    format?: LogFormat;
+    file?: string;
+}
+/**
+ * Initialize logger with options
+ */
+export declare function initLogger(options?: LogOptions): void;
+/**
+ * Logger instance
+ */
+export declare const logger: {
+    debug(message: string, data?: unknown): void;
+    info(message: string, data?: unknown): void;
+    warn(message: string, data?: unknown): void;
+    error(message: string, data?: unknown): void;
+    /**
+     * Log startup banner
+     */
+    startup(config: {
+        mode: string;
+        rpcUrl: string;
+        programId: string;
+        version?: string;
+    }): void;
+};
+/**
+ * Set log level dynamically
+ */
+export declare function setLogLevel(level: LogLevel): void;
+/**
+ * Set log format dynamically
+ */
+export declare function setLogFormat(format: LogFormat): void;
+/**
+ * Set log file dynamically
+ */
+export declare function setLogFile(file: string | undefined): void;
+/**
+ * Get current logger configuration
+ */
+export declare function getLoggerConfig(): LogOptions;
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAC3D;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAoBD;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,UAAe,QAOlD;AAmED;;GAEG;AACH,eAAO,MAAM,MAAM;mBACF,MAAM,SAAS,OAAO;kBAMvB,MAAM,SAAS,OAAO;kBAMtB,MAAM,SAAS,OAAO;mBAMrB,MAAM,SAAS,OAAO;IAMrC;;OAEG;oBACa;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;CAgBtF,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,QAE1C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,QAE7C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,QAKlD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,UAAU,CAM5C"}