planche 0.5.1 → 0.5.3

package/README.md

@@ -40,6 +40,7 @@ npx planche [options]
   -p, --port <n>       Port to listen on (default: 8888)
       --addr <host>    Address to bind (default: 127.0.0.1)
       --token <str>    Auth token (default: random on each start)
+      --print-token    Print the token (hidden by default; the pairing link is enough)
       --no-open        Print the pairing link without opening a browser
       --verbose        Log every request
   -h, --help           Show help

package/dist/index.js

@@ -526,6 +526,7 @@ var MySqlDriver = class {
 var mysqlDriverFactory = {
   async open(config) {
     const connection = await mysql.createConnection(toConnectionOptions(config));
+    connection.on("error", (err) => console.error("[mysql] Connection error:", err.message));
     return new MySqlDriver(connection, config);
   },
   async test(config) {
@@ -719,6 +720,7 @@ var postgresDriverFactory = {
   async open(config) {
     const client = new pg.Client(toClientConfig(config));
     await client.connect();
+    client.on("error", (err) => console.error("[postgres] Connection error:", err.message));
     const driver = new PostgresDriver(client, config);
     await driver.loadTypeNames();
     return driver;
@@ -1520,6 +1522,69 @@ function testDirect(config) {
   }
 }
 
+// src/drivers/connection-lost.ts
+var ConnectionLostError = class extends Error {
+  status = 404;
+  constructor(message) {
+    super(message);
+    this.name = "ConnectionLostError";
+  }
+};
+var LOST_CODES = /* @__PURE__ */ new Set([
+  // mysql2
+  "PROTOCOL_CONNECTION_LOST",
+  "PROTOCOL_ENQUEUE_AFTER_FATAL_ERROR",
+  "PROTOCOL_ENQUEUE_AFTER_QUIT",
+  "PROTOCOL_ENQUEUE_AFTER_DESTROY",
+  // node sockets (pg, mssql/tedious surface these directly)
+  "ECONNRESET",
+  "EPIPE",
+  "ETIMEDOUT",
+  "ECONNABORTED",
+  "ENETUNREACH",
+  "EHOSTUNREACH",
+  "ENETDOWN",
+  // mssql
+  "ESOCKET",
+  "ECLOSE",
+  "ENOTOPEN",
+  // pg: admin_shutdown / crash_shutdown / cannot_connect_now
+  "57P01",
+  "57P02",
+  "57P03"
+]);
+var LOST_MESSAGES = [
+  /connection is in closed state/i,
+  // mysql2 "Can't add new command when connection is in closed state"
+  /connection lost/i,
+  /connection terminated/i,
+  // pg
+  /client has encountered a connection error/i,
+  // pg
+  /client was closed and is not queryable/i,
+  // pg
+  /connection is closed/i,
+  // mssql
+  /socket hang up/i,
+  /ORA-0311[34]\b/,
+  /ORA-01012\b/,
+  /ORA-12541\b/,
+  /ORA-03135\b/,
+  /NJS-500\b/,
+  /NJS-521\b/
+  // oracle
+];
+function isConnectionLost(err) {
+  if (!err || typeof err !== "object") return false;
+  const e = err;
+  if (typeof e.code === "string" && LOST_CODES.has(e.code)) return true;
+  if (e.fatal === true) return true;
+  if (typeof e.errorNum === "number" && [3113, 3114, 1012, 12541, 3135].includes(e.errorNum)) return true;
+  const message = typeof e.message === "string" ? e.message : "";
+  if (LOST_MESSAGES.some((re) => re.test(message))) return true;
+  return e.originalError !== void 0 && e.originalError !== err && isConnectionLost(e.originalError);
+}
+
 // src/tunneling.ts
 var IDLE_TIMEOUT_MS = Number(process.env.PLANCHE_IDLE_TIMEOUT_MS) || 30 * 60 * 1e3;
 var MAX_CONNECTIONS = Number(process.env.PLANCHE_MAX_CONNECTIONS) || 64;
@@ -1567,7 +1632,16 @@ var ConnectionManager = class {
       throw new Error(`Connection not found: ${connectionId}`);
     }
     this.lastUsed.set(connectionId, Date.now());
-    return driver.query(sql2, database);
+    try {
+      return await driver.query(sql2, database);
+    } catch (err) {
+      if (!isConnectionLost(err)) throw err;
+      console.log(`[ConnectionManager] Connection lost, evicting: ${connectionId}`);
+      this.connections.delete(connectionId);
+      this.lastUsed.delete(connectionId);
+      await driver.close().catch(() => void 0);
+      throw new ConnectionLostError(`Connection lost: ${err instanceof Error ? err.message : String(err)}`);
+    }
   }
   /**
    * Close and remove a connection.
@@ -1818,6 +1892,10 @@ function createAgent(options) {
     } catch (err) {
       const message = errorMessage(err);
       console.error("[query] Error:", message);
+      if (err instanceof ConnectionLostError) {
+        fail(res, 404, message);
+        return;
+      }
       fail(res, 422, message);
     }
   });
@@ -1879,6 +1957,7 @@ Options:
   -p, --port <n>       Port to listen on (default: 8888, env PLANCHE_PORT)
       --addr <host>    Address to bind (default: 127.0.0.1, env PLANCHE_ADDR)
       --token <str>    Auth token (default: random, env PLANCHE_AUTH_TOKEN)
+      --print-token    Print the token (for manual setup); hidden by default
       --app <url>      Web app to open (default: ${DEFAULT_APP_URL}, env PLANCHE_APP_URL)
       --origin <url>   Extra browser origin allowed to use the agent (repeatable,
                        env PLANCHE_ALLOWED_ORIGINS as a comma-separated list)
@@ -1931,6 +2010,7 @@ function main() {
         open: { type: "boolean" },
         verbose: { type: "boolean" },
         "allow-remote": { type: "boolean" },
+        "print-token": { type: "boolean" },
         version: { type: "boolean", short: "v" },
         help: { type: "boolean", short: "h" }
       },
@@ -2011,7 +2091,8 @@ function main() {
 
   ${pairUrl}
 `);
-    console.log(tokenFromEnv ? "Auth token: (from PLANCHE_AUTH_TOKEN)" : `Auth token (for manual setup): ${authToken}`);
+    if (flags["print-token"]) console.log(`Auth token: ${authToken}`);
+    else console.log(tokenFromEnv ? "Auth token: (from PLANCHE_AUTH_TOKEN)" : "Auth token: hidden \u2014 run with --print-token to show it for manual setup");
     console.log(`Allowed origins: ${allowedOrigins.join(", ")}`);
     if (!loopback) {
       console.error(`WARNING: bound to ${addr} without TLS \u2014 anyone who can reach this port and knows the token can use your databases, and anyone on the path can read the traffic.`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "planche",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "description": "Local agent for Planche — lets the browser-based Planche SQL client reach MySQL/MariaDB/PostgreSQL/SQLite/SQL Server/Oracle/Neon/Supabase/Cloudflare D1 databases from your machine.",
   "license": "UNLICENSED",
   "homepage": "https://planche.dev",