@mcp-abap-adt/core 4.7.1 → 4.8.2

package/dist/src/handlers/domain/low/handleValidateDomain.js

@@ -0,0 +1,129 @@
+"use strict";
+/**
+ * ValidateDomain Handler - Validate ABAP Domain Name
+ *
+ * Uses AdtClient.validateDomain from @mcp-abap-adt/adt-clients.
+ * Low-level handler: single method call.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_DEFINITION = void 0;
+exports.handleValidateDomain = handleValidateDomain;
+const clients_1 = require("../../../lib/clients");
+const utils_1 = require("../../../lib/utils");
+exports.TOOL_DEFINITION = {
+    name: 'ValidateDomainLow',
+    available_in: ['onprem', 'cloud'],
+    description: '[low-level] Validate an ABAP domain name before creation. Checks if the name is valid and available. Returns validation result with success status and message. Can use session_id and session_state from GetSession to maintain the same session.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            domain_name: {
+                type: 'string',
+                description: 'Domain name to validate (e.g., Z_MY_PROGRAM).',
+            },
+            description: {
+                type: 'string',
+                description: 'Domain description (required for validation).',
+            },
+            package_name: {
+                type: 'string',
+                description: 'Package name (required for validation).',
+            },
+            session_id: {
+                type: 'string',
+                description: 'Session ID from GetSession. If not provided, a new session will be created.',
+            },
+            session_state: {
+                type: 'object',
+                description: 'Session state from GetSession (cookies, csrf_token, cookie_store). Required if session_id is provided.',
+                properties: {
+                    cookies: { type: 'string' },
+                    csrf_token: { type: 'string' },
+                    cookie_store: { type: 'object' },
+                },
+            },
+        },
+        required: ['domain_name', 'package_name', 'description'],
+    },
+};
+/**
+ * Main handler for ValidateDomain MCP tool
+ *
+ * Uses AdtClient.validateDomain - low-level single method call
+ */
+async function handleValidateDomain(context, args) {
+    const { connection, logger } = context;
+    try {
+        const { domain_name, description, package_name, session_id, session_state, } = args;
+        // Validation
+        if (!domain_name || !package_name || !description) {
+            return (0, utils_1.return_error)(new Error('domain_name, package_name, and description are required'));
+        }
+        const client = (0, clients_1.createAdtClient)(connection);
+        // Restore session state if provided
+        if (session_id && session_state) {
+            await (0, utils_1.restoreSessionInConnection)(connection, session_id, session_state);
+        }
+        const domainName = domain_name.toUpperCase();
+        logger?.info(`Starting domain validation: ${domainName}`);
+        try {
+            // Validate domain using AdtClient
+            const validationState = await client.getDomain().validate({
+                domainName,
+                description: description,
+                packageName: package_name.toUpperCase(),
+            });
+            const validationResponse = validationState.validationResponse;
+            if (!validationResponse) {
+                throw new Error('Validation did not return a result');
+            }
+            const result = (0, utils_1.parseValidationResponse)(validationResponse);
+            // Get updated session state after validation
+            logger?.info(`✅ ValidateDomain completed: ${domainName} (valid=${result.valid})`);
+            return (0, utils_1.return_response)({
+                data: JSON.stringify({
+                    success: result.valid,
+                    domain_name: domainName,
+                    validation_result: result,
+                    session_id: session_id || null,
+                    session_state: null, // Session state management is now handled by auth-broker,
+                    message: result.valid
+                        ? `Domain name ${domainName} is valid and available`
+                        : `Domain name ${domainName} validation failed: ${result.message}`,
+                }, null, 2),
+            });
+        }
+        catch (error) {
+            logger?.error(`Error validating domain ${domainName}: ${error?.message || error}`);
+            // Parse error message
+            let errorMessage = `Failed to validate domain: ${error.message || String(error)}`;
+            if (error.response?.status === 404) {
+                errorMessage = `Domain ${domainName} not found.`;
+            }
+            else if (error.response?.data &&
+                typeof error.response.data === 'string') {
+                try {
+                    const { XMLParser } = require('fast-xml-parser');
+                    const parser = new XMLParser({
+                        ignoreAttributes: false,
+                        attributeNamePrefix: '@_',
+                    });
+                    const errorData = parser.parse(error.response.data);
+                    const errorMsg = errorData['exc:exception']?.message?.['#text'] ||
+                        errorData['exc:exception']?.message;
+                    if (errorMsg) {
+                        errorMessage = `SAP Error: ${errorMsg}`;
+                    }
+                }
+                catch (_parseError) {
+                    // Ignore parse errors
+                }
+            }
+            return (0, utils_1.return_error)(new Error(errorMessage));
+        }
+    }
+    catch (error) {
+        return (0, utils_1.return_error)(error);
+    }
+}
+//# sourceMappingURL=handleValidateDomain.js.map

