@neverinfamous/postgres-mcp 2.0.0 → 2.1.0

package/dist/adapters/postgresql/schemas/jsonb/basic.d.ts

@@ -0,0 +1,283 @@
+/**
+ * postgres-mcp - JSONB Tool Schemas
+ *
+ * Input validation schemas for JSONB operations.
+ *
+ * DUAL-SCHEMA PATTERN:
+ * Base schemas are exported for MCP (visible parameters).
+ * Preprocess functions are exported for handlers to normalize inputs.
+ * This ensures MCP clients see parameters while handlers get normalized data.
+ *
+ * PATH FORMAT NORMALIZATION:
+ * All tools now accept BOTH formats for paths:
+ * - STRING: 'a.b[0]' or 'a.b.0' (dot notation)
+ * - ARRAY: ['a', 'b', '0']
+ */
+import { z } from "zod";
+/**
+ * Convert a string path to array format
+ * 'a.b[0].c' → ['a', 'b', '0', 'c']
+ * 'a.b.0' → ['a', 'b', '0']
+ * '[-1]' → ['-1'] (supports negative indices)
+ */
+export declare function stringPathToArray(path: string): string[];
+/**
+ * Convert array path to string format for extract
+ * ['a', 'b', '0'] → 'a.b.0'
+ */
+export declare function arrayPathToString(path: string[]): string;
+/**
+ * Normalize path to array format (for set/insert handlers)
+ * Accepts both string paths and arrays with mixed string/number elements
+ */
+export declare function normalizePathToArray(path: string | number | (string | number)[]): string[];
+/**
+ * Normalize path for jsonb_insert - converts numeric path segments to numbers
+ * PostgreSQL jsonb_insert requires integer indices for array access
+ * 'tags.0' → ['tags', 0] (number, not string)
+ * 0 → [0] (bare number wrapped in array)
+ */
+export declare function normalizePathForInsert(path: string | number | (string | number)[]): (string | number)[];
+/**
+ * Normalize path to string format (for extract handler)
+ * Accepts both string paths and arrays with mixed string/number elements
+ */
+export declare function normalizePathToString(path: string | number | (string | number)[]): string;
+/**
+ * Parse JSON string values for JSONB value parameters
+ * MCP clients may send objects as JSON strings
+ */
+export declare function parseJsonbValue(value: unknown): unknown;
+/**
+ * Preprocess JSONB tool parameters to normalize common input patterns.
+ * Handles aliases and schema.table format parsing.
+ * Exported so tools can apply it in their handlers.
+ *
+ * SPLIT SCHEMA PATTERN:
+ * - Base schemas use optional table/tableName with .refine() for MCP visibility
+ * - Handlers use z.preprocess(preprocessJsonbParams, BaseSchema) for alias resolution
+ */
+export declare function preprocessJsonbParams(input: unknown): unknown;
+export declare const JsonbExtractSchemaBase: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>>;
+    select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    where: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodAny>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const JsonbExtractSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>>;
+    select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    where: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodAny>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export declare const JsonbSetSchemaBase: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>>;
+    value: z.ZodUnknown;
+    where: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    createMissing: z.ZodOptional<z.ZodBoolean>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const JsonbSetSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>>;
+    value: z.ZodUnknown;
+    where: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    createMissing: z.ZodOptional<z.ZodBoolean>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export declare const JsonbContainsSchemaBase: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    value: z.ZodOptional<z.ZodUnknown>;
+    contains: z.ZodOptional<z.ZodUnknown>;
+    select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    where: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodAny>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const JsonbContainsSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    value: z.ZodOptional<z.ZodUnknown>;
+    contains: z.ZodOptional<z.ZodUnknown>;
+    select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    where: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodAny>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export declare const JsonbPathQuerySchemaBase: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    vars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    where: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodAny>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const JsonbPathQuerySchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    vars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    where: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodAny>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export declare const JsonbInsertSchemaBase: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>>;
+    value: z.ZodUnknown;
+    where: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    insertAfter: z.ZodOptional<z.ZodBoolean>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const JsonbInsertSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>>;
+    value: z.ZodUnknown;
+    where: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    insertAfter: z.ZodOptional<z.ZodBoolean>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export declare const JsonbDeleteSchemaBase: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>>;
+    where: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const JsonbDeleteSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>>;
+    where: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export declare const JsonbTypeofSchemaBase: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>>;
+    where: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const JsonbTypeofSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>>;
+    where: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export declare const JsonbKeysSchemaBase: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    where: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const JsonbKeysSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    where: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export declare const JsonbStripNullsSchemaBase: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    where: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    preview: z.ZodOptional<z.ZodBoolean>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const JsonbStripNullsSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    where: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    preview: z.ZodOptional<z.ZodBoolean>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export declare const JsonbAggSchemaBase: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    where: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    groupBy: z.ZodOptional<z.ZodString>;
+    orderBy: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodAny>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const JsonbAggSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    where: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    groupBy: z.ZodOptional<z.ZodString>;
+    orderBy: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodAny>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+//# sourceMappingURL=basic.d.ts.map

package/dist/adapters/postgresql/schemas/jsonb/basic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/schemas/jsonb/basic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAYxD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAC1C,MAAM,EAAE,CASV;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAC1C,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAcrB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAC1C,MAAM,CAQR;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CASvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAwC7D;AAID,eAAO,MAAM,sBAAsB;;;;;;;;;;;iBA2BjC,CAAC;AAeH,eAAO,MAAM,kBAAkB;;;;;;;;;;;kBAG9B,CAAC;AAIF,eAAO,MAAM,kBAAkB;;;;;;;;;;;iBAgC7B,CAAC;AAkBH,eAAO,MAAM,cAAc;;;;;;;;;;;kBAG1B,CAAC;AAIF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;iBA4BlC,CAAC;AAWH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;kBAG/B,CAAC;AAIF,eAAO,MAAM,wBAAwB;;;;;;;;;;;iBAwBnC,CAAC;AAeH,eAAO,MAAM,oBAAoB;;;;;;;;;;;kBAGhC,CAAC;AAIF,eAAO,MAAM,qBAAqB;;;;;;;;;;;iBAyBhC,CAAC;AAkBH,eAAO,MAAM,iBAAiB;;;;;;;;;;;kBAG7B,CAAC;AAIF,eAAO,MAAM,qBAAqB;;;;;;;;;iBAkBhC,CAAC;AAkBH,eAAO,MAAM,iBAAiB;;;;;;;;;kBAG7B,CAAC;AAIF,eAAO,MAAM,qBAAqB;;;;;;;;;iBAYhC,CAAC;AAWH,eAAO,MAAM,iBAAiB;;;;;;;;;kBAG7B,CAAC;AAIF,eAAO,MAAM,mBAAmB;;;;;;;;iBAQ9B,CAAC;AAWH,eAAO,MAAM,eAAe;;;;;;;;kBAG3B,CAAC;AAIF,eAAO,MAAM,yBAAyB;;;;;;;;;iBAYpC,CAAC;AAWH,eAAO,MAAM,qBAAqB;;;;;;;;;kBAGjC,CAAC;AAIF,eAAO,MAAM,kBAAkB;;;;;;;;;;iBAuB7B,CAAC;AASH,eAAO,MAAM,cAAc;;;;;;;;;;kBAG1B,CAAC"}