@scriptdb/client 1.1.0 → 1.1.1

package/dist/index.js

@@ -1,72 +1,116 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
 // src/index.ts
-import * as net from "net";
-import * as tls from "tls";
-import { URL } from "url";
-import * as crypto from "crypto";
+var index_exports = {};
+__export(index_exports, {
+  ScriptDBClient: () => ScriptDBClient,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+var net = __toESM(require("net"));
+var tls = __toESM(require("tls"));
+var import_url = require("url");
+var crypto = __toESM(require("crypto"));
 var noopLogger = {
-  debug: () => {},
-  info: () => {},
-  warn: () => {},
-  error: () => {}
+  debug: () => {
+  },
+  info: () => {
+  },
+  warn: () => {
+  },
+  error: () => {
+  }
 };
-
-class ScriptDBClient {
-  options;
-  socketTimeout = 0;
-  maxMessageSize = 0;
-  _mask = () => {};
-  _maskArgs = () => [];
-  logger = {};
-  secure = true;
-  requestTimeout = 0;
-  retries = 0;
-  retryDelay = 0;
-  frame = "ndjson";
-  uri = "";
-  protocolName = "";
-  username = null;
-  password = null;
-  host = "";
-  port = 0;
-  database = null;
-  client = null;
-  buffer = Buffer.alloc(0);
-  _nextId = 1;
-  _pending = new Map;
-  _maxPending = 0;
-  _maxQueue = 0;
-  _pendingQueue = [];
-  _connected = false;
-  _authenticating = false;
-  token = null;
-  _currentRetries = 0;
-  tokenExpiry = null;
-  _destroyed = false;
-  _reconnectTimer = null;
-  signing = null;
-  _stringify = JSON.stringify;
-  ready = Promise.resolve();
-  _resolveReadyFn = null;
-  _rejectReadyFn = null;
-  _connecting = null;
-  _authPendingId = null;
+var ScriptDBClient = class {
+  /**
+   * Create a new client. Do NOT auto-connect in constructor — call connect()
+   * @param uri - Connection URI
+   * @param options - Client options
+   * @param options.secure - use TLS
+   * @param options.logger - { debug, info, warn, error }
+   * @param options.requestTimeout - Request timeout in ms
+   * @param options.retries - Reconnection retries
+   * @param options.retryDelay - Initial retry delay in ms
+   * @param options.tlsOptions - Passed to tls.connect when secure
+   */
   constructor(uri, options = {}) {
-    if (!uri || typeof uri !== "string")
-      throw new Error("uri required");
+    this.socketTimeout = 0;
+    this.maxMessageSize = 0;
+    this._mask = () => {
+    };
+    this._maskArgs = () => [];
+    this.logger = {};
+    this.secure = true;
+    this.requestTimeout = 0;
+    this.retries = 0;
+    this.retryDelay = 0;
+    this.frame = "ndjson";
+    this.uri = "";
+    this.protocolName = "";
+    this.username = null;
+    this.password = null;
+    this.host = "";
+    this.port = 0;
+    this.database = null;
+    this.client = null;
+    this.buffer = Buffer.alloc(0);
+    this._nextId = 1;
+    this._pending = /* @__PURE__ */ new Map();
+    this._maxPending = 0;
+    this._maxQueue = 0;
+    this._pendingQueue = [];
+    this._connected = false;
+    this._authenticating = false;
+    this.token = null;
+    this._currentRetries = 0;
+    this.tokenExpiry = null;
+    this._destroyed = false;
+    this._reconnectTimer = null;
+    this.signing = null;
+    this._stringify = JSON.stringify;
+    this.ready = Promise.resolve();
+    this._resolveReadyFn = null;
+    this._rejectReadyFn = null;
+    this._connecting = null;
+    this._authPendingId = null;
+    if (!uri || typeof uri !== "string") throw new Error("uri required");
     this.options = Object.assign({}, options);
     this.socketTimeout = Number.isFinite(this.options.socketTimeout) ? this.options.socketTimeout : 0;
     this.maxMessageSize = Number.isFinite(this.options.maxMessageSize) ? this.options.maxMessageSize : 5 * 1024 * 1024;
     this._mask = (obj) => {
       try {
-        if (!obj || typeof obj !== "object")
-          return obj;
+        if (!obj || typeof obj !== "object") return obj;
         const copy = Array.isArray(obj) ? obj.slice() : Object.assign({}, obj);
-        if (copy.token)
-          copy.token = "****";
-        if (copy.password)
-          copy.password = "****";
-        if (copy.data && copy.data.password)
-          copy.data.password = "****";
+        if (copy.token) copy.token = "****";
+        if (copy.password) copy.password = "****";
+        if (copy.data && copy.data.password) copy.data.password = "****";
         return copy;
       } catch (e) {
         return obj;
@@ -75,10 +119,8 @@ class ScriptDBClient {
     const rawLogger = this.options.logger && typeof this.options.logger === "object" ? this.options.logger : noopLogger;
     this._maskArgs = (args) => {
       return args.map((a) => {
-        if (!a)
-          return a;
-        if (typeof a === "string")
-          return a;
+        if (!a) return a;
+        if (typeof a === "string") return a;
         return this._mask(a);
       });
     };
@@ -90,14 +132,16 @@ class ScriptDBClient {
     };
     this.secure = typeof this.options.secure === "boolean" ? !!this.options.secure : true;
     if (!this.secure)
-      this.logger.warn?.("Warning: connecting in insecure mode (secure=false). This is not recommended.");
+      this.logger.warn?.(
+        "Warning: connecting in insecure mode (secure=false). This is not recommended."
+      );
     this.requestTimeout = Number.isFinite(this.options.requestTimeout) ? this.options.requestTimeout : 0;
     this.retries = Number.isFinite(this.options.retries) ? this.options.retries : 3;
-    this.retryDelay = Number.isFinite(this.options.retryDelay) ? this.options.retryDelay : 1000;
+    this.retryDelay = Number.isFinite(this.options.retryDelay) ? this.options.retryDelay : 1e3;
     this.frame = this.options.frame === "length-prefix" || this.options.preferLengthPrefix ? "length-prefix" : "ndjson";
     let parsed;
     try {
-      parsed = new URL(uri);
+      parsed = new import_url.URL(uri);
     } catch (e) {
       throw new Error("Invalid uri");
     }
@@ -109,7 +153,9 @@ class ScriptDBClient {
     this.username = (typeof this.options.username === "string" ? this.options.username : parsed.username) || null;
     this.password = (typeof this.options.password === "string" ? this.options.password : parsed.password) || null;
     if (parsed.username && !(typeof this.options.username === "string")) {
-      this.logger.warn?.("Credentials found in URI — consider passing credentials via options instead of embedding in URI");
+      this.logger.warn?.(
+        "Credentials found in URI \u2014 consider passing credentials via options instead of embedding in URI"
+      );
     }
     try {
       parsed.username = "";
@@ -124,9 +170,9 @@ class ScriptDBClient {
     this.client = null;
     this.buffer = Buffer.alloc(0);
     this._nextId = 1;
-    this._pending = new Map;
+    this._pending = /* @__PURE__ */ new Map();
     this._maxPending = Number.isFinite(this.options.maxPending) ? this.options.maxPending : 100;
-    this._maxQueue = Number.isFinite(this.options.maxQueue) ? this.options.maxQueue : 1000;
+    this._maxQueue = Number.isFinite(this.options.maxQueue) ? this.options.maxQueue : 1e3;
     this._pendingQueue = [];
     this._connected = false;
     this._authenticating = false;
@@ -149,7 +195,8 @@ class ScriptDBClient {
     if (this._resolveReadyFn) {
       try {
         this._resolveReadyFn(value);
-      } catch (e) {}
+      } catch (e) {
+      }
       this._resolveReadyFn = null;
       this._rejectReadyFn = null;
     }
@@ -162,16 +209,22 @@ class ScriptDBClient {
       process.nextTick(() => {
         try {
           rejectFn(err);
-        } catch (e) {}
+        } catch (e) {
+        }
       });
     }
   }
+  /**
+   * Check if connected
+   */
   get connected() {
     return this._connected;
   }
+  /**
+   * Connect to server and authenticate. Returns a Promise that resolves when authenticated.
+   */
   connect() {
-    if (this._connecting)
-      return this._connecting;
+    if (this._connecting) return this._connecting;
     this._connecting = new Promise((resolve, reject) => {
       const opts = { host: this.host, port: this.port };
       const onConnect = () => {
@@ -192,7 +245,11 @@ class ScriptDBClient {
       try {
         if (this.secure) {
           const connectionOpts = { host: opts.host, port: opts.port };
-          const tlsOptions = Object.assign({}, this.options.tlsOptions || {}, connectionOpts);
+          const tlsOptions = Object.assign(
+            {},
+            this.options.tlsOptions || {},
+            connectionOpts
+          );
           if (typeof tlsOptions.rejectUnauthorized === "undefined")
             tlsOptions.rejectUnauthorized = true;
           this.client = tls.connect(tlsOptions, onConnect);
@@ -214,7 +271,10 @@ class ScriptDBClient {
         return reject(error);
       }
       const onError = (err) => {
-        this.logger?.error?.("Client socket error:", err && err.message ? err.message : err);
+        this.logger?.error?.(
+          "Client socket error:",
+          err && err.message ? err.message : err
+        );
         this._handleDisconnect(err);
       };
       const onClose = (hadError) => {
@@ -229,7 +289,8 @@ class ScriptDBClient {
           this.logger?.warn?.("Socket timeout, destroying connection");
           try {
             this.client?.destroy();
-          } catch (e) {}
+          } catch (e) {
+          }
         });
       }
     }).catch((err) => {
@@ -239,8 +300,7 @@ class ScriptDBClient {
     return this._connecting;
   }
   _setupListeners() {
-    if (!this.client)
-      return;
+    if (!this.client) return;
     console.log("ScriptDBClient _setupListeners: called, client exists:", !!this.client);
     this.client.removeAllListeners("data");
     this.buffer = Buffer.alloc(0);
@@ -258,28 +318,32 @@ class ScriptDBClient {
         while (this.buffer.length >= 4) {
           const len = this.buffer.readUInt32BE(0);
           if (len > this.maxMessageSize) {
-            this.logger?.error?.("Incoming length-prefixed frame exceeds maxMessageSize — closing connection");
+            this.logger?.error?.(
+              "Incoming length-prefixed frame exceeds maxMessageSize \u2014 closing connection"
+            );
             try {
               this.client?.destroy();
-            } catch (e) {}
+            } catch (e) {
+            }
             return;
           }
-          if (this.buffer.length < 4 + len)
-            break;
+          if (this.buffer.length < 4 + len) break;
           const payload = this.buffer.slice(4, 4 + len);
           this.buffer = this.buffer.slice(4 + len);
           let msg;
           try {
             msg = JSON.parse(payload.toString("utf8"));
           } catch (e) {
-            this.logger?.error?.("Invalid JSON frame", e && e.message ? e.message : e);
+            this.logger?.error?.(
+              "Invalid JSON frame",
+              e && e.message ? e.message : e
+            );
             continue;
           }
-          if (!msg || typeof msg !== "object")
-            continue;
+          if (!msg || typeof msg !== "object") continue;
           const validSchema = (typeof msg.id === "undefined" || typeof msg.id === "number") && (typeof msg.action === "string" || typeof msg.action === "undefined") && (typeof msg.command === "string" || typeof msg.command === "undefined") && (typeof msg.message === "string" || typeof msg.message === "undefined") && (typeof msg.data === "object" || typeof msg.data === "undefined" || msg.data === null);
           if (!validSchema) {
-            this.logger?.warn?.("Message failed schema validation — ignoring");
+            this.logger?.warn?.("Message failed schema validation \u2014 ignoring");
             continue;
           }
           this._handleMessage(msg);
@@ -303,48 +367,53 @@ class ScriptDBClient {
           while ((idx2 = chunk.indexOf(10, start)) !== -1) {
             const lineBuf = chunk.slice(start, idx2);
             start = idx2 + 1;
-            if (lineBuf.length === 0)
-              continue;
+            if (lineBuf.length === 0) continue;
             let msg;
             try {
               msg = JSON.parse(lineBuf.toString("utf8"));
             } catch (e) {
-              this.logger?.error?.("Invalid JSON from server", e && e.message ? e.message : e);
+              this.logger?.error?.(
+                "Invalid JSON from server",
+                e && e.message ? e.message : e
+              );
               continue;
             }
-            if (!msg || typeof msg !== "object")
-              continue;
+            if (!msg || typeof msg !== "object") continue;
             const validSchema = (typeof msg.id === "undefined" || typeof msg.id === "number") && (typeof msg.action === "string" || typeof msg.action === "undefined") && (typeof msg.command === "string" || typeof msg.command === "undefined") && (typeof msg.message === "string" || typeof msg.message === "undefined");
-            if (!validSchema)
-              continue;
+            if (!validSchema) continue;
             this._handleMessage(msg);
           }
           return;
         }
         this.buffer = Buffer.concat([this.buffer, chunk]);
         if (this.buffer.length > this.maxMessageSize) {
-          this.logger?.error?.("Incoming message exceeds maxMessageSize — closing connection");
+          this.logger?.error?.(
+            "Incoming message exceeds maxMessageSize \u2014 closing connection"
+          );
           try {
             this.client?.destroy();
-          } catch (e) {}
+          } catch (e) {
+          }
           return;
         }
         let idx;
         while ((idx = this.buffer.indexOf(10)) !== -1) {
           const lineBuf = this.buffer.slice(0, idx);
           this.buffer = this.buffer.slice(idx + 1);
-          if (lineBuf.length === 0)
-            continue;
+          if (lineBuf.length === 0) continue;
           let msg;
           try {
             msg = JSON.parse(lineBuf.toString("utf8"));
           } catch (e) {
-            this.logger?.error?.("Invalid JSON from server", e && e.message ? e.message : e);
+            this.logger?.error?.(
+              "Invalid JSON from server",
+              e && e.message ? e.message : e
+            );
             continue;
           }
           const validSchema = (typeof msg.id === "undefined" || typeof msg.id === "number") && (typeof msg.action === "string" || typeof msg.action === "undefined") && (typeof msg.command === "string" || typeof msg.command === "undefined") && (typeof msg.message === "string" || typeof msg.message === "undefined");
           if (!validSchema) {
-            this.logger?.warn?.("Message failed schema validation — ignoring");
+            this.logger?.warn?.("Message failed schema validation \u2014 ignoring");
             continue;
           }
           this._handleMessage(msg);
@@ -352,13 +421,19 @@ class ScriptDBClient {
       });
     }
   }
+  // build the final buffer for sending using current token and signing settings
   _buildFinalBuffer(payloadBase, id) {
-    const payloadObj = Object.assign({ id, action: payloadBase.action }, payloadBase.data !== undefined ? { data: payloadBase.data } : {});
-    if (this.token)
-      payloadObj.token = this.token;
+    const payloadObj = Object.assign(
+      { id, action: payloadBase.action },
+      payloadBase.data !== void 0 ? { data: payloadBase.data } : {}
+    );
+    if (this.token) payloadObj.token = this.token;
     const payloadStr = this._stringify(payloadObj);
     if (this.signing && this.signing.secret) {
-      const hmac = crypto.createHmac(this.signing.algorithm || "sha256", this.signing.secret);
+      const hmac = crypto.createHmac(
+        this.signing.algorithm || "sha256",
+        this.signing.secret
+      );
       hmac.update(payloadStr);
       const sig = hmac.digest("hex");
       const envelope = { id, signature: sig, payload: payloadObj };
@@ -370,8 +445,7 @@ class ScriptDBClient {
         body.copy(buf, 4);
         return buf;
       }
-      return Buffer.from(envelopeStr + `
-`, "utf8");
+      return Buffer.from(envelopeStr + "\n", "utf8");
     }
     if (this.frame === "length-prefix") {
       const body = Buffer.from(payloadStr, "utf8");
@@ -380,8 +454,7 @@ class ScriptDBClient {
       body.copy(buf, 4);
       return buf;
     }
-    return Buffer.from(payloadStr + `
-`, "utf8");
+    return Buffer.from(payloadStr + "\n", "utf8");
   }
   _handleMessage(msg) {
     console.log("ScriptDBClient _handleMessage:", JSON.stringify(msg));
@@ -395,8 +468,7 @@ class ScriptDBClient {
         return;
       }
       const { resolve, reject, timer } = pending;
-      if (timer)
-        clearTimeout(timer);
+      if (timer) clearTimeout(timer);
       this._pending.delete(msg.id);
       this._processQueue();
       if (msg.action === "login" || msg.command === "login") {
@@ -412,7 +484,8 @@ class ScriptDBClient {
           const errorMsg = msg.data || "Authentication failed";
           try {
             this.client?.end();
-          } catch (e) {}
+          } catch (e) {
+          }
           return reject(new Error(typeof errorMsg === "string" ? errorMsg : "Authentication failed"));
         }
       }
@@ -456,27 +529,22 @@ class ScriptDBClient {
       }
       this._pending.set(id, {
         resolve: (data) => {
-          if (timer)
-            clearTimeout(timer);
+          if (timer) clearTimeout(timer);
           this._authenticating = false;
-          if (data && data.token)
-            this.token = data.token;
+          if (data && data.token) this.token = data.token;
           resolve(data);
         },
         reject: (err) => {
-          if (timer)
-            clearTimeout(timer);
+          if (timer) clearTimeout(timer);
           this._authenticating = false;
           reject(err);
         },
         timer
       });
       try {
-        const buf = Buffer.from(JSON.stringify(payload) + `
-`, "utf8");
+        const buf = Buffer.from(JSON.stringify(payload) + "\n", "utf8");
         this._write(buf).catch((err) => {
-          if (timer)
-            clearTimeout(timer);
+          if (timer) clearTimeout(timer);
           this._pending.delete(id);
           this._authenticating = false;
           reject(err);
@@ -498,18 +566,18 @@ class ScriptDBClient {
       throw err;
     });
   }
+  // internal write helper that respects backpressure
   _write(buf) {
     return new Promise((resolve, reject) => {
       if (!this.client || !this._connected)
         return reject(new Error("Not connected"));
       try {
         const ok = this.client.write(buf, (err) => {
-          if (err)
-            return reject(err);
-          resolve(undefined);
+          if (err) return reject(err);
+          resolve(void 0);
         });
         if (!ok) {
-          this.client.once("drain", () => resolve(undefined));
+          this.client.once("drain", () => resolve(void 0));
         }
       } catch (e) {
         reject(e);
@@ -526,7 +594,8 @@ class ScriptDBClient {
           clearTimeout(timer);
           try {
             reject(new Error("Token expired and refresh failed"));
-          } catch (e) {}
+          } catch (e) {
+          }
           continue;
         }
       }
@@ -537,7 +606,8 @@ class ScriptDBClient {
         clearTimeout(timer);
         try {
           reject(e);
-        } catch (er) {}
+        } catch (er) {
+        }
         continue;
       }
       this._pending.set(id, { resolve, reject, timer });
@@ -548,24 +618,29 @@ class ScriptDBClient {
         this._pending.delete(id);
         try {
           reject(e);
-        } catch (er) {}
+        } catch (er) {
+        }
       }
     }
   }
+  /**
+   * Execute a command. Supports concurrent requests via request id mapping.
+   * Returns a Promise resolved with response.data or rejected on ERROR/timeout.
+   */
   async execute(payload) {
     try {
       await this.ready;
     } catch (err) {
-      throw new Error("Not authenticated: " + (err && err.message ? err.message : err));
+      throw new Error(
+        "Not authenticated: " + (err && err.message ? err.message : err)
+      );
     }
-    if (!this.token)
-      throw new Error("Not authenticated");
+    if (!this.token) throw new Error("Not authenticated");
     const id = this._nextId++;
     const payloadBase = { action: payload.action, data: payload.data };
     if (this.tokenExpiry && Date.now() >= this.tokenExpiry) {
       const refreshed = await this._maybeRefreshToken();
-      if (!refreshed)
-        throw new Error("Token expired");
+      if (!refreshed) throw new Error("Token expired");
     }
     return new Promise((resolve, reject) => {
       let timer = null;
@@ -579,12 +654,12 @@ class ScriptDBClient {
       }
       if (this._pending.size >= this._maxPending) {
         if (this._pendingQueue.length >= this._maxQueue) {
-          if (timer)
-            clearTimeout(timer);
+          if (timer) clearTimeout(timer);
           return reject(new Error("Pending queue full"));
         }
         this._pendingQueue.push({ payloadBase, id, resolve, reject, timer });
-        this._processQueue().catch(() => {});
+        this._processQueue().catch(() => {
+        });
         return;
       }
       let finalBuf;
@@ -596,13 +671,16 @@ class ScriptDBClient {
       }
       this._pending.set(id, { resolve, reject, timer });
       this._write(finalBuf).catch((e) => {
-        if (timer)
-          clearTimeout(timer);
+        if (timer) clearTimeout(timer);
         this._pending.delete(id);
         reject(e);
       });
     });
   }
+  /**
+   * Attempt to refresh token using provided tokenRefresh option if token expired.
+   * options.tokenRefresh should be async function that returns { token, expiresAt }
+   */
   async _maybeRefreshToken() {
     if (!this.options.tokenRefresh || typeof this.options.tokenRefresh !== "function")
       return false;
@@ -610,12 +688,14 @@ class ScriptDBClient {
       const res = await this.options.tokenRefresh();
       if (res && res.token) {
         this.token = res.token;
-        if (res.expiresAt)
-          this.tokenExpiry = res.expiresAt;
+        if (res.expiresAt) this.tokenExpiry = res.expiresAt;
         return true;
       }
     } catch (e) {
-      this.logger?.error?.("Token refresh failed", e && e.message ? e.message : String(e));
+      this.logger?.error?.(
+        "Token refresh failed",
+        e && e.message ? e.message : String(e)
+      );
     }
     return false;
   }
@@ -627,18 +707,18 @@ class ScriptDBClient {
     }
     this._rejectReady(new Error("Client destroyed"));
     this._pending.forEach((pending, id) => {
-      if (pending.timer)
-        clearTimeout(pending.timer);
+      if (pending.timer) clearTimeout(pending.timer);
       try {
         pending.reject(new Error("Client destroyed"));
-      } catch (e) {}
+      } catch (e) {
+      }
       this._pending.delete(id);
     });
     this._pendingQueue = [];
     try {
-      if (this.client)
-        this.client.destroy();
-    } catch (e) {}
+      if (this.client) this.client.destroy();
+    } catch (e) {
+    }
     this.client = null;
   }
   _handleDisconnect(err) {
@@ -647,13 +727,13 @@ class ScriptDBClient {
     }
     const wasAuthenticating = this._authenticating;
     this._pending.forEach((pending, id) => {
-      if (pending.timer)
-        clearTimeout(pending.timer);
+      if (pending.timer) clearTimeout(pending.timer);
       const errorMsg = wasAuthenticating ? "Authentication failed - credentials may be required" : err && err.message ? err.message : "Disconnected";
       process.nextTick(() => {
         try {
           pending.reject(new Error(errorMsg));
-        } catch (e) {}
+        } catch (e) {
+        }
       });
       this._pending.delete(id);
     });
@@ -664,16 +744,22 @@ class ScriptDBClient {
       const rejectErr = err || new Error("Authentication failed and no retries configured");
       try {
         this._rejectReady(rejectErr);
-      } catch (e) {}
+      } catch (e) {
+      }
       return;
     }
     if (this._currentRetries < this.retries) {
       this._createReady();
-      const base = Math.min(this.retryDelay * Math.pow(2, this._currentRetries), 30000);
-      const jitter = Math.floor(Math.random() * Math.min(1000, base));
+      const base = Math.min(
+        this.retryDelay * Math.pow(2, this._currentRetries),
+        3e4
+      );
+      const jitter = Math.floor(Math.random() * Math.min(1e3, base));
       const delay = base + jitter;
       this._currentRetries += 1;
-      this.logger?.info?.("Attempting reconnect in " + delay + "ms (attempt " + this._currentRetries + ")");
+      this.logger?.info?.(
+        "Attempting reconnect in " + delay + "ms (attempt " + this._currentRetries + ")"
+      );
       this.token = null;
       setTimeout(() => {
         this.connect().catch((e) => {
@@ -683,62 +769,104 @@ class ScriptDBClient {
     } else {
       try {
         this._rejectReady(err || new Error("Disconnected and no retries left"));
-      } catch (e) {}
+      } catch (e) {
+      }
     }
   }
   close() {
-    if (!this.client)
-      return;
+    if (!this.client) return;
     try {
       this.client.removeAllListeners("data");
       this.client.removeAllListeners("error");
       this.client.removeAllListeners("close");
       this.client.end();
-    } catch (e) {}
+    } catch (e) {
+    }
     this.client = null;
   }
+  /**
+   * Disconnect (alias for close)
+   */
   disconnect() {
     this.close();
   }
+  /**
+   * Send request helper (for public API methods)
+   */
   async sendRequest(action, data = {}) {
     return this.execute({ action, data });
   }
+  // ========== Public API Methods ==========
+  /**
+   * Login with username and password
+   */
   async login(username, password) {
     return this.sendRequest("login", { username, password });
   }
+  /**
+   * Logout from server
+   */
   async logout() {
     return this.sendRequest("logout", {});
   }
+  /**
+   * List all databases
+   */
   async listDatabases() {
     return this.sendRequest("list-dbs", {});
   }
+  /**
+   * Create a new database
+   */
   async createDatabase(name) {
     return this.sendRequest("create-db", { databaseName: name });
   }
+  /**
+   * Remove a database
+   */
   async removeDatabase(name) {
     return this.sendRequest("remove-db", { databaseName: name });
   }
+  /**
+   * Rename a database
+   */
   async renameDatabase(oldName, newName) {
     return this.sendRequest("rename-db", { databaseName: oldName, newName });
   }
+  /**
+   * Execute code in a database
+   */
   async run(code, databaseName) {
     return this.sendRequest("script-code", { code, databaseName });
   }
+  /**
+   * Save a database to disk
+   */
   async saveDatabase(databaseName) {
     return this.sendRequest("save-db", { databaseName });
   }
+  /**
+   * Update database metadata
+   */
   async updateDatabase(databaseName, data) {
     return this.sendRequest("update-db", { databaseName, ...data });
   }
+  /**
+   * Get server information
+   */
   async getInfo() {
     return this.sendRequest("get-info", {});
   }
+  /**
+   * Execute shell command on server
+   */
   async executeShell(command) {
     return this.sendRequest("shell-command", { command });
   }
-}
-var src_default = ScriptDBClient;
-export {
-  src_default as default,
-  ScriptDBClient
 };
+var index_default = ScriptDBClient;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ScriptDBClient
+});
+//# sourceMappingURL=index.js.map