pgserve 1.1.2 → 1.1.3-rc.2

package/bin/pgserve-wrapper.cjs

@@ -5,9 +5,12 @@
  * 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.
+ *
+ * Windows EBUSY fix: Uses synchronous waiting and taskkill for
+ * reliable process termination and file handle cleanup.
  */
 
-const { spawn } = require('child_process');
+const { spawn, execSync } = require('child_process');
 const path = require('path');
 const fs = require('fs');
 
@@ -53,6 +56,8 @@ if (!bunPath) {
 const scriptPath = path.join(__dirname, 'pglite-server.js');
 
 // Spawn bun with the actual script, inherit all stdio
+// IMPORTANT: Do NOT use detached mode - wrapper must wait for child to fully terminate
+// Using detached with stdio:'inherit' causes file handle inheritance issues on Windows
 const child = spawn(bunPath, [scriptPath, ...process.argv.slice(2)], {
   stdio: 'inherit',
   windowsHide: true
@@ -63,19 +68,85 @@ child.on('error', (err) => {
   process.exit(1);
 });
 
-child.on('exit', (code, signal) => {
+// Safety timeout: force exit if 'close' event never fires after 'exit'
+let forceExitTimeout = null;
+
+child.on('exit', () => {
+  // Give 5 seconds for 'close' event after 'exit'
+  forceExitTimeout = setTimeout(() => {
+    console.error('Warning: Child process did not close cleanly, forcing exit');
+    process.exit(1);
+  }, 5000);
+});
+
+// Use 'close' event instead of 'exit' - fires AFTER all stdio streams are closed
+// This is critical for Windows where file handles may remain locked after 'exit' fires
+child.on('close', (code, signal) => {
+  // Clear the safety timeout
+  if (forceExitTimeout) {
+    clearTimeout(forceExitTimeout);
+  }
+
+  // On Windows, use SYNCHRONOUS delay to ensure all file handles are released
+  // This prevents EBUSY errors when npx tries to clean up the cache
+  // NOTE: async/await does NOT work in EventEmitter callbacks - Node ignores the Promise
+  if (isWindows) {
+    const delay = 200; // ms - enough for Windows kernel to release handles
+    const start = Date.now();
+    while (Date.now() - start < delay) {
+      // Synchronous busy-wait - actually blocks unlike async setTimeout
+    }
+  }
+
   if (signal) {
-    process.kill(process.pid, signal);
+    // On Windows, can't reliably re-raise Unix signals
+    if (isWindows) {
+      process.exit(1);
+    } else {
+      process.kill(process.pid, signal);
+    }
   } else {
     process.exit(code ?? 0);
   }
 });
 
-// Forward signals to child process
-['SIGINT', 'SIGTERM', 'SIGHUP'].forEach(signal => {
-  process.on(signal, () => {
+// Platform-specific signal handling
+if (isWindows) {
+  // Windows: use taskkill for reliable process termination
+  // process.kill(pid, 'SIGINT') does NOT work properly on Windows
+  process.on('SIGINT', () => {
     if (child.pid) {
-      process.kill(child.pid, signal);
+      try {
+        // /T = terminate child processes (tree), /F = force
+        execSync(`taskkill /PID ${child.pid} /T /F`, {
+          stdio: 'ignore',
+          windowsHide: true
+        });
+      } catch {
+        // Process may have already exited, ignore errors
+      }
     }
   });
-});
+
+  // Handle Ctrl+C via readline for Windows terminal compatibility
+  // Some Windows terminals don't emit SIGINT properly
+  const readline = require('readline');
+  if (process.stdin.isTTY) {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+    rl.on('SIGINT', () => {
+      process.emit('SIGINT');
+    });
+  }
+} else {
+  // Unix: forward signals to child process normally
+  ['SIGINT', 'SIGTERM', 'SIGHUP'].forEach(signal => {
+    process.on(signal, () => {
+      if (child.pid) {
+        process.kill(child.pid, signal);
+      }
+    });
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pgserve",
-  "version": "1.1.2",
+  "version": "1.1.3-rc.2",
   "description": "Embedded PostgreSQL server with true concurrent connections - zero config, auto-provision databases",
   "main": "src/index.js",
   "type": "module",

package/src/postgres.js

@@ -308,6 +308,12 @@ export class PostgresManager {
     // Initialize admin connection pool (for database creation operations)
     await this._initAdminPool();
 
+    // For persistent mode, load existing databases into createdDatabases
+    // This prevents "database already exists" errors when reusing data directories
+    if (this.persistent) {
+      await this._loadExistingDatabases();
+    }
+
     this.logger.info({
       databaseDir: this.databaseDir,
       port: this.port,
@@ -407,6 +413,33 @@ export class PostgresManager {
     }, 'Admin connection pool initialized (Bun.sql)');
   }
 
+  /**
+   * Load existing databases into createdDatabases Set (for persistent mode)
+   * This allows pgserve to reuse existing data directories without
+   * attempting to CREATE DATABASE for databases that already exist.
+   */
+  async _loadExistingDatabases() {
+    try {
+      const result = await this.adminPool`
+        SELECT datname FROM pg_database
+        WHERE datistemplate = false
+        AND datname NOT IN ('postgres', 'template0', 'template1')
+      `;
+
+      for (const row of result) {
+        this.createdDatabases.add(row.datname);
+      }
+
+      this.logger.info({
+        databases: Array.from(this.createdDatabases),
+        count: this.createdDatabases.size
+      }, 'Loaded existing databases from persistent storage');
+    } catch (error) {
+      // Non-fatal - if we can't load existing DBs, createDatabase will handle it
+      this.logger.warn({ error: error.message }, 'Failed to load existing databases');
+    }
+  }
+
   /**
    * Start the PostgreSQL server process
    * Uses Bun.spawn() for ~40% faster process startup
@@ -543,7 +576,11 @@ export class PostgresManager {
     } catch (error) {
       // Database might already exist (from previous persistent session or race condition)
       // 42P04 = duplicate_database, 23505 = unique_violation
-      if (error.code === '42P04' || error.code === '23505') {
+      // Also check error.message for Bun.sql compatibility (may not expose SQLSTATE codes)
+      const isAlreadyExists = error.code === '42P04' ||
+                              error.code === '23505' ||
+                              error.message?.includes('already exists');
+      if (isAlreadyExists) {
         this.createdDatabases.add(dbName);
         this.logger.debug({ dbName }, 'Database already exists');
       } else {