@ibm/ibmi-mcp-server 0.2.0 → 0.3.0

package/dist/ibmi-mcp-server/tools/executeSql/index.js

@@ -1,9 +0,0 @@
-/**
- * @fileoverview Barrel file for the execute SQL tool
- * This module exports the registration function and configuration utilities
- * for the dynamic SQL execution tool.
- *
- * @module src/mcp-server/tools/executeSql/index
- */
-export { registerExecuteSqlTool, setExecuteSqlConfig, getExecuteSqlConfig, isExecuteSqlEnabled, } from "./registration.js";
-//# sourceMappingURL=index.js.map

package/dist/ibmi-mcp-server/tools/executeSql/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ibmi-mcp-server/tools/executeSql/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GAEpB,MAAM,mBAAmB,CAAC"}

package/dist/ibmi-mcp-server/tools/executeSql/logic.d.ts

@@ -1,51 +0,0 @@
-/**
- * @fileoverview Defines the core logic, schemas, and types for the `execute_sql` tool.
- * This module provides dynamic SQL execution capabilities for the IBM i database.
- * Unlike YAML tools with predefined statements, this tool accepts arbitrary SQL at runtime.
- * @module src/mcp-server/tools/executeSql/logic
- * @see {@link src/mcp-server/tools/executeSql/registration.ts} for the handler and registration logic.
- */
-import { z } from "zod";
-/**
- * Zod schema defining the input parameters for the `execute_sql` tool.
- * CRITICAL: The descriptions are sent to the LLM and must be clear.
- */
-export declare const ExecuteSqlInputSchema: z.ZodObject<{
-    sql: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    sql: string;
-}, {
-    sql: string;
-}>;
-/**
- * Zod schema for the successful response of the `execute_sql` tool.
- */
-export declare const ExecuteSqlResponseSchema: z.ZodObject<{
-    data: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
-    rowCount: z.ZodNumber;
-    executionTimeMs: z.ZodOptional<z.ZodNumber>;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, "strip", z.ZodTypeAny, {
-    data: Record<string, unknown>[];
-    rowCount: number;
-    metadata?: Record<string, unknown> | undefined;
-    executionTimeMs?: number | undefined;
-}, {
-    data: Record<string, unknown>[];
-    rowCount: number;
-    metadata?: Record<string, unknown> | undefined;
-    executionTimeMs?: number | undefined;
-}>;
-export type ExecuteSqlInput = z.infer<typeof ExecuteSqlInputSchema>;
-export type ExecuteSqlResponse = z.infer<typeof ExecuteSqlResponseSchema>;
-/**
- * Processes the core logic for the `execute_sql` tool.
- * This function executes arbitrary SQL statements against the IBM i database.
- * Only read-only operations are allowed for security.
- *
- * @param params - The validated input parameters containing the SQL statement
- * @returns A promise resolving with the structured response data
- * @throws {McpError} If the SQL execution encounters an unrecoverable issue
- */
-export declare function executeSqlLogic(params: ExecuteSqlInput): Promise<ExecuteSqlResponse>;
-//# sourceMappingURL=logic.d.ts.map

package/dist/ibmi-mcp-server/tools/executeSql/logic.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"logic.d.ts","sourceRoot":"","sources":["../../../../src/ibmi-mcp-server/tools/executeSql/logic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA6BxB;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;EAShC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;EAiBnC,CAAC;AAGH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAsE1E;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAwF7B"}

package/dist/ibmi-mcp-server/tools/executeSql/logic.js

@@ -1,179 +0,0 @@
-/**
- * @fileoverview Defines the core logic, schemas, and types for the `execute_sql` tool.
- * This module provides dynamic SQL execution capabilities for the IBM i database.
- * Unlike YAML tools with predefined statements, this tool accepts arbitrary SQL at runtime.
- * @module src/mcp-server/tools/executeSql/logic
- * @see {@link src/mcp-server/tools/executeSql/registration.ts} for the handler and registration logic.
- */
-import { z } from "zod";
-import { JsonRpcErrorCode, McpError } from "../../../types-global/errors.js";
-import { getRequestContext } from "../../../utils/index.js";
-import { logger } from "../../../utils/internal/logger.js";
-import { IBMiConnectionPool } from "../../services/connectionPool.js";
-/**
- * Restricted SQL keywords that are not allowed in execute-sql tool
- * This provides basic protection against destructive operations
- */
-const RESTRICTED_KEYWORDS = [
-    "DROP",
-    "DELETE",
-    "TRUNCATE",
-    "ALTER",
-    "CREATE",
-    "INSERT",
-    "UPDATE",
-    "GRANT",
-    "REVOKE",
-    "COMMIT",
-    "ROLLBACK",
-];
-/**
- * Maximum allowed SQL statement length to prevent abuse
- */
-const MAX_SQL_LENGTH = 10000;
-/**
- * Zod schema defining the input parameters for the `execute_sql` tool.
- * CRITICAL: The descriptions are sent to the LLM and must be clear.
- */
-export const ExecuteSqlInputSchema = z.object({
-    sql: z
-        .string()
-        .min(1, "SQL statement cannot be empty.")
-        .max(MAX_SQL_LENGTH, `SQL statement cannot exceed ${MAX_SQL_LENGTH} characters.`)
-        .describe("The SQL statement to execute against the IBM i database."),
-});
-/**
- * Zod schema for the successful response of the `execute_sql` tool.
- */
-export const ExecuteSqlResponseSchema = z.object({
-    data: z
-        .array(z.record(z.unknown()))
-        .describe("Array of result rows returned by the SQL query."),
-    rowCount: z
-        .number()
-        .int()
-        .min(0)
-        .describe("Number of rows returned by the query."),
-    executionTimeMs: z
-        .number()
-        .optional()
-        .describe("Query execution time in milliseconds."),
-    metadata: z
-        .record(z.unknown())
-        .optional()
-        .describe("Additional metadata about the query execution."),
-});
-/**
- * Validates SQL statement for security and safety
- * @param sql - SQL statement to validate
- * @throws {McpError} If the SQL statement contains restricted keywords or patterns
- * @private
- */
-function validateSqlSecurity(sql) {
-    const context = getRequestContext();
-    const normalizedSql = sql.trim().toUpperCase();
-    // Check for restricted keywords at the beginning of statements
-    for (const keyword of RESTRICTED_KEYWORDS) {
-        if (normalizedSql.startsWith(keyword)) {
-            logger.warning({
-                ...context,
-                keyword,
-                sqlPrefix: sql.substring(0, 50),
-            }, "Restricted SQL keyword detected");
-            throw new McpError(JsonRpcErrorCode.ValidationError, `SQL statement cannot start with restricted keyword: ${keyword}. Only SELECT and read-only operations are allowed.`, { keyword, sqlPrefix: sql.substring(0, 50) });
-        }
-    }
-    // Check for potentially dangerous patterns
-    const dangerousPatterns = [
-        /;\s*(DROP|DELETE|TRUNCATE|ALTER|CREATE|INSERT|UPDATE)\s+/i,
-        /UNION\s+SELECT.*INTO\s+/i,
-        /EXEC\s*\(/i,
-        /(CALL|EXECUTE)\s+/i,
-    ];
-    for (const pattern of dangerousPatterns) {
-        if (pattern.test(sql)) {
-            logger.warning({
-                ...context,
-                pattern: pattern.source,
-                sqlPrefix: sql.substring(0, 100),
-            }, "Potentially dangerous SQL pattern detected");
-            throw new McpError(JsonRpcErrorCode.ValidationError, "SQL statement contains potentially dangerous patterns. Only safe, read-only queries are allowed.", {
-                pattern: pattern.source,
-                sqlPrefix: sql.substring(0, 100),
-            });
-        }
-    }
-    logger.debug({
-        ...context,
-        sqlLength: sql.length,
-        sqlPrefix: sql.substring(0, 50),
-    }, "SQL security validation passed");
-}
-/**
- * Processes the core logic for the `execute_sql` tool.
- * This function executes arbitrary SQL statements against the IBM i database.
- * Only read-only operations are allowed for security.
- *
- * @param params - The validated input parameters containing the SQL statement
- * @returns A promise resolving with the structured response data
- * @throws {McpError} If the SQL execution encounters an unrecoverable issue
- */
-export async function executeSqlLogic(params) {
-    const context = getRequestContext();
-    logger.debug({
-        ...context,
-        sqlLength: params.sql.length,
-        sqlPrefix: params.sql.substring(0, 50),
-    }, "Processing execute SQL logic");
-    // Validate SQL security before execution
-    validateSqlSecurity(params.sql);
-    const startTime = Date.now();
-    try {
-        // Execute the SQL query using the existing connection pool
-        const result = await IBMiConnectionPool.executeQuery(params.sql, [], // No parameters for dynamic SQL
-        context);
-        const executionTime = Date.now() - startTime;
-        if (!result.success) {
-            throw new McpError(JsonRpcErrorCode.DatabaseError, "SQL query execution failed", {
-                sql: params.sql.substring(0, 100),
-                sqlReturnCode: result.sql_rc,
-                executionTime,
-            });
-        }
-        const response = {
-            data: result.data || [],
-            rowCount: result.data?.length || 0,
-            executionTimeMs: executionTime,
-        };
-        // Add metadata if available from the query result
-        if (result.metadata) {
-            response.metadata = result.metadata;
-        }
-        logger.debug({
-            ...context,
-            rowCount: response.rowCount,
-            executionTime: response.executionTimeMs,
-            sqlPrefix: params.sql.substring(0, 50),
-        }, "SQL query executed successfully");
-        return response;
-    }
-    catch (error) {
-        const executionTime = Date.now() - startTime;
-        logger.error({
-            ...context,
-            error: error instanceof Error ? error.message : String(error),
-            executionTime,
-            sqlPrefix: params.sql.substring(0, 100),
-        }, "SQL execution failed");
-        // Re-throw McpErrors as-is, wrap other errors
-        if (error instanceof McpError) {
-            throw error;
-        }
-        throw new McpError(JsonRpcErrorCode.DatabaseError, `SQL execution failed: ${error instanceof Error ? error.message : String(error)}`, {
-            sql: params.sql.substring(0, 100),
-            executionTime,
-            originalError: error instanceof Error ? error.name : "Unknown",
-        });
-    }
-}
-//# sourceMappingURL=logic.js.map

package/dist/ibmi-mcp-server/tools/executeSql/logic.js.map

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

package/dist/ibmi-mcp-server/tools/executeSql/registration.d.ts

@@ -1,52 +0,0 @@
-/**
- * @fileoverview Handles registration and error handling for the `execute_sql` tool.
- * This module acts as the "handler" layer, connecting the pure business logic to the
- * MCP server and ensuring all outcomes (success or failure) are handled gracefully.
- * @module src/mcp-server/tools/executeSql/registration
- * @see {@link src/mcp-server/tools/executeSql/logic.ts} for the core business logic and schemas.
- */
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-/**
- * Configuration interface for the execute SQL tool
- * This allows the tool to be enabled/disabled and configured via YAML
- */
-export interface ExecuteSqlToolConfig {
-    /** Whether the tool is enabled */
-    enabled: boolean;
-    /** Tool description override */
-    description?: string;
-    /** Security configuration */
-    security?: {
-        /** Whether to enforce read-only mode (default: true) */
-        readOnly?: boolean;
-        /** Maximum query length (default: 10000) */
-        maxQueryLength?: number;
-        /** Additional forbidden keywords */
-        forbiddenKeywords?: string[];
-    };
-}
-/**
- * Set the configuration for the execute SQL tool
- * This is called by the YAML configuration system
- * @param config - Tool configuration
- */
-export declare function setExecuteSqlConfig(config: Partial<ExecuteSqlToolConfig>): void;
-/**
- * Get the current configuration for the execute SQL tool
- * @returns Current tool configuration
- */
-export declare function getExecuteSqlConfig(): ExecuteSqlToolConfig;
-/**
- * Check if the execute SQL tool is enabled
- * @returns True if the tool is enabled
- */
-export declare function isExecuteSqlEnabled(): boolean;
-/**
- * Registers the 'execute_sql' tool and its handler with the provided MCP server instance.
- * This function uses ErrorHandler.tryCatch to ensure that any failure during the
- * registration process itself is caught and logged, preventing server startup failures.
- *
- * @param server - The MCP server instance to register the tool with.
- */
-export declare const registerExecuteSqlTool: (server: McpServer) => Promise<void>;
-//# sourceMappingURL=registration.d.ts.map

package/dist/ibmi-mcp-server/tools/executeSql/registration.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../../../../src/ibmi-mcp-server/tools/executeSql/registration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmCpE;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE;QACT,wDAAwD;QACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,4CAA4C;QAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,oCAAoC;QACpC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC;CACH;AAmBD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACpC,IAAI,CAoBN;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,oBAAoB,CAE1D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,SAAS,KAChB,OAAO,CAAC,IAAI,CAmGd,CAAC"}

package/dist/ibmi-mcp-server/tools/executeSql/registration.js

@@ -1,161 +0,0 @@
-/**
- * @fileoverview Handles registration and error handling for the `execute_sql` tool.
- * This module acts as the "handler" layer, connecting the pure business logic to the
- * MCP server and ensuring all outcomes (success or failure) are handled gracefully.
- * @module src/mcp-server/tools/executeSql/registration
- * @see {@link src/mcp-server/tools/executeSql/logic.ts} for the core business logic and schemas.
- */
-import { JsonRpcErrorCode } from "../../../types-global/errors.js";
-import { ErrorHandler, requestContextService } from "../../../utils/index.js";
-import { logOperationStart, logOperationSuccess, } from "../../../utils/internal/logging-helpers.js";
-import { measureToolExecution } from "../../../utils/internal/performance.js";
-import { getRequestContext } from "../../../utils/internal/asyncContext.js";
-import { ExecuteSqlInputSchema, executeSqlLogic, ExecuteSqlResponseSchema, } from "./logic.js";
-// The unique name for the tool, used for registration and identification.
-const TOOL_NAME = "execute_sql";
-// A concise description for the LLM. More detailed guidance should be in the
-// parameter descriptions within the Zod schema in `logic.ts`.
-const TOOL_DESCRIPTION = `Execute SQL statements against the IBM i database. Only SELECT and read-only operations are allowed for security.`;
-const responseFormatter = (result) => ({
-    structuredContent: result,
-    content: [
-        {
-            type: "text",
-            text: `SQL Query executed successfully. Returned ${result.rowCount} rows.\n\n${JSON.stringify(result.data, null, 2)}`,
-        },
-    ],
-});
-/**
- * Default configuration for the execute SQL tool
- */
-const DEFAULT_CONFIG = {
-    enabled: true,
-    security: {
-        readOnly: true,
-        maxQueryLength: 10000,
-        forbiddenKeywords: [],
-    },
-};
-/**
- * Internal configuration storage
- */
-let toolConfig = DEFAULT_CONFIG;
-/**
- * Set the configuration for the execute SQL tool
- * This is called by the YAML configuration system
- * @param config - Tool configuration
- */
-export function setExecuteSqlConfig(config) {
-    toolConfig = {
-        ...DEFAULT_CONFIG,
-        ...config,
-        security: {
-            ...DEFAULT_CONFIG.security,
-            ...config.security,
-        },
-    };
-    const context = requestContextService.createRequestContext({
-        operation: "ConfigUpdate",
-        toolName: TOOL_NAME,
-    });
-    logOperationSuccess(context, "Execute SQL tool configuration updated", {
-        enabled: toolConfig.enabled,
-        readOnly: toolConfig.security?.readOnly,
-        maxQueryLength: toolConfig.security?.maxQueryLength,
-    });
-}
-/**
- * Get the current configuration for the execute SQL tool
- * @returns Current tool configuration
- */
-export function getExecuteSqlConfig() {
-    return toolConfig;
-}
-/**
- * Check if the execute SQL tool is enabled
- * @returns True if the tool is enabled
- */
-export function isExecuteSqlEnabled() {
-    return toolConfig.enabled;
-}
-/**
- * Registers the 'execute_sql' tool and its handler with the provided MCP server instance.
- * This function uses ErrorHandler.tryCatch to ensure that any failure during the
- * registration process itself is caught and logged, preventing server startup failures.
- *
- * @param server - The MCP server instance to register the tool with.
- */
-export const registerExecuteSqlTool = async (server) => {
-    const registrationContext = requestContextService.createRequestContext({
-        operation: "RegisterTool",
-        toolName: TOOL_NAME,
-    });
-    logOperationStart(registrationContext, `Checking if tool should be registered: '${TOOL_NAME}'`, {
-        enabled: toolConfig.enabled,
-    });
-    // Only register if the tool is enabled
-    if (!toolConfig.enabled) {
-        logOperationSuccess(registrationContext, `Tool '${TOOL_NAME}' is disabled, skipping registration`);
-        return;
-    }
-    logOperationStart(registrationContext, `Registering tool: '${TOOL_NAME}'`);
-    await ErrorHandler.tryCatch(async () => {
-        const description = toolConfig.description || TOOL_DESCRIPTION;
-        server.registerTool(TOOL_NAME, {
-            title: "Execute SQL",
-            description,
-            inputSchema: ExecuteSqlInputSchema.shape,
-            outputSchema: ExecuteSqlResponseSchema.shape,
-            annotations: {
-                readOnlyHint: toolConfig.security?.readOnly, // Default to true for safety
-                destructiveHint: !(toolConfig.security?.readOnly ?? true), // Destructive if not read-only
-                openWorldHint: !(toolConfig.security?.readOnly ?? true), // Open world if not read-only
-            },
-            _meta: {
-                requiresAuth: true, // Requires database authentication
-            },
-        }, async (params, mcpContext) => {
-            try {
-                const result = await measureToolExecution(TOOL_NAME, () => executeSqlLogic(params), params);
-                return responseFormatter(result);
-            }
-            catch (error) {
-                const handlerContext = requestContextService.createRequestContext({
-                    parentContext: mcpContext,
-                    operation: `tool:${TOOL_NAME}`,
-                });
-                const handledError = ErrorHandler.handleError(error, {
-                    operation: `tool:${TOOL_NAME}`,
-                    context: getRequestContext() ?? handlerContext,
-                    input: params,
-                });
-                return {
-                    isError: true,
-                    content: [
-                        {
-                            type: "text",
-                            text: `SQL Error: ${handledError.message}`,
-                        },
-                    ],
-                    structuredContent: {
-                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                        code: handledError.code,
-                        message: handledError.message,
-                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                        details: handledError.details,
-                    },
-                };
-            }
-        });
-        logOperationSuccess(registrationContext, `Tool '${TOOL_NAME}' registered successfully.`, {
-            enabled: toolConfig.enabled,
-            readOnly: toolConfig.security?.readOnly,
-        });
-    }, {
-        operation: `RegisteringTool_${TOOL_NAME}`,
-        context: registrationContext,
-        errorCode: JsonRpcErrorCode.InitializationFailed,
-        critical: true, // A failure to register a tool is a critical startup error.
-    });
-};
-//# sourceMappingURL=registration.js.map

package/dist/ibmi-mcp-server/tools/executeSql/registration.js.map

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

package/dist/ibmi-mcp-server/tools/generateSql/index.d.ts

@@ -1,13 +0,0 @@
-/**
- * @fileoverview Barrel file for the `generate_sql` tool.
- * This file serves as the public interface for the generate SQL tool module,
- * primarily exporting the `registerGenerateSqlTool` function. This function is
- * responsible for registering the generate SQL tool with an MCP server instance,
- * making it available for invocation by clients.
- *
- * Consuming modules should import from this barrel file to access
- * the generate SQL tool's registration capabilities.
- * @module src/mcp-server/tools/generateSql/index
- */
-export { registerGenerateSqlTool } from "./registration.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/ibmi-mcp-server/tools/generateSql/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ibmi-mcp-server/tools/generateSql/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/ibmi-mcp-server/tools/generateSql/index.js

@@ -1,13 +0,0 @@
-/**
- * @fileoverview Barrel file for the `generate_sql` tool.
- * This file serves as the public interface for the generate SQL tool module,
- * primarily exporting the `registerGenerateSqlTool` function. This function is
- * responsible for registering the generate SQL tool with an MCP server instance,
- * making it available for invocation by clients.
- *
- * Consuming modules should import from this barrel file to access
- * the generate SQL tool's registration capabilities.
- * @module src/mcp-server/tools/generateSql/index
- */
-export { registerGenerateSqlTool } from "./registration.js";
-//# sourceMappingURL=index.js.map

package/dist/ibmi-mcp-server/tools/generateSql/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ibmi-mcp-server/tools/generateSql/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/ibmi-mcp-server/tools/generateSql/logic.d.ts

@@ -1,64 +0,0 @@
-/**
- * @fileoverview Defines the core logic, schemas, and types for the `generate_sql` tool.
- * This module is the single source of truth for the tool's data contracts (Zod schemas)
- * and its pure business logic for generating SQL DDL statements from IBM i database objects.
- * @module src/mcp-server/tools/generateSql/logic
- * @see {@link src/mcp-server/tools/generateSql/registration.ts} for the handler and registration logic.
- */
-import { z } from "zod";
-/**
- * Zod schema defining the input parameters for the `generate_sql` tool.
- */
-export declare const GenerateSqlInputSchema: z.ZodObject<{
-    object_name: z.ZodString;
-    object_library: z.ZodDefault<z.ZodString>;
-    object_type: z.ZodDefault<z.ZodEnum<["ALIAS", "CONSTRAINT", "FUNCTION", "INDEX", "MASK", "PERMISSION", "PROCEDURE", "SCHEMA", "SEQUENCE", "TABLE", "TRIGGER", "TYPE", "VARIABLE", "VIEW", "XSR"]>>;
-}, "strip", z.ZodTypeAny, {
-    object_name: string;
-    object_library: string;
-    object_type: "ALIAS" | "CONSTRAINT" | "FUNCTION" | "INDEX" | "MASK" | "PERMISSION" | "PROCEDURE" | "SCHEMA" | "SEQUENCE" | "TABLE" | "TRIGGER" | "TYPE" | "VARIABLE" | "VIEW" | "XSR";
-}, {
-    object_name: string;
-    object_library?: string | undefined;
-    object_type?: "ALIAS" | "CONSTRAINT" | "FUNCTION" | "INDEX" | "MASK" | "PERMISSION" | "PROCEDURE" | "SCHEMA" | "SEQUENCE" | "TABLE" | "TRIGGER" | "TYPE" | "VARIABLE" | "VIEW" | "XSR" | undefined;
-}>;
-/**
- * Zod schema for the successful response of the `generate_sql` tool.
- * Contains the generated DDL along with metadata about the source object.
- */
-export declare const GenerateSqlOutputSchema: z.ZodObject<{
-    sql: z.ZodString;
-    object_name: z.ZodString;
-    object_library: z.ZodString;
-    object_type: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    object_name: string;
-    object_library: string;
-    object_type: string;
-    sql: string;
-}, {
-    object_name: string;
-    object_library: string;
-    object_type: string;
-    sql: string;
-}>;
-/**
- * TypeScript type inferred from the input schema.
- * Represents the validated parameters passed to the generate SQL logic.
- */
-export type GenerateSqlInput = z.infer<typeof GenerateSqlInputSchema>;
-/**
- * TypeScript type inferred from the output schema.
- * Represents the structured response returned by the generate SQL logic.
- */
-export type GenerateSqlOutput = z.infer<typeof GenerateSqlOutputSchema>;
-/**
- * Processes the core logic for the `generate_sql` tool.
- * This function calls the QSYS2.GENERATE_SQL procedure to generate DDL for IBM i database objects.
- *
- * @param params - The validated input parameters containing object details
- * @returns A promise resolving with the generated SQL DDL
- * @throws {McpError} If the SQL generation encounters an unrecoverable issue
- */
-export declare function generateSqlLogic(params: GenerateSqlInput): Promise<GenerateSqlOutput>;
-//# sourceMappingURL=logic.d.ts.map

package/dist/ibmi-mcp-server/tools/generateSql/logic.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"logic.d.ts","sourceRoot":"","sources":["../../../../src/ibmi-mcp-server/tools/generateSql/logic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA6BxB;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAsBe,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAkBc,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,iBAAiB,CAAC,CAuJ5B"}