@neverinfamous/postgres-mcp 1.0.1

package/dist/adapters/postgresql/schemas/text-search.d.ts

@@ -0,0 +1,83 @@
+/**
+ * postgres-mcp - Text Search Tool Schemas
+ *
+ * Input validation schemas for full-text search and pattern matching.
+ *
+ * NOTE: Some tools use the "Split Schema" pattern where a Base schema (without
+ * z.preprocess) is used for MCP inputSchema visibility, while the full schema
+ * (with preprocess) is used in the handler. This is because z.preprocess() can
+ * interfere with JSON Schema generation for direct MCP tool calls.
+ */
+import { z } from "zod";
+/**
+ * Preprocess text tool parameters to normalize common input patterns.
+ * Exported so tools can apply it in their handlers.
+ */
+export declare function preprocessTextParams(input: unknown): unknown;
+export declare const TextSearchSchemaBase: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    column: z.ZodOptional<z.ZodString>;
+    query: z.ZodString;
+    config: z.ZodOptional<z.ZodString>;
+    select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const TrigramSimilaritySchemaBase: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodString;
+    value: z.ZodString;
+    threshold: z.ZodOptional<z.ZodNumber>;
+    select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    where: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const RegexpMatchSchemaBase: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodString;
+    pattern: z.ZodString;
+    flags: z.ZodOptional<z.ZodString>;
+    select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    where: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const TextSearchSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    column: z.ZodOptional<z.ZodString>;
+    query: z.ZodString;
+    config: z.ZodOptional<z.ZodString>;
+    select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export declare const TrigramSimilaritySchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodString;
+    value: z.ZodString;
+    threshold: z.ZodOptional<z.ZodNumber>;
+    select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    where: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export declare const RegexpMatchSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodString;
+    pattern: z.ZodString;
+    flags: z.ZodOptional<z.ZodString>;
+    select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    where: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+//# sourceMappingURL=text-search.d.ts.map

package/dist/adapters/postgresql/schemas/text-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-search.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/schemas/text-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAgD5D;AAMD,eAAO,MAAM,oBAAoB;;;;;;;;;;iBA0B7B,CAAC;AAEL,eAAO,MAAM,2BAA2B;;;;;;;;;;iBAsBpC,CAAC;AAEL,eAAO,MAAM,qBAAqB;;;;;;;;;;iBAc9B,CAAC;AAML,eAAO,MAAM,gBAAgB;;;;;;;;;;kBAG5B,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;kBAGnC,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;kBAG7B,CAAC"}

package/dist/adapters/postgresql/schemas/text-search.js

@@ -0,0 +1,132 @@
+/**
+ * postgres-mcp - Text Search Tool Schemas
+ *
+ * Input validation schemas for full-text search and pattern matching.
+ *
+ * NOTE: Some tools use the "Split Schema" pattern where a Base schema (without
+ * z.preprocess) is used for MCP inputSchema visibility, while the full schema
+ * (with preprocess) is used in the handler. This is because z.preprocess() can
+ * interfere with JSON Schema generation for direct MCP tool calls.
+ */
+import { z } from "zod";
+/**
+ * Preprocess text tool parameters to normalize common input patterns.
+ * Exported so tools can apply it in their handlers.
+ */
+export function preprocessTextParams(input) {
+    if (typeof input !== "object" || input === null) {
+        return input;
+    }
+    const result = { ...input };
+    // Alias: tableName → table
+    if (result["tableName"] !== undefined && result["table"] === undefined) {
+        result["table"] = result["tableName"];
+    }
+    // Alias: col → column
+    if (result["col"] !== undefined && result["column"] === undefined) {
+        result["column"] = result["col"];
+    }
+    // Alias: filter → where
+    if (result["filter"] !== undefined && result["where"] === undefined) {
+        result["where"] = result["filter"];
+    }
+    // Alias: text → value (for trigram/fuzzy tools)
+    if (result["text"] !== undefined && result["value"] === undefined) {
+        result["value"] = result["text"];
+    }
+    // Alias: indexName → name (for FTS index tool)
+    if (result["indexName"] !== undefined && result["name"] === undefined) {
+        result["name"] = result["indexName"];
+    }
+    // Alias: column (singular) → columns (array) for text search
+    if (result["column"] !== undefined &&
+        result["columns"] === undefined &&
+        typeof result["column"] === "string") {
+        result["columns"] = [result["column"]];
+    }
+    // Parse schema.table format (embedded schema takes priority)
+    if (typeof result["table"] === "string" && result["table"].includes(".")) {
+        const parts = result["table"].split(".");
+        if (parts.length === 2 && parts[0] && parts[1]) {
+            // Only override schema if not already explicitly set
+            if (result["schema"] === undefined) {
+                result["schema"] = parts[0];
+            }
+            result["table"] = parts[1];
+        }
+    }
+    return result;
+}
+// =============================================================================
+// Base Schemas (for MCP inputSchema visibility - no preprocess)
+// =============================================================================
+export const TextSearchSchemaBase = z
+    .object({
+    table: z.string().optional().describe("Table name"),
+    tableName: z.string().optional().describe("Table name (alias for table)"),
+    columns: z
+        .array(z.string())
+        .optional()
+        .describe("Text columns to search (array)"),
+    column: z
+        .string()
+        .optional()
+        .describe("Text column to search (singular, alias for columns)"),
+    query: z.string().describe("Search query"),
+    config: z
+        .string()
+        .optional()
+        .describe("Text search config (default: english)"),
+    select: z.array(z.string()).optional().describe("Columns to return"),
+    limit: z.number().optional().describe("Max results"),
+    schema: z.string().optional().describe("Schema name (default: public)"),
+})
+    .refine((data) => data.table !== undefined || data.tableName !== undefined, {
+    message: "Either 'table' or 'tableName' is required",
+})
+    .refine((data) => data.columns !== undefined || data.column !== undefined, {
+    message: "Either 'columns' (array) or 'column' (string) is required",
+});
+export const TrigramSimilaritySchemaBase = z
+    .object({
+    table: z.string().optional().describe("Table name"),
+    tableName: z.string().optional().describe("Table name (alias for table)"),
+    column: z.string().describe("Column to compare"),
+    value: z.string().describe("Value to compare against"),
+    threshold: z
+        .number()
+        .optional()
+        .describe("Similarity threshold (0-1, default 0.3; use 0.1-0.2 for partial matches)"),
+    select: z.array(z.string()).optional().describe("Columns to return"),
+    limit: z
+        .number()
+        .optional()
+        .describe("Max results (default: 100 to prevent large payloads)"),
+    where: z.string().optional().describe("Additional WHERE clause filter"),
+    schema: z.string().optional().describe("Schema name (default: public)"),
+})
+    .refine((data) => data.table !== undefined || data.tableName !== undefined, {
+    message: "Either 'table' or 'tableName' is required",
+});
+export const RegexpMatchSchemaBase = z
+    .object({
+    table: z.string().optional().describe("Table name"),
+    tableName: z.string().optional().describe("Table name (alias for table)"),
+    column: z.string().describe("Column to match"),
+    pattern: z.string().describe("POSIX regex pattern"),
+    flags: z.string().optional().describe("Regex flags (i, g, etc.)"),
+    select: z.array(z.string()).optional().describe("Columns to return"),
+    limit: z.number().optional().describe("Max results"),
+    where: z.string().optional().describe("Additional WHERE clause filter"),
+    schema: z.string().optional().describe("Schema name (default: public)"),
+})
+    .refine((data) => data.table !== undefined || data.tableName !== undefined, {
+    message: "Either 'table' or 'tableName' is required",
+});
+// =============================================================================
+// Full Schemas (with preprocess - for handler parsing)
+// =============================================================================
+export const TextSearchSchema = z.preprocess(preprocessTextParams, TextSearchSchemaBase);
+export const TrigramSimilaritySchema = z.preprocess(preprocessTextParams, TrigramSimilaritySchemaBase);
+export const RegexpMatchSchema = z.preprocess(preprocessTextParams, RegexpMatchSchemaBase);
+//# sourceMappingURL=text-search.js.map

package/dist/adapters/postgresql/schemas/text-search.js.map

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

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

@@ -0,0 +1,143 @@
+/**
+ * postgres-mcp - pgvector Tool Schemas
+ *
+ * Input validation schemas for vector similarity search.
+ * Supports parameter smoothing: col -> column, tableName -> table
+ */
+import { z } from "zod";
+/**
+ * Validates that an array contains only finite numbers (rejects Infinity, -Infinity, NaN).
+ * Provides clear error message instead of confusing "expected number, received number".
+ */
+export declare const FiniteNumberArray: z.ZodArray<z.ZodNumber>;
+export declare const VectorSearchSchemaBase: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    vector: z.ZodArray<z.ZodNumber>;
+    metric: z.ZodOptional<z.ZodEnum<{
+        l2: "l2";
+        cosine: "cosine";
+        inner_product: "inner_product";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    where: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+    excludeNull: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const VectorSearchSchema: z.ZodPipe<z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    vector: z.ZodArray<z.ZodNumber>;
+    metric: z.ZodOptional<z.ZodEnum<{
+        l2: "l2";
+        cosine: "cosine";
+        inner_product: "inner_product";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    where: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+    excludeNull: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodTransform<{
+    table: string;
+    column: string;
+    vector: number[];
+    metric: "l2" | "cosine" | "inner_product" | undefined;
+    limit: number | undefined;
+    select: string[] | undefined;
+    where: string | undefined;
+    schema: string | undefined;
+    excludeNull: boolean | undefined;
+}, {
+    vector: number[];
+    table?: string | undefined;
+    tableName?: string | undefined;
+    column?: string | undefined;
+    col?: string | undefined;
+    metric?: "l2" | "cosine" | "inner_product" | undefined;
+    limit?: number | undefined;
+    select?: string[] | undefined;
+    where?: string | undefined;
+    filter?: string | undefined;
+    schema?: string | undefined;
+    excludeNull?: boolean | undefined;
+}>>;
+export declare const VectorCreateIndexSchemaBase: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<{
+        ivfflat: "ivfflat";
+        hnsw: "hnsw";
+    }>>;
+    method: z.ZodOptional<z.ZodEnum<{
+        ivfflat: "ivfflat";
+        hnsw: "hnsw";
+    }>>;
+    metric: z.ZodOptional<z.ZodEnum<{
+        l2: "l2";
+        cosine: "cosine";
+        inner_product: "inner_product";
+    }>>;
+    ifNotExists: z.ZodOptional<z.ZodBoolean>;
+    lists: z.ZodOptional<z.ZodNumber>;
+    m: z.ZodOptional<z.ZodNumber>;
+    efConstruction: z.ZodOptional<z.ZodNumber>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const VectorCreateIndexSchema: z.ZodPipe<z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    column: z.ZodOptional<z.ZodString>;
+    col: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<{
+        ivfflat: "ivfflat";
+        hnsw: "hnsw";
+    }>>;
+    method: z.ZodOptional<z.ZodEnum<{
+        ivfflat: "ivfflat";
+        hnsw: "hnsw";
+    }>>;
+    metric: z.ZodOptional<z.ZodEnum<{
+        l2: "l2";
+        cosine: "cosine";
+        inner_product: "inner_product";
+    }>>;
+    ifNotExists: z.ZodOptional<z.ZodBoolean>;
+    lists: z.ZodOptional<z.ZodNumber>;
+    m: z.ZodOptional<z.ZodNumber>;
+    efConstruction: z.ZodOptional<z.ZodNumber>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodTransform<{
+    table: string;
+    column: string;
+    type: "ivfflat" | "hnsw";
+    metric: "l2" | "cosine" | "inner_product";
+    ifNotExists: boolean | undefined;
+    lists: number | undefined;
+    m: number | undefined;
+    efConstruction: number | undefined;
+    schema: string | undefined;
+}, {
+    table?: string | undefined;
+    tableName?: string | undefined;
+    column?: string | undefined;
+    col?: string | undefined;
+    type?: "ivfflat" | "hnsw" | undefined;
+    method?: "ivfflat" | "hnsw" | undefined;
+    metric?: "l2" | "cosine" | "inner_product" | undefined;
+    ifNotExists?: boolean | undefined;
+    lists?: number | undefined;
+    m?: number | undefined;
+    efConstruction?: number | undefined;
+    schema?: string | undefined;
+}>>;
+//# sourceMappingURL=vector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vector.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/schemas/vector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,iBAAiB,yBAgB1B,CAAC;AAGL,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;iBAsBjC,CAAC;AAGH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqB7B,CAAC;AAGH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;iBAsBtC,CAAC;AAGH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyBnC,CAAC"}

package/dist/adapters/postgresql/schemas/vector.js

@@ -0,0 +1,123 @@
+/**
+ * postgres-mcp - pgvector Tool Schemas
+ *
+ * Input validation schemas for vector similarity search.
+ * Supports parameter smoothing: col -> column, tableName -> table
+ */
+import { z } from "zod";
+/**
+ * Validates that an array contains only finite numbers (rejects Infinity, -Infinity, NaN).
+ * Provides clear error message instead of confusing "expected number, received number".
+ */
+export const FiniteNumberArray = z
+    .array(z.number())
+    .superRefine((arr, ctx) => {
+    const invalidIndexes = arr
+        .map((n, i) => (Number.isFinite(n) ? -1 : i))
+        .filter((i) => i >= 0);
+    if (invalidIndexes.length > 0) {
+        const invalidValues = invalidIndexes
+            .map((i) => String(arr[i]))
+            .join(", ");
+        ctx.addIssue({
+            code: "custom",
+            message: `Vector contains invalid values at index ${invalidIndexes.join(", ")}: ${invalidValues}. Only finite numbers are allowed (no Infinity or NaN).`,
+        });
+    }
+});
+// Base schema for MCP exposure (shows all accepted parameters)
+export const VectorSearchSchemaBase = z.object({
+    table: z.string().optional().describe("Table name"),
+    tableName: z.string().optional().describe("Alias for table"),
+    column: z.string().optional().describe("Vector column name"),
+    col: z.string().optional().describe("Alias for column"),
+    vector: FiniteNumberArray.describe("Query vector"),
+    metric: z
+        .enum(["l2", "cosine", "inner_product"])
+        .optional()
+        .describe("Distance metric"),
+    limit: z.number().optional().describe("Number of results"),
+    select: z
+        .array(z.string())
+        .optional()
+        .describe("Additional columns to return"),
+    where: z.string().optional().describe("Filter condition"),
+    filter: z.string().optional().describe("Alias for where"),
+    schema: z.string().optional().describe("Database schema (default: public)"),
+    excludeNull: z
+        .boolean()
+        .optional()
+        .describe("Exclude rows with NULL vectors (default: false)"),
+});
+// Transformed schema with alias resolution and schema.table parsing
+export const VectorSearchSchema = VectorSearchSchemaBase.transform((data) => {
+    // Parse schema.table format (embedded schema takes priority over explicit schema param)
+    let resolvedTable = data.table ?? data.tableName ?? "";
+    let resolvedSchema = data.schema;
+    if (resolvedTable.includes(".")) {
+        const parts = resolvedTable.split(".");
+        resolvedSchema = parts[0] ?? data.schema ?? "public";
+        resolvedTable = parts[1] ?? resolvedTable;
+    }
+    return {
+        table: resolvedTable,
+        column: data.column ?? data.col ?? "",
+        vector: data.vector,
+        metric: data.metric,
+        limit: data.limit,
+        select: data.select,
+        where: data.where ?? data.filter,
+        schema: resolvedSchema,
+        excludeNull: data.excludeNull,
+    };
+});
+// Base schema for MCP exposure
+export const VectorCreateIndexSchemaBase = z.object({
+    table: z.string().optional().describe("Table name"),
+    tableName: z.string().optional().describe("Alias for table"),
+    column: z.string().optional().describe("Vector column name"),
+    col: z.string().optional().describe("Alias for column"),
+    type: z.enum(["ivfflat", "hnsw"]).optional().describe("Index type"),
+    method: z.enum(["ivfflat", "hnsw"]).optional().describe("Alias for type"),
+    metric: z
+        .enum(["l2", "cosine", "inner_product"])
+        .optional()
+        .describe("Distance metric (default: l2)"),
+    ifNotExists: z
+        .boolean()
+        .optional()
+        .describe("Skip if index already exists (default: false)"),
+    lists: z.number().optional().describe("Number of lists for IVFFlat"),
+    m: z.number().optional().describe("HNSW m parameter"),
+    efConstruction: z
+        .number()
+        .optional()
+        .describe("HNSW ef_construction parameter"),
+    schema: z.string().optional().describe("Database schema (default: public)"),
+});
+// Transformed schema with alias resolution
+export const VectorCreateIndexSchema = VectorCreateIndexSchemaBase.transform((data) => {
+    // Resolve type from type or method alias
+    const resolvedType = data.type ?? data.method;
+    if (!resolvedType) {
+        throw new z.ZodError([
+            {
+                code: "custom",
+                path: [],
+                message: "type (or method alias) is required",
+            },
+        ]);
+    }
+    return {
+        table: data.table ?? data.tableName ?? "",
+        column: data.column ?? data.col ?? "",
+        type: resolvedType,
+        metric: data.metric ?? "l2",
+        ifNotExists: data.ifNotExists,
+        lists: data.lists,
+        m: data.m,
+        efConstruction: data.efConstruction,
+        schema: data.schema,
+    };
+});
+//# sourceMappingURL=vector.js.map

package/dist/adapters/postgresql/schemas/vector.js.map

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

package/dist/adapters/postgresql/tools/admin.d.ts

@@ -0,0 +1,13 @@
+/**
+ * PostgreSQL Admin Tools
+ *
+ * Database maintenance: VACUUM, ANALYZE, REINDEX, configuration.
+ * 10 tools total.
+ */
+import type { PostgresAdapter } from "../PostgresAdapter.js";
+import type { ToolDefinition } from "../../../types/index.js";
+/**
+ * Get all admin tools
+ */
+export declare function getAdminTools(adapter: PostgresAdapter): ToolDefinition[];
+//# sourceMappingURL=admin.d.ts.map

package/dist/adapters/postgresql/tools/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/tools/admin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,yBAAyB,CAAC;AAiB9E;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,EAAE,CAaxE"}