mysql2 3.15.3 → 3.16.0

package/lib/base/connection.js

@@ -412,6 +412,37 @@ class BaseConnection extends EventEmitter {
     this.emit('error', err);
   }
 
+  get state() {
+    // Error state has highest priority
+    if (this._fatalError || this._protocolError) {
+      return 'error';
+    }
+
+    // Closing state has second priority
+    if (this._closing || (this.stream && this.stream.destroyed)) {
+      return 'disconnected';
+    }
+
+    // Authenticated state has third priority
+    if (this.authorized) {
+      return 'authenticated';
+    }
+
+    // Connected state: handshake completed but not yet authorized
+    // This matches the original mysql driver's 'connected' state
+    if (this._handshakePacket) {
+      return 'connected';
+    }
+
+    // Protocol handshake state: connection established, handshake in progress
+    if (this.stream && !this.stream.destroyed) {
+      return 'protocol_handshake';
+    }
+
+    // Default: not connected
+    return 'disconnected';
+  }
+
   get fatalError() {
     return this._fatalError;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mysql2",
-  "version": "3.15.3",
+  "version": "3.16.0",
   "description": "fast mysql driver. Implements core protocol, prepared statements, ssl and compression in native JS",
   "main": "index.js",
   "typings": "typings/mysql/index",
@@ -60,7 +60,7 @@
     "@eslint/eslintrc": "^3.3.0",
     "@eslint/js": "^9.21.0",
     "@eslint/markdown": "^7.0.0",
-    "@types/node": "^24.0.0",
+    "@types/node": "^25.0.2",
     "@typescript-eslint/eslint-plugin": "^8.26.0",
     "@typescript-eslint/parser": "^8.26.0",
     "assert-diff": "^3.0.2",

package/typings/mysql/lib/Connection.d.ts

@@ -339,6 +339,13 @@ export interface ConnectionOptions {
   gracefulEnd?: boolean;
 }
 
+export type ConnectionState =
+  | 'disconnected'
+  | 'protocol_handshake'
+  | 'connected'
+  | 'authenticated'
+  | 'error';
+
 declare class Connection extends QueryableBase(ExecutableBase(EventEmitter)) {
   config: ConnectionOptions;
 
@@ -346,6 +353,8 @@ declare class Connection extends QueryableBase(ExecutableBase(EventEmitter)) {
 
   authorized: boolean;
 
+  readonly state: ConnectionState;
+
   static createQuery<
     T extends
       | RowDataPacket[][]