fix tests and readme

Author: nicoloboschi

README.md

@@ -22,6 +22,17 @@ pg0 gives you **real PostgreSQL** with the same simplicity as SQLite:
 
 Use pg0 for local development, testing, CI/CD pipelines, or any scenario where you want PostgreSQL without the setup overhead.
 
+## Supported Platforms
+
+| Platform | Architecture | Binary |
+|----------|--------------|--------|
+| macOS | Apple Silicon (M1/M2/M3) | `pg0-macos-arm64` |
+| Linux | x86_64 (glibc) | `pg0-linux-amd64-gnu` |
+| Linux | x86_64 (musl/Alpine) | `pg0-linux-amd64-musl` |
+| Linux | ARM64 (glibc) | `pg0-linux-arm64-gnu` |
+| Linux | ARM64 (musl/Alpine) | `pg0-linux-arm64-musl` |
+| Windows | x64 | `pg0-windows-amd64.exe` |
+
 ## Features
 
 - **Zero dependencies** - single binary, works offline
@@ -141,12 +152,14 @@ docker run -d myimage bash -c "pg0 start && exec your-application"
 
 ### Alpine (musl-based)
 
+**Note:** The musl binary requires ICU 74. Use Alpine 3.20 (not 3.22+) as newer versions have ICU 76.
+
 ```dockerfile
-FROM alpine:latest
-# or: python:3.11-alpine
+FROM alpine:3.20
+# or: python:3.12-alpine3.20
 
 # Install required dependencies
-RUN apk add --no-cache curl bash shadow
+RUN apk add --no-cache curl bash shadow icu-libs lz4-libs libxml2
 
 # Create non-root user (PostgreSQL cannot run as root)
 RUN adduser -D -s /bin/bash pguser
@@ -183,9 +196,9 @@ docker run --rm -it python:3.11-slim bash -c '
     pg0 psql -c \"SELECT version();\""
 '
 
-# Alpine
-docker run --rm -it python:3.11-alpine sh -c '
-  apk add --no-cache curl bash shadow &&
+# Alpine (use 3.20 for ICU 74 compatibility)
+docker run --rm -it python:3.12-alpine3.20 sh -c '
+  apk add --no-cache curl bash shadow icu-libs lz4-libs libxml2 &&
   adduser -D pguser &&
   su - pguser -c "curl -fsSL https://raw.githubusercontent.com/vectorize-io/pg0/main/install.sh | bash &&
     export PATH=\"\$HOME/.local/bin:\$PATH\" &&

docker-tests/README.md

@@ -8,8 +8,8 @@ Automated tests to verify pg0 works correctly across different platforms and dis
 |------|-------|----------|--------------|------|
 | `test_debian_amd64.sh` | python:3.11-slim | linux/amd64 | x86_64 | glibc |
 | `test_debian_arm64.sh` | python:3.11-slim | linux/arm64 | aarch64 | glibc |
-| `test_alpine_amd64.sh` | python:3.11-alpine | linux/amd64 | x86_64 | musl |
-| `test_alpine_arm64.sh` | python:3.11-alpine | linux/arm64 | aarch64 | musl |
+| `test_alpine_amd64.sh` | python:3.12-alpine3.20 | linux/amd64 | x86_64 | musl |
+| `test_alpine_arm64.sh` | python:3.12-alpine3.20 | linux/arm64 | aarch64 | musl |
 
 ## What Each Test Does
 
@@ -55,10 +55,12 @@ chmod +x *.sh
 - ✅ All queries: Success
 
 ### Alpine (musl)
-- ✅ PostgreSQL: Works
-- ⚠️ pgvector: May fail (no musl binaries available yet)
+- ✅ PostgreSQL: Works (requires `icu-libs`, `lz4-libs`, `libxml2` packages and ICU 74 - use Alpine 3.20)
+- ⚠️ pgvector: Fails (no musl binaries available - glibc-only)
 - ✅ Basic queries: Success
 
+**Note:** The PostgreSQL musl binary is built against ICU 74. Alpine 3.22+ uses ICU 76 which is not compatible. Use Alpine 3.20 for musl-based deployments.
+
 ## Requirements
 
 - Docker installed and running

docker-tests/test_alpine_amd64.sh

@@ -3,17 +3,19 @@ set -e
 
 echo "=================================="
 echo "Testing pg0 on Alpine AMD64"
-echo "Image: python:3.11-alpine"
+echo "Image: python:3.12-alpine3.20"
 echo "Platform: linux/amd64"
 echo "=================================="
 
 # Get the script directory to find install.sh
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 INSTALL_SCRIPT="$SCRIPT_DIR/../install.sh"
 
+# Note: Using Alpine 3.20 because the musl PostgreSQL binary requires ICU 74
+# Alpine 3.22 has ICU 76 which is not compatible
 docker run --rm --platform=linux/amd64 \
   -v "$INSTALL_SCRIPT:/tmp/install.sh:ro" \
-  python:3.11-alpine sh -c '
+  python:3.12-alpine3.20 sh -c '
 set -e
 
 echo "=== System Info ==="
@@ -22,7 +24,7 @@ cat /etc/os-release | grep PRETTY_NAME
 
 echo ""
 echo "=== Installing dependencies ==="
-apk add --no-cache curl bash sudo procps shadow > /dev/null 2>&1
+apk add --no-cache curl bash sudo procps shadow icu-libs lz4-libs libxml2 > /dev/null 2>&1
 
 echo ""
 echo "=== Creating non-root user ==="

docker-tests/test_alpine_arm64.sh

@@ -3,17 +3,19 @@ set -e
 
 echo "=================================="
 echo "Testing pg0 on Alpine ARM64"
-echo "Image: python:3.11-alpine"
+echo "Image: python:3.12-alpine3.20"
 echo "Platform: linux/arm64"
 echo "=================================="
 
 # Get the script directory to find install.sh
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 INSTALL_SCRIPT="$SCRIPT_DIR/../install.sh"
 
+# Note: Using Alpine 3.20 because the musl PostgreSQL binary requires ICU 74
+# Alpine 3.22 has ICU 76 which is not compatible
 docker run --rm --platform=linux/arm64 \
   -v "$INSTALL_SCRIPT:/tmp/install.sh:ro" \
-  python:3.11-alpine sh -c '
+  python:3.12-alpine3.20 sh -c '
 set -e
 
 echo "=== System Info ==="
@@ -22,7 +24,7 @@ cat /etc/os-release | grep PRETTY_NAME
 
 echo ""
 echo "=== Installing dependencies ==="
-apk add --no-cache curl bash sudo procps shadow > /dev/null 2>&1
+apk add --no-cache curl bash sudo procps shadow icu-libs lz4-libs libxml2 > /dev/null 2>&1
 
 echo ""
 echo "=== Creating non-root user ==="

sdk/node/README.md

@@ -1,142 +1,73 @@
 # pg0 - Embedded PostgreSQL for Node.js
 
-Zero-config PostgreSQL with pgvector support. Just `npm install` and go.
+[![npm](https://badge.fury.io/js/@vectorize-io%2Fpg0.svg)](https://www.npmjs.com/package/@vectorize-io/pg0)
 
-## Installation
+Embedded PostgreSQL with pgvector. No installation, no Docker, no configuration.
+
+## Install
 
 ```bash
 npm install @vectorize-io/pg0
 ```
 
-## Quick Start
+## Usage
 
 ```typescript
 import { Pg0 } from "@vectorize-io/pg0";
 
-// Start PostgreSQL (auto-installs on first run)
+// Basic usage
 const pg = new Pg0();
 await pg.start();
-
 console.log(await pg.getUri()); // postgresql://postgres:postgres@localhost:5432/postgres
-
+await pg.execute("CREATE EXTENSION IF NOT EXISTS vector");
 await pg.stop();
-```
-
-## Synchronous API
-
-```typescript
-import { Pg0 } from "@vectorize-io/pg0";
-
-const pg = new Pg0();
-pg.startSync();
-console.log(pg.getUriSync());
-pg.stopSync();
-```
-
-## Custom Configuration
-
-```typescript
-import { Pg0 } from "@vectorize-io/pg0";
 
+// Custom configuration
 const pg = new Pg0({
+  name: "myapp",
   port: 5433,
   username: "myuser",
   password: "mypass",
   database: "mydb",
-  config: {
-    shared_buffers: "512MB",
-    maintenance_work_mem: "1GB",
-  },
+  config: { shared_buffers: "512MB" }
 });
-
 await pg.start();
-console.log(await pg.getUri());
 await pg.stop();
-```
-
-## Multiple Instances
 
-```typescript
-import { Pg0, listInstances } from "@vectorize-io/pg0";
-
-const app = new Pg0({ name: "app", port: 5432 });
-const test = new Pg0({ name: "test", port: 5433 });
-
-await app.start();
-await test.start();
-
-for (const instance of await listInstances()) {
-  console.log(`${instance.name}: ${instance.uri}`);
-}
-
-await app.stop();
-await test.stop();
+// Sync API also available
+pg.startSync();
+pg.stopSync();
 ```
 
-## API Reference
+## API
 
 ### Pg0 Class
 
-```typescript
-const pg = new Pg0({
-  name: "default",      // Instance name
-  port: 5432,           // Port
-  username: "postgres", // Username
-  password: "postgres", // Password
-  database: "postgres", // Database
-  dataDir: undefined,   // Custom data directory
-  config: {},           // PostgreSQL config options
-});
-
-// Async methods
-await pg.start();       // Start PostgreSQL -> InstanceInfo
-await pg.stop();        // Stop PostgreSQL
-await pg.info();        // Get instance info -> InstanceInfo
-await pg.getUri();      // Connection URI
-await pg.isRunning();   // Is running
-await pg.execute(sql);  // Execute SQL -> string
-
-// Sync methods
-pg.startSync();
-pg.stopSync();
-pg.infoSync();
-pg.getUriSync();
-pg.isRunningSync();
-pg.executeSync(sql);
-```
+| Method | Description |
+|--------|-------------|
+| `start()` / `startSync()` | Start PostgreSQL, returns `InstanceInfo` |
+| `stop()` / `stopSync()` | Stop PostgreSQL |
+| `drop()` / `dropSync()` | Stop and delete all data |
+| `info()` / `infoSync()` | Get instance info |
+| `execute(sql)` / `executeSync(sql)` | Run SQL query |
+| `getUri()` / `getUriSync()` | Get connection URI |
+| `isRunning()` / `isRunningSync()` | Check if running |
 
 ### Module Functions
 
 ```typescript
-import { start, stop, info, listInstances, install } from "@vectorize-io/pg0";
-
-// Async
-await start({ port: 5432 });  // Start -> InstanceInfo
-await stop("default");        // Stop
-await info("default");        // Info -> InstanceInfo
-await listInstances();        // List all -> InstanceInfo[]
-await install();              // Install pg0 binary
-
-// Sync
-startSync({ port: 5432 });
-stopSync("default");
-infoSync("default");
-listInstancesSync();
-installSync();
-```
+import { start, stop, drop, info, listInstances } from "@vectorize-io/pg0";
 
-### InstanceInfo
+await start({ name: "default", port: 5432 });  // Start instance
+await stop("default");                          // Stop instance
+await drop("default");                          // Delete instance
+await info("default");                          // Get instance info
+await listInstances();                          // List all instances
 
-```typescript
-interface InstanceInfo {
-  name: string;
-  running: boolean;
-  pid?: number;
-  port?: number;
-  version?: string;
-  username?: string;
-  database?: string;
-  data_dir?: string;
-  uri?: string;
-}
+// Sync versions: startSync, stopSync, dropSync, infoSync, listInstancesSync
 ```
+
+## Links
+
+- [GitHub](https://github.com/vectorize-io/pg0)
+- [CLI Documentation](https://github.com/vectorize-io/pg0#readme)

sdk/node/dist/src/index.d.ts

@@ -111,6 +111,10 @@ export declare class Pg0 {
 export declare function listInstances(): Promise<InstanceInfo[]>;
 /** List all pg0 instances (synchronous). */
 export declare function listInstancesSync(): InstanceInfo[];
+/** List available PostgreSQL extensions. */
+export declare function listExtensions(): Promise<string[]>;
+/** List available PostgreSQL extensions (synchronous). */
+export declare function listExtensionsSync(): string[];
 /** Start a PostgreSQL instance (convenience function). */
 export declare function start(options?: Pg0Options): Promise<InstanceInfo>;
 /** Start a PostgreSQL instance (synchronous convenience function). */

sdk/node/dist/src/index.js

@@ -5,6 +5,8 @@ exports.install = install;
 exports.installSync = installSync;
 exports.listInstances = listInstances;
 exports.listInstancesSync = listInstancesSync;
+exports.listExtensions = listExtensions;
+exports.listExtensionsSync = listExtensionsSync;
 exports.start = start;
 exports.startSync = startSync;
 exports.stop = stop;
@@ -63,10 +65,37 @@ function getPlatform() {
         return "darwin-aarch64"; // Intel Macs use Rosetta
     }
     else if (os === "linux") {
+        // Detect architecture
+        let arch_str;
         if (cpu === "x64") {
-            return "linux-x86_64";
+            arch_str = "x86_64";
         }
-        throw new Pg0NotFoundError(`Unsupported Linux architecture: ${cpu}`);
+        else if (cpu === "arm64") {
+            arch_str = "aarch64";
+        }
+        else {
+            throw new Pg0NotFoundError(`Unsupported Linux architecture: ${cpu}`);
+        }
+        // Detect libc (musl vs glibc)
+        // Check for musl by looking for the musl loader
+        const { execSync } = require("child_process");
+        try {
+            const ldd = execSync("ldd --version 2>&1", { encoding: "utf-8" });
+            if (ldd.toLowerCase().includes("musl")) {
+                return `linux-${arch_str}-musl`;
+            }
+        }
+        catch {
+            // If ldd fails, check for musl loader file
+            const { existsSync } = require("fs");
+            if (existsSync(`/lib/ld-musl-${arch_str}.so.1`) ||
+                existsSync(`/lib/ld-musl-x86_64.so.1`) ||
+                existsSync(`/lib/ld-musl-aarch64.so.1`)) {
+                return `linux-${arch_str}-musl`;
+            }
+        }
+        // Default to glibc
+        return `linux-${arch_str}-gnu`;
     }
     else if (os === "win32") {
         return "windows-x86_64";
@@ -428,6 +457,16 @@ async function listInstances() {
 function listInstancesSync() {
     return JSON.parse(runPg0Sync("list", "-o", "json"));
 }
+/** List available PostgreSQL extensions. */
+async function listExtensions() {
+    const { stdout } = await runPg0("list-extensions");
+    return stdout.trim().split("\n").filter(line => line.trim());
+}
+/** List available PostgreSQL extensions (synchronous). */
+function listExtensionsSync() {
+    const stdout = runPg0Sync("list-extensions");
+    return stdout.trim().split("\n").filter(line => line.trim());
+}
 /** Start a PostgreSQL instance (convenience function). */
 async function start(options = {}) {
     return new Pg0(options).start();