package/dist/src/handlers/domain/low/handleValidateDomain.js.map

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

package/dist/src/handlers/domain/readonly/handleReadDomain.d.ts

@@ -0,0 +1,33 @@
+import type { HandlerContext } from '../../../lib/handlers/interfaces';
+export declare const TOOL_DEFINITION: {
+    readonly name: "ReadDomain";
+    readonly available_in: readonly ["onprem", "cloud"];
+    readonly description: "[read-only] Read ABAP domain definition and metadata (package, responsible, description, etc.).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly domain_name: {
+                readonly type: "string";
+                readonly description: "Domain name (e.g., Z_MY_DOMAIN).";
+            };
+            readonly version: {
+                readonly type: "string";
+                readonly enum: readonly ["active", "inactive"];
+                readonly description: "Version to read: \"active\" (default) or \"inactive\".";
+                readonly default: "active";
+            };
+        };
+        readonly required: readonly ["domain_name"];
+    };
+};
+export declare function handleReadDomain(context: HandlerContext, args: {
+    domain_name: string;
+    version?: 'active' | 'inactive';
+}): Promise<{
+    isError: boolean;
+    content: {
+        type: string;
+        text: any;
+    }[];
+}>;
+//# sourceMappingURL=handleReadDomain.d.ts.map

package/dist/src/handlers/domain/readonly/handleReadDomain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleReadDomain.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/domain/readonly/handleReadDomain.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAOvE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;CAqBlB,CAAC;AAEX,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAA;CAAE;;;;;;GAwD/D"}

package/dist/src/handlers/domain/readonly/handleReadDomain.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_DEFINITION = void 0;
+exports.handleReadDomain = handleReadDomain;
+const clients_1 = require("../../../lib/clients");
+const utils_1 = require("../../../lib/utils");
+exports.TOOL_DEFINITION = {
+    name: 'ReadDomain',
+    available_in: ['onprem', 'cloud'],
+    description: '[read-only] Read ABAP domain definition and metadata (package, responsible, description, etc.).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            domain_name: {
+                type: 'string',
+                description: 'Domain name (e.g., Z_MY_DOMAIN).',
+            },
+            version: {
+                type: 'string',
+                enum: ['active', 'inactive'],
+                description: 'Version to read: "active" (default) or "inactive".',
+                default: 'active',
+            },
+        },
+        required: ['domain_name'],
+    },
+};
+async function handleReadDomain(context, args) {
+    const { connection, logger } = context;
+    try {
+        const { domain_name, version = 'active' } = args;
+        if (!domain_name)
+            return (0, utils_1.return_error)(new Error('domain_name is required'));
+        const client = (0, clients_1.createAdtClient)(connection, logger);
+        const domainName = domain_name.toUpperCase();
+        const obj = client.getDomain();
+        let source_code = null;
+        try {
+            const readResult = await obj.read({ domainName }, version);
+            if (readResult?.readResult?.data) {
+                source_code =
+                    typeof readResult.readResult.data === 'string'
+                        ? readResult.readResult.data
+                        : safeStringify(readResult.readResult.data);
+            }
+        }
+        catch (e) {
+            logger?.warn(`Could not read source for ${domainName}: ${e?.message}`);
+        }
+        let metadata = null;
+        try {
+            const metaResult = await obj.readMetadata({ domainName });
+            if (metaResult?.metadataResult?.data) {
+                metadata =
+                    typeof metaResult.metadataResult.data === 'string'
+                        ? metaResult.metadataResult.data
+                        : safeStringify(metaResult.metadataResult.data);
+            }
+        }
+        catch (e) {
+            logger?.warn(`Could not read metadata for ${domainName}: ${e?.message}`);
+        }
+        return (0, utils_1.return_response)({
+            data: JSON.stringify({
+                success: true,
+                domain_name: domainName,
+                version,
+                source_code,
+                metadata,
+            }, null, 2),
+        });
+    }
+    catch (error) {
+        return (0, utils_1.return_error)(error);
+    }
+}
+function safeStringify(data) {
+    try {
+        return JSON.stringify(data);
+    }
+    catch {
+        return String(data);
+    }
+}
+//# sourceMappingURL=handleReadDomain.js.map

package/dist/src/handlers/domain/readonly/handleReadDomain.js.map

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

package/dist/src/handlers/enhancement/readonly/handleGetEnhancementImpl.d.ts

@@ -0,0 +1,71 @@
+import type { HandlerContext } from '../../../lib/handlers/interfaces';
+export declare const TOOL_DEFINITION: {
+    readonly name: "GetEnhancementImpl";
+    readonly available_in: readonly ["onprem", "cloud"];
+    readonly description: "[read-only] Retrieve source code of a specific enhancement implementation by its name and enhancement spot.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly enhancement_spot: {
+                readonly type: "string";
+                readonly description: "Name of the enhancement spot";
+            };
+            readonly enhancement_name: {
+                readonly type: "string";
+                readonly description: "[read-only] Name of the enhancement implementation";
+            };
+        };
+        readonly required: readonly ["enhancement_spot", "enhancement_name"];
+    };
+};
+/**
+ * Interface for enhancement by name response
+ */
+export interface EnhancementByNameResponse {
+    enhancement_spot: string;
+    enhancement_name: string;
+    source_code: string;
+}
+/**
+ * Handler to retrieve a specific enhancement implementation by name in an ABAP system.
+ * This function is intended for retrieving the source code of a specific enhancement implementation (requires both spot and implementation name).
+ * This function uses the SAP ADT API endpoint to fetch the source code of a specific enhancement
+ * implementation within a given enhancement spot. If the implementation is not found, it falls back
+ * to retrieving metadata about the enhancement spot itself to provide context about the failure.
+ *
+ * @param args - Tool arguments containing:
+ *   - enhancement_spot: Name of the enhancement spot (e.g., 'enhoxhh'). This is a required parameter.
+ *   - enhancement_name: Name of the specific enhancement implementation (e.g., 'zpartner_update_pai'). This is a required parameter.
+ * @returns Response object containing:
+ *   - If successful: enhancement_spot, enhancement_name, source_code, and raw_xml of the enhancement implementation.
+ *   - If implementation not found: enhancement_spot, enhancement_name, status as 'not_found', a message, spot_metadata, and raw_xml of the spot.
+ *   - In case of error: an error object with details about the failure.
+ */
+export declare function handleGetEnhancementImpl(context: HandlerContext, args: any): Promise<{
+    isError: boolean;
+    content: {
+        type: string;
+        json: EnhancementByNameResponse;
+    }[];
+} | {
+    isError: boolean;
+    content: {
+        type: string;
+        json: {
+            enhancement_spot: any;
+            enhancement_name: any;
+            status: string;
+            message: string;
+            spot_metadata: {
+                description?: string;
+            };
+        };
+    }[];
+} | {
+    isError: boolean;
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=handleGetEnhancementImpl.d.ts.map

package/dist/src/handlers/enhancement/readonly/handleGetEnhancementImpl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleGetEnhancementImpl.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/enhancement/readonly/handleGetEnhancementImpl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AASvE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;CAmBlB,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAgDD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,GAAG;;;;;;;;;;;;;;;;8BAmF6B,MAAM;;;;;;;;;;GAiD7C"}

package/dist/src/handlers/enhancement/readonly/handleGetEnhancementImpl.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_DEFINITION = void 0;
+exports.handleGetEnhancementImpl = handleGetEnhancementImpl;
+const utils_1 = require("../../../lib/utils");
+const writeResultToFile_1 = require("../../../lib/writeResultToFile");
+exports.TOOL_DEFINITION = {
+    name: 'GetEnhancementImpl',
+    available_in: ['onprem', 'cloud'],
+    description: '[read-only] Retrieve source code of a specific enhancement implementation by its name and enhancement spot.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            enhancement_spot: {
+                type: 'string',
+                description: 'Name of the enhancement spot',
+            },
+            enhancement_name: {
+                type: 'string',
+                description: '[read-only] Name of the enhancement implementation',
+            },
+        },
+        required: ['enhancement_spot', 'enhancement_name'],
+    },
+};
+/**
+ * Parses enhancement source XML to extract the source code
+ * @param xmlData - Raw XML response from ADT
+ * @returns Decoded source code
+ */
+function parseEnhancementSourceFromXml(xmlData) {
+    try {
+        // Look for source code in various possible formats
+        // Try to find base64 encoded source in <source> or similar tags
+        const base64SourceRegex = /<(?:source|enh:source)[^>]*>([^<]*)<\/(?:source|enh:source)>/;
+        const base64Match = xmlData.match(base64SourceRegex);
+        if (base64Match?.[1]) {
+            try {
+                // Decode base64 source code
+                const decodedSource = Buffer.from(base64Match[1], 'base64').toString('utf-8');
+                return decodedSource;
+            }
+            catch (decodeError) {
+                utils_1.logger?.warn('Failed to decode base64 source code:', decodeError);
+            }
+        }
+        // Try to find plain text source code
+        const textSourceRegex = /<(?:source|enh:source)[^>]*>\s*<!\[CDATA\[(.*?)\]\]>\s*<\/(?:source|enh:source)>/s;
+        const textMatch = xmlData.match(textSourceRegex);
+        if (textMatch?.[1]) {
+            return textMatch[1];
+        }
+        // If no specific source tags found, return the entire XML as fallback
+        utils_1.logger?.warn('Could not find source code in expected format, returning raw XML');
+        return xmlData;
+    }
+    catch (parseError) {
+        utils_1.logger?.error('Failed to parse enhancement source XML:', parseError);
+        return xmlData; // Return raw XML as fallback
+    }
+}
+/**
+ * Handler to retrieve a specific enhancement implementation by name in an ABAP system.
+ * This function is intended for retrieving the source code of a specific enhancement implementation (requires both spot and implementation name).
+ * This function uses the SAP ADT API endpoint to fetch the source code of a specific enhancement
+ * implementation within a given enhancement spot. If the implementation is not found, it falls back
+ * to retrieving metadata about the enhancement spot itself to provide context about the failure.
+ *
+ * @param args - Tool arguments containing:
+ *   - enhancement_spot: Name of the enhancement spot (e.g., 'enhoxhh'). This is a required parameter.
+ *   - enhancement_name: Name of the specific enhancement implementation (e.g., 'zpartner_update_pai'). This is a required parameter.
+ * @returns Response object containing:
+ *   - If successful: enhancement_spot, enhancement_name, source_code, and raw_xml of the enhancement implementation.
+ *   - If implementation not found: enhancement_spot, enhancement_name, status as 'not_found', a message, spot_metadata, and raw_xml of the spot.
+ *   - In case of error: an error object with details about the failure.
+ */
+async function handleGetEnhancementImpl(context, args) {
+    const { connection, logger } = context;
+    try {
+        logger?.info('handleGetEnhancementByName called with args:', args);
+        if (!args?.enhancement_spot) {
+            throw new utils_1.McpError(utils_1.ErrorCode.InvalidParams, 'Enhancement spot is required');
+        }
+        if (!args?.enhancement_name) {
+            throw new utils_1.McpError(utils_1.ErrorCode.InvalidParams, 'Enhancement name is required');
+        }
+        const enhancementSpot = args.enhancement_spot;
+        const enhancementName = args.enhancement_name;
+        logger?.info(`Getting enhancement: ${enhancementName} from spot: ${enhancementSpot}`);
+        // Build the ADT URL for the specific enhancement
+        // Format: /sap/bc/adt/enhancements/{enhancement_spot}/{enhancement_name}/source/main
+        const url = `/sap/bc/adt/enhancements/${(0, utils_1.encodeSapObjectName)(enhancementSpot)}/${(0, utils_1.encodeSapObjectName)(enhancementName)}/source/main`;
+        logger?.info(`Enhancement URL: ${url}`);
+        const response = await (0, utils_1.makeAdtRequestWithTimeout)(connection, url, 'GET', 'default');
+        if (response.status === 200 && response.data) {
+            // Parse the XML to extract source code
+            const sourceCode = parseEnhancementSourceFromXml(response.data);
+            const enhancementResponse = {
+                enhancement_spot: enhancementSpot,
+                enhancement_name: enhancementName,
+                source_code: sourceCode,
+            };
+            const result = {
+                isError: false,
+                content: [
+                    {
+                        type: 'json',
+                        json: enhancementResponse,
+                    },
+                ],
+            };
+            if (args.filePath) {
+                (0, writeResultToFile_1.writeResultToFile)(JSON.stringify(result, null, 2), args.filePath);
+            }
+            return result;
+        }
+        else {
+            logger?.warn(`Enhancement ${enhancementName} not found in spot ${enhancementSpot}. Status: ${response.status}. Attempting to retrieve spot metadata as fallback.`);
+            // Fallback to retrieve metadata about the enhancement spot
+            const spotUrl = `/sap/bc/adt/enhancements/${(0, utils_1.encodeSapObjectName)(enhancementSpot)}`;
+            logger?.info(`Fallback enhancement spot URL: ${spotUrl}`);
+            const spotResponse = await (0, utils_1.makeAdtRequestWithTimeout)(connection, spotUrl, 'GET', 'default', {
+                Accept: 'application/vnd.sap.adt.enhancements.v1+xml',
+            });
+            if (spotResponse.status === 200 && spotResponse.data) {
+                // Parse metadata if possible
+                const metadata = {};
+                const descriptionMatch = spotResponse.data.match(/<adtcore:description>([^<]*)<\/adtcore:description>/);
+                if (descriptionMatch?.[1]) {
+                    metadata.description = descriptionMatch[1];
+                }
+                const fallbackResult = {
+                    isError: false,
+                    content: [
+                        {
+                            type: 'json',
+                            json: {
+                                enhancement_spot: enhancementSpot,
+                                enhancement_name: enhancementName,
+                                status: 'not_found',
+                                message: `Enhancement implementation ${enhancementName} not found in spot ${enhancementSpot}.`,
+                                spot_metadata: metadata,
+                            },
+                        },
+                    ],
+                };
+                if (args.filePath) {
+                    (0, writeResultToFile_1.writeResultToFile)(JSON.stringify(fallbackResult, null, 2), args.filePath);
+                }
+                return fallbackResult;
+            }
+            else {
+                throw new utils_1.McpError(utils_1.ErrorCode.InternalError, `Failed to retrieve enhancement ${enhancementName} from spot ${enhancementSpot}. Status: ${response.status}. Fallback to retrieve spot metadata also failed. Status: ${spotResponse.status}`);
+            }
+        }
+    }
+    catch (error) {
+        // MCP-compliant error response: always return content[] with type "text"
+        return {
+            isError: true,
+            content: [
+                {
+                    type: 'text',
+                    text: `ADT error: ${String(error)}`,
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=handleGetEnhancementImpl.js.map

package/dist/src/handlers/enhancement/readonly/handleGetEnhancementImpl.js.map

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

package/dist/src/handlers/enhancement/readonly/handleGetEnhancementSpot.d.ts

@@ -0,0 +1,55 @@
+import type { HandlerContext } from '../../../lib/handlers/interfaces';
+export declare const TOOL_DEFINITION: {
+    readonly name: "GetEnhancementSpot";
+    readonly available_in: readonly ["onprem", "cloud"];
+    readonly description: "[read-only] Retrieve metadata and list of implementations for a specific enhancement spot.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly enhancement_spot: {
+                readonly type: "string";
+                readonly description: "Name of the enhancement spot";
+            };
+        };
+        readonly required: readonly ["enhancement_spot"];
+    };
+};
+/**
+ * Interface for enhancement spot response
+ */
+export interface EnhancementSpotResponse {
+    enhancement_spot: string;
+    metadata: {
+        description?: string;
+        type?: string;
+        status?: string;
+    };
+}
+/**
+ * Handler to retrieve metadata for a specific enhancement spot in an ABAP system.
+ * This function uses the SAP ADT API endpoint to fetch details about an enhancement spot,
+ * regardless of whether it has any implementations. It is designed to provide information
+ * about the spot's existence, description, type, and status.
+ *
+ * @param args - Tool arguments containing:
+ *   - enhancement_spot: Name of the enhancement spot (e.g., 'enhoxhh'). This is a required parameter.
+ * @returns Response object containing:
+ *   - enhancement_spot: The name of the queried enhancement spot.
+ *   - metadata: An object with properties like description, type, and status of the enhancement spot.
+ *   - raw_xml: The raw XML response from the ADT API for debugging purposes.
+ *   - In case of error, an error object with details about the failure.
+ */
+export declare function handleGetEnhancementSpot(context: HandlerContext, args: any): Promise<{
+    isError: boolean;
+    content: {
+        type: string;
+        json: EnhancementSpotResponse;
+    }[];
+} | {
+    isError: boolean;
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=handleGetEnhancementSpot.d.ts.map

package/dist/src/handlers/enhancement/readonly/handleGetEnhancementSpot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleGetEnhancementSpot.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/enhancement/readonly/handleGetEnhancementSpot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AASvE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;CAelB,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AA2ED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,GAAG;;;;;;;;;;;;GAwEV"}