@calebmabry/postgres-mcp-server 2.0.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2025, abiswas97
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,203 @@
+# Postgres MCP Server
+
+[![npm version](https://badge.fury.io/js/@calebmabry%2Fpostgres-mcp-server.svg)](https://www.npmjs.com/package/@calebmabry/postgres-mcp-server)
+[![Tests](https://github.com/caleb-mabry/postgres-mcp/actions/workflows/test.yml/badge.svg)](https://github.com/caleb-mabry/postgres-mcp/actions/workflows/test.yml)
+[![GitHub issues](https://img.shields.io/github/issues/caleb-mabry/postgres-mcp)](https://github.com/caleb-mabry/postgres-mcp/issues)
+[![Documentation](https://img.shields.io/badge/docs-docusaurus-blue)](https://caleb-mabry.github.io/postgres-mcp/)
+
+A Model Context Protocol (MCP) server that provides secure database access to PostgreSQL through Kysely ORM. This server enables Claude Desktop to interact with PostgreSQL databases using natural language.
+
+## 📚 Documentation
+
+**Full documentation is available at: [caleb-mabry.github.io/postgres-mcp](https://caleb-mabry.github.io/postgres-mcp/)**
+
+## Features
+
+- **MCP Tools**: Query execution, table listing, schema inspection, and constraint information
+- **Type Safety**: Full TypeScript support with typed inputs/outputs
+- **Connection Pooling**: Configurable connection limits with idle timeout
+- **Error Handling**: Graceful error messages for connection and query issues
+- **Security**: Parameterized queries to prevent SQL injection
+
+## Quick Start
+
+### For Claude Desktop Users
+
+👉 **See [CLAUDE_SETUP.md](./CLAUDE_SETUP.md) for complete Claude Desktop setup instructions**
+
+### For HTTP/API Usage
+
+See [HTTP_SERVER.md](./HTTP_SERVER.md) for HTTP transport setup
+
+### Direct Installation
+
+```bash
+npx -y @calebmabry/postgres-mcp-server
+```
+
+## Configuration
+
+Create a `.env` file with your database credentials:
+
+```env
+DB_HOST=127.0.0.1
+DB_PORT=5432
+DB_USER=postgres
+DB_PASSWORD=your_password_here
+DB_NAME=postgres
+DB_SSL=true
+```
+
+## Available Tools
+
+| Tool                  | Description                                 | Required Parameters                 | Optional Parameters                                         |
+| --------------------- | ------------------------------------------- | ----------------------------------- | ----------------------------------------------------------- |
+| **`query`**           | Execute SQL queries with pagination support | `sql` (string)                      | `pageSize` (1-500), `offset` (number), `parameters` (array) |
+| **`describe_table`**  | Get table structure and column details      | `schema` (string), `table` (string) | -                                                           |
+| **`list_tables`**     | List all tables in a schema                 | `schema` (string)                   | -                                                           |
+| **`list_schemas`**    | List all schemas in the database            | -                                   | `includeSystemSchemas` (boolean)                            |
+| **`get_constraints`** | Get table constraints (PK, FK, etc.)        | `schema` (string), `table` (string) | -                                                           |
+| **`list_indexes`**    | List indexes for a table or schema          | `schema` (string)                   | `table` (string)                                            |
+| **`list_views`**      | List views in a schema                      | `schema` (string)                   | -                                                           |
+| **`list_functions`**  | List functions and procedures               | `schema` (string)                   | -                                                           |
+| **`explain_query`**   | Get query execution plan                    | `sql` (string)                      | `analyze` (boolean), `format` (text/json/xml/yaml)          |
+| **`get_table_stats`** | Get table size and statistics               | `schema` (string)                   | `table` (string)                                            |
+
+### Key Features
+
+- **Pagination**: Query tool supports up to 500 rows per page with automatic LIMIT/OFFSET handling
+- **Security**: Parameterized queries prevent SQL injection, READ_ONLY mode by default
+- **Type Safety**: Full TypeScript support with Zod schema validation
+
+## Client Configuration
+
+The postgres-mcp-server works with any MCP-compatible client. See configuration examples below:
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "postgres-mcp-server": {
+      "command": "npx",
+      "args": ["-y", "@calebmabry/postgres-mcp-server"],
+      "env": {
+        "DB_HOST": "127.0.0.1",
+        "DB_PORT": "5432",
+        "DB_USER": "postgres",
+        "DB_PASSWORD": "your_password_here",
+        "DB_NAME": "your_database_name",
+        "DB_SSL": "false",
+        "READ_ONLY": "true"
+      }
+    }
+  }
+}
+```
+
+**Config locations:**
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+See [claude_config_example.json](./claude_config_example.json) for a full example.
+
+### Cline (VS Code)
+
+Add to `.cline/mcp_settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "postgres-mcp-server": {
+      "command": "npx",
+      "args": ["-y", "@calebmabry/postgres-mcp-server"],
+      "env": {
+        "DB_HOST": "localhost",
+        "DB_NAME": "your_database",
+        "DB_USER": "postgres",
+        "DB_PASSWORD": "your_password"
+      }
+    }
+  }
+}
+```
+
+See [cline_mcp_settings_example.json](./cline_mcp_settings_example.json) for a full example.
+
+### Zed Editor
+
+Add to Zed settings (Settings → Context Servers):
+
+```json
+{
+  "context_servers": {
+    "postgres-mcp-server": {
+      "command": {
+        "path": "npx",
+        "args": ["-y", "@calebmabry/postgres-mcp-server"]
+      },
+      "settings": {
+        "DB_HOST": "localhost",
+        "DB_NAME": "your_database",
+        "DB_USER": "postgres",
+        "DB_PASSWORD": "your_password"
+      }
+    }
+  }
+}
+```
+
+See [zed_settings_example.json](./zed_settings_example.json) for a full example.
+
+### Docker
+
+Use the included Dockerfile or docker-compose.yml:
+
+```bash
+docker-compose up -d
+```
+
+See [docker-compose.example.yml](./docker-compose.example.yml) for a full example.
+
+## Development
+
+```bash
+# Clone and install dependencies
+git clone https://github.com/caleb-mabry/postgres-mcp.git
+cd postgres-mcp-server
+npm install
+
+# Run in development mode with hot reload
+npm run dev
+
+# Build for production
+npm run build
+
+# Run tests
+npm run test
+
+# Run specific test suites
+npm run test:unit
+npm run test:integration
+```
+
+## Environment Variables
+
+| Variable            | Default     | Description                             |
+| ------------------- | ----------- | --------------------------------------- |
+| `DB_HOST`           | `127.0.0.1` | PostgreSQL host                         |
+| `DB_PORT`           | `5432`      | PostgreSQL port                         |
+| `DB_USER`           | `postgres`  | Database user                           |
+| `DB_PASSWORD`       | _required_  | Database password                       |
+| `DB_NAME`           | `postgres`  | Database name                           |
+| `DB_SSL`            | `true`      | Enable SSL connection                   |
+| `READ_ONLY`         | `true`      | Restrict to SELECT/WITH/EXPLAIN queries |
+| `QUERY_TIMEOUT`     | `30000`     | Query timeout in milliseconds           |
+| `MAX_PAGE_SIZE`     | `500`       | Maximum rows per page                   |
+| `DEFAULT_PAGE_SIZE` | `100`       | Default page size when not specified    |
+
+## License
+
+ISC

package/dist/config.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Centralized configuration management for environment variables
+ */
+export interface AppConfig {
+    db: {
+        host: string;
+        port: number;
+        user: string;
+        password: string;
+        database: string;
+        maxConnections: number;
+        idleTimeoutMs: number;
+        connectionTimeoutMs: number;
+        queryTimeoutMs: number;
+        ssl: {
+            enabled: boolean;
+            rejectUnauthorized: boolean;
+            caCert?: string;
+            allowSelfSigned: boolean;
+        };
+    };
+    server: {
+        port: number;
+        allowedHosts?: string;
+    };
+    query: {
+        maxPageSize: number;
+        defaultPageSize: number;
+        autoLimit: boolean;
+        maxPayloadSize: number;
+    };
+    app: {
+        readOnly: boolean;
+        logLevel: "debug" | "info" | "warn" | "error";
+    };
+}
+/**
+ * Load and validate configuration from environment variables
+ * @param forceReload - Force reloading from environment variables (useful for tests)
+ */
+export declare function loadConfig(forceReload?: boolean): AppConfig;
+/**
+ * Singleton configuration instance
+ * Can be accessed directly for most use cases
+ */
+export declare const config: AppConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,SAAS;IAExB,EAAE,EAAE;QACF,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,cAAc,EAAE,MAAM,CAAC;QACvB,GAAG,EAAE;YACH,OAAO,EAAE,OAAO,CAAC;YACjB,kBAAkB,EAAE,OAAO,CAAC;YAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,eAAe,EAAE,OAAO,CAAC;SAC1B,CAAC;KACH,CAAC;IAGF,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IAGF,KAAK,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,OAAO,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IAGF,GAAG,EAAE;QACH,QAAQ,EAAE,OAAO,CAAC;QAClB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;KAC/C,CAAC;CACH;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,WAAW,UAAQ,GAAG,SAAS,CA+CzD;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,SAAwB,CAAC"}

package/dist/config.js

@@ -0,0 +1,51 @@
+/**
+ * Centralized configuration management for environment variables
+ */
+/**
+ * Load and validate configuration from environment variables
+ * @param forceReload - Force reloading from environment variables (useful for tests)
+ */
+export function loadConfig(forceReload = false) {
+    // For DB_PASSWORD, allow it to be empty in test/dev environments
+    // but it will still be required for actual DB connections
+    const dbPassword = process.env.DB_PASSWORD || "";
+    return {
+        db: {
+            host: process.env.DB_HOST || "127.0.0.1",
+            port: parseInt(process.env.DB_PORT || "5432", 10),
+            user: process.env.DB_USER || "postgres",
+            password: dbPassword,
+            database: process.env.DB_NAME || "postgres",
+            maxConnections: parseInt(process.env.DB_POOL_MAX || "5", 10),
+            idleTimeoutMs: parseInt(process.env.DB_IDLE_TIMEOUT || "5000", 10),
+            connectionTimeoutMs: parseInt(process.env.DB_CONNECTION_TIMEOUT || "10000", 10),
+            queryTimeoutMs: parseInt(process.env.DB_QUERY_TIMEOUT || "30000", 10),
+            ssl: {
+                enabled: process.env.DB_SSL !== "false",
+                rejectUnauthorized: process.env.DB_SSL_REJECT_UNAUTHORIZED !== "false",
+                caCert: process.env.DB_SSL_CA_CERT,
+                allowSelfSigned: process.env.DB_SSL_ALLOW_SELF_SIGNED === "true",
+            },
+        },
+        server: {
+            port: process.env.PORT ? parseInt(process.env.PORT, 10) : 3000,
+            allowedHosts: process.env.ALLOWED_HOSTS,
+        },
+        query: {
+            maxPageSize: parseInt(process.env.MAX_PAGE_SIZE || "500", 10),
+            defaultPageSize: parseInt(process.env.DEFAULT_PAGE_SIZE || "100", 10),
+            autoLimit: process.env.AUTO_LIMIT !== "false",
+            maxPayloadSize: parseInt(process.env.MAX_PAYLOAD_SIZE || String(5 * 1024 * 1024), 10),
+        },
+        app: {
+            readOnly: process.env.READ_ONLY !== "false",
+            logLevel: process.env.LOG_LEVEL || "info",
+        },
+    };
+}
+/**
+ * Singleton configuration instance
+ * Can be accessed directly for most use cases
+ */
+export const config = loadConfig();
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AA2CH;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,WAAW,GAAG,KAAK;IAC5C,iEAAiE;IACjE,0DAA0D;IAC1D,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;IAEjD,OAAO;QACL,EAAE,EAAE;YACF,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,WAAW;YACxC,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,MAAM,EAAE,EAAE,CAAC;YACjD,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,UAAU;YACvC,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,UAAU;YAC3C,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,EAAE,EAAE,CAAC;YAC5D,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,MAAM,EAAE,EAAE,CAAC;YAClE,mBAAmB,EAAE,QAAQ,CAC3B,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,OAAO,EAC5C,EAAE,CACH;YACD,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,OAAO,EAAE,EAAE,CAAC;YACrE,GAAG,EAAE;gBACH,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,OAAO;gBACvC,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B,KAAK,OAAO;gBACtE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;gBAClC,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,KAAK,MAAM;aACjE;SACF;QAED,MAAM,EAAE;YACN,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;YAC9D,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa;SACxC;QAED,KAAK,EAAE;YACL,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,KAAK,EAAE,EAAE,CAAC;YAC7D,eAAe,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,KAAK,EAAE,EAAE,CAAC;YACrE,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,OAAO;YAC7C,cAAc,EAAE,QAAQ,CACtB,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,MAAM,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,EACvD,EAAE,CACH;SACF;QAED,GAAG,EAAE;YACH,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,OAAO;YAC3C,QAAQ,EAAG,OAAO,CAAC,GAAG,CAAC,SAA0C,IAAI,MAAM;SAC5E;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAc,UAAU,EAAE,CAAC"}

package/dist/db.d.ts

@@ -0,0 +1,46 @@
+import { Kysely } from "kysely";
+import { Pool } from "pg";
+export interface Database {
+    [key: string]: any;
+}
+export interface DatabaseConfig {
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+    database: string;
+    maxConnections: number;
+    idleTimeoutMs: number;
+    ssl: boolean | {
+        rejectUnauthorized: boolean;
+        ca?: string;
+    };
+    connectionTimeoutMs: number;
+    queryTimeoutMs: number;
+}
+declare class DatabaseManager {
+    private static instance;
+    private db;
+    private pool;
+    private config;
+    private constructor();
+    static getInstance(): DatabaseManager;
+    private loadConfig;
+    private buildSSLConfig;
+    getDatabase(): Kysely<Database>;
+    private connect;
+    close(): Promise<void>;
+    healthCheck(): Promise<{
+        healthy: boolean;
+        error?: string;
+    }>;
+    getConfig(): DatabaseConfig;
+    getPool(): Pool;
+    isConnected(): boolean;
+}
+export declare function getDb(): Kysely<Database>;
+export declare function closeDb(): Promise<void>;
+export declare function getPool(): Pool;
+export declare function getDbManager(): DatabaseManager;
+export {};
+//# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAmB,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,IAAI,EAAc,MAAM,IAAI,CAAC;AAOtC,MAAM,WAAW,QAAQ;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,OAAO,GAAG;QAAE,kBAAkB,EAAE,OAAO,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,cAAM,eAAe;IACnB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgC;IACvD,OAAO,CAAC,EAAE,CAAiC;IAC3C,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,MAAM,CAAiB;IAE/B,OAAO;WAIO,WAAW,IAAI,eAAe;IAO5C,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,cAAc;IAwBf,WAAW,IAAI,MAAM,CAAC,QAAQ,CAAC;IAOtC,OAAO,CAAC,OAAO;IAoCF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtB,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAsBlE,SAAS,IAAI,cAAc;IAI3B,OAAO,IAAI,IAAI;IAOf,WAAW,IAAI,OAAO;CAG9B;AAED,wBAAgB,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,CAExC;AAED,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAE7C;AAED,wBAAgB,OAAO,IAAI,IAAI,CAE9B;AAED,wBAAgB,YAAY,IAAI,eAAe,CAE9C"}

package/dist/db.js

@@ -0,0 +1,142 @@
+import { Kysely, PostgresDialect } from "kysely";
+import { Pool } from "pg";
+import * as dotenv from "dotenv";
+import { config } from "./config.js";
+import { log } from "./logger.js";
+dotenv.config();
+class DatabaseManager {
+    static instance = null;
+    db = null;
+    pool = null;
+    config;
+    constructor() {
+        this.config = this.loadConfig();
+    }
+    static getInstance() {
+        if (!DatabaseManager.instance) {
+            DatabaseManager.instance = new DatabaseManager();
+        }
+        return DatabaseManager.instance;
+    }
+    loadConfig() {
+        return {
+            host: config.db.host,
+            port: config.db.port,
+            user: config.db.user,
+            password: config.db.password,
+            database: config.db.database,
+            maxConnections: config.db.maxConnections,
+            idleTimeoutMs: config.db.idleTimeoutMs,
+            connectionTimeoutMs: config.db.connectionTimeoutMs,
+            queryTimeoutMs: config.db.queryTimeoutMs,
+            ssl: this.buildSSLConfig(),
+        };
+    }
+    buildSSLConfig() {
+        if (!config.db.ssl.enabled) {
+            return false;
+        }
+        const sslConfig = {
+            rejectUnauthorized: config.db.ssl.rejectUnauthorized,
+        };
+        // Add CA certificate if provided
+        if (config.db.ssl.caCert) {
+            sslConfig.ca = config.db.ssl.caCert;
+        }
+        // For when explicitly allowing self-signed certs
+        if (config.db.ssl.allowSelfSigned) {
+            sslConfig.rejectUnauthorized = false;
+        }
+        return sslConfig;
+    }
+    getDatabase() {
+        if (!this.db) {
+            this.connect();
+        }
+        return this.db;
+    }
+    connect() {
+        if (this.db) {
+            return;
+        }
+        const poolConfig = {
+            host: this.config.host,
+            port: this.config.port,
+            user: this.config.user,
+            password: this.config.password,
+            database: this.config.database,
+            max: this.config.maxConnections,
+            idleTimeoutMillis: this.config.idleTimeoutMs,
+            connectionTimeoutMillis: this.config.connectionTimeoutMs,
+            statement_timeout: this.config.queryTimeoutMs,
+            query_timeout: this.config.queryTimeoutMs,
+            ssl: this.config.ssl,
+        };
+        this.pool = new Pool(poolConfig);
+        this.pool.on("error", (err) => {
+            log.error(`Pool error: ${err.message}`, "db", { code: err.code });
+        });
+        this.pool.on("connect", () => {
+            log.debug("New pool connection established", "db");
+        });
+        this.db = new Kysely({
+            dialect: new PostgresDialect({
+                pool: this.pool,
+            }),
+        });
+    }
+    async close() {
+        if (this.db) {
+            await this.db.destroy();
+            this.db = null;
+        }
+        if (this.pool && !this.pool.ended) {
+            await this.pool.end();
+            this.pool = null;
+        }
+    }
+    async healthCheck() {
+        try {
+            if (!this.db) {
+                this.connect();
+            }
+            await this.db.selectFrom("information_schema.tables")
+                .select("table_name")
+                .limit(1)
+                .execute();
+            return { healthy: true };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error";
+            return {
+                healthy: false,
+                error: errorMessage,
+            };
+        }
+    }
+    getConfig() {
+        return { ...this.config }; // Return a copy to prevent modification
+    }
+    getPool() {
+        if (!this.pool) {
+            this.connect();
+        }
+        return this.pool;
+    }
+    isConnected() {
+        return this.db !== null && this.pool !== null;
+    }
+}
+export function getDb() {
+    return DatabaseManager.getInstance().getDatabase();
+}
+export async function closeDb() {
+    await DatabaseManager.getInstance().close();
+}
+export function getPool() {
+    return DatabaseManager.getInstance().getPool();
+}
+export function getDbManager() {
+    return DatabaseManager.getInstance();
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,IAAI,EAAc,MAAM,IAAI,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,MAAM,CAAC,MAAM,EAAE,CAAC;AAmBhB,MAAM,eAAe;IACX,MAAM,CAAC,QAAQ,GAA2B,IAAI,CAAC;IAC/C,EAAE,GAA4B,IAAI,CAAC;IACnC,IAAI,GAAgB,IAAI,CAAC;IACzB,MAAM,CAAiB;IAE/B;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IAClC,CAAC;IAEM,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC;YAC9B,eAAe,CAAC,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;QACnD,CAAC;QACD,OAAO,eAAe,CAAC,QAAQ,CAAC;IAClC,CAAC;IAEO,UAAU;QAChB,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI;YACpB,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI;YACpB,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI;YACpB,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ;YAC5B,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ;YAC5B,cAAc,EAAE,MAAM,CAAC,EAAE,CAAC,cAAc;YACxC,aAAa,EAAE,MAAM,CAAC,EAAE,CAAC,aAAa;YACtC,mBAAmB,EAAE,MAAM,CAAC,EAAE,CAAC,mBAAmB;YAClD,cAAc,EAAE,MAAM,CAAC,EAAE,CAAC,cAAc;YACxC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE;SAC3B,CAAC;IACJ,CAAC;IAEO,cAAc;QAGpB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,SAAS,GAAiD;YAC9D,kBAAkB,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,kBAAkB;SACrD,CAAC;QAEF,iCAAiC;QACjC,IAAI,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YACzB,SAAS,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC;QACtC,CAAC;QAED,iDAAiD;QACjD,IAAI,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;YAClC,SAAS,CAAC,kBAAkB,GAAG,KAAK,CAAC;QACvC,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAEM,WAAW;QAChB,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;QACD,OAAO,IAAI,CAAC,EAAG,CAAC;IAClB,CAAC;IAEO,OAAO;QACb,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAe;YAC7B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YACtB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YACtB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YACtB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;YAC9B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;YAC9B,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc;YAC/B,iBAAiB,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;YAC5C,uBAAuB,EAAE,IAAI,CAAC,MAAM,CAAC,mBAAmB;YACxD,iBAAiB,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc;YAC7C,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc;YACzC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG;SACrB,CAAC;QAEF,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC;QAEjC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YAC5B,GAAG,CAAC,KAAK,CAAC,eAAe,GAAG,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAG,GAAW,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7E,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YAC3B,GAAG,CAAC,KAAK,CAAC,iCAAiC,EAAE,IAAI,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,GAAG,IAAI,MAAM,CAAW;YAC7B,OAAO,EAAE,IAAI,eAAe,CAAC;gBAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;QACjB,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAClC,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,WAAW;QACtB,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACb,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,CAAC;YAED,MAAM,IAAI,CAAC,EAAG,CAAC,UAAU,CAAC,2BAA2B,CAAC;iBACnD,MAAM,CAAC,YAAY,CAAC;iBACpB,KAAK,CAAC,CAAC,CAAC;iBACR,OAAO,EAAE,CAAC;YAEb,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YAC3D,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,YAAY;aACpB,CAAC;QACJ,CAAC;IACH,CAAC;IAEM,SAAS;QACd,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,wCAAwC;IACrE,CAAC;IAEM,OAAO;QACZ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;QACD,OAAO,IAAI,CAAC,IAAK,CAAC;IACpB,CAAC;IAEM,WAAW;QAChB,OAAO,IAAI,CAAC,EAAE,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC;IAChD,CAAC;;AAGH,MAAM,UAAU,KAAK;IACnB,OAAO,eAAe,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO;IAC3B,MAAM,eAAe,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,OAAO,eAAe,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,eAAe,CAAC,WAAW,EAAE,CAAC;AACvC,CAAC"}

package/dist/http-server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=http-server.d.ts.map

package/dist/http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":""}