velocious 1.0.586 → 1.0.587

package/package.json

@@ -3,7 +3,7 @@
     "velocious": "build/bin/velocious.js"
   },
   "name": "velocious",
-  "version": "1.0.586",
+  "version": "1.0.587",
   "main": "build/index.js",
   "types": "build/index.d.ts",
   "files": [

package/src/database/drivers/base.js

@@ -233,6 +233,13 @@ export default class VelociousDatabaseDriversBase {
     this._schemaCache = new Map()
   }
 
+  /**
+   * Cleans driver-specific session state before this logical connection is reusable.
+   * Drivers whose physical sessions cannot be safely reset should dispose them here.
+   * @returns {Promise<void>} - Resolves when the next checkout cannot observe prior session state.
+   */
+  async cleanupSessionStateAfterCheckout() {}
+
   /**
    * Runs add foreign key.
    * @param {string} tableName - Table name.

package/src/database/drivers/mysql/index.js

@@ -65,11 +65,34 @@ export default class VelociousDatabaseDriversMysql extends Base{
    * @returns {Promise<void>} - Resolves when complete.
    */
   async _close() {
-    await this.pool?.end()
+    const pool = this.pool
+
+    if (!pool) return
+
+    await new Promise((resolve, reject) => {
+      pool.end((error) => {
+        if (error) {
+          reject(error)
+        } else {
+          resolve(undefined)
+        }
+      })
+    })
     this.pool = undefined
     this.resetCurrentSessionTimeZone()
   }
 
+  /**
+   * Disposes the physical MySQL session after each logical pool checkout.
+   * MySQL exposes open-ended session state, so reconnecting is safer than trying
+   * to enumerate and reset variables, temporary tables, prepared statements,
+   * SQL modes, and other caller-controlled state.
+   * @returns {Promise<void>} - Resolves after the physical session is closed.
+   */
+  async cleanupSessionStateAfterCheckout() {
+    await this._close()
+  }
+
   /**
    * Runs set connection checkout name.
    * @param {string | undefined} name - Human-readable name for this active checkout.

package/src/database/pool/async-tracked-multi-connection.js

@@ -150,6 +150,7 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
       await this.rollbackLeftOpenTransaction(connection)
       await connection.releaseHeldAdvisoryLocks()
       await connection.clearConnectionCheckoutName()
+      await connection.cleanupSessionStateAfterCheckout()
     } catch (error) {
       await this.closeCheckedOutConnectionAfterCheckinFailure(connection, id, error)
       throw error