@neverinfamous/postgres-mcp 1.0.1

package/dist/adapters/postgresql/schemas/extensions.d.ts

@@ -0,0 +1,403 @@
+/**
+ * postgres-mcp - Extension Tool Schemas
+ *
+ * Input validation schemas for PostgreSQL extensions:
+ * - pg_stat_kcache
+ * - citext
+ * - ltree
+ * - pgcrypto
+ */
+import { z } from "zod";
+/**
+ * Schema for querying enhanced statistics with kcache data.
+ * Joins pg_stat_statements with pg_stat_kcache for full picture.
+ */
+export declare const KcacheQueryStatsSchema: z.ZodPipe<z.ZodTransform<Record<string, unknown>, unknown>, z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    orderBy: z.ZodOptional<z.ZodEnum<{
+        total_time: "total_time";
+        cpu_time: "cpu_time";
+        reads: "reads";
+        writes: "writes";
+    }>>;
+    minCalls: z.ZodOptional<z.ZodNumber>;
+    queryPreviewLength: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+/**
+ * Schema for top resource consumers query.
+ */
+export declare const KcacheTopConsumersSchema: z.ZodObject<{
+    resource: z.ZodEnum<{
+        reads: "reads";
+        writes: "writes";
+        cpu: "cpu";
+        page_faults: "page_faults";
+    }>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Schema for database-level aggregation.
+ */
+export declare const KcacheDatabaseStatsSchema: z.ZodPipe<z.ZodTransform<Record<string, unknown>, unknown>, z.ZodObject<{
+    database: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+/**
+ * Schema for identifying resource-bound queries.
+ */
+export declare const KcacheResourceAnalysisSchema: z.ZodPipe<z.ZodTransform<Record<string, unknown>, unknown>, z.ZodObject<{
+    queryId: z.ZodOptional<z.ZodString>;
+    threshold: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    minCalls: z.ZodOptional<z.ZodNumber>;
+    queryPreviewLength: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+/**
+ * Base schema for MCP visibility (shows all parameters including aliases).
+ */
+export declare const CitextConvertColumnSchemaBase: z.ZodObject<{
+    table: z.ZodString;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Transformed schema for converting a text column to citext.
+ * Resolves aliases, parses schema.table format, and validates required fields.
+ */
+export declare const CitextConvertColumnSchema: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodString;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>, z.ZodTransform<{
+    table: string;
+    column: string;
+    schema: string | undefined;
+}, {
+    table: string;
+    column?: string | undefined;
+    col?: string | undefined;
+    schema?: string | undefined;
+}>>;
+/**
+ * Base schema for MCP visibility - shows all parameters for listColumns.
+ */
+export declare const CitextListColumnsSchemaBase: z.ZodObject<{
+    schema: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Schema for listing citext columns.
+ * Preprocesses to handle empty/null params.
+ */
+export declare const CitextListColumnsSchema: z.ZodPipe<z.ZodTransform<Record<string, unknown>, unknown>, z.ZodObject<{
+    schema: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+/**
+ * Base schema for MCP visibility - shows all parameters for analyzeCandidates.
+ */
+export declare const CitextAnalyzeCandidatesSchemaBase: z.ZodObject<{
+    patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    schema: z.ZodOptional<z.ZodString>;
+    table: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    excludeSystemSchemas: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Schema for analyzing candidate columns for citext conversion.
+ * Preprocesses to handle empty/null params.
+ */
+export declare const CitextAnalyzeCandidatesSchema: z.ZodPipe<z.ZodTransform<Record<string, unknown>, unknown>, z.ZodObject<{
+    patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    schema: z.ZodOptional<z.ZodString>;
+    table: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    excludeSystemSchemas: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>>;
+/**
+ * Base schema for MCP visibility (shows all parameters including aliases).
+ */
+export declare const CitextSchemaAdvisorSchemaBase: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Transformed schema for citext schema advisor tool.
+ * Resolves aliases, parses schema.table format, and validates required fields.
+ */
+export declare const CitextSchemaAdvisorSchema: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>, z.ZodTransform<{
+    table: string;
+    schema: string | undefined;
+}, {
+    table?: string | undefined;
+    tableName?: string | undefined;
+    schema?: string | undefined;
+}>>;
+/**
+ * Base schema for MCP visibility - shows all parameters including aliases.
+ */
+export declare const LtreeQuerySchemaBase: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    path: z.ZodString;
+    pattern: z.ZodOptional<z.ZodString>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        exact: "exact";
+        ancestors: "ancestors";
+        descendants: "descendants";
+    }>>;
+    type: z.ZodOptional<z.ZodEnum<{
+        exact: "exact";
+        ancestors: "ancestors";
+        descendants: "descendants";
+    }>>;
+    schema: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Base schema for MCP visibility - shows all parameters including aliases.
+ */
+export declare const LtreeSubpathSchemaBase: z.ZodObject<{
+    path: z.ZodString;
+    offset: z.ZodOptional<z.ZodNumber>;
+    start: z.ZodOptional<z.ZodNumber>;
+    from: z.ZodOptional<z.ZodNumber>;
+    length: z.ZodOptional<z.ZodNumber>;
+    len: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Base schema for MCP visibility - shows all parameters including aliases.
+ */
+export declare const LtreeMatchSchemaBase: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    pattern: z.ZodOptional<z.ZodString>;
+    query: z.ZodOptional<z.ZodString>;
+    lquery: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    maxResults: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Base schema for MCP visibility - shows all parameters including aliases.
+ */
+export declare const LtreeConvertColumnSchemaBase: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Base schema for MCP visibility - shows all parameters including aliases.
+ */
+export declare const LtreeIndexSchemaBase: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    indexName: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for querying ltree hierarchies (ancestors/descendants).
+ * Accepts 'pattern' as alias for 'path', 'type' as alias for 'mode', 'col'/'tableName'/'name' aliases.
+ */
+export declare const LtreeQuerySchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodString;
+    column: z.ZodString;
+    path: z.ZodString;
+    mode: z.ZodOptional<z.ZodEnum<{
+        exact: "exact";
+        ancestors: "ancestors";
+        descendants: "descendants";
+    }>>;
+    schema: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+/**
+ * Schema for extracting subpath from ltree.
+ * Accepts 'start'/'from' as alias for 'offset', 'len'/'end' as alias for 'length'.
+ */
+export declare const LtreeSubpathSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    path: z.ZodString;
+    offset: z.ZodNumber;
+    length: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+/**
+ * Schema for finding longest common ancestor.
+ */
+export declare const LtreeLcaSchema: z.ZodObject<{
+    paths: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for pattern matching with lquery.
+ * Accepts 'query'/'lquery' as aliases for 'pattern', 'maxResults' as alias for 'limit'.
+ */
+export declare const LtreeMatchSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodString;
+    column: z.ZodString;
+    pattern: z.ZodString;
+    schema: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+/**
+ * Schema for listing ltree columns in the database.
+ */
+export declare const LtreeListColumnsSchema: z.ZodPipe<z.ZodTransform<Record<string, unknown>, unknown>, z.ZodObject<{
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+/**
+ * Schema for converting a text column to ltree.
+ * Accepts 'tableName'/'name' as aliases for 'table', 'col' as alias for 'column'.
+ */
+export declare const LtreeConvertColumnSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodString;
+    column: z.ZodString;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+/**
+ * Schema for creating a GiST index on ltree column.
+ * Accepts 'tableName'/'name' as aliases for 'table', 'col' as alias for 'column'.
+ */
+export declare const LtreeIndexSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodString;
+    column: z.ZodString;
+    indexName: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+/**
+ * Schema for hashing data with digest().
+ */
+export declare const PgcryptoHashSchema: z.ZodObject<{
+    data: z.ZodString;
+    algorithm: z.ZodEnum<{
+        md5: "md5";
+        sha1: "sha1";
+        sha224: "sha224";
+        sha256: "sha256";
+        sha384: "sha384";
+        sha512: "sha512";
+    }>;
+    encoding: z.ZodOptional<z.ZodEnum<{
+        base64: "base64";
+        hex: "hex";
+    }>>;
+}, z.core.$strip>;
+/**
+ * Schema for HMAC authentication.
+ */
+export declare const PgcryptoHmacSchema: z.ZodObject<{
+    data: z.ZodString;
+    key: z.ZodString;
+    algorithm: z.ZodEnum<{
+        md5: "md5";
+        sha1: "sha1";
+        sha224: "sha224";
+        sha256: "sha256";
+        sha384: "sha384";
+        sha512: "sha512";
+    }>;
+    encoding: z.ZodOptional<z.ZodEnum<{
+        base64: "base64";
+        hex: "hex";
+    }>>;
+}, z.core.$strip>;
+/**
+ * Schema for PGP symmetric encryption.
+ * Accepts 'key' as alias for 'password'.
+ *
+ * Uses base schema for MCP exposure and transform schema for validation.
+ */
+export declare const PgcryptoEncryptSchemaBase: z.ZodObject<{
+    data: z.ZodString;
+    password: z.ZodOptional<z.ZodString>;
+    key: z.ZodOptional<z.ZodString>;
+    options: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const PgcryptoEncryptSchema: z.ZodPipe<z.ZodObject<{
+    data: z.ZodString;
+    password: z.ZodOptional<z.ZodString>;
+    key: z.ZodOptional<z.ZodString>;
+    options: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodTransform<{
+    password: string | undefined;
+    data: string;
+    key?: string | undefined;
+    options?: string | undefined;
+}, {
+    data: string;
+    password?: string | undefined;
+    key?: string | undefined;
+    options?: string | undefined;
+}>>;
+/**
+ * Schema for PGP symmetric decryption.
+ * Accepts 'data' as alias for 'encryptedData', 'key' as alias for 'password'.
+ *
+ * Uses base schema for MCP exposure and transform schema for validation.
+ */
+export declare const PgcryptoDecryptSchemaBase: z.ZodObject<{
+    encryptedData: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodString>;
+    password: z.ZodOptional<z.ZodString>;
+    key: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const PgcryptoDecryptSchema: z.ZodPipe<z.ZodObject<{
+    encryptedData: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodString>;
+    password: z.ZodOptional<z.ZodString>;
+    key: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodTransform<{
+    encryptedData: string | undefined;
+    password: string | undefined;
+}, {
+    encryptedData?: string | undefined;
+    data?: string | undefined;
+    password?: string | undefined;
+    key?: string | undefined;
+}>>;
+/**
+ * Schema for generating random bytes.
+ */
+export declare const PgcryptoRandomBytesSchema: z.ZodObject<{
+    length: z.ZodNumber;
+    encoding: z.ZodOptional<z.ZodEnum<{
+        base64: "base64";
+        hex: "hex";
+    }>>;
+}, z.core.$strip>;
+/**
+ * Schema for generating password salt.
+ */
+export declare const PgcryptoGenSaltSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        md5: "md5";
+        bf: "bf";
+        xdes: "xdes";
+        des: "des";
+    }>;
+    iterations: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Schema for password hashing with crypt().
+ */
+export declare const PgcryptoCryptSchema: z.ZodObject<{
+    password: z.ZodString;
+    salt: z.ZodString;
+}, z.core.$strip>;
+//# sourceMappingURL=extensions.d.ts.map

package/dist/adapters/postgresql/schemas/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/schemas/extensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;kBAmBlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;iBAQnC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB;;kBAQrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;;kBAuBxC,CAAC;AAqDF;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;;iBAKxC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;GASlC,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;iBAStC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;kBAGnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iCAAiC;;;;;;iBAsB5C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,6BAA6B;;;;;;kBAGzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;iBAIxC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;GAQlC,CAAC;AAiDL;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;iBAoB/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;iBAajC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;iBAe/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;;;iBAOvC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;iBAW/B,CAAC;AAMH;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;kBA6B5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;kBAyC9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc;;iBAKzB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;kBA0B5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB;;kBAQlC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;kBAOpC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;kBAW5B,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;iBAS7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;iBAU7B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;;;;;iBAQpC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;GAWhC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;;;;;iBAQpC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;GAgB9B,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;iBAUpC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;iBAQhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;iBAK9B,CAAC"}