Add tests, schema sync safeguards, and query/handler improvements

- Add bun test suite: SQL generator and value unit tests, plus MariaDB
  integration tests gated on BUN_MARIADB_TEST_DB
- schema: add --dry-run and require confirmation (or --yes) before
  dropping tables/columns; block unapproved destructive statements
- Always AND targetId with the query, regardless of searchOperator
- Initialize lazily on first call; init throws instead of exiting
- Generate IN (?, ?, ...) lists for IN / NOT IN
- Share value binding between insert and update (booleans, embeddings,
  function values, "" -> NULL for non-text columns)
- Keep Buffers and convert BigInt/Date without a JSON round-trip
- DbSQL: report success for empty SELECT results
- Run update() in a transaction with row locking
- Key the client cache on the full connection config
- Consolidate identifier quoting, drop dead code, merge column lookup
- Read CLI version from package.json, pin @types/bun, chmod CLI on compile
- Rebuild dist

Co-Authored-By: Claude Opus 5.5 <[email protected]>

dist/lib/db-handler.js

@@ -1,41 +1,62 @@
-import grabMariaDBClient from "../functions/grab-mariadb-client";
+import grabMariaDBClient, { mariadbClientCacheKey, } from "../functions/grab-mariadb-client";
 /**
  * Resolve a shared MariaDB client. Prefer the global client so schema sync
  * and CRUD do not open a new connection per query.
  */
-function resolveClient(config) {
-    const resolvedConfig = config || global.CONFIG;
-    // Same database as the global client → reuse it
-    if (global.MARIADB_CLIENT &&
-        (!resolvedConfig?.db_name ||
-            !global.CONFIG?.db_name ||
-            resolvedConfig.db_name === global.CONFIG.db_name)) {
+export function resolveClient(config) {
+    if (!config) {
         return global.MARIADB_CLIENT;
     }
-    if (resolvedConfig) {
-        return grabMariaDBClient({ config: resolvedConfig });
+    // Same connection config as the global client → reuse it
+    if (global.MARIADB_CLIENT &&
+        (!global.CONFIG ||
+            mariadbClientCacheKey(config) ===
+                mariadbClientCacheKey(global.CONFIG))) {
+        return global.MARIADB_CLIENT;
     }
-    return global.MARIADB_CLIENT;
+    return grabMariaDBClient({ config });
+}
+/**
+ * Convert driver rows to plain objects.
+ * - BigInt -> number (or string when outside the safe integer range)
+ * - Date -> ISO string (matches the generated `string` typedefs)
+ * - Buffers / typed arrays (BLOB, VECTOR) are kept as-is
+ */
+function normalizeValue(value) {
+    if (typeof value == "bigint") {
+        const num = Number(value);
+        return Number.isSafeInteger(num) ? num : value.toString();
+    }
+    if (value instanceof Date) {
+        return Number.isNaN(value.getTime()) ? null : value.toISOString();
+    }
+    return value;
+}
+function normalizeRows(res) {
+    if (!Array.isArray(res))
+        return undefined;
+    return res.map((row) => {
+        if (!row || typeof row != "object")
+            return row;
+        const normalized = {};
+        for (const [key, value] of Object.entries(row)) {
+            normalized[key] = normalizeValue(value);
+        }
+        return normalized;
+    });
 }
 /**
  * # Main DB Handler Function
  */
-export default async function dbHandler({ query, values, config }) {
+export default async function dbHandler({ query, values, config, client }) {
     try {
-        const CLIENT = resolveClient(config);
+        const CLIENT = client || resolveClient(config);
         if (!CLIENT) {
             throw new Error(`Couldn't grab MariaDB Client.`);
         }
         const res = await CLIENT.unsafe(query, values);
         const count = res.count;
-        const res_array = (() => {
-            try {
-                return JSON.parse(JSON.stringify(res));
-            }
-            catch (error) {
-                return undefined;
-            }
-        })();
+        const res_array = normalizeRows(res);
         const last_insert_id = res_array?.[0] ? res_array[0]?.id : undefined;
         const affected_rows = res_array?.[0] ? res_array.length : undefined;
         const insert_return = {