@neverinfamous/postgres-mcp 1.0.1

package/dist/types/schema.d.ts

@@ -0,0 +1,110 @@
+/**
+ * postgres-mcp - Schema Types
+ *
+ * Database schema metadata types for introspection.
+ */
+import type { TableInfo } from "./database.js";
+/**
+ * Schema information for a database
+ */
+export interface SchemaInfo {
+    tables: TableInfo[];
+    views?: TableInfo[];
+    materializedViews?: TableInfo[];
+    indexes?: IndexInfo[];
+    constraints?: ConstraintInfo[];
+    functions?: FunctionInfo[];
+    triggers?: TriggerInfo[];
+    sequences?: SequenceInfo[];
+    types?: CustomTypeInfo[];
+}
+/**
+ * Index information
+ */
+export interface IndexInfo {
+    name: string;
+    tableName: string;
+    schemaName?: string | undefined;
+    columns: string[];
+    unique: boolean;
+    type: "btree" | "hash" | "gist" | "gin" | "spgist" | "brin";
+    isPartial?: boolean | undefined;
+    predicate?: string | undefined;
+    sizeBytes?: number | undefined;
+    numberOfScans?: number | undefined;
+}
+/**
+ * Constraint information
+ */
+export interface ConstraintInfo {
+    name: string;
+    tableName: string;
+    schemaName?: string;
+    type: "primary_key" | "foreign_key" | "unique" | "check" | "exclusion";
+    columns: string[];
+    definition?: string;
+    referencedTable?: string;
+    referencedColumns?: string[];
+    onDelete?: "CASCADE" | "SET NULL" | "SET DEFAULT" | "RESTRICT" | "NO ACTION";
+    onUpdate?: "CASCADE" | "SET NULL" | "SET DEFAULT" | "RESTRICT" | "NO ACTION";
+    isDeferrable?: boolean;
+    isDeferred?: boolean;
+}
+/**
+ * Function/procedure information
+ */
+export interface FunctionInfo {
+    name: string;
+    schemaName?: string;
+    type: "FUNCTION" | "PROCEDURE" | "AGGREGATE" | "WINDOW";
+    language: string;
+    returnType?: string;
+    argumentTypes?: string[];
+    owner: string;
+    isStrict?: boolean;
+    securityDefiner?: boolean;
+    volatility?: "IMMUTABLE" | "STABLE" | "VOLATILE";
+}
+/**
+ * Trigger information
+ */
+export interface TriggerInfo {
+    name: string;
+    tableName: string;
+    schemaName?: string;
+    event: ("INSERT" | "UPDATE" | "DELETE" | "TRUNCATE")[];
+    timing: "BEFORE" | "AFTER" | "INSTEAD OF";
+    orientation: "ROW" | "STATEMENT";
+    functionName: string;
+    isEnabled: boolean;
+}
+/**
+ * Sequence information
+ */
+export interface SequenceInfo {
+    name: string;
+    schemaName?: string;
+    dataType: string;
+    startValue: bigint;
+    minValue: bigint;
+    maxValue: bigint;
+    increment: bigint;
+    cycled: boolean;
+    cacheSize: number;
+    lastValue?: bigint;
+    ownedBy?: string;
+}
+/**
+ * Custom type information
+ */
+export interface CustomTypeInfo {
+    name: string;
+    schemaName?: string;
+    type: "ENUM" | "COMPOSITE" | "DOMAIN" | "RANGE";
+    values?: string[];
+    attributes?: {
+        name: string;
+        type: string;
+    }[];
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/types/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/types/schema.ts"],"names":[],"mappings":"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"}

package/dist/types/schema.js

@@ -0,0 +1,7 @@
+/**
+ * postgres-mcp - Schema Types
+ *
+ * Database schema metadata types for introspection.
+ */
+export {};
+//# sourceMappingURL=schema.js.map

package/dist/types/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/types/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/utils/annotations.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Tool Annotations Presets
+ *
+ * Reusable annotation configurations for common tool behavior patterns.
+ * Used by all tool definition files for consistency.
+ */
+import type { ToolAnnotations } from "../types/index.js";
+/** Read-only query tools (SELECT, EXPLAIN, metadata retrieval) */
+export declare const READ_ONLY: ToolAnnotations;
+/** Standard write tools (INSERT, UPDATE, CREATE) */
+export declare const WRITE: ToolAnnotations;
+/** Destructive tools (DELETE, DROP, TRUNCATE) */
+export declare const DESTRUCTIVE: ToolAnnotations;
+/** Idempotent tools (CREATE IF NOT EXISTS, upserts) */
+export declare const IDEMPOTENT: ToolAnnotations;
+/** Admin/maintenance tools (VACUUM, ANALYZE, REINDEX) */
+export declare const ADMIN: ToolAnnotations;
+/**
+ * Create annotations with a custom title
+ */
+export declare function withTitle(title: string, base?: ToolAnnotations): ToolAnnotations;
+/**
+ * Create read-only annotations with title
+ */
+export declare function readOnly(title: string): ToolAnnotations;
+/**
+ * Create write annotations with title
+ */
+export declare function write(title: string): ToolAnnotations;
+/**
+ * Create destructive annotations with title
+ */
+export declare function destructive(title: string): ToolAnnotations;
+/**
+ * Create idempotent annotations with title
+ */
+export declare function idempotent(title: string): ToolAnnotations;
+/**
+ * Create admin annotations with title
+ */
+export declare function admin(title: string): ToolAnnotations;
+//# sourceMappingURL=annotations.d.ts.map

package/dist/utils/annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/utils/annotations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMzD,kEAAkE;AAClE,eAAO,MAAM,SAAS,EAAE,eAGvB,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,KAAK,EAAE,eAGnB,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,WAAW,EAAE,eAGzB,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,UAAU,EAAE,eAIxB,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,KAAK,EAAE,eAGnB,CAAC;AAMF;;GAEG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,eAA2B,GAChC,eAAe,CAEjB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAEvD;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAEpD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAE1D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAEzD;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAEpD"}

package/dist/utils/annotations.js

@@ -0,0 +1,75 @@
+/**
+ * Tool Annotations Presets
+ *
+ * Reusable annotation configurations for common tool behavior patterns.
+ * Used by all tool definition files for consistency.
+ */
+// =============================================================================
+// Base Annotation Presets
+// =============================================================================
+/** Read-only query tools (SELECT, EXPLAIN, metadata retrieval) */
+export const READ_ONLY = {
+    readOnlyHint: true,
+    destructiveHint: false,
+};
+/** Standard write tools (INSERT, UPDATE, CREATE) */
+export const WRITE = {
+    readOnlyHint: false,
+    destructiveHint: false,
+};
+/** Destructive tools (DELETE, DROP, TRUNCATE) */
+export const DESTRUCTIVE = {
+    readOnlyHint: false,
+    destructiveHint: true,
+};
+/** Idempotent tools (CREATE IF NOT EXISTS, upserts) */
+export const IDEMPOTENT = {
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: true,
+};
+/** Admin/maintenance tools (VACUUM, ANALYZE, REINDEX) */
+export const ADMIN = {
+    readOnlyHint: false,
+    destructiveHint: false,
+};
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Create annotations with a custom title
+ */
+export function withTitle(title, base = READ_ONLY) {
+    return { title, ...base };
+}
+/**
+ * Create read-only annotations with title
+ */
+export function readOnly(title) {
+    return { title, ...READ_ONLY };
+}
+/**
+ * Create write annotations with title
+ */
+export function write(title) {
+    return { title, ...WRITE };
+}
+/**
+ * Create destructive annotations with title
+ */
+export function destructive(title) {
+    return { title, ...DESTRUCTIVE };
+}
+/**
+ * Create idempotent annotations with title
+ */
+export function idempotent(title) {
+    return { title, ...IDEMPOTENT };
+}
+/**
+ * Create admin annotations with title
+ */
+export function admin(title) {
+    return { title, ...ADMIN };
+}
+//# sourceMappingURL=annotations.js.map

package/dist/utils/annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../../src/utils/annotations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF,kEAAkE;AAClE,MAAM,CAAC,MAAM,SAAS,GAAoB;IACxC,YAAY,EAAE,IAAI;IAClB,eAAe,EAAE,KAAK;CACvB,CAAC;AAEF,oDAAoD;AACpD,MAAM,CAAC,MAAM,KAAK,GAAoB;IACpC,YAAY,EAAE,KAAK;IACnB,eAAe,EAAE,KAAK;CACvB,CAAC;AAEF,iDAAiD;AACjD,MAAM,CAAC,MAAM,WAAW,GAAoB;IAC1C,YAAY,EAAE,KAAK;IACnB,eAAe,EAAE,IAAI;CACtB,CAAC;AAEF,uDAAuD;AACvD,MAAM,CAAC,MAAM,UAAU,GAAoB;IACzC,YAAY,EAAE,KAAK;IACnB,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,IAAI;CACrB,CAAC;AAEF,yDAAyD;AACzD,MAAM,CAAC,MAAM,KAAK,GAAoB;IACpC,YAAY,EAAE,KAAK;IACnB,eAAe,EAAE,KAAK;CACvB,CAAC;AAEF,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,KAAa,EACb,OAAwB,SAAS;IAEjC,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAO,EAAE,KAAK,EAAE,GAAG,SAAS,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,EAAE,KAAK,EAAE,GAAG,WAAW,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,EAAE,KAAK,EAAE,GAAG,UAAU,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC;AAC7B,CAAC"}

package/dist/utils/icons.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Tool Icons Utility
+ *
+ * Programmatic SVG icons for MCP tool categories with per-tool variants
+ * based on behavior annotations (destructive, admin, etc.).
+ */
+import type { ToolIcon, ToolGroup, ToolAnnotations } from "../types/index.js";
+/**
+ * Get appropriate icons for a tool based on its group and annotations.
+ *
+ * Priority:
+ * 1. Destructive tools → Warning icon
+ * 2. Admin tools (VACUUM, ANALYZE, REINDEX) → Admin gear icon
+ * 3. All other tools → Category-specific icon
+ */
+export declare function getToolIcons(group: ToolGroup, annotations?: ToolAnnotations): ToolIcon[];
+/**
+ * Get the category icon for a tool group (ignores behavior annotations)
+ */
+export declare function getCategoryIcon(group: ToolGroup): ToolIcon[];
+/**
+ * Get all category icons for documentation/discovery
+ */
+export declare function getAllCategoryIcons(): Record<ToolGroup, ToolIcon[]>;
+//# sourceMappingURL=icons.d.ts.map

package/dist/utils/icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/utils/icons.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAqL9E;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,EAChB,WAAW,CAAC,EAAE,eAAe,GAC5B,QAAQ,EAAE,CAkBZ;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,CAE5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,CAMnE"}

package/dist/utils/icons.js

@@ -0,0 +1,212 @@
+/**
+ * Tool Icons Utility
+ *
+ * Programmatic SVG icons for MCP tool categories with per-tool variants
+ * based on behavior annotations (destructive, admin, etc.).
+ */
+// =============================================================================
+// SVG Icon Generator
+// =============================================================================
+/**
+ * Create a base64-encoded SVG data URI
+ */
+function createSvgDataUri(pathContent, color) {
+    const svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="${color}" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">${pathContent}</svg>`;
+    // Use Buffer for Node.js base64 encoding
+    return `data:image/svg+xml;base64,${Buffer.from(svg).toString("base64")}`;
+}
+/** SVG path content and color for each tool category */
+const CATEGORY_ICONS = {
+    // Core: Database cylinder
+    core: {
+        path: '<ellipse cx="12" cy="5" rx="9" ry="3"/><path d="M3 5v14c0 1.66 4 3 9 3s9-1.34 9-3V5"/><path d="M3 12c0 1.66 4 3 9 3s9-1.34 9-3"/>',
+        color: "#3B82F6",
+    },
+    // Transactions: Circular arrows
+    transactions: {
+        path: '<path d="M21 12a9 9 0 1 1-9-9"/><path d="M21 3v9h-9"/>',
+        color: "#8B5CF6",
+    },
+    // JSONB: Curly braces
+    jsonb: {
+        path: '<path d="M8 3H7a2 2 0 0 0-2 2v5a2 2 0 0 1-2 2 2 2 0 0 1 2 2v5a2 2 0 0 0 2 2h1"/><path d="M16 3h1a2 2 0 0 1 2 2v5a2 2 0 0 0 2 2 2 2 0 0 0-2 2v5a2 2 0 0 1-2 2h-1"/>',
+        color: "#F59E0B",
+    },
+    // Text: Search magnifier with text
+    text: {
+        path: '<circle cx="11" cy="11" r="8"/><path d="m21 21-4.35-4.35"/><path d="M8 11h6"/>',
+        color: "#06B6D4",
+    },
+    // Performance: Gauge/speedometer
+    performance: {
+        path: '<path d="M12 2a10 10 0 1 0 10 10"/><path d="M12 12l5-5"/><circle cx="12" cy="12" r="2"/>',
+        color: "#10B981",
+    },
+    // Admin: Wrench
+    admin: {
+        path: '<path d="M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.77-3.77a6 6 0 0 1-7.94 7.94l-6.91 6.91a2.12 2.12 0 0 1-3-3l6.91-6.91a6 6 0 0 1 7.94-7.94l-3.76 3.76z"/>',
+        color: "#6B7280",
+    },
+    // Monitoring: Eye
+    monitoring: {
+        path: '<path d="M2 12s3-7 10-7 10 7 10 7-3 7-10 7-10-7-10-7Z"/><circle cx="12" cy="12" r="3"/>',
+        color: "#6366F1",
+    },
+    // Backup: Download/archive
+    backup: {
+        path: '<path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="7,10 12,15 17,10"/><line x1="12" y1="15" x2="12" y2="3"/>',
+        color: "#475569",
+    },
+    // Schema: Table grid
+    schema: {
+        path: '<rect x="3" y="3" width="18" height="18" rx="2" ry="2"/><line x1="3" y1="9" x2="21" y2="9"/><line x1="9" y1="21" x2="9" y2="9"/>',
+        color: "#14B8A6",
+    },
+    // Vector: 3D cube
+    vector: {
+        path: '<path d="M21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z"/><polyline points="3.27,6.96 12,12.01 20.73,6.96"/><line x1="12" y1="22.08" x2="12" y2="12"/>',
+        color: "#7C3AED",
+    },
+    // PostGIS: Globe
+    postgis: {
+        path: '<circle cx="12" cy="12" r="10"/><line x1="2" y1="12" x2="22" y2="12"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/>',
+        color: "#059669",
+    },
+    // Partitioning: Pie slices
+    partitioning: {
+        path: '<path d="M21.21 15.89A10 10 0 1 1 8 2.83"/><path d="M22 12A10 10 0 0 0 12 2v10z"/>',
+        color: "#F43F5E",
+    },
+    // Stats: Bar chart
+    stats: {
+        path: '<line x1="12" y1="20" x2="12" y2="10"/><line x1="18" y1="20" x2="18" y2="4"/><line x1="6" y1="20" x2="6" y2="16"/>',
+        color: "#0EA5E9",
+    },
+    // Cron: Clock
+    cron: {
+        path: '<circle cx="12" cy="12" r="10"/><polyline points="12,6 12,12 16,14"/>',
+        color: "#D97706",
+    },
+    // Partman: Calendar
+    partman: {
+        path: '<rect x="3" y="4" width="18" height="18" rx="2" ry="2"/><line x1="16" y1="2" x2="16" y2="6"/><line x1="8" y1="2" x2="8" y2="6"/><line x1="3" y1="10" x2="21" y2="10"/>',
+        color: "#C026D3",
+    },
+    // Kcache: CPU chip
+    kcache: {
+        path: '<rect x="4" y="4" width="16" height="16" rx="2" ry="2"/><rect x="9" y="9" width="6" height="6"/><line x1="9" y1="1" x2="9" y2="4"/><line x1="15" y1="1" x2="15" y2="4"/><line x1="9" y1="20" x2="9" y2="23"/><line x1="15" y1="20" x2="15" y2="23"/><line x1="20" y1="9" x2="23" y2="9"/><line x1="20" y1="14" x2="23" y2="14"/><line x1="1" y1="9" x2="4" y2="9"/><line x1="1" y1="14" x2="4" y2="14"/>',
+        color: "#EF4444",
+    },
+    // Citext: Aa letters
+    citext: {
+        path: '<path d="M3 21h4l3-9 3 9h4"/><path d="M14 21h4l1-3h-6l1 3z"/><path d="M7 9l3-6 3 6"/>',
+        color: "#84CC16",
+    },
+    // Ltree: Tree branches
+    ltree: {
+        path: '<path d="M8 19H5a2 2 0 0 1-2-2V7a2 2 0 0 1 2-2h3"/><path d="M16 5h3a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2h-3"/><line x1="12" y1="3" x2="12" y2="21"/>',
+        color: "#22C55E",
+    },
+    // Pgcrypto: Lock/shield
+    pgcrypto: {
+        path: '<rect x="3" y="11" width="18" height="11" rx="2" ry="2"/><path d="M7 11V7a5 5 0 0 1 10 0v4"/>',
+        color: "#EAB308",
+    },
+    // Codemode: Terminal/code
+    codemode: {
+        path: '<polyline points="4,17 10,11 4,5"/><line x1="12" y1="19" x2="20" y2="19"/>',
+        color: "#EC4899",
+    },
+};
+// =============================================================================
+// Special Behavior Icons
+// =============================================================================
+/** Warning icon for destructive operations (red triangle) */
+const WARNING_ICON_PATH = '<path d="M10.29 3.86L1.82 18a2 2 0 001.71 3h16.94a2 2 0 001.71-3L13.71 3.86a2 2 0 00-3.42 0z"/><line x1="12" y1="9" x2="12" y2="13"/><line x1="12" y1="17" x2="12.01" y2="17"/>';
+const WARNING_COLOR = "#EF4444";
+/** Admin icon for maintenance operations (gear) */
+const ADMIN_ICON_PATH = '<circle cx="12" cy="12" r="3"/><path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 0 1 0 2.83 2 2 0 0 1-2.83 0l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-2 2 2 2 0 0 1-2-2v-.09A1.65 1.65 0 0 0 9 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 0 1-2.83 0 2 2 0 0 1 0-2.83l.06-.06a1.65 1.65 0 0 0 .33-1.82 1.65 1.65 0 0 0-1.51-1H3a2 2 0 0 1-2-2 2 2 0 0 1 2-2h.09A1.65 1.65 0 0 0 4.6 9a1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 0 1 0-2.83 2 2 0 0 1 2.83 0l.06.06a1.65 1.65 0 0 0 1.82.33H9a1.65 1.65 0 0 0 1-1.51V3a2 2 0 0 1 2-2 2 2 0 0 1 2 2v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 0 1 2.83 0 2 2 0 0 1 0 2.83l-.06.06a1.65 1.65 0 0 0-.33 1.82V9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 0 1 2 2 2 2 0 0 1-2 2h-.09a1.65 1.65 0 0 0-1.51 1z"/>';
+const ADMIN_COLOR = "#F59E0B";
+// =============================================================================
+// Icon Builders
+// =============================================================================
+/**
+ * Create a ToolIcon array for standard category icons
+ */
+function createCategoryIcon(group) {
+    const { path, color } = CATEGORY_ICONS[group];
+    return [
+        {
+            src: createSvgDataUri(path, color),
+            mimeType: "image/svg+xml",
+            sizes: ["any"],
+        },
+    ];
+}
+/**
+ * Create a warning icon for destructive operations
+ */
+function createWarningIcon() {
+    return [
+        {
+            src: createSvgDataUri(WARNING_ICON_PATH, WARNING_COLOR),
+            mimeType: "image/svg+xml",
+            sizes: ["any"],
+        },
+    ];
+}
+/**
+ * Create an admin/maintenance icon
+ */
+function createAdminIcon() {
+    return [
+        {
+            src: createSvgDataUri(ADMIN_ICON_PATH, ADMIN_COLOR),
+            mimeType: "image/svg+xml",
+            sizes: ["any"],
+        },
+    ];
+}
+// =============================================================================
+// Public API
+// =============================================================================
+/**
+ * Get appropriate icons for a tool based on its group and annotations.
+ *
+ * Priority:
+ * 1. Destructive tools → Warning icon
+ * 2. Admin tools (VACUUM, ANALYZE, REINDEX) → Admin gear icon
+ * 3. All other tools → Category-specific icon
+ */
+export function getToolIcons(group, annotations) {
+    // Destructive operations get warning icon
+    if (annotations?.destructiveHint === true) {
+        return createWarningIcon();
+    }
+    // Admin/maintenance operations get gear icon
+    const title = annotations?.title?.toLowerCase() ?? "";
+    if (title.includes("vacuum") ||
+        title.includes("analyze") ||
+        title.includes("reindex")) {
+        return createAdminIcon();
+    }
+    // Default to category icon
+    return createCategoryIcon(group);
+}
+/**
+ * Get the category icon for a tool group (ignores behavior annotations)
+ */
+export function getCategoryIcon(group) {
+    return createCategoryIcon(group);
+}
+/**
+ * Get all category icons for documentation/discovery
+ */
+export function getAllCategoryIcons() {
+    const result = {};
+    for (const group of Object.keys(CATEGORY_ICONS)) {
+        result[group] = createCategoryIcon(group);
+    }
+    return result;
+}
+//# sourceMappingURL=icons.js.map

package/dist/utils/icons.js.map

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

package/dist/utils/identifiers.d.ts

@@ -0,0 +1,111 @@
+/**
+ * postgres-mcp - Identifier Sanitization Utilities
+ *
+ * Provides safe handling of PostgreSQL identifiers (table names, column names, schema names)
+ * to prevent SQL injection attacks via identifier interpolation.
+ *
+ * PostgreSQL identifier rules:
+ * - Must start with a letter (a-z) or underscore (_)
+ * - Can contain letters, digits (0-9), underscores, and dollar signs ($)
+ * - Maximum length: 63 bytes (NAMEDATALEN - 1)
+ * - Case-insensitive unless quoted
+ */
+/**
+ * Error thrown when an identifier is invalid
+ */
+export declare class InvalidIdentifierError extends Error {
+    readonly identifier: string;
+    readonly reason: string;
+    constructor(identifier: string, reason: string);
+}
+/**
+ * Validate a PostgreSQL identifier
+ *
+ * @param name - The identifier to validate
+ * @throws InvalidIdentifierError if the identifier is invalid
+ */
+export declare function validateIdentifier(name: string): void;
+/**
+ * Sanitize and quote a PostgreSQL identifier for safe use in SQL queries
+ *
+ * This function:
+ * 1. Validates the identifier against PostgreSQL naming rules
+ * 2. Escapes any embedded double quotes
+ * 3. Wraps the identifier in double quotes for safe interpolation
+ *
+ * @param name - The identifier to sanitize
+ * @returns The sanitized, double-quoted identifier
+ * @throws InvalidIdentifierError if the identifier is invalid
+ *
+ * @example
+ * sanitizeIdentifier('users') // Returns: "users"
+ * sanitizeIdentifier('my_table') // Returns: "my_table"
+ * sanitizeIdentifier('User"Data') // Throws: InvalidIdentifierError
+ */
+export declare function sanitizeIdentifier(name: string): string;
+/**
+ * Check if an identifier needs quoting (is a reserved keyword or has special characters)
+ *
+ * @param name - The identifier to check
+ * @returns True if the identifier needs quoting
+ */
+export declare function needsQuoting(name: string): boolean;
+/**
+ * Sanitize a schema-qualified table name
+ *
+ * @param table - The table name
+ * @param schema - Optional schema name (defaults to no schema prefix)
+ * @returns The sanitized, fully-qualified table reference
+ *
+ * @example
+ * sanitizeTableName('users') // Returns: "users"
+ * sanitizeTableName('users', 'public') // Returns: "public"."users"
+ */
+export declare function sanitizeTableName(table: string, schema?: string): string;
+/**
+ * Sanitize a column reference with optional table qualifier
+ *
+ * @param column - The column name
+ * @param table - Optional table name or alias
+ * @returns The sanitized column reference
+ *
+ * @example
+ * sanitizeColumnRef('id') // Returns: "id"
+ * sanitizeColumnRef('id', 'users') // Returns: "users"."id"
+ */
+export declare function sanitizeColumnRef(column: string, table?: string): string;
+/**
+ * Sanitize an array of identifiers
+ *
+ * @param names - Array of identifier names
+ * @returns Array of sanitized identifiers
+ */
+export declare function sanitizeIdentifiers(names: string[]): string[];
+/**
+ * Create a safe column list for SELECT statements
+ *
+ * @param columns - Array of column names
+ * @returns Comma-separated list of sanitized column names
+ *
+ * @example
+ * createColumnList(['id', 'name', 'email']) // Returns: "id", "name", "email"
+ */
+export declare function createColumnList(columns: string[]): string;
+/**
+ * Sanitize an index name
+ * PostgreSQL index names follow the same rules as identifiers
+ *
+ * @param name - The index name
+ * @returns The sanitized index name
+ */
+export declare function sanitizeIndexName(name: string): string;
+/**
+ * Generate a safe default index name from table and column names
+ *
+ * @param table - The table name
+ * @param columns - The column name(s)
+ * @param prefix - Optional prefix (default: 'idx')
+ * @returns A sanitized index name
+ */
+export declare function generateIndexName(table: string, columns: string | string[], prefix?: string): string;
+//# sourceMappingURL=identifiers.d.ts.map

package/dist/utils/identifiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifiers.d.ts","sourceRoot":"","sources":["../../src/utils/identifiers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAkGH;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;aAE7B,UAAU,EAAE,MAAM;aAClB,MAAM,EAAE,MAAM;gBADd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM;CAKjC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CA4BrD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOvD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAgBlD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CASxE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CASxE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAE7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAC1B,MAAM,SAAQ,GACb,MAAM,CAcR"}