pgserve 1.0.9-rc.7 → 1.1.2

package/.github/workflows/ci.yml

@@ -81,4 +81,38 @@ jobs:
       - name: Verify executable
         run: |
           ./dist/pgserve --help
-          echo "Build successful!"
+          echo "Build successful!"
+
+  # Test npx flow (user experience)
+  test-npx:
+    name: Test npx install
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Bun (for packing)
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Setup Node.js (for testing)
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install deps and pack
+        run: |
+          bun install
+          bun pm pack --destination /tmp --ignore-scripts
+
+      - name: Test npx install (fresh environment)
+        run: |
+          cd /tmp
+          mkdir test-pgserve
+          cd test-pgserve
+          npm init -y
+          npm install /tmp/pgserve-*.tgz
+          timeout 30 npx pgserve --help
+          echo "npx test passed!"

package/.github/workflows/release.yml

@@ -105,11 +105,10 @@ jobs:
           git push origin HEAD:${{ github.ref_name }}
           git push origin --tags
 
-  # Build: Build all platforms (skip for promote)
+  # Build & Publish: Always build and publish (npm_tag comes from version job)
   build:
     name: Build & Publish
     needs: version
-    if: needs.version.outputs.is_promote != 'true'
     uses: ./.github/workflows/build-all-platforms.yml
     with:
       version: ${{ needs.version.outputs.version }}
@@ -117,52 +116,11 @@ jobs:
       ref: ${{ needs.version.outputs.tag }}
     secrets: inherit
 
-  # Promote: Just update npm tags (no rebuild)
-  promote:
-    name: Promote to Latest
-    needs: version
-    if: needs.version.outputs.is_promote == 'true'
-    runs-on: ubuntu-latest
-    environment: npm-publish
-
-    steps:
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          registry-url: 'https://registry.npmjs.org'
-
-      - name: Get RC version from @next tag
-        id: get-rc
-        run: |
-          RC_VERSION=$(npm view pgserve@next version 2>/dev/null || echo "")
-          if [ -z "$RC_VERSION" ]; then
-            echo "No RC version found at @next tag"
-            exit 1
-          fi
-          echo "rc_version=$RC_VERSION" >> $GITHUB_OUTPUT
-          echo "Found RC version: $RC_VERSION"
-
-      - name: Promote @next to @latest
-        run: |
-          echo "Promoting pgserve@${{ steps.get-rc.outputs.rc_version }} to @latest"
-          npm dist-tag add pgserve@${{ steps.get-rc.outputs.rc_version }} latest
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      - name: Verify promotion
-        run: |
-          LATEST=$(npm view pgserve@latest version)
-          echo "Latest version is now: $LATEST"
-          if [ "$LATEST" != "${{ steps.get-rc.outputs.rc_version }}" ]; then
-            echo "Warning: Version mismatch after promotion"
-          fi
-
   # GitHub Release: Create release with changelog
   github-release:
     name: Create GitHub Release
     needs: [version, build]
-    if: always() && needs.version.result == 'success' && (needs.build.result == 'success' || needs.build.result == 'skipped')
+    if: always() && needs.version.result == 'success' && needs.build.result == 'success'
     runs-on: ubuntu-latest
     permissions:
       contents: write

package/AGENTS.md

@@ -188,9 +188,16 @@ Before editing ANY implementation file, Base Genie must check:
 
 **Protocol:** `@.genie/spells/orchestration-boundary-protocol.md`
 
+**Release Workflow Protocol:**
+- ❌ Never manually trigger `workflow_dispatch` for releases
+- ❌ Never manually bump version in package.json
+- ✅ Always use PR with `rc` or `stable` label - release.yml auto-triggers on merge
+- ✅ Version bumping is automated by scripts/release.cjs
+
 **Documented Violations:**
 - Bug #168, task b51db539, 2025-10-21 (duplicate implementation)
 - 2025-10-26 (claimed release implementation steps without investigating automation)
+- 2025-12-08 (manually set version to 1.1.0 + triggered workflow_dispatch → version jumped to 1.1.1-rc.1)
 
 ### 4. Task State Optimization - Live State, Not Documentation 🔴 CRITICAL
 **Rule:** Task state is ephemeral runtime data, not permanent documentation

package/README.md

@@ -4,8 +4,7 @@
 
   <p>
     <a href="https://www.npmjs.com/package/pgserve"><img src="https://img.shields.io/npm/v/pgserve?style=flat-square&color=00D9FF" alt="npm version"></a>
-    <img src="https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen?style=flat-square" alt="Node.js">
-    <img src="https://img.shields.io/badge/bun-%3E%3D1.0.0-f472b6?style=flat-square" alt="Bun">
+    <img src="https://img.shields.io/badge/node-%3E%3D18-green?style=flat-square" alt="Node.js">
     <img src="https://img.shields.io/badge/PostgreSQL-17.7-blue?style=flat-square" alt="PostgreSQL">
     <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="License"></a>
     <a href="https://discord.gg/xcW8c7fF3R"><img src="https://img.shields.io/discord/1095114867012292758?style=flat-square&color=00D9FF&label=discord" alt="Discord"></a>
@@ -33,7 +32,7 @@ npx pgserve
 Connect from any PostgreSQL client — databases auto-create on first connection:
 
 ```bash
-psql postgresql://localhost:5432/myapp
+psql postgresql://localhost:8432/myapp
 ```
 
 <br>
@@ -41,6 +40,10 @@ psql postgresql://localhost:5432/myapp
 ## Features
 
 <table>
+  <tr>
+    <td><b>Real PostgreSQL 17</b></td>
+    <td>Native binaries, not WASM — full compatibility, extensions support</td>
+  </tr>
   <tr>
     <td><b>Unlimited Concurrency</b></td>
     <td>Native PostgreSQL process forking — no connection locks</td>
@@ -67,7 +70,7 @@ psql postgresql://localhost:5432/myapp
   </tr>
   <tr>
     <td><b>Async Replication</b></td>
-    <td>Sync to real PostgreSQL with zero performance impact</td>
+    <td>Sync to real PostgreSQL with minimal overhead</td>
   </tr>
   <tr>
     <td><b>Cross-Platform</b></td>
@@ -92,13 +95,9 @@ npm install -g pgserve
 
 # Project dependency
 npm install pgserve
-
-# With Bun
-bunx pgserve
-bun add pgserve
 ```
 
-> PostgreSQL binaries are automatically downloaded on first run.
+> PostgreSQL binaries are automatically downloaded on first run (~100MB).
 
 <br>
 
@@ -179,7 +178,7 @@ await server.stop();
 import pg from 'pg';
 
 const client = new pg.Client({
-  connectionString: 'postgresql://localhost:5432/myapp'
+  connectionString: 'postgresql://localhost:8432/myapp'
 });
 
 await client.connect();
@@ -205,7 +204,7 @@ datasource db {
 
 ```bash
 # .env
-DATABASE_URL="postgresql://localhost:5432/myapp"
+DATABASE_URL="postgresql://localhost:8432/myapp"
 
 # Run migrations
 npx prisma migrate dev
@@ -221,7 +220,7 @@ import { drizzle } from 'drizzle-orm/node-postgres';
 import { Pool } from 'pg';
 
 const pool = new Pool({
-  connectionString: 'postgresql://localhost:5432/myapp'
+  connectionString: 'postgresql://localhost:8432/myapp'
 });
 
 const db = drizzle(pool);
@@ -244,7 +243,7 @@ pgserve --sync-to "postgresql://user:pass@db.example.com:5432/mydb"
 pgserve --sync-to "postgresql://..." --sync-databases "myapp,tenant_*"
 ```
 
-> Replication is handled by PostgreSQL's WAL writer process, completely off the Node.js event loop. Sync failures don't affect main server operation.
+> Replication is handled by PostgreSQL's WAL writer process, completely off the runtime event loop. Sync failures don't affect main server operation.
 
 <br>
 
@@ -287,9 +286,9 @@ pgserve --sync-to "postgresql://..." --sync-databases "myapp,tenant_*"
   </tr>
 </table>
 
-> **Bun gives 2x throughput** for concurrent writes vs Node.js. **RAM mode adds another 2-4x** on Linux.
+> pgserve uses Bun runtime internally for 2x throughput. **RAM mode adds another 2-4x** on Linux.
 >
-> Run benchmarks: `bun run bench`
+> Run benchmarks: `bun run bench` (contributors only)
 
 <br>
 
@@ -339,14 +338,14 @@ pgserve --sync-to "postgresql://..." --sync-databases "myapp,tenant_*"
 
 ## Requirements
 
-- **Runtime**: Node.js >= 18.0.0 or Bun >= 1.0.0
+- **Runtime**: Node.js >= 18 (npm/npx)
 - **Platform**: Linux x64, macOS ARM64/x64, Windows x64
 
 <br>
 
 ## Development
 
-This project uses Bun for development:
+Contributors: This project uses Bun internally for development:
 
 ```bash
 # Install dependencies

package/bin/pgserve-wrapper.cjs

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+/**
+ * pgserve wrapper - Finds and spawns bun runtime from node_modules
+ *
+ * This wrapper enables `npx pgserve` to work without requiring
+ * users to install bun globally. The bun runtime is bundled as
+ * an npm dependency and this wrapper finds and invokes it.
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Detect platform
+const isWindows = process.platform === 'win32';
+const bunBin = isWindows ? 'bun.exe' : 'bun';
+
+// Try multiple locations for cross-platform compatibility
+// Order matters - most common locations first
+// Note: npm hoists dependencies, so bun may be in parent node_modules
+const locations = [
+  // Hoisted to top-level node_modules (npm default behavior)
+  path.join(__dirname, '..', '..', '.bin', bunBin),
+  // Standard location when not hoisted
+  path.join(__dirname, '..', 'node_modules', '.bin', bunBin),
+  // Direct bun package location (some npm versions)
+  path.join(__dirname, '..', 'node_modules', 'bun', bunBin),
+  // Hoisted bun package
+  path.join(__dirname, '..', '..', 'bun', bunBin),
+  // Platform-specific @oven packages (hoisted)
+  path.join(__dirname, '..', '..', '@oven', `bun-${process.platform}-${process.arch}`, bunBin),
+  // Platform-specific @oven packages (not hoisted)
+  path.join(__dirname, '..', 'node_modules', '@oven', `bun-${process.platform}-${process.arch}`, bunBin),
+  // Alternative arch naming (darwin-aarch64 vs darwin-arm64)
+  path.join(__dirname, '..', '..', '@oven', `bun-${process.platform}-${process.arch === 'arm64' ? 'aarch64' : process.arch}`, bunBin),
+  // Windows specific paths
+  isWindows ? path.join(__dirname, '..', '..', '.bin', 'bun.cmd') : null,
+  isWindows ? path.join(__dirname, '..', 'node_modules', '.bin', 'bun.cmd') : null,
+].filter(Boolean);
+
+const bunPath = locations.find(p => fs.existsSync(p));
+
+if (!bunPath) {
+  console.error('Error: Could not find bun runtime.');
+  console.error('');
+  console.error('Tried locations:');
+  locations.forEach(l => console.error(`  - ${l}`));
+  console.error('');
+  console.error('Try reinstalling: npm install pgserve');
+  process.exit(1);
+}
+
+const scriptPath = path.join(__dirname, 'pglite-server.js');
+
+// Spawn bun with the actual script, inherit all stdio
+const child = spawn(bunPath, [scriptPath, ...process.argv.slice(2)], {
+  stdio: 'inherit',
+  windowsHide: true
+});
+
+child.on('error', (err) => {
+  console.error('Failed to start pgserve:', err.message);
+  process.exit(1);
+});
+
+child.on('exit', (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code ?? 0);
+  }
+});
+
+// Forward signals to child process
+['SIGINT', 'SIGTERM', 'SIGHUP'].forEach(signal => {
+  process.on(signal, () => {
+    if (child.pid) {
+      process.kill(child.pid, signal);
+    }
+  });
+});

package/bun.lock

@@ -4,6 +4,9 @@
   "workspaces": {
     "": {
       "name": "pgserve",
+      "dependencies": {
+        "bun": "^1.3.4",
+      },
       "devDependencies": {
         "@electric-sql/pglite": "^0.2.17",
         "eslint": "^9.39.1",
@@ -70,6 +73,28 @@
 
     "@nodelib/fs.walk": ["@nodelib/fs.walk@1.2.8", "", { "dependencies": { "@nodelib/fs.scandir": "2.1.5", "fastq": "^1.6.0" } }, "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg=="],
 
+    "@oven/bun-darwin-aarch64": ["@oven/bun-darwin-aarch64@1.3.4", "", { "os": "darwin", "cpu": "arm64" }, "sha512-2Ie4jDGvNGuPSD+pyyBKL8dJmX+bZfDNYEalwgROImVtwB1XYAatJK20dMaRlPA7jOhjvS9Io+4IZAJu7Js0AA=="],
+
+    "@oven/bun-darwin-x64": ["@oven/bun-darwin-x64@1.3.4", "", { "os": "darwin", "cpu": "x64" }, "sha512-4/BJojT8hk5g6Gecjn5yI7y96/+9Mtzsvdp9+2dcy9sTMdlV7jBvDzswqyJPZyQqw0F3HV3Vu9XuMubZwKd9lA=="],
+
+    "@oven/bun-darwin-x64-baseline": ["@oven/bun-darwin-x64-baseline@1.3.4", "", { "os": "darwin", "cpu": "x64" }, "sha512-ZYxzIOCDqylTMsnWYERjKMMuK2b4an4qbloBmUZTwLHmVzos00yrhtpitZhJBgH6yB/l4Q5eoJ2W98UKtFFeiQ=="],
+
+    "@oven/bun-linux-aarch64": ["@oven/bun-linux-aarch64@1.3.4", "", { "os": "linux", "cpu": "arm64" }, "sha512-8DUIlanftMdFxLGq2FxwKwfrp8O4ZofF/8Oc6lxCyEFmg2hixbHhL04+fPfJIi5D4hZloynxZdwTeDbGv/Kc4A=="],
+
+    "@oven/bun-linux-aarch64-musl": ["@oven/bun-linux-aarch64-musl@1.3.4", "", { "os": "linux", "cpu": "arm64" }, "sha512-6UtmM4wXgRKz+gnLZEfddfsuBSVQpJr09K12e5pbdnLzeWgXYlBT5FG8S7SVn1t6cbgBMnigEsFjWwfTuMNoCw=="],
+
+    "@oven/bun-linux-x64": ["@oven/bun-linux-x64@1.3.4", "", { "os": "linux", "cpu": "x64" }, "sha512-03iSDMqdrmIFAsvsRptq+A7EGNjkg20dNzPnqxAlXHk5rc1PeIRWIP0eIn0i3nI6mmdj33mimf9AGr0+d0lKMg=="],
+
+    "@oven/bun-linux-x64-baseline": ["@oven/bun-linux-x64-baseline@1.3.4", "", { "os": "linux", "cpu": "x64" }, "sha512-ZMGPbFPqmG/VYJv61D+Y1V7T23jPK57vYl7yYLakmkTRjG6vcJ0Akhb2qR1iW94rHvfEBjeuVDAZBp8Qp9oyWA=="],
+
+    "@oven/bun-linux-x64-musl": ["@oven/bun-linux-x64-musl@1.3.4", "", { "os": "linux", "cpu": "x64" }, "sha512-xUXPuJHndGhk4K3Cx1FgTyTgDZOn+ki3eWvdXYqKdfi0EaNA9KpUq+/vUtpJbZRjzpHs9L+OJcdDILq5H0LX4g=="],
+
+    "@oven/bun-linux-x64-musl-baseline": ["@oven/bun-linux-x64-musl-baseline@1.3.4", "", { "os": "linux", "cpu": "x64" }, "sha512-qsGSSlNsxiX8lAayK2uYCfMLtqu776F0nn7qoyzg9Ti7mElM3woNh7RtGClTwQ6qsp5/UvgqT9g4pLaDHmqJFg=="],
+
+    "@oven/bun-windows-x64": ["@oven/bun-windows-x64@1.3.4", "", { "os": "win32", "cpu": "x64" }, "sha512-nswsuN6+HZPim6x4tFpDFpMa/qpTKfywbGvCkzxwrbJO9MtpuW/54NA1nFbHhpV14OLU0xuxyBj2PK4FHq4MlA=="],
+
+    "@oven/bun-windows-x64-baseline": ["@oven/bun-windows-x64-baseline@1.3.4", "", { "os": "win32", "cpu": "x64" }, "sha512-ZQiSDFfSUdOrPTiL2GvkxlC/kMED4fsJwdZnwJK6S9ylXnk9xY/9ZXfe1615SFLQl2LsVRzJAtjQLeM0BifIKQ=="],
+
     "@oxc-resolver/binding-android-arm-eabi": ["@oxc-resolver/binding-android-arm-eabi@11.15.0", "", { "os": "android", "cpu": "arm" }, "sha512-Q+lWuFfq7whNelNJIP1dhXaVz4zO9Tu77GcQHyxDWh3MaCoO2Bisphgzmsh4ZoUe2zIchQh6OvQL99GlWHg9Tw=="],
 
     "@oxc-resolver/binding-android-arm64": ["@oxc-resolver/binding-android-arm64@11.15.0", "", { "os": "android", "cpu": "arm64" }, "sha512-vbdBttesHR0W1oJaxgWVTboyMUuu+VnPsHXJ6jrXf4czELzB6GIg5DrmlyhAmFBhjwov+yJH/DfTnHS+2sDgOw=="],
@@ -138,6 +163,8 @@
 
     "braces": ["braces@3.0.3", "", { "dependencies": { "fill-range": "^7.1.1" } }, "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA=="],
 
+    "bun": ["bun@1.3.4", "", { "optionalDependencies": { "@oven/bun-darwin-aarch64": "1.3.4", "@oven/bun-darwin-x64": "1.3.4", "@oven/bun-darwin-x64-baseline": "1.3.4", "@oven/bun-linux-aarch64": "1.3.4", "@oven/bun-linux-aarch64-musl": "1.3.4", "@oven/bun-linux-x64": "1.3.4", "@oven/bun-linux-x64-baseline": "1.3.4", "@oven/bun-linux-x64-musl": "1.3.4", "@oven/bun-linux-x64-musl-baseline": "1.3.4", "@oven/bun-windows-x64": "1.3.4", "@oven/bun-windows-x64-baseline": "1.3.4" }, "os": [ "linux", "win32", "darwin", ], "cpu": [ "x64", "arm64", ], "bin": { "bun": "bin/bun.exe", "bunx": "bin/bunx.exe" } }, "sha512-xV6KgD5ImquuKsoghzbWmYzeCXmmSgN6yJGz444hri2W+NGKNRFUNrEhy9+/rRXbvNA2qF0K0jAwqFNy1/GhBg=="],
+
     "callsites": ["callsites@3.1.0", "", {}, "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ=="],
 
     "chalk": ["chalk@4.1.2", "", { "dependencies": { "ansi-styles": "^4.1.0", "supports-color": "^7.1.0" } }, "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA=="],

package/knip.json

@@ -1,8 +1,9 @@
 {
   "$schema": "https://unpkg.com/knip@5/schema.json",
-  "entry": ["src/index.js", "bin/pglite-server.js"],
-  "project": ["src/**/*.js", "bin/**/*.js"],
+  "entry": ["src/index.js", "bin/pglite-server.js", "bin/pgserve-wrapper.cjs"],
+  "project": ["src/**/*.js", "bin/**/*.js", "bin/**/*.cjs"],
   "ignore": ["tests/**", "helpers/**", "scripts/**"],
-  "ignoreBinaries": ["scripts/test-bunx.sh", "make"],
+  "ignoreBinaries": ["scripts/test-npx.sh", "make"],
+  "ignoreDependencies": ["bun"],
   "ignoreExportsUsedInFile": true
 }

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "pgserve",
-  "version": "1.0.9-rc.7",
+  "version": "1.1.2",
   "description": "Embedded PostgreSQL server with true concurrent connections - zero config, auto-provision databases",
   "main": "src/index.js",
   "type": "module",
   "bin": {
-    "pgserve": "./bin/pglite-server.js"
+    "pgserve": "./bin/pgserve-wrapper.cjs"
   },
   "scripts": {
     "bench": "bun tests/benchmarks/runner.js",
@@ -18,8 +18,8 @@
     "lint": "eslint src/ bin/",
     "lint:fix": "eslint src/ bin/ --fix",
     "deadcode": "knip",
-    "test:bunx": "scripts/test-bunx.sh",
-    "prepublishOnly": "npm run lint && npm run deadcode && npm run test:bunx",
+    "test:npx": "scripts/test-npx.sh",
+    "prepublishOnly": "npm run lint && npm run deadcode && npm run test:npx",
     "prepare": "husky"
   },
   "keywords": [
@@ -55,9 +55,6 @@
     "lint-staged": "^16.2.7",
     "pg": "^8.16.3"
   },
-  "engines": {
-    "bun": ">=1.1.0"
-  },
   "lint-staged": {
     "src/**/*.js": [
       "eslint --fix"
@@ -65,5 +62,8 @@
     "bin/**/*.js": [
       "eslint --fix"
     ]
+  },
+  "dependencies": {
+    "bun": "^1.3.4"
   }
 }

package/scripts/release.cjs

@@ -89,12 +89,20 @@ function bumpRcVersion(currentVersion) {
 }
 
 function promoteToStable(currentVersion) {
-  // 1.0.9-rc.2 -> 1.0.9
-  const match = currentVersion.match(/^(\d+\.\d+\.\d+)-rc\.\d+$/);
-  if (!match) {
-    throw new Error(`Cannot promote: ${currentVersion} is not an RC version`);
+  // If RC version: 1.0.9-rc.2 -> 1.0.9
+  const rcMatch = currentVersion.match(/^(\d+\.\d+\.\d+)-rc\.\d+$/);
+  if (rcMatch) {
+    return rcMatch[1];
+  }
+
+  // If already stable: 1.1.1 -> 1.1.2 (bump patch for new stable release)
+  const stableMatch = currentVersion.match(/^(\d+)\.(\d+)\.(\d+)$/);
+  if (stableMatch) {
+    const [, major, minor, patch] = stableMatch;
+    return `${major}.${minor}.${parseInt(patch) + 1}`;
   }
-  return match[1];
+
+  throw new Error(`Invalid version format: ${currentVersion}`);
 }
 
 function createTag(version) {

package/scripts/test-npx.sh

@@ -0,0 +1,60 @@
+#!/bin/bash
+# Test that the package works with npx (simulates fresh user install)
+# This catches path resolution issues that static analysis can't detect
+
+set -e
+
+echo "=== Testing npx compatibility ==="
+
+# Create temp directory
+TEST_DIR=$(mktemp -d)
+trap "rm -rf $TEST_DIR" EXIT
+
+# Pack the current package
+echo "Packing package..."
+PACK_OUTPUT=$(npm pack --pack-destination "$TEST_DIR" 2>&1)
+PACK_FILE=$(echo "$PACK_OUTPUT" | grep -E '\.tgz$' | tail -1)
+
+# If npm pack fails, exit with an error
+if [ -z "$PACK_FILE" ] || [ ! -f "$TEST_DIR/$PACK_FILE" ]; then
+  echo "✗ Failed to pack package with npm"
+  echo "Pack output: $PACK_OUTPUT"
+  exit 1
+fi
+echo "Packed: $PACK_FILE"
+
+# Install in isolated environment using npm
+echo "Installing in isolated environment..."
+cd "$TEST_DIR"
+echo '{"name":"test-npx-install","private":true}' > package.json
+npm install "./$PACK_FILE" > /dev/null 2>&1
+
+# Test that it starts (with timeout)
+echo "Testing server startup via npx..."
+timeout 30 npx pgserve --no-cluster --port 15432 > output.log 2>&1 &
+PID=$!
+
+# Wait for ready signal (Server started successfully!)
+for i in {1..60}; do
+  if grep -q "Server started successfully" output.log 2>/dev/null; then
+    echo "✓ Server started successfully via npx"
+    kill $PID 2>/dev/null || true
+    wait $PID 2>/dev/null || true
+    echo "=== npx test PASSED ==="
+    exit 0
+  fi
+  if ! kill -0 $PID 2>/dev/null; then
+    echo "✗ Server exited unexpectedly"
+    cat output.log
+    echo "=== npx test FAILED ==="
+    exit 1
+  fi
+  sleep 0.5
+done
+
+# Timeout
+kill $PID 2>/dev/null || true
+echo "✗ Server did not start within timeout"
+cat output.log
+echo "=== npx test FAILED ==="
+exit 1

package/scripts/test-bunx.sh

@@ -1,60 +0,0 @@
-#!/bin/bash
-# Test that the package works with bunx (simulates fresh install)
-# This catches path resolution issues that static analysis can't detect
-
-set -e
-
-echo "=== Testing bunx compatibility ==="
-
-# Create temp directory
-TEST_DIR=$(mktemp -d)
-trap "rm -rf $TEST_DIR" EXIT
-
-# Pack the current package (--ignore-scripts to skip prepare/husky in CI)
-echo "Packing package..."
-PACK_PATH=$(bun pm pack --destination "$TEST_DIR" --ignore-scripts --quiet 2>&1)
-PACK_FILE=$(basename "$PACK_PATH" 2>/dev/null)
-
-# If bun pm pack fails, exit with an error
-if [ -z "$PACK_FILE" ] || [ ! -f "$TEST_DIR/$PACK_FILE" ]; then
-  echo "✗ Failed to pack package with bun"
-  echo "Pack output: $PACK_PATH"
-  exit 1
-fi
-echo "Packed: $PACK_FILE"
-
-# Extract and install in isolated environment
-echo "Installing in isolated environment..."
-cd "$TEST_DIR"
-echo '{"name":"test","type":"module"}' > package.json
-bun add "./$PACK_FILE" > /dev/null 2>&1 || bun install "$PACK_FILE" > /dev/null 2>&1
-
-# Test that it starts (with timeout)
-echo "Testing server startup..."
-timeout 8 bunx pgserve --no-cluster --port 15432 > output.log 2>&1 &
-PID=$!
-
-# Wait for ready signal
-for i in {1..20}; do
-  if grep -q "READY" output.log 2>/dev/null; then
-    echo "✓ Server started successfully"
-    kill $PID 2>/dev/null || true
-    wait $PID 2>/dev/null || true
-    echo "=== bunx test PASSED ==="
-    exit 0
-  fi
-  if ! kill -0 $PID 2>/dev/null; then
-    echo "✗ Server exited unexpectedly"
-    cat output.log
-    echo "=== bunx test FAILED ==="
-    exit 1
-  fi
-  sleep 0.5
-done
-
-# Timeout
-kill $PID 2>/dev/null || true
-echo "✗ Server did not start within timeout"
-cat output.log
-echo "=== bunx test FAILED ==="
-exit 1