@neverinfamous/postgres-mcp 2.0.0 → 2.2.0

package/dist/adapters/postgresql/tools/jsonb/analytics.js

@@ -0,0 +1,367 @@
+/**
+ * PostgreSQL JSONB Tools - Analytics Operations
+ *
+ * JSONB analytics tools: index suggestions, security scanning, and statistics.
+ */
+import { readOnly } from "../../../../utils/annotations.js";
+import { getToolIcons } from "../../../../utils/icons.js";
+import { formatPostgresError } from "../core/error-helpers.js";
+import { sanitizeWhereClause } from "../../../../utils/where-clause.js";
+import { sanitizeIdentifier, sanitizeTableName, } from "../../../../utils/identifiers.js";
+import { JsonbIndexSuggestOutputSchema, JsonbSecurityScanOutputSchema, JsonbStatsOutputSchema, JsonbStatsSchemaBase, JsonbIndexSuggestSchemaBase, JsonbSecurityScanSchemaBase, JsonbStatsSchema, JsonbIndexSuggestSchema, JsonbSecurityScanSchema, } from "../../schemas/index.js";
+/**
+ * Suggest JSONB indexes based on query patterns
+ */
+export function createJsonbIndexSuggestTool(adapter) {
+    return {
+        name: "pg_jsonb_index_suggest",
+        description: "Analyze JSONB column and suggest indexes. Only works on object-type JSONB (not arrays).",
+        group: "jsonb",
+        inputSchema: JsonbIndexSuggestSchemaBase,
+        outputSchema: JsonbIndexSuggestOutputSchema,
+        annotations: readOnly("JSONB Index Suggest"),
+        icons: getToolIcons("jsonb", readOnly("JSONB Index Suggest")),
+        handler: async (params, _context) => {
+            try {
+                // Parse with preprocess schema to resolve aliases (tableName→table, col→column, filter→where)
+                const parsed = JsonbIndexSuggestSchema.parse(params);
+                const table = parsed.table;
+                const column = parsed.column;
+                if (!table || !column) {
+                    return { success: false, error: "table and column are required" };
+                }
+                const rawSample = Number(parsed.sampleSize);
+                const sample = isNaN(rawSample) ? 1000 : rawSample;
+                const whereClause = parsed.where
+                    ? ` WHERE ${sanitizeWhereClause(parsed.where)}`
+                    : "";
+                // Validate schema existence for non-public schemas
+                const schemaName = parsed.schema ?? "public";
+                if (schemaName !== "public") {
+                    const schemaResult = await adapter.executeQuery(`SELECT 1 FROM information_schema.schemata WHERE schema_name = $1`, [schemaName]);
+                    if (!schemaResult.rows || schemaResult.rows.length === 0) {
+                        return {
+                            success: false,
+                            error: `Schema '${schemaName}' does not exist. Use pg_list_objects with type 'table' to see available schemas.`,
+                        };
+                    }
+                }
+                const tableName = sanitizeTableName(table, schemaName);
+                const columnName = sanitizeIdentifier(column);
+                const keySql = `
+                SELECT key, COUNT(*) as frequency,
+                       jsonb_typeof(value) as value_type
+                FROM (SELECT * FROM ${tableName}${whereClause} LIMIT ${String(sample)}) t,
+                     jsonb_each(${columnName})
+                GROUP BY key, jsonb_typeof(value)
+                ORDER BY frequency DESC
+                LIMIT 20
+            `;
+                const keyResult = await adapter.executeQuery(keySql);
+                const indexSql = `
+                SELECT indexname, indexdef
+                FROM pg_indexes
+                WHERE tablename = $1
+                AND indexdef LIKE '%' || $2 || '%'
+            `;
+                const indexResult = await adapter.executeQuery(indexSql, [
+                    parsed.table,
+                    parsed.column,
+                ]);
+                const recommendations = [];
+                const keys = (keyResult.rows ?? []).map((row) => ({
+                    key: row["key"],
+                    frequency: Number(row["frequency"]),
+                    value_type: row["value_type"],
+                }));
+                if ((indexResult.rows?.length ?? 0) === 0 && keys.length > 0) {
+                    recommendations.push(`CREATE INDEX ON ${tableName} USING GIN (${columnName})`);
+                }
+                for (const keyInfo of keys.slice(0, 5)) {
+                    if (keyInfo.frequency > sample * 0.5) {
+                        recommendations.push(`CREATE INDEX ON ${tableName} ((${columnName} ->> '${keyInfo.key.replace(/'/g, "''")}'))`);
+                    }
+                }
+                const response = {
+                    keyDistribution: keys,
+                    existingIndexes: indexResult.rows,
+                    recommendations,
+                };
+                if (recommendations.length === 0) {
+                    if ((indexResult.rows?.length ?? 0) > 0) {
+                        response.hint =
+                            "No new recommendations - existing indexes already cover this column";
+                    }
+                    else if (keys.length === 0) {
+                        response.hint =
+                            "No recommendations - table is empty or column has no keys to analyze";
+                    }
+                    else {
+                        response.hint =
+                            "No recommendations - no keys appeared in >50% of sampled rows";
+                    }
+                }
+                return response;
+            }
+            catch (error) {
+                if (error instanceof Error &&
+                    (error.message.includes("function jsonb_each") ||
+                        error.message.includes("cannot call jsonb_each"))) {
+                    return {
+                        success: false,
+                        error: `pg_jsonb_index_suggest requires JSONB objects (not arrays). Column may not be JSONB type or contains arrays.`,
+                    };
+                }
+                return {
+                    success: false,
+                    error: formatPostgresError(error, {
+                        tool: "pg_jsonb_index_suggest",
+                    }),
+                };
+            }
+        },
+    };
+}
+/**
+ * Scan JSONB for security issues
+ */
+export function createJsonbSecurityScanTool(adapter) {
+    return {
+        name: "pg_jsonb_security_scan",
+        description: "Scan JSONB for security issues. Only works on object-type JSONB (not arrays). Use larger sampleSize for thorough scans.",
+        group: "jsonb",
+        inputSchema: JsonbSecurityScanSchemaBase,
+        outputSchema: JsonbSecurityScanOutputSchema,
+        annotations: readOnly("JSONB Security Scan"),
+        icons: getToolIcons("jsonb", readOnly("JSONB Security Scan")),
+        handler: async (params, _context) => {
+            try {
+                // Parse with preprocess schema to resolve aliases (tableName→table, col→column, filter→where)
+                const parsed = JsonbSecurityScanSchema.parse(params);
+                const table = parsed.table;
+                const column = parsed.column;
+                if (!table || !column) {
+                    return { success: false, error: "table and column are required" };
+                }
+                const rawSample = Number(parsed.sampleSize);
+                const sample = isNaN(rawSample) ? 100 : rawSample;
+                const whereClause = parsed.where
+                    ? ` WHERE ${sanitizeWhereClause(parsed.where)}`
+                    : "";
+                const issues = [];
+                // Validate schema existence for non-public schemas
+                const schemaName = parsed.schema ?? "public";
+                if (schemaName !== "public") {
+                    const schemaResult = await adapter.executeQuery(`SELECT 1 FROM information_schema.schemata WHERE schema_name = $1`, [schemaName]);
+                    if (!schemaResult.rows || schemaResult.rows.length === 0) {
+                        return {
+                            success: false,
+                            error: `Schema '${schemaName}' does not exist. Use pg_list_objects with type 'table' to see available schemas.`,
+                        };
+                    }
+                }
+                const tableName = sanitizeTableName(table, schemaName);
+                const columnName = sanitizeIdentifier(column);
+                // Count actual rows scanned
+                const countSql = `SELECT COUNT(*) as count FROM (SELECT * FROM ${tableName}${whereClause} LIMIT ${String(sample)}) t`;
+                const countResult = await adapter.executeQuery(countSql);
+                const actualRowsScanned = Number(countResult.rows?.[0]?.["count"] ?? 0);
+                const sensitiveKeysSql = `
+                SELECT key, COUNT(*) as count
+                FROM (SELECT * FROM ${tableName}${whereClause} LIMIT ${String(sample)}) t,
+                     jsonb_each_text(${columnName})
+                WHERE lower(key) IN ('password', 'secret', 'token', 'api_key', 'apikey',
+                                     'auth', 'credential', 'ssn', 'credit_card', 'cvv')
+                GROUP BY key
+            `;
+                const sensitiveResult = await adapter.executeQuery(sensitiveKeysSql);
+                for (const row of (sensitiveResult.rows ?? [])) {
+                    issues.push({
+                        type: "sensitive_key",
+                        key: row.key,
+                        count: Number(row.count),
+                    });
+                }
+                const injectionSql = `
+                SELECT key, COUNT(*) as count
+                FROM (SELECT * FROM ${tableName}${whereClause} LIMIT ${String(sample)}) t,
+                     jsonb_each_text(${columnName})
+                WHERE value ~* '(\\bSELECT\\s+.+\\bFROM\\b|\\bINSERT\\s+INTO\\b|\\bUPDATE\\s+.+\\bSET\\b|\\bDELETE\\s+FROM\\b|\\bDROP\\s+(TABLE|DATABASE|INDEX)\\b|\\bUNION\\s+(ALL\\s+)?SELECT\\b|--\\s*$|;\\s*(SELECT|INSERT|UPDATE|DELETE))'
+                GROUP BY key
+            `;
+                const injectionResult = await adapter.executeQuery(injectionSql);
+                for (const row of (injectionResult.rows ?? [])) {
+                    issues.push({
+                        type: "sql_injection_pattern",
+                        key: row.key,
+                        count: Number(row.count),
+                    });
+                }
+                // XSS pattern detection
+                const xssSql = `
+                SELECT key, COUNT(*) as count
+                FROM (SELECT * FROM ${tableName}${whereClause} LIMIT ${String(sample)}) t,
+                     jsonb_each_text(${columnName})
+                WHERE value ~* '(<script|javascript:|on(click|load|error|mouseover)\\s*=|<iframe|<object|<embed|<svg[^>]+on|<img[^>]+onerror)'
+                GROUP BY key
+            `;
+                const xssResult = await adapter.executeQuery(xssSql);
+                for (const row of (xssResult.rows ?? [])) {
+                    issues.push({
+                        type: "xss_pattern",
+                        key: row.key,
+                        count: Number(row.count),
+                    });
+                }
+                return {
+                    scannedRows: actualRowsScanned,
+                    issues,
+                    riskLevel: issues.length === 0 ? "low" : issues.length < 3 ? "medium" : "high",
+                };
+            }
+            catch (error) {
+                if (error instanceof Error &&
+                    (error.message.includes("function jsonb_each") ||
+                        error.message.includes("cannot call jsonb_each"))) {
+                    return {
+                        success: false,
+                        error: `pg_jsonb_security_scan requires JSONB objects. Column may contain arrays or non-JSONB data.`,
+                    };
+                }
+                return {
+                    success: false,
+                    error: formatPostgresError(error, {
+                        tool: "pg_jsonb_security_scan",
+                    }),
+                };
+            }
+        },
+    };
+}
+/**
+ * Get JSONB column statistics
+ */
+export function createJsonbStatsTool(adapter) {
+    return {
+        name: "pg_jsonb_stats",
+        description: "Get statistics about JSONB column usage. Note: topKeys only applies to object-type JSONB, not arrays.",
+        group: "jsonb",
+        inputSchema: JsonbStatsSchemaBase,
+        outputSchema: JsonbStatsOutputSchema,
+        annotations: readOnly("JSONB Stats"),
+        icons: getToolIcons("jsonb", readOnly("JSONB Stats")),
+        handler: async (params, _context) => {
+            try {
+                // Parse with preprocess schema to resolve aliases (tableName→table, col→column, filter→where)
+                const parsed = JsonbStatsSchema.parse(params);
+                const table = parsed.table;
+                const column = parsed.column;
+                if (!table || !column) {
+                    return { success: false, error: "table and column are required" };
+                }
+                const rawSample = Number(parsed.sampleSize);
+                const sample = isNaN(rawSample) ? 1000 : rawSample;
+                const whereClause = parsed.where
+                    ? ` WHERE ${sanitizeWhereClause(parsed.where)}`
+                    : "";
+                // Validate schema existence for non-public schemas
+                const schemaName = parsed.schema ?? "public";
+                if (schemaName !== "public") {
+                    const schemaResult = await adapter.executeQuery(`SELECT 1 FROM information_schema.schemata WHERE schema_name = $1`, [schemaName]);
+                    if (!schemaResult.rows || schemaResult.rows.length === 0) {
+                        return {
+                            success: false,
+                            error: `Schema '${schemaName}' does not exist. Use pg_list_objects with type 'table' to see available schemas.`,
+                        };
+                    }
+                }
+                const tableName = sanitizeTableName(table, schemaName);
+                const columnName = sanitizeIdentifier(column);
+                const basicSql = `
+                SELECT
+                    COUNT(*) as total_rows,
+                    COUNT(${columnName}) as non_null_count,
+                    AVG(length(${columnName}::text))::int as avg_size_bytes,
+                    MAX(length(${columnName}::text)) as max_size_bytes
+                FROM (SELECT * FROM ${tableName}${whereClause} LIMIT ${String(sample)}) t
+            `;
+                const basicResult = await adapter.executeQuery(basicSql);
+                const basics = basicResult.rows?.[0];
+                const basicsNormalized = basics
+                    ? {
+                        total_rows: Number(basics["total_rows"]),
+                        non_null_count: Number(basics["non_null_count"]),
+                        avg_size_bytes: Number(basics["avg_size_bytes"]),
+                        max_size_bytes: Number(basics["max_size_bytes"]),
+                    }
+                    : undefined;
+                const rawKeyLimit = Number(parsed.topKeysLimit);
+                const keyLimit = isNaN(rawKeyLimit) ? 20 : rawKeyLimit;
+                const keySql = `
+                SELECT key, COUNT(*) as frequency
+                FROM (SELECT * FROM ${tableName}${whereClause} LIMIT ${String(sample)}) t,
+                     jsonb_object_keys(${columnName}) key
+                GROUP BY key
+                ORDER BY frequency DESC
+                LIMIT ${String(keyLimit)}
+            `;
+                let topKeys = [];
+                try {
+                    const keyResult = await adapter.executeQuery(keySql);
+                    topKeys = (keyResult.rows ?? []).map((row) => ({
+                        key: row["key"],
+                        frequency: Number(row["frequency"]),
+                    }));
+                }
+                catch (error) {
+                    // Gracefully handle array columns (jsonb_object_keys fails on arrays)
+                    if (error instanceof Error &&
+                        error.message.includes("cannot call jsonb_object_keys")) {
+                        // Leave topKeys empty for array columns - this is valid
+                    }
+                    else {
+                        throw error; // Re-throw to be caught by outer catch
+                    }
+                }
+                const typeSql = `
+                SELECT jsonb_typeof(${columnName}) as type, COUNT(*) as count
+                FROM (SELECT * FROM ${tableName}${whereClause} LIMIT ${String(sample)}) t
+                GROUP BY jsonb_typeof(${columnName})
+            `;
+                const typeResult = await adapter.executeQuery(typeSql);
+                const typeDistribution = (typeResult.rows ?? []).map((row) => ({
+                    type: row["type"],
+                    count: Number(row["count"]),
+                }));
+                const sqlNullCount = typeDistribution.find((t) => t.type === null)?.count ?? 0;
+                const hasNullColumns = sqlNullCount > 0;
+                const isArrayColumn = typeDistribution.some((t) => t.type === "array");
+                let hint;
+                if (hasNullColumns) {
+                    hint =
+                        "typeDistribution null type represents SQL NULL columns, not JSON null values";
+                }
+                else if (topKeys.length === 0 && isArrayColumn) {
+                    hint =
+                        'topKeys empty for array columns - use pg_jsonb_normalize mode: "array" to analyze elements';
+                }
+                return {
+                    basics: basicsNormalized,
+                    topKeys,
+                    typeDistribution,
+                    sqlNullCount,
+                    hint,
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: formatPostgresError(error, {
+                        tool: "pg_jsonb_stats",
+                    }),
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=analytics.js.map

package/dist/adapters/postgresql/tools/jsonb/analytics.js.map

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

package/dist/adapters/postgresql/tools/jsonb/index.d.ts

@@ -6,8 +6,10 @@
  */
 import type { PostgresAdapter } from "../../PostgresAdapter.js";
 import type { ToolDefinition } from "../../../../types/index.js";
-import { createJsonbExtractTool, createJsonbSetTool, createJsonbInsertTool, createJsonbDeleteTool, createJsonbContainsTool, createJsonbPathQueryTool, createJsonbAggTool, createJsonbObjectTool, createJsonbArrayTool, createJsonbKeysTool, createJsonbStripNullsTool, createJsonbTypeofTool } from "./basic.js";
-import { createJsonbValidatePathTool, createJsonbMergeTool, createJsonbNormalizeTool, createJsonbDiffTool, createJsonbIndexSuggestTool, createJsonbSecurityScanTool, createJsonbStatsTool } from "./advanced.js";
+import { createJsonbExtractTool, createJsonbContainsTool, createJsonbPathQueryTool, createJsonbAggTool, createJsonbKeysTool, createJsonbTypeofTool } from "./read.js";
+import { createJsonbSetTool, createJsonbInsertTool, createJsonbDeleteTool, createJsonbObjectTool, createJsonbArrayTool, createJsonbStripNullsTool } from "./write.js";
+import { createJsonbValidatePathTool, createJsonbMergeTool, createJsonbNormalizeTool, createJsonbDiffTool } from "./transform.js";
+import { createJsonbIndexSuggestTool, createJsonbSecurityScanTool, createJsonbStatsTool } from "./analytics.js";
 /**
  * Get all JSONB tools
  */

package/dist/adapters/postgresql/tools/jsonb/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/jsonb/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAGjE,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,2BAA2B,EAC3B,oBAAoB,EACrB,MAAM,eAAe,CAAC;AAEvB;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,EAAE,CAsBxE;AAGD,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,2BAA2B,EAC3B,oBAAoB,GACrB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/jsonb/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAGjE,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,oBAAoB,EACrB,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,EAAE,CAsBxE;AAGD,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,2BAA2B,EAC3B,oBAAoB,GACrB,CAAC"}

package/dist/adapters/postgresql/tools/jsonb/index.js

@@ -4,10 +4,14 @@
  * JSONB operations including path queries, containment, and aggregation.
  * 19 tools total.
  */
-// Basic JSONB operations
-import { createJsonbExtractTool, createJsonbSetTool, createJsonbInsertTool, createJsonbDeleteTool, createJsonbContainsTool, createJsonbPathQueryTool, createJsonbAggTool, createJsonbObjectTool, createJsonbArrayTool, createJsonbKeysTool, createJsonbStripNullsTool, createJsonbTypeofTool, } from "./basic.js";
-// Advanced JSONB operations
-import { createJsonbValidatePathTool, createJsonbMergeTool, createJsonbNormalizeTool, createJsonbDiffTool, createJsonbIndexSuggestTool, createJsonbSecurityScanTool, createJsonbStatsTool, } from "./advanced.js";
+// Read JSONB operations
+import { createJsonbExtractTool, createJsonbContainsTool, createJsonbPathQueryTool, createJsonbAggTool, createJsonbKeysTool, createJsonbTypeofTool, } from "./read.js";
+// Write JSONB operations
+import { createJsonbSetTool, createJsonbInsertTool, createJsonbDeleteTool, createJsonbObjectTool, createJsonbArrayTool, createJsonbStripNullsTool, } from "./write.js";
+// JSONB transform operations (validate path, merge, normalize, diff)
+import { createJsonbValidatePathTool, createJsonbMergeTool, createJsonbNormalizeTool, createJsonbDiffTool, } from "./transform.js";
+// JSONB analytics operations (index suggest, security scan, stats)
+import { createJsonbIndexSuggestTool, createJsonbSecurityScanTool, createJsonbStatsTool, } from "./analytics.js";
 /**
  * Get all JSONB tools
  */

package/dist/adapters/postgresql/tools/jsonb/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/jsonb/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,yBAAyB;AACzB,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAEpB,4BAA4B;AAC5B,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAEvB;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAwB;IACpD,OAAO;QACL,sBAAsB,CAAC,OAAO,CAAC;QAC/B,kBAAkB,CAAC,OAAO,CAAC;QAC3B,qBAAqB,CAAC,OAAO,CAAC;QAC9B,qBAAqB,CAAC,OAAO,CAAC;QAC9B,uBAAuB,CAAC,OAAO,CAAC;QAChC,wBAAwB,CAAC,OAAO,CAAC;QACjC,kBAAkB,CAAC,OAAO,CAAC;QAC3B,qBAAqB,CAAC,OAAO,CAAC;QAC9B,oBAAoB,CAAC,OAAO,CAAC;QAC7B,mBAAmB,CAAC,OAAO,CAAC;QAC5B,yBAAyB,CAAC,OAAO,CAAC;QAClC,qBAAqB,CAAC,OAAO,CAAC;QAC9B,2BAA2B,CAAC,OAAO,CAAC;QACpC,oBAAoB,CAAC,OAAO,CAAC;QAC7B,wBAAwB,CAAC,OAAO,CAAC;QACjC,mBAAmB,CAAC,OAAO,CAAC;QAC5B,2BAA2B,CAAC,OAAO,CAAC;QACpC,2BAA2B,CAAC,OAAO,CAAC;QACpC,oBAAoB,CAAC,OAAO,CAAC;KAC9B,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,2BAA2B,EAC3B,oBAAoB,GACrB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/jsonb/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,wBAAwB;AACxB,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAEnB,yBAAyB;AACzB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,qEAAqE;AACrE,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAExB,mEAAmE;AACnE,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAwB;IACpD,OAAO;QACL,sBAAsB,CAAC,OAAO,CAAC;QAC/B,kBAAkB,CAAC,OAAO,CAAC;QAC3B,qBAAqB,CAAC,OAAO,CAAC;QAC9B,qBAAqB,CAAC,OAAO,CAAC;QAC9B,uBAAuB,CAAC,OAAO,CAAC;QAChC,wBAAwB,CAAC,OAAO,CAAC;QACjC,kBAAkB,CAAC,OAAO,CAAC;QAC3B,qBAAqB,CAAC,OAAO,CAAC;QAC9B,oBAAoB,CAAC,OAAO,CAAC;QAC7B,mBAAmB,CAAC,OAAO,CAAC;QAC5B,yBAAyB,CAAC,OAAO,CAAC;QAClC,qBAAqB,CAAC,OAAO,CAAC;QAC9B,2BAA2B,CAAC,OAAO,CAAC;QACpC,oBAAoB,CAAC,OAAO,CAAC;QAC7B,wBAAwB,CAAC,OAAO,CAAC;QACjC,mBAAmB,CAAC,OAAO,CAAC;QAC5B,2BAA2B,CAAC,OAAO,CAAC;QACpC,2BAA2B,CAAC,OAAO,CAAC;QACpC,oBAAoB,CAAC,OAAO,CAAC;KAC9B,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,2BAA2B,EAC3B,oBAAoB,GACrB,CAAC"}

package/dist/adapters/postgresql/tools/jsonb/read.d.ts

@@ -0,0 +1,38 @@
+/**
+ * PostgreSQL JSONB Tools - Read Operations
+ *
+ * Read-only JSONB tools: extract, contains, pathQuery, agg, keys, typeof.
+ * Also exports shared utilities: toJsonString, resolveJsonbTable, parseSelectAlias.
+ */
+import type { PostgresAdapter } from "../../PostgresAdapter.js";
+import type { ToolDefinition } from "../../../../types/index.js";
+/**
+ * Convert value to a valid JSON string for PostgreSQL's ::jsonb cast
+ * Always uses JSON.stringify to ensure proper encoding
+ */
+export declare function toJsonString(value: unknown): string;
+/**
+ * Resolve table and schema for JSONB tools.
+ * Validates schema existence when non-public, returns schema-qualified table name.
+ * Returns [qualifiedTable, null] on success, or [null, errorResponse] on failure.
+ */
+export declare function resolveJsonbTable(adapter: PostgresAdapter, table: string, schema?: string): Promise<[string, null] | [null, {
+    success: false;
+    error: string;
+}]>;
+export declare function createJsonbExtractTool(adapter: PostgresAdapter): ToolDefinition;
+export declare function createJsonbContainsTool(adapter: PostgresAdapter): ToolDefinition;
+export declare function createJsonbPathQueryTool(adapter: PostgresAdapter): ToolDefinition;
+/**
+ * Parse a select expression and extract the alias if present.
+ * Handles: "column", "expression AS alias", "expression as alias"
+ * Returns: { expr: string, alias: string }
+ */
+export declare function parseSelectAlias(selectItem: string): {
+    expr: string;
+    alias: string;
+};
+export declare function createJsonbAggTool(adapter: PostgresAdapter): ToolDefinition;
+export declare function createJsonbKeysTool(adapter: PostgresAdapter): ToolDefinition;
+export declare function createJsonbTypeofTool(adapter: PostgresAdapter): ToolDefinition;
+//# sourceMappingURL=read.d.ts.map

package/dist/adapters/postgresql/tools/jsonb/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/jsonb/read.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,4BAA4B,CAAC;AAgCpC;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAmBrE;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,eAAe,GACvB,cAAc,CAwHhB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,GACvB,cAAc,CA6HhB;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,eAAe,GACvB,cAAc,CAkGhB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAiBA;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAwG3E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CA2D5E;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,eAAe,GACvB,cAAc,CAuDhB"}