@neverinfamous/postgres-mcp 1.0.1

package/dist/types/database.d.ts

@@ -0,0 +1,204 @@
+/**
+ * postgres-mcp - Database Types
+ *
+ * Core database configuration and query result types.
+ */
+/**
+ * Database type identifier (PostgreSQL only for this server)
+ */
+export type DatabaseType = "postgresql";
+/**
+ * PostgreSQL connection configuration
+ */
+export interface DatabaseConfig {
+    /** Database type identifier */
+    type: DatabaseType;
+    /** Connection string (postgres://user:pass@host:port/database) */
+    connectionString?: string;
+    /** Individual connection parameters (alternative to connectionString) */
+    host?: string;
+    port?: number;
+    database?: string;
+    username?: string;
+    password?: string;
+    /** Connection pool options */
+    pool?: PoolConfig;
+    /** Additional PostgreSQL-specific options */
+    options?: PostgresOptions;
+}
+/**
+ * PostgreSQL-specific connection options
+ */
+export interface PostgresOptions {
+    /** SSL configuration */
+    ssl?: boolean | {
+        ca?: string;
+        cert?: string;
+        key?: string;
+        rejectUnauthorized?: boolean;
+    };
+    /** Statement timeout in milliseconds */
+    statementTimeout?: number;
+    /** Query timeout in milliseconds */
+    queryTimeout?: number;
+    /** Connection timeout in milliseconds */
+    connectionTimeoutMillis?: number;
+    /** Idle connection timeout in milliseconds */
+    idleTimeoutMillis?: number;
+    /** Application name for pg_stat_activity */
+    applicationName?: string;
+    /** Search path (schema search order) */
+    searchPath?: string;
+    /** Enable prepared statement caching */
+    preparedStatements?: boolean;
+}
+/**
+ * Connection pool configuration
+ */
+export interface PoolConfig {
+    /** Maximum number of connections in pool (default: 10) */
+    max?: number;
+    /** Minimum number of connections in pool (default: 0) */
+    min?: number;
+    /** Connection acquire timeout in ms (default: 10000) */
+    acquireTimeoutMillis?: number;
+    /** Idle timeout before closing connection in ms (default: 10000) */
+    idleTimeoutMillis?: number;
+    /** Maximum connection lifetime in ms (default: unlimited) */
+    maxLifetimeMillis?: number;
+    /** Connection timeout in ms (default: 0 = unlimited) */
+    connectionTimeoutMillis?: number;
+    /** Allow exit on idle (default: true) */
+    allowExitOnIdle?: boolean;
+}
+/**
+ * Connection pool statistics
+ */
+export interface PoolStats {
+    /** Total connections in pool */
+    total: number;
+    /** Active connections (in use) */
+    active: number;
+    /** Idle connections (available) */
+    idle: number;
+    /** Waiting requests in queue */
+    waiting: number;
+    /** Total queries executed */
+    totalQueries: number;
+}
+/**
+ * Database connection health status
+ */
+export interface HealthStatus {
+    connected: boolean;
+    latencyMs?: number | undefined;
+    version?: string | undefined;
+    poolStats?: PoolStats | undefined;
+    details?: Record<string, unknown> | undefined;
+    error?: string | undefined;
+}
+/**
+ * Query execution result
+ */
+export interface QueryResult {
+    /** Rows returned (for SELECT queries) */
+    rows?: Record<string, unknown>[] | undefined;
+    /** Number of rows affected (for INSERT/UPDATE/DELETE) */
+    rowsAffected?: number | undefined;
+    /** Returned rows from RETURNING clause */
+    returning?: Record<string, unknown>[] | undefined;
+    /** Query execution time in milliseconds */
+    executionTimeMs?: number | undefined;
+    /** Column metadata */
+    columns?: ColumnInfo[] | undefined;
+    /** Field info from PostgreSQL */
+    fields?: FieldInfo[] | undefined;
+    /** Command type (SELECT, INSERT, etc.) */
+    command?: string | undefined;
+}
+/**
+ * Column metadata information
+ */
+export interface ColumnInfo {
+    name: string;
+    type: string;
+    nullable?: boolean | undefined;
+    /** Alias for !nullable - for consistency with createTable API */
+    notNull?: boolean | undefined;
+    primaryKey?: boolean | undefined;
+    defaultValue?: unknown;
+    isSerial?: boolean | undefined;
+    isGenerated?: boolean | undefined;
+    generatedExpression?: string | undefined;
+    characterMaxLength?: number | undefined;
+    numericPrecision?: number | undefined;
+    numericScale?: number | undefined;
+    arrayDimensions?: number | undefined;
+    comment?: string | undefined;
+    /** Foreign key reference for this column */
+    foreignKey?: {
+        table: string;
+        schema: string;
+        column: string;
+    } | undefined;
+}
+/**
+ * PostgreSQL field information from result set
+ */
+export interface FieldInfo {
+    name: string;
+    tableID: number;
+    columnID: number;
+    dataTypeID: number;
+    dataTypeSize: number;
+    dataTypeModifier: number;
+    format: string;
+}
+/**
+ * Table information
+ */
+export interface TableInfo {
+    name: string;
+    schema?: string | undefined;
+    type: "table" | "view" | "materialized_view" | "foreign_table" | "partitioned_table";
+    owner?: string | undefined;
+    rowCount?: number | undefined;
+    sizeBytes?: number | undefined;
+    totalSizeBytes?: number | undefined;
+    createTime?: Date | undefined;
+    comment?: string | undefined;
+    columns?: ColumnInfo[] | undefined;
+    isPartitioned?: boolean | undefined;
+    partitionKey?: string | undefined;
+    /** True if table statistics are stale (reltuples = -1, needs ANALYZE) */
+    statsStale?: boolean | undefined;
+    /** Primary key column(s) - convenience field extracted from constraints */
+    primaryKey?: string[] | null | undefined;
+    /** Table indexes */
+    indexes?: {
+        name: string;
+        type: string;
+        isUnique: boolean;
+        isPrimary: boolean;
+        columns: string[];
+        definition: string;
+    }[] | undefined;
+    /** Table constraints (PRIMARY KEY, CHECK, UNIQUE, EXCLUSION, NOT NULL) */
+    constraints?: {
+        name: string;
+        type: string;
+        definition: string;
+        columns?: string[];
+    }[] | undefined;
+    /** Foreign key relationships */
+    foreignKeys?: {
+        name: string;
+        column: string;
+        referencedTable: string;
+        referencedSchema: string;
+        referencedColumn: string;
+        onUpdate: string;
+        onDelete: string;
+    }[] | undefined;
+}
+//# sourceMappingURL=database.d.ts.map

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

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

package/dist/types/database.js

@@ -0,0 +1,7 @@
+/**
+ * postgres-mcp - Database Types
+ *
+ * Core database configuration and query result types.
+ */
+export {};
+//# sourceMappingURL=database.js.map

package/dist/types/database.js.map

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

package/dist/types/errors.d.ts

@@ -0,0 +1,62 @@
+/**
+ * postgres-mcp - Error Types
+ *
+ * Custom error classes for postgres-mcp operations.
+ */
+/**
+ * Base error class for postgres-mcp
+ */
+export declare class PostgresMcpError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, details?: Record<string, unknown> | undefined);
+}
+/**
+ * Database connection error
+ */
+export declare class ConnectionError extends PostgresMcpError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Connection pool error
+ */
+export declare class PoolError extends PostgresMcpError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Query execution error
+ */
+export declare class QueryError extends PostgresMcpError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Authentication error
+ */
+export declare class AuthenticationError extends PostgresMcpError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Authorization error (insufficient permissions)
+ */
+export declare class AuthorizationError extends PostgresMcpError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Validation error for input parameters
+ */
+export declare class ValidationError extends PostgresMcpError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Transaction error
+ */
+export declare class TransactionError extends PostgresMcpError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Extension not available error
+ */
+export declare class ExtensionNotAvailableError extends PostgresMcpError {
+    constructor(extensionName: string, details?: Record<string, unknown>);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;aAGvB,IAAI,EAAE,MAAM;aACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjD,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,gBAAgB;gBACvC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,gBAAgB;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,gBAAgB;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,gBAAgB;gBAC3C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,gBAAgB;gBAC1C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,gBAAgB;gBACvC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,gBAAgB;gBAClD,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQrE"}

package/dist/types/errors.js

@@ -0,0 +1,91 @@
+/**
+ * postgres-mcp - Error Types
+ *
+ * Custom error classes for postgres-mcp operations.
+ */
+/**
+ * Base error class for postgres-mcp
+ */
+export class PostgresMcpError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "PostgresMcpError";
+    }
+}
+/**
+ * Database connection error
+ */
+export class ConnectionError extends PostgresMcpError {
+    constructor(message, details) {
+        super(message, "CONNECTION_ERROR", details);
+        this.name = "ConnectionError";
+    }
+}
+/**
+ * Connection pool error
+ */
+export class PoolError extends PostgresMcpError {
+    constructor(message, details) {
+        super(message, "POOL_ERROR", details);
+        this.name = "PoolError";
+    }
+}
+/**
+ * Query execution error
+ */
+export class QueryError extends PostgresMcpError {
+    constructor(message, details) {
+        super(message, "QUERY_ERROR", details);
+        this.name = "QueryError";
+    }
+}
+/**
+ * Authentication error
+ */
+export class AuthenticationError extends PostgresMcpError {
+    constructor(message, details) {
+        super(message, "AUTHENTICATION_ERROR", details);
+        this.name = "AuthenticationError";
+    }
+}
+/**
+ * Authorization error (insufficient permissions)
+ */
+export class AuthorizationError extends PostgresMcpError {
+    constructor(message, details) {
+        super(message, "AUTHORIZATION_ERROR", details);
+        this.name = "AuthorizationError";
+    }
+}
+/**
+ * Validation error for input parameters
+ */
+export class ValidationError extends PostgresMcpError {
+    constructor(message, details) {
+        super(message, "VALIDATION_ERROR", details);
+        this.name = "ValidationError";
+    }
+}
+/**
+ * Transaction error
+ */
+export class TransactionError extends PostgresMcpError {
+    constructor(message, details) {
+        super(message, "TRANSACTION_ERROR", details);
+        this.name = "TransactionError";
+    }
+}
+/**
+ * Extension not available error
+ */
+export class ExtensionNotAvailableError extends PostgresMcpError {
+    constructor(extensionName, details) {
+        super(`Extension '${extensionName}' is not installed or enabled`, "EXTENSION_NOT_AVAILABLE", { extension: extensionName, ...details });
+        this.name = "ExtensionNotAvailableError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAGvB;IACA;IAHlB,YACE,OAAe,EACC,IAAY,EACZ,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAA0B;QAGjD,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,gBAAgB;IACnD,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,gBAAgB;IAC7C,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,gBAAgB;IAC9C,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,gBAAgB;IACvD,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,sBAAsB,EAAE,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,gBAAgB;IACtD,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,gBAAgB;IACnD,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,gBAAgB;IACpD,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,0BAA2B,SAAQ,gBAAgB;IAC9D,YAAY,aAAqB,EAAE,OAAiC;QAClE,KAAK,CACH,cAAc,aAAa,+BAA+B,EAC1D,yBAAyB,EACzB,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,OAAO,EAAE,CACzC,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF"}

package/dist/types/filtering.d.ts

@@ -0,0 +1,39 @@
+/**
+ * postgres-mcp - Tool Filtering Types
+ *
+ * Types for tool groups, meta-groups, and filtering configuration.
+ */
+/**
+ * Tool group identifiers for PostgreSQL
+ */
+export type ToolGroup = "core" | "transactions" | "jsonb" | "text" | "performance" | "admin" | "monitoring" | "backup" | "schema" | "vector" | "postgis" | "partitioning" | "stats" | "cron" | "partman" | "kcache" | "citext" | "ltree" | "pgcrypto" | "codemode";
+/**
+ * Meta-group identifiers for common multi-group selections
+ * These are shortcuts that expand to multiple ToolGroups
+ *
+ * STRICT LIMIT: All shortcuts must stay ≤50 tools
+ */
+export type MetaGroup = "starter" | "essential" | "dev-power" | "ai-data" | "ai-vector" | "dba-monitor" | "dba-manage" | "dba-stats" | "geo" | "base-core" | "base-ops" | "ext-ai" | "ext-geo" | "ext-schedule" | "ext-perf";
+/**
+ * Tool filter rule
+ */
+export interface ToolFilterRule {
+    /** Rule type: include or exclude */
+    type: "include" | "exclude";
+    /** Target: group name or tool name */
+    target: string;
+    /** Whether target is a group (true) or individual tool (false) */
+    isGroup: boolean;
+}
+/**
+ * Parsed tool filter configuration
+ */
+export interface ToolFilterConfig {
+    /** Original filter string */
+    raw: string;
+    /** Parsed rules in order */
+    rules: ToolFilterRule[];
+    /** Set of enabled tool names after applying rules */
+    enabledTools: Set<string>;
+}
+//# sourceMappingURL=filtering.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filtering.d.ts","sourceRoot":"","sources":["../../src/types/filtering.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,cAAc,GACd,OAAO,GACP,MAAM,GACN,aAAa,GACb,OAAO,GACP,YAAY,GACZ,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,cAAc,GACd,OAAO,GACP,MAAM,GACN,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,UAAU,GACV,UAAU,CAAC;AAEf;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAEjB,SAAS,GACT,WAAW,GACX,WAAW,GAEX,SAAS,GACT,WAAW,GAEX,aAAa,GACb,YAAY,GACZ,WAAW,GAEX,KAAK,GAEL,WAAW,GACX,UAAU,GAEV,QAAQ,GACR,SAAS,GACT,cAAc,GACd,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAE5B,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IAEf,kEAAkE;IAClE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAC;IAEZ,4BAA4B;IAC5B,KAAK,EAAE,cAAc,EAAE,CAAC;IAExB,qDAAqD;IACrD,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC3B"}

package/dist/types/filtering.js

@@ -0,0 +1,7 @@
+/**
+ * postgres-mcp - Tool Filtering Types
+ *
+ * Types for tool groups, meta-groups, and filtering configuration.
+ */
+export {};
+//# sourceMappingURL=filtering.js.map

package/dist/types/filtering.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * postgres-mcp - PostgreSQL MCP Server
+ *
+ * Core type definitions for the MCP server, database adapters,
+ * OAuth 2.0 authentication, and tool filtering.
+ *
+ * Re-exports all types from modular files.
+ */
+export type { DatabaseType, DatabaseConfig, PostgresOptions, PoolConfig, PoolStats, HealthStatus, QueryResult, ColumnInfo, FieldInfo, TableInfo, } from "./database.js";
+export type { SchemaInfo, IndexInfo, ConstraintInfo, FunctionInfo, TriggerInfo, SequenceInfo, CustomTypeInfo, } from "./schema.js";
+export type { TransportType, McpServerConfig } from "./mcp.js";
+export type { OAuthConfig, OAuthScope, TokenClaims, RequestContext, } from "./oauth.js";
+export type { ToolGroup, MetaGroup, ToolFilterRule, ToolFilterConfig, } from "./filtering.js";
+export type { AdapterCapabilities, ToolAnnotations, ToolIcon, ToolDefinition, ResourceDefinition, ResourceAnnotations, PromptDefinition, } from "./adapters.js";
+export { PostgresMcpError, ConnectionError, PoolError, QueryError, AuthenticationError, AuthorizationError, ValidationError, TransactionError, ExtensionNotAvailableError, } from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EACV,YAAY,EACZ,cAAc,EACd,eAAe,EACf,UAAU,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,SAAS,GACV,MAAM,eAAe,CAAC;AAGvB,YAAY,EACV,UAAU,EACV,SAAS,EACT,cAAc,EACd,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG/D,YAAY,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,SAAS,EACT,SAAS,EACT,cAAc,EACd,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,QAAQ,EACR,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,aAAa,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,11 @@
+/**
+ * postgres-mcp - PostgreSQL MCP Server
+ *
+ * Core type definitions for the MCP server, database adapters,
+ * OAuth 2.0 authentication, and tool filtering.
+ *
+ * Re-exports all types from modular files.
+ */
+// Error classes
+export { PostgresMcpError, ConnectionError, PoolError, QueryError, AuthenticationError, AuthorizationError, ValidationError, TransactionError, ExtensionNotAvailableError, } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAyDH,gBAAgB;AAChB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,aAAa,CAAC"}

package/dist/types/mcp.d.ts

@@ -0,0 +1,31 @@
+/**
+ * postgres-mcp - MCP Server Types
+ *
+ * MCP server configuration types.
+ */
+import type { DatabaseConfig } from "./database.js";
+import type { OAuthConfig } from "./oauth.js";
+/**
+ * Transport type for MCP communication
+ */
+export type TransportType = "stdio" | "http" | "sse";
+/**
+ * MCP Server configuration
+ */
+export interface McpServerConfig {
+    /** Server name */
+    name: string;
+    /** Server version */
+    version: string;
+    /** Transport configuration */
+    transport: TransportType;
+    /** HTTP port (for http/sse transports) */
+    port?: number;
+    /** Database configurations */
+    databases: DatabaseConfig[];
+    /** OAuth configuration */
+    oauth?: OAuthConfig;
+    /** Tool filtering configuration */
+    toolFilter?: string;
+}
+//# sourceMappingURL=mcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/types/mcp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IAEb,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAEhB,8BAA8B;IAC9B,SAAS,EAAE,aAAa,CAAC;IAEzB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,8BAA8B;IAC9B,SAAS,EAAE,cAAc,EAAE,CAAC;IAE5B,0BAA0B;IAC1B,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/mcp.js

@@ -0,0 +1,7 @@
+/**
+ * postgres-mcp - MCP Server Types
+ *
+ * MCP server configuration types.
+ */
+export {};
+//# sourceMappingURL=mcp.js.map

package/dist/types/mcp.js.map

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

package/dist/types/oauth.d.ts

@@ -0,0 +1,65 @@
+/**
+ * postgres-mcp - OAuth 2.0 Types
+ *
+ * OAuth 2.0/2.1 authentication and authorization types.
+ */
+/**
+ * OAuth 2.0 configuration
+ */
+export interface OAuthConfig {
+    /** Enable OAuth authentication */
+    enabled: boolean;
+    /** Authorization server URL */
+    authorizationServerUrl?: string;
+    /** Token validation endpoint */
+    tokenEndpoint?: string;
+    /** JWKS URI for token verification */
+    jwksUri?: string;
+    /** Expected audience in tokens */
+    audience?: string;
+    /** Expected issuer in tokens */
+    issuer?: string;
+    /** Clock tolerance for token validation (seconds) */
+    clockTolerance?: number;
+    /** JWKS cache TTL (seconds) */
+    jwksCacheTtl?: number;
+    /** Paths that bypass authentication */
+    publicPaths?: string[];
+}
+/**
+ * OAuth scopes for access control
+ */
+export type OAuthScope = "read" | "write" | "admin" | `db:${string}` | `schema:${string}` | `table:${string}:${string}`;
+/**
+ * Validated OAuth token claims
+ */
+export interface TokenClaims {
+    /** Subject (user ID) */
+    sub: string;
+    /** Granted scopes */
+    scopes: OAuthScope[];
+    /** Token expiration time */
+    exp: number;
+    /** Token issued at time */
+    iat: number;
+    /** Token issuer */
+    iss?: string;
+    /** Token audience */
+    aud?: string | string[];
+    /** Additional claims */
+    [key: string]: unknown;
+}
+/**
+ * Request context with authentication info
+ */
+export interface RequestContext {
+    /** Validated token claims (if authenticated) */
+    auth?: TokenClaims;
+    /** Raw access token */
+    accessToken?: string;
+    /** Request timestamp */
+    timestamp: Date;
+    /** Request ID for tracing */
+    requestId: string;
+}
+//# sourceMappingURL=oauth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../src/types/oauth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IAEjB,+BAA+B;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEhC,gCAAgC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,OAAO,GACP,OAAO,GACP,MAAM,MAAM,EAAE,GACd,UAAU,MAAM,EAAE,GAClB,SAAS,MAAM,IAAI,MAAM,EAAE,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IAEZ,qBAAqB;IACrB,MAAM,EAAE,UAAU,EAAE,CAAC;IAErB,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IAEZ,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;IAEZ,mBAAmB;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,qBAAqB;IACrB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,wBAAwB;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,IAAI,CAAC,EAAE,WAAW,CAAC;IAEnB,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,wBAAwB;IACxB,SAAS,EAAE,IAAI,CAAC;IAEhB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/oauth.js

@@ -0,0 +1,7 @@
+/**
+ * postgres-mcp - OAuth 2.0 Types
+ *
+ * OAuth 2.0/2.1 authentication and authorization types.
+ */
+export {};
+//# sourceMappingURL=oauth.js.map

package/dist/types/oauth.js.map

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