Postgres wire-compatible server for queryleaf

- working
- has tests
- Can't believe it

Author: rathboma

docs/overrides/partials/integrations/analytics/custom.html

@@ -0,0 +1,2 @@
+<!-- Fathom - beautiful, simple website analytics -->
+<script src="https://cdn.usefathom.com/script.js" data-spa="auto" data-site="SGMKGHHQ" defer></script> <!-- / Fathom -->

docs/usage/postgres-server.md

@@ -0,0 +1,123 @@
+# PostgreSQL Wire-Compatible Server
+
+QueryLeaf includes a PostgreSQL wire-compatible server that allows you to connect to your MongoDB database using standard PostgreSQL clients like `psql`, pgAdmin, DBeaver, or any application that supports PostgreSQL connectivity.
+
+This provides a convenient way to use SQL with your MongoDB database without requiring specialized drivers or custom integration work.
+
+## Installation
+
+The PostgreSQL server is included in the QueryLeaf package and can be installed via npm:
+
+```bash
+npm install -g @queryleaf/postgres-server
+```
+
+## Usage
+
+### Starting the Server
+
+You can start the server using the following command:
+
+```bash
+queryleaf-pg-server --db your_database_name
+```
+
+By default, the server will connect to MongoDB at `mongodb://localhost:27017` and listen for PostgreSQL connections on port 5432.
+
+### Command Line Options
+
+The server supports the following command line options:
+
+| Option | Description | Default |
+| ------ | ----------- | ------- |
+| `--uri` | MongoDB connection URI | `mongodb://localhost:27017` |
+| `--db` | MongoDB database name (required) | - |
+| `--port` | PostgreSQL server port | `5432` |
+| `--host` | PostgreSQL server host | `localhost` |
+| `--max-connections` | Maximum number of connections | `100` |
+
+Example with custom options:
+
+```bash
+queryleaf-pg-server --db your_database_name --uri mongodb://user:[email protected]:27017 --port 5433 --host 0.0.0.0
+```
+
+## Connecting with PostgreSQL Clients
+
+Once the server is running, you can connect to it using any PostgreSQL client. Authentication is currently simplified - any username will be accepted.
+
+### Using psql
+
+```bash
+psql -h localhost -p 5432 -d your_database_name -U any_username
+```
+
+### Connection String
+
+The PostgreSQL connection string format is:
+
+```
+postgresql://username@host:port/database
+```
+
+For example:
+
+```
+postgresql://user@localhost:5432/your_database_name
+```
+
+## Supported Features
+
+The PostgreSQL server supports:
+
+- Basic SQL queries (SELECT, INSERT, UPDATE, DELETE)
+- Transaction management (BEGIN, COMMIT, ROLLBACK)
+- Connection pooling for multiple concurrent clients
+
+## Limitations
+
+The current implementation has the following limitations:
+
+- Limited support for PostgreSQL-specific features and data types
+- Authentication is simplified (any username/password is accepted)
+- Some advanced PostgreSQL features may not be supported
+- Performance may differ from native PostgreSQL
+
+## Programmatic Usage
+
+You can also use the PostgreSQL server programmatically in your Node.js applications:
+
+```typescript
+import { MongoClient } from 'mongodb';
+import { PostgresServer } from '@queryleaf/postgres-server';
+
+async function startServer() {
+  // Connect to MongoDB
+  const mongoClient = new MongoClient('mongodb://localhost:27017');
+  await mongoClient.connect();
+  
+  // Start PostgreSQL server
+  const server = new PostgresServer(mongoClient, 'your_database_name', {
+    port: 5432,
+    host: 'localhost',
+    maxConnections: 100,
+  });
+  
+  // Server is now running
+  console.log('PostgreSQL-compatible server started');
+  
+  // To shutdown the server:
+  // await server.shutdown();
+}
+
+startServer().catch(console.error);
+```
+
+## Use Cases
+
+The PostgreSQL wire-compatible server is useful for:
+
+- Connecting existing PostgreSQL-based applications to MongoDB
+- Using familiar SQL tools for data exploration and analysis
+- Providing a SQL interface to team members unfamiliar with MongoDB query syntax
+- Supporting applications that require a SQL interface but need MongoDB's document model

package.json

@@ -10,20 +10,23 @@
     "clean:lib": "rm -rf packages/lib/dist",
     "clean:cli": "rm -rf packages/cli/dist",
     "clean:server": "rm -rf packages/server/dist",
-    "clean": "yarn clean:lib && yarn clean:cli && yarn clean:server",
+    "clean:pg-server": "rm -rf packages/postgres-server/dist",
+    "clean": "yarn clean:lib && yarn clean:cli && yarn clean:server && yarn clean:pg-server",
     "build:lib": "cd packages/lib && npx tsc",
     "build:cli": "cd packages/cli && npx tsc",
     "build:server": "cd packages/server && npx tsc",
-    "build": "yarn clean && yarn build:lib && yarn build:cli && yarn build:server",
+    "build:pg-server": "cd packages/postgres-server && npx tsc",
+    "build": "yarn clean && yarn build:lib && yarn build:cli && yarn build:server && yarn build:pg-server",
     "build:references": "tsc --build",
     "test": "jest",
     "test:lib": "cd packages/lib && npm test",
     "test:lib:unit": "cd packages/lib && npm run test:unit",
     "test:lib:integration": "cd packages/lib && npm run test:integration",
     "test:cli": "cd packages/cli && npm test",
     "test:server": "cd packages/server && npm test",
-    "test:all": "npm run test:lib && npm run test:cli && npm run test:server",
-    "typecheck": "cd packages/lib && npx tsc --noEmit && cd ../cli && npx tsc --noEmit && cd ../server && npx tsc --noEmit",
+    "test:pg-server": "cd packages/postgres-server && npm test",
+    "test:all": "npm run test:lib && npm run test:cli && npm run test:server && npm run test:pg-server",
+    "typecheck": "cd packages/lib && npx tsc --noEmit && cd ../cli && npx tsc --noEmit && cd ../server && npx tsc --noEmit && cd ../postgres-server && npx tsc --noEmit",
     "lint": "eslint --ext .ts packages/*/src",
     "lint:fix": "eslint --ext .ts --fix packages/*/src",
     "format": "prettier --write \"packages/*/src/**/*.ts\"",
@@ -59,4 +62,4 @@
     "prettier": "^3.2.5",
     "typescript": "^5.8.2"
   }
-}
+}

packages/postgres-server/bin/queryleaf-pg-server

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+require("../dist/pg-server");