@neverinfamous/mysql-mcp 2.1.0

package/dist/adapters/mysql/tools/json/core.js

@@ -0,0 +1,264 @@
+/**
+ * MySQL JSON Tools - Core Operations
+ *
+ * Basic JSON operations: extract, set, insert, replace, remove, contains, keys, array append.
+ * 8 tools total.
+ */
+import { JsonExtractSchema, JsonSetSchema, JsonContainsSchema, JsonKeysSchema } from '../../types.js';
+import { z } from 'zod';
+import { validateIdentifier, validateQualifiedIdentifier, validateWhereClause, escapeQualifiedTable } from '../../../../utils/validators.js';
+/**
+ * Export all core JSON tool creation functions
+ */
+function validateJsonString(value) {
+    if (typeof value === 'string') {
+        try {
+            JSON.parse(value);
+            return value;
+        }
+        catch {
+            throw new Error(`Invalid JSON value. To store a string/text, it must be quoted (e.g., '"my_string"'). Value provided: ${value}`);
+        }
+    }
+    return JSON.stringify(value);
+}
+export function createJsonExtractTool(adapter) {
+    return {
+        name: 'mysql_json_extract',
+        title: 'MySQL JSON Extract',
+        description: 'Extract values from JSON columns using JSON path expressions.',
+        group: 'json',
+        inputSchema: JsonExtractSchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (params, _context) => {
+            const { table, column, path, where } = JsonExtractSchema.parse(params);
+            // Validate inputs
+            validateQualifiedIdentifier(table, 'table');
+            validateIdentifier(column, 'column');
+            if (where) {
+                validateWhereClause(where);
+            }
+            let sql = `SELECT JSON_EXTRACT(\`${column}\`, ?) as extracted_value FROM ${escapeQualifiedTable(table)}`;
+            const queryParams = [path];
+            if (where) {
+                sql += ` WHERE ${where}`;
+            }
+            const result = await adapter.executeReadQuery(sql, queryParams);
+            return { rows: result.rows };
+        }
+    };
+}
+export function createJsonSetTool(adapter) {
+    return {
+        name: 'mysql_json_set',
+        title: 'MySQL JSON Set',
+        description: 'Set or update values in JSON columns at specified paths.',
+        group: 'json',
+        inputSchema: JsonSetSchema,
+        requiredScopes: ['write'],
+        annotations: {
+            readOnlyHint: false
+        },
+        handler: async (params, _context) => {
+            const { table, column, path, value, where } = JsonSetSchema.parse(params);
+            // Validate inputs
+            validateQualifiedIdentifier(table, 'table');
+            validateIdentifier(column, 'column');
+            validateWhereClause(where);
+            // Use CAST(? AS JSON) to ensure the value is interpreted as JSON, not as a raw string
+            const sql = `UPDATE ${escapeQualifiedTable(table)} SET \`${column}\` = JSON_SET(\`${column}\`, ?, CAST(? AS JSON)) WHERE ${where}`;
+            const jsonValue = validateJsonString(value);
+            const result = await adapter.executeWriteQuery(sql, [path, jsonValue]);
+            return { rowsAffected: result.rowsAffected };
+        }
+    };
+}
+export function createJsonInsertTool(adapter) {
+    const schema = z.object({
+        table: z.string(),
+        column: z.string(),
+        path: z.string(),
+        value: z.unknown(),
+        where: z.string()
+    });
+    return {
+        name: 'mysql_json_insert',
+        title: 'MySQL JSON Insert',
+        description: 'Insert values into JSON columns only if the path does not exist.',
+        group: 'json',
+        inputSchema: schema,
+        requiredScopes: ['write'],
+        annotations: {
+            readOnlyHint: false
+        },
+        handler: async (params, _context) => {
+            const { table, column, path, value, where } = schema.parse(params);
+            // Validate inputs
+            validateQualifiedIdentifier(table, 'table');
+            validateIdentifier(column, 'column');
+            validateWhereClause(where);
+            // Use CAST(? AS JSON) to ensure the value is interpreted as JSON, not as a raw string
+            const sql = `UPDATE ${escapeQualifiedTable(table)} SET \`${column}\` = JSON_INSERT(\`${column}\`, ?, CAST(? AS JSON)) WHERE ${where}`;
+            const jsonValue = validateJsonString(value);
+            const result = await adapter.executeWriteQuery(sql, [path, jsonValue]);
+            return { rowsAffected: result.rowsAffected };
+        }
+    };
+}
+export function createJsonReplaceTool(adapter) {
+    const schema = z.object({
+        table: z.string(),
+        column: z.string(),
+        path: z.string(),
+        value: z.unknown(),
+        where: z.string()
+    });
+    return {
+        name: 'mysql_json_replace',
+        title: 'MySQL JSON Replace',
+        description: 'Replace values in JSON columns only if the path exists.',
+        group: 'json',
+        inputSchema: schema,
+        requiredScopes: ['write'],
+        annotations: {
+            readOnlyHint: false
+        },
+        handler: async (params, _context) => {
+            const { table, column, path, value, where } = schema.parse(params);
+            // Validate inputs
+            validateQualifiedIdentifier(table, 'table');
+            validateIdentifier(column, 'column');
+            validateWhereClause(where);
+            // Use CAST(? AS JSON) to ensure the value is interpreted as JSON, not as a raw string
+            const sql = `UPDATE ${escapeQualifiedTable(table)} SET \`${column}\` = JSON_REPLACE(\`${column}\`, ?, CAST(? AS JSON)) WHERE ${where}`;
+            const jsonValue = validateJsonString(value);
+            const result = await adapter.executeWriteQuery(sql, [path, jsonValue]);
+            return { rowsAffected: result.rowsAffected };
+        }
+    };
+}
+export function createJsonRemoveTool(adapter) {
+    const schema = z.object({
+        table: z.string(),
+        column: z.string(),
+        paths: z.array(z.string()),
+        where: z.string()
+    });
+    return {
+        name: 'mysql_json_remove',
+        title: 'MySQL JSON Remove',
+        description: 'Remove values from JSON columns at specified paths.',
+        group: 'json',
+        inputSchema: schema,
+        requiredScopes: ['write'],
+        annotations: {
+            readOnlyHint: false
+        },
+        handler: async (params, _context) => {
+            const { table, column, paths, where } = schema.parse(params);
+            // Validate inputs
+            validateQualifiedIdentifier(table, 'table');
+            validateIdentifier(column, 'column');
+            validateWhereClause(where);
+            const pathPlaceholders = paths.map(() => '?').join(', ');
+            const sql = `UPDATE ${escapeQualifiedTable(table)} SET \`${column}\` = JSON_REMOVE(\`${column}\`, ${pathPlaceholders}) WHERE ${where}`;
+            const result = await adapter.executeWriteQuery(sql, paths);
+            return { rowsAffected: result.rowsAffected };
+        }
+    };
+}
+export function createJsonContainsTool(adapter) {
+    return {
+        name: 'mysql_json_contains',
+        title: 'MySQL JSON Contains',
+        description: 'Find rows where JSON column contains a specified value.',
+        group: 'json',
+        inputSchema: JsonContainsSchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (params, _context) => {
+            const { table, column, value, path } = JsonContainsSchema.parse(params);
+            // Validate inputs
+            validateQualifiedIdentifier(table, 'table');
+            validateIdentifier(column, 'column');
+            // JSON_CONTAINS expects the value to be a valid JSON document
+            // We ensure strict validation so that strings must be quoted (e.g. '"green"')
+            const jsonValue = validateJsonString(value);
+            let sql;
+            const queryParams = [jsonValue];
+            if (path) {
+                sql = `SELECT * FROM ${escapeQualifiedTable(table)} WHERE JSON_CONTAINS(\`${column}\`, ?, ?)`;
+                queryParams.push(path);
+            }
+            else {
+                sql = `SELECT * FROM ${escapeQualifiedTable(table)} WHERE JSON_CONTAINS(\`${column}\`, ?)`;
+            }
+            const result = await adapter.executeReadQuery(sql, queryParams);
+            return { rows: result.rows, count: result.rows?.length ?? 0 };
+        }
+    };
+}
+export function createJsonKeysTool(adapter) {
+    return {
+        name: 'mysql_json_keys',
+        title: 'MySQL JSON Keys',
+        description: 'Get the keys of a JSON object at the specified path.',
+        group: 'json',
+        inputSchema: JsonKeysSchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (params, _context) => {
+            const { table, column, path } = JsonKeysSchema.parse(params);
+            // Validate inputs
+            validateQualifiedIdentifier(table, 'table');
+            validateIdentifier(column, 'column');
+            const jsonPath = path ?? '$';
+            const sql = `SELECT JSON_KEYS(\`${column}\`, ?) as json_keys FROM ${escapeQualifiedTable(table)}`;
+            const result = await adapter.executeReadQuery(sql, [jsonPath]);
+            return { rows: result.rows };
+        }
+    };
+}
+export function createJsonArrayAppendTool(adapter) {
+    const schema = z.object({
+        table: z.string(),
+        column: z.string(),
+        path: z.string(),
+        value: z.unknown(),
+        where: z.string()
+    });
+    return {
+        name: 'mysql_json_array_append',
+        title: 'MySQL JSON Array Append',
+        description: 'Append a value to a JSON array at the specified path.',
+        group: 'json',
+        inputSchema: schema,
+        requiredScopes: ['write'],
+        annotations: {
+            readOnlyHint: false
+        },
+        handler: async (params, _context) => {
+            const { table, column, path, value, where } = schema.parse(params);
+            // Validate inputs
+            validateQualifiedIdentifier(table, 'table');
+            validateIdentifier(column, 'column');
+            validateWhereClause(where);
+            // Use CAST(? AS JSON) to ensure the value is interpreted as JSON, not as a raw string
+            const sql = `UPDATE ${escapeQualifiedTable(table)} SET \`${column}\` = JSON_ARRAY_APPEND(\`${column}\`, ?, CAST(? AS JSON)) WHERE ${where}`;
+            const jsonValue = validateJsonString(value);
+            const result = await adapter.executeWriteQuery(sql, [path, jsonValue]);
+            return { rowsAffected: result.rowsAffected };
+        }
+    };
+}
+//# sourceMappingURL=core.js.map

package/dist/adapters/mysql/tools/json/core.js.map

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

package/dist/adapters/mysql/tools/json/enhanced.d.ts

@@ -0,0 +1,14 @@
+/**
+ * MySQL JSON Tools - Enhanced Operations
+ *
+ * Advanced JSON tools: merge, diff, normalize, stats, index suggestions.
+ * 5 tools total.
+ */
+import type { MySQLAdapter } from '../../MySQLAdapter.js';
+import type { ToolDefinition } from '../../../../types/index.js';
+export declare function createJsonMergeTool(adapter: MySQLAdapter): ToolDefinition;
+export declare function createJsonDiffTool(adapter: MySQLAdapter): ToolDefinition;
+export declare function createJsonNormalizeTool(adapter: MySQLAdapter): ToolDefinition;
+export declare function createJsonStatsTool(adapter: MySQLAdapter): ToolDefinition;
+export declare function createJsonIndexSuggestTool(adapter: MySQLAdapter): ToolDefinition;
+//# sourceMappingURL=enhanced.d.ts.map

package/dist/adapters/mysql/tools/json/enhanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhanced.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/mysql/tools/json/enhanced.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,4BAA4B,CAAC;AA2CjF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CA0BzE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CA8CxE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CA8D7E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CA0DzE;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CA8FhF"}

package/dist/adapters/mysql/tools/json/enhanced.js

@@ -0,0 +1,305 @@
+/**
+ * MySQL JSON Tools - Enhanced Operations
+ *
+ * Advanced JSON tools: merge, diff, normalize, stats, index suggestions.
+ * 5 tools total.
+ */
+import { z } from 'zod';
+import { validateQualifiedIdentifier, escapeQualifiedTable, validateIdentifier } from '../../../../utils/validators.js';
+// =============================================================================
+// Schemas
+// =============================================================================
+const JsonMergeSchema = z.object({
+    json1: z.string().describe('First JSON document'),
+    json2: z.string().describe('Second JSON document'),
+    mode: z.enum(['patch', 'preserve']).default('patch').describe('Merge mode: patch (RFC 7396) or preserve (array merge)')
+});
+const JsonDiffSchema = z.object({
+    json1: z.string().describe('First JSON document'),
+    json2: z.string().describe('Second JSON document')
+});
+const JsonNormalizeSchema = z.object({
+    table: z.string().describe('Table name'),
+    column: z.string().describe('JSON column name'),
+    where: z.string().optional().describe('WHERE clause'),
+    limit: z.number().default(100).describe('Maximum rows to process')
+});
+const JsonStatsSchema = z.object({
+    table: z.string().describe('Table name'),
+    column: z.string().describe('JSON column name'),
+    where: z.string().optional().describe('Optional WHERE clause'),
+    sampleSize: z.number().default(1000).describe('Sample size for statistics')
+});
+const JsonIndexSuggestSchema = z.object({
+    table: z.string().describe('Table name'),
+    column: z.string().describe('JSON column name'),
+    sampleSize: z.number().default(100).describe('Sample size to analyze')
+});
+// =============================================================================
+// Tool Creation Functions
+// =============================================================================
+export function createJsonMergeTool(adapter) {
+    return {
+        name: 'mysql_json_merge',
+        title: 'MySQL JSON Merge',
+        description: 'Merge two JSON documents using JSON_MERGE_PATCH or JSON_MERGE_PRESERVE.',
+        group: 'json',
+        inputSchema: JsonMergeSchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (params, _context) => {
+            const { json1, json2, mode } = JsonMergeSchema.parse(params);
+            const mergeFunction = mode === 'patch' ? 'JSON_MERGE_PATCH' : 'JSON_MERGE_PRESERVE';
+            const sql = `SELECT ${mergeFunction}(?, ?) as merged`;
+            const result = await adapter.executeReadQuery(sql, [json1, json2]);
+            const merged = result.rows?.[0]?.['merged'];
+            return {
+                merged: typeof merged === 'string' ? JSON.parse(merged) : merged,
+                mode
+            };
+        }
+    };
+}
+export function createJsonDiffTool(adapter) {
+    return {
+        name: 'mysql_json_diff',
+        title: 'MySQL JSON Diff',
+        description: 'Compare two JSON documents and identify differences.',
+        group: 'json',
+        inputSchema: JsonDiffSchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (params, _context) => {
+            const { json1, json2 } = JsonDiffSchema.parse(params);
+            // MySQL doesn't have native JSON_DIFF, so we compare key-by-key
+            const sql = `
+                SELECT 
+                    JSON_CONTAINS(?, ?) as json1_contains_json2,
+                    JSON_CONTAINS(?, ?) as json2_contains_json1,
+                    CASE WHEN ? = ? THEN 1 ELSE 0 END as identical,
+                    JSON_LENGTH(?) as json1_length,
+                    JSON_LENGTH(?) as json2_length,
+                    JSON_KEYS(?) as json1_keys,
+                    JSON_KEYS(?) as json2_keys
+            `;
+            const result = await adapter.executeReadQuery(sql, [
+                json1, json2, json2, json1, json1, json2, json1, json2, json1, json2
+            ]);
+            const row = result.rows?.[0];
+            return {
+                identical: row?.['identical'] === 1,
+                json1ContainsJson2: row?.['json1_contains_json2'] === 1,
+                json2ContainsJson1: row?.['json2_contains_json1'] === 1,
+                json1Length: row?.['json1_length'],
+                json2Length: row?.['json2_length'],
+                json1Keys: typeof row?.['json1_keys'] === 'string'
+                    ? JSON.parse(row['json1_keys'])
+                    : row?.['json1_keys'],
+                json2Keys: typeof row?.['json2_keys'] === 'string'
+                    ? JSON.parse(row['json2_keys'])
+                    : row?.['json2_keys']
+            };
+        }
+    };
+}
+export function createJsonNormalizeTool(adapter) {
+    return {
+        name: 'mysql_json_normalize',
+        title: 'MySQL JSON Normalize',
+        description: 'Normalize JSON column structure by extracting all unique keys across documents.',
+        group: 'json',
+        inputSchema: JsonNormalizeSchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (params, _context) => {
+            const { table, column, where, limit } = JsonNormalizeSchema.parse(params);
+            // Validate identifiers
+            validateQualifiedIdentifier(table, 'table');
+            validateIdentifier(column, 'column');
+            const whereClause = where ? `WHERE ${where}` : '';
+            // Get all unique top-level keys
+            const keysQuery = `
+                SELECT DISTINCT jt.key_name
+                FROM ${escapeQualifiedTable(table)},
+                JSON_TABLE(
+                    JSON_KEYS(\`${column}\`),
+                    '$[*]' COLUMNS (key_name VARCHAR(255) PATH '$')
+                ) as jt
+                ${whereClause}
+                LIMIT ${String(limit)}
+            `;
+            const keysResult = await adapter.executeQuery(keysQuery);
+            const uniqueKeys = (keysResult.rows ?? []).map(r => (r)['key_name']);
+            // Get type distribution for each key
+            const keyStats = [];
+            for (const key of uniqueKeys.slice(0, 20)) { // Limit to 20 keys
+                const typeQuery = `
+                    SELECT 
+                        JSON_TYPE(JSON_EXTRACT(\`${column}\`, CONCAT('$.', ?))) as value_type,
+                        COUNT(*) as count
+                    FROM ${escapeQualifiedTable(table)}
+                    ${whereClause}
+                    GROUP BY value_type
+                `;
+                const typeResult = await adapter.executeQuery(typeQuery, [key]);
+                keyStats.push({
+                    key,
+                    types: typeResult.rows ?? []
+                });
+            }
+            return {
+                uniqueKeys,
+                keyCount: uniqueKeys.length,
+                keyStats,
+                truncated: uniqueKeys.length > 20
+            };
+        }
+    };
+}
+export function createJsonStatsTool(adapter) {
+    return {
+        name: 'mysql_json_stats',
+        title: 'MySQL JSON Stats',
+        description: 'Analyze statistics for a JSON column including depth, size, and key frequency.',
+        group: 'json',
+        inputSchema: JsonStatsSchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (params, _context) => {
+            const { table, column, where, sampleSize } = JsonStatsSchema.parse(params);
+            // Validate identifiers
+            validateQualifiedIdentifier(table, 'table');
+            validateIdentifier(column, 'column');
+            const whereClause = where ? `WHERE ${where}` : '';
+            const statsQuery = `
+                SELECT 
+                    COUNT(*) as total_rows,
+                    SUM(CASE WHEN \`${column}\` IS NULL THEN 1 ELSE 0 END) as null_count,
+                    AVG(JSON_LENGTH(\`${column}\`)) as avg_length,
+                    MAX(JSON_LENGTH(\`${column}\`)) as max_length,
+                    MIN(JSON_LENGTH(\`${column}\`)) as min_length,
+                    AVG(JSON_DEPTH(\`${column}\`)) as avg_depth,
+                    MAX(JSON_DEPTH(\`${column}\`)) as max_depth,
+                    AVG(LENGTH(\`${column}\`)) as avg_size_bytes,
+                    MAX(LENGTH(\`${column}\`)) as max_size_bytes
+                FROM (SELECT \`${column}\` FROM ${escapeQualifiedTable(table)} ${whereClause} LIMIT ${String(sampleSize)}) as sample
+            `;
+            const result = await adapter.executeQuery(statsQuery);
+            const row = result.rows?.[0];
+            return {
+                totalSampled: row?.['total_rows'],
+                nullCount: row?.['null_count'],
+                length: {
+                    avg: row?.['avg_length'],
+                    max: row?.['max_length'],
+                    min: row?.['min_length']
+                },
+                depth: {
+                    avg: row?.['avg_depth'],
+                    max: row?.['max_depth']
+                },
+                sizeBytes: {
+                    avg: row?.['avg_size_bytes'],
+                    max: row?.['max_size_bytes']
+                },
+                sampleSize
+            };
+        }
+    };
+}
+export function createJsonIndexSuggestTool(adapter) {
+    return {
+        name: 'mysql_json_index_suggest',
+        title: 'MySQL JSON Index Suggest',
+        description: 'Suggest functional indexes for frequently accessed JSON paths.',
+        group: 'json',
+        inputSchema: JsonIndexSuggestSchema,
+        requiredScopes: ['read'],
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        },
+        handler: async (params, _context) => {
+            const { table, column, sampleSize } = JsonIndexSuggestSchema.parse(params);
+            // Validate identifiers
+            validateQualifiedIdentifier(table, 'table');
+            validateIdentifier(column, 'column');
+            // Get top-level keys and their types
+            const keysQuery = `
+                SELECT DISTINCT jt.key_name
+                FROM ${escapeQualifiedTable(table)},
+                JSON_TABLE(
+                    JSON_KEYS(\`${column}\`),
+                    '$[*]' COLUMNS (key_name VARCHAR(255) PATH '$')
+                ) as jt
+                LIMIT ${String(sampleSize)}
+            `;
+            const keysResult = await adapter.executeQuery(keysQuery);
+            const keys = (keysResult.rows ?? []).map(r => (r)['key_name']);
+            // Check cardinality and suggest indexes
+            const suggestions = [];
+            for (const key of keys.slice(0, 10)) { // Analyze top 10 keys
+                // Use standard SQL structure for strict FULL_GROUP_BY compliance
+                const cardQuery = `
+                    SELECT 
+                        t.value_type,
+                        COUNT(DISTINCT t.val) as cardinality
+                    FROM (
+                        SELECT 
+                            JSON_TYPE(JSON_EXTRACT(\`sub\`.\`${column}\`, CONCAT('$.', ?))) as value_type,
+                            JSON_EXTRACT(\`sub\`.\`${column}\`, CONCAT('$.', ?)) as val
+                        FROM (
+                            SELECT \`${column}\` 
+                            FROM ${escapeQualifiedTable(table)} 
+                            LIMIT ${String(sampleSize)}
+                        ) as sub
+                        WHERE JSON_EXTRACT(\`sub\`.\`${column}\`, CONCAT('$.', ?)) IS NOT NULL
+                    ) as t
+                    GROUP BY t.value_type
+                    ORDER BY cardinality DESC
+                    LIMIT 1
+                `;
+                const cardResult = await adapter.executeQuery(cardQuery, [key, key, key]);
+                const cardRow = cardResult.rows?.[0];
+                const valueType = cardRow?.['value_type'];
+                const cardinality = Number(cardRow?.['cardinality'] ?? 0);
+                if (cardinality > 1) {
+                    let dataType = 'VARCHAR(255)';
+                    if (valueType === 'INTEGER')
+                        dataType = 'BIGINT';
+                    else if (valueType === 'DOUBLE')
+                        dataType = 'DOUBLE';
+                    else if (valueType === 'BOOLEAN')
+                        dataType = 'TINYINT(1)';
+                    suggestions.push({
+                        path: `$.${key}`,
+                        type: valueType ?? 'UNKNOWN',
+                        cardinality,
+                        indexDdl: `ALTER TABLE \`${table}\` ADD INDEX idx_${table}_${key} ((CAST(JSON_EXTRACT(\`${column}\`, '$.${key}') AS ${dataType})));`
+                    });
+                }
+            }
+            // Sort by cardinality (higher is better for indexing)
+            suggestions.sort((a, b) => b.cardinality - a.cardinality);
+            return {
+                table,
+                column,
+                suggestions: suggestions.slice(0, 5), // Top 5 suggestions
+                note: 'Indexes on high-cardinality paths provide the most benefit. Consider query patterns when creating indexes.'
+            };
+        }
+    };
+}
+//# sourceMappingURL=enhanced.js.map

package/dist/adapters/mysql/tools/json/enhanced.js.map

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

package/dist/adapters/mysql/tools/json/helpers.d.ts

@@ -0,0 +1,16 @@
+/**
+ * MySQL JSON Tools - Helper Functions
+ *
+ * Simplified JSON helper tools: get, update, search, validate.
+ * 4 tools total.
+ */
+import type { MySQLAdapter } from '../../MySQLAdapter.js';
+import type { ToolDefinition } from '../../../../types/index.js';
+/**
+ * Export all JSON helper tool creation functions
+ */
+export declare function createJsonGetTool(adapter: MySQLAdapter): ToolDefinition;
+export declare function createJsonUpdateTool(adapter: MySQLAdapter): ToolDefinition;
+export declare function createJsonSearchTool(adapter: MySQLAdapter): ToolDefinition;
+export declare function createJsonValidateTool(adapter: MySQLAdapter): ToolDefinition;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/adapters/mysql/tools/json/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/mysql/tools/json/helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,4BAA4B,CAAC;AAKjF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CAiCvE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CAmC1E;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CAwB1E;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CAsB5E"}