befly 3.76.0 → 3.76.2

package/{lib → libs/mysql}/dbHelper.js

@@ -1,11 +1,11 @@
-import { createError, getRootCause, validationError } from "../utils/error.js";
-import { fieldClear } from "../utils/fieldClear.js";
-import { isLowerCamelCaseName, isNonEmptyString, isNullable, isNumber, isPlainObject, isString } from "../utils/is.js";
-import { camelCase, canConvertToNumber, keysToSnake, snakeCase } from "../utils/util.js";
+import { genId } from "../../utils/id.js";
+import { Logger } from "../logger/index.js";
 import { DbParse } from "./dbParse.js";
 import { deserializeArrayFields, parseTableRef, serializeArrayFields } from "./dbUtil.js";
-import { Logger } from "./logger.js";
-import { SqlBuilder } from "./sqlBuilder.js";
+import { createError, getRootCause, validationError } from "./error.js";
+import { isLowerCamelCaseName, isNonEmptyString, isNullable, isNumber, isPlainObject, isString } from "./is.js";
+import { SqlBuilder } from "./sql/index.js";
+import { camelCase, canConvertToNumber, fieldClear, keysToSnake, snakeCase } from "./util.js";
 
 function quoteIdentMySql(identifier) {
     if (!isString(identifier)) {
@@ -221,7 +221,7 @@ function assertBatchInsertRowsConsistent(rows, options) {
 
 class DbHelper {
     constructor(options = {}) {
-        this.redis = options.redis;
+        this.closeHandler = options.close;
 
         if (!isNonEmptyString(options.dbName)) {
             throw validationError("DbHelper 初始化失败：dbName 必须为非空字符串");
@@ -236,21 +236,24 @@ class DbHelper {
         this.queryTimeout = (options.queryTimeout || 30) * 1000;
     }
 
-    getTableDef(table) {
+    getTableModel(table) {
         const tableName = parseTableRef(table).table;
 
-        if (!isLowerCamelCaseName(tableName)) {
-            throw validationError(`表名必须使用小驼峰写法 (table: ${tableName})`);
+        if (!isLowerCamelCaseName(tableName)) throw validationError(`表名必须使用小驼峰写法 (table: ${tableName})`);
+        const tableModel = this.tables[tableName];
+        if (!isPlainObject(tableModel) || !isPlainObject(tableModel.fields)) {
+            const sourceLabel = tableName.startsWith("befly") ? "opensource/core/tables" : "app tables";
+            throw createError(`表 ${tableName} 缺少标准 tables 模型，请检查 ${sourceLabel}`, { code: "runtime" });
         }
+        return tableModel;
+    }
 
-        const tableInfo = this.tables[tableName];
-
-        if (!isPlainObject(tableInfo)) {
-            const sourceLabel = tableName.startsWith("befly") ? "packages/core/tables" : "app tables";
-            throw createError(`表 ${tableName} 缺少本地 tables 定义，请检查 ${sourceLabel}`, { code: "runtime" });
-        }
+    getTableMode(table) {
+        return parseTableRef(table).table.startsWith("befly") ? "auto" : this.beflyMode;
+    }
 
-        return tableInfo;
+    getTableFields(table) {
+        return this.getTableModel(table).fields;
     }
 
     normalizeDbFieldNames(row) {
@@ -297,17 +300,20 @@ class DbHelper {
             }
         }
 
+        let queryTimedOut = false;
         try {
-            // 查询超时兜底：SQL 响应丢失/挂起时显式报错，避免进程静默卡死
-            const queryPromise = safeParams.length > 0 ? this.sql.unsafe(sql, safeParams) : this.sql.unsafe(sql);
-            let timeoutId;
-            const timeoutPromise = new Promise((_, reject) => {
-                timeoutId = setTimeout(() => {
-                    reject(createError(`SQL 执行超时（${this.queryTimeout}ms）: ${sql.slice(0, 100)}`, { code: "runtime", subsystem: "sql", operation: "execute", sqlInfo: { sql: sql, params: safeParams } }));
-                }, this.queryTimeout);
-            });
-            const queryResult = await Promise.race([queryPromise, timeoutPromise]);
-            clearTimeout(timeoutId);
+            const query = safeParams.length > 0 ? this.sql.unsafe(sql, safeParams) : this.sql.unsafe(sql);
+            const timeoutId = setTimeout(() => {
+                queryTimedOut = true;
+                query.cancel();
+            }, this.queryTimeout);
+
+            let queryResult;
+            try {
+                queryResult = await query;
+            } finally {
+                clearTimeout(timeoutId);
+            }
 
             const duration = Date.now() - startTime;
 
@@ -320,10 +326,19 @@ class DbHelper {
                 }
             };
         } catch (error) {
+            const executeError = queryTimedOut
+                ? createError(`SQL 执行超时（${this.queryTimeout}ms）: ${sql.slice(0, 100)}`, {
+                      cause: error,
+                      code: "runtime",
+                      subsystem: "sql",
+                      operation: "execute"
+                  })
+                : error;
+
             const duration = Date.now() - startTime;
-            const msg = getExecuteErrorMessage(error);
+            const msg = getExecuteErrorMessage(executeError);
 
-            if (retryOnConnectionClosed && this.isConnectionClosedError(error, msg)) {
+            if (retryOnConnectionClosed && this.isConnectionClosedError(executeError, msg)) {
                 return this.execute(sql, params, false);
             }
 
@@ -333,7 +348,7 @@ class DbHelper {
                 duration: duration
             };
             throw createError(`SQL执行失败: ${msg}`, {
-                cause: error,
+                cause: executeError,
                 code: "runtime",
                 subsystem: "sql",
                 operation: "execute",
@@ -350,9 +365,6 @@ class DbHelper {
         if (rootCause?.code === "ERR_MYSQL_CONNECTION_CLOSED") {
             return true;
         }
-        if (rootCause?.code === "ERR_POSTGRES_CONNECTION_CLOSED") {
-            return true;
-        }
         if (typeof msg === "string" && msg.includes("Connection closed")) {
             return true;
         }
@@ -396,13 +408,13 @@ class DbHelper {
         };
     }
 
-    normalizeRowData(row) {
+    normalizeRowData(row, tableInfo = {}) {
         if (!row) {
             return {};
         }
 
         const camelRow = this.normalizeDbFieldNames(row);
-        const deserialized = deserializeArrayFields(camelRow);
+        const deserialized = deserializeArrayFields(camelRow, tableInfo);
 
         const convertedList = normalizeBigIntValues([deserialized]);
         if (convertedList && convertedList.length > 0) {
@@ -412,20 +424,20 @@ class DbHelper {
         return deserialized;
     }
 
-    normalizeListData(list) {
+    normalizeListData(list, tableInfo = {}) {
         const camelList = list.map((item) => this.normalizeDbFieldNames(item));
-        const deserializedList = camelList.map((item) => deserializeArrayFields(item)).filter((item) => item !== null);
+        const deserializedList = camelList.map((item) => deserializeArrayFields(item, tableInfo)).filter((item) => item !== null);
         return normalizeBigIntValues(deserializedList);
     }
 
-    prepareWriteInputData(data) {
-        return serializeArrayFields(keysToSnake(fieldClear(data, { excludeValues: [undefined] })));
+    prepareWriteInputData(data, tableInfo = {}) {
+        return serializeArrayFields(keysToSnake(fieldClear(data, { excludeValues: [undefined] })), tableInfo);
     }
 
-    prepareWriteUserData(data, allowState) {
+    prepareWriteUserData(data, allowState, tableInfo = {}) {
         const result = {};
 
-        for (const [key, value] of Object.entries(this.prepareWriteInputData(data))) {
+        for (const [key, value] of Object.entries(this.prepareWriteInputData(data, tableInfo))) {
             if (key === "id") continue;
             if (key === "created_at") continue;
             if (key === "updated_at") continue;
@@ -438,7 +450,7 @@ class DbHelper {
     }
 
     buildInsertRow(options) {
-        const result = options.beflyMode === "manual" ? this.prepareWriteInputData(options.data) : this.prepareWriteUserData(options.data, false);
+        const result = options.beflyMode === "manual" ? this.prepareWriteInputData(options.data, options.tableInfo) : this.prepareWriteUserData(options.data, false, options.tableInfo);
 
         if (options.beflyMode === "auto") {
             assertTimeIdValue(options.id);
@@ -455,7 +467,7 @@ class DbHelper {
     }
 
     buildUpdateRow(options) {
-        const result = options.beflyMode === "manual" ? this.prepareWriteInputData(options.data) : this.prepareWriteUserData(options.data, options.allowState);
+        const result = options.beflyMode === "manual" ? this.prepareWriteInputData(options.data, options.tableInfo) : this.prepareWriteUserData(options.data, options.allowState, options.tableInfo);
         if (options.beflyMode !== "manual") {
             result.updated_at = options.now;
         }
@@ -463,7 +475,7 @@ class DbHelper {
     }
 
     async getTableColumns(table) {
-        const tableInfo = this.getTableDef(table);
+        const tableInfo = this.getTableFields(table);
         const fieldNames = Object.keys(tableInfo);
 
         if (fieldNames.length === 0) {
@@ -484,14 +496,17 @@ class DbHelper {
     }
 
     async createInsertRows(table, snakeTable, dataList, now) {
-        if (this.beflyMode === "manual") {
+        const tableInfo = this.getTableFields(table);
+        const tableMode = this.getTableMode(table);
+        if (tableMode === "manual") {
             return {
                 ids: [],
                 processedList: dataList.map((data) =>
                     this.buildInsertRow({
                         data: data,
                         now: now,
-                        beflyMode: this.beflyMode
+                        beflyMode: tableMode,
+                        tableInfo: tableInfo
                     })
                 )
             };
@@ -500,15 +515,15 @@ class DbHelper {
         const ids = [];
         try {
             for (let i = 0; i < dataList.length; i++) {
-                ids.push(await this.redis.genTimeID());
+                ids.push(genId());
             }
         } catch (error) {
             if (dataList.length === 1) {
-                throw createError(`生成 ID 失败，Redis 可能不可用 (table: ${table})`, {
+                throw createError(`生成 ID 失败 (table: ${table})`, {
                     cause: error,
                     code: "runtime",
                     subsystem: "db",
-                    operation: "genTimeID",
+                    operation: "genId",
                     table: table
                 });
             }
@@ -525,7 +540,8 @@ class DbHelper {
                 data: data,
                 id: id,
                 now: now,
-                beflyMode: this.beflyMode
+                beflyMode: tableMode,
+                tableInfo: tableInfo
             });
         });
 
@@ -538,7 +554,7 @@ class DbHelper {
     resolveInsertedData(table, count, executeRes, generatedIds, operation) {
         const lastInsertRowidNum = normalizeSqlMetaNumber(executeRes.data?.lastInsertRowid);
 
-        if (this.beflyMode === "manual") {
+        if (this.getTableMode(table) === "manual") {
             if (lastInsertRowidNum <= 0) {
                 throw createError(operation === "insBatch" ? `批量插入失败：beflyMode=manual 时无法获取 lastInsertRowid (table: ${table})` : `插入失败：beflyMode=manual 时无法获取 lastInsertRowid (table: ${table})`, { code: "runtime" });
             }
@@ -581,7 +597,7 @@ class DbHelper {
         const executeRes = await this.execute(sql, params);
         const result = executeRes.data;
 
-        const data = this.normalizeRowData(result?.[0] || null);
+        const data = this.normalizeRowData(result?.[0] || null, this.getTableFields(prepared.codeTable));
         return {
             data: data,
             sql: executeRes.sql
@@ -625,7 +641,7 @@ class DbHelper {
 
         return {
             data: {
-                lists: this.normalizeListData(list),
+                lists: this.normalizeListData(list, this.getTableFields(prepared.codeTable)),
                 total: total,
                 page: prepared.page,
                 limit: prepared.limit,
@@ -694,7 +710,7 @@ class DbHelper {
             });
         }
 
-        const lists = this.normalizeListData(result);
+        const lists = this.normalizeListData(result, this.getTableFields(prepared.codeTable));
 
         return {
             data: {
@@ -721,8 +737,8 @@ class DbHelper {
     async insData(options) {
         const parsed = this.createDbParse().parseInsert(options);
         const { table, snakeTable, data } = parsed;
-        const tableInfo = this.getTableDef(table);
-        const inputData = this.prepareWriteInputData(data);
+        const tableInfo = this.getTableFields(table);
+        const inputData = this.prepareWriteInputData(data, tableInfo);
         assertWriteDataHasFields(inputData, "插入数据必须至少有一个字段", snakeTable);
         const now = Date.now();
         const insertRows = await this.createInsertRows(table, snakeTable, [data], now);
@@ -758,7 +774,7 @@ class DbHelper {
         assertInsertBatchSize(dataList.length, MAX_BATCH_SIZE);
 
         const snakeTable = parsed.snakeTable;
-        const tableInfo = this.getTableDef(table);
+        const tableInfo = this.getTableFields(table);
         const now = Date.now();
         const insertRows = await this.createInsertRows(table, snakeTable, dataList, now);
         const processedList = insertRows.processedList;
@@ -800,9 +816,10 @@ class DbHelper {
         }
 
         const snakeTable = parsed.snakeTable;
+        const primaryField = snakeCase(this.getTableModel(table).primary || "id");
         const query = SqlBuilder.toDeleteInSql({
             table: snakeTable,
-            idField: "id",
+            idField: primaryField,
             ids: ids,
             quoteIdent: quoteIdentMySql
         });
@@ -826,20 +843,24 @@ class DbHelper {
         }
 
         const snakeTable = parsed.snakeTable;
-        const tableInfo = this.getTableDef(table);
+        const tableModel = this.getTableModel(table);
+        const tableInfo = tableModel.fields;
+        const tableMode = this.getTableMode(table);
+        const primaryCodeName = tableModel.primary || "id";
+        const primaryDbName = snakeCase(primaryCodeName);
         const now = Date.now();
 
         const processedList = [];
         const fieldSet = new Set();
 
         for (const item of dataList) {
-            const userData = this.prepareWriteUserData(item.data, true);
+            const userData = this.prepareWriteUserData(item.data, true, tableInfo);
 
             for (const key of Object.keys(userData)) {
                 fieldSet.add(key);
             }
 
-            processedList.push({ id: item.id, data: userData });
+            processedList.push({ id: item[primaryCodeName], data: userData });
         }
 
         const fields = Array.from(fieldSet).toSorted();
@@ -850,21 +871,21 @@ class DbHelper {
             };
         }
         const writeFields = fields.slice();
-        if (this.beflyMode === "auto") {
+        if (tableMode === "auto") {
             writeFields.push("updated_at");
         }
         assertWriteFieldNamesDefined(tableInfo, writeFields, table, "updBatch.dataList");
 
         const query = SqlBuilder.toUpdateCaseByIdSql({
             table: snakeTable,
-            idField: "id",
+            idField: primaryDbName,
             rows: processedList,
             fields: fields,
             quoteIdent: quoteIdentMySql,
-            updatedAtField: this.beflyMode === "auto" ? "updated_at" : "",
-            updatedAtValue: this.beflyMode === "auto" ? now : null,
+            updatedAtField: tableMode === "auto" ? "updated_at" : "",
+            updatedAtValue: tableMode === "auto" ? now : null,
             stateField: "state",
-            stateGtZero: this.beflyMode === "auto"
+            stateGtZero: tableMode === "auto"
         });
 
         const executeRes = await this.execute(query.sql, query.params);
@@ -877,15 +898,16 @@ class DbHelper {
 
     async updData(options) {
         const parsed = this.createDbParse().parseUpdate(options);
-        const tableInfo = this.getTableDef(parsed.table);
-        const inputData = this.prepareWriteInputData(parsed.data);
+        const tableInfo = this.getTableFields(parsed.table);
+        const inputData = this.prepareWriteInputData(parsed.data, tableInfo);
         assertWriteDataHasFields(inputData, "更新数据必须至少有一个字段", parsed.snakeTable);
 
         const processed = this.buildUpdateRow({
             data: parsed.data,
             now: Date.now(),
             allowState: true,
-            beflyMode: this.beflyMode
+            beflyMode: this.getTableMode(parsed.table),
+            tableInfo: tableInfo
         });
         assertWriteDataHasFields(processed, "更新数据必须至少有一个字段", parsed.snakeTable);
         assertWriteFieldsDefined(tableInfo, processed, parsed.table, "updData.data");
@@ -902,11 +924,11 @@ class DbHelper {
 
     async delData(options) {
         const parsed = this.createDbParse().parseDelete(options, false);
-        const tableInfo = this.getTableDef(parsed.table);
+        const tableInfo = this.getTableFields(parsed.table);
         let processed;
 
         if (parsed.deleteMode === "manual") {
-            processed = this.prepareWriteInputData(parsed.data);
+            processed = this.prepareWriteInputData(parsed.data, tableInfo);
             assertWriteDataHasFields(processed, "delData 在 beflyMode=manual 时 data 必须至少有一个字段", parsed.snakeTable);
         } else {
             const now = Date.now();
@@ -945,7 +967,7 @@ class DbHelper {
 
     async increment(table, field, where, value = 1) {
         const parsed = this.createDbParse().parseIncrement(table, field, where, value, "increment");
-        const tableInfo = this.getTableDef(table);
+        const tableInfo = this.getTableFields(table);
         assertWriteFieldNamesDefined(tableInfo, [parsed.snakeField], table, "increment.field");
 
         const builder = this.createSqlBuilder().where(parsed.where);
@@ -972,6 +994,11 @@ class DbHelper {
         return await this.increment(table, field, where, -value);
     }
 
+    async close() {
+        if (this.isTransaction) return;
+        await this.closeHandler?.();
+    }
+
     async trans(callback) {
         if (this.isTransaction) {
             throw createError("不支持嵌套事务", { code: "policy" });
@@ -983,11 +1010,11 @@ class DbHelper {
 
         return await this.sql.begin(async (tx) => {
             const trans = new this.constructor({
-                redis: this.redis,
                 dbName: this.dbName,
                 sql: tx,
                 isTransaction: true,
                 beflyMode: this.beflyMode,
+                queryTimeout: this.queryTimeout / 1000,
                 tables: this.tables
             });
             return await callback(trans);

package/{lib → libs/mysql}/dbParse.js

@@ -1,7 +1,7 @@
-import { validationError } from "../utils/error.js";
-import { isNonEmptyString, isNullable, isPlainObject, isString } from "../utils/is.js";
-import { snakeCase } from "../utils/util.js";
 import { assertNoExprField, clearDeep, fieldsToSnake, normalizeQualifierField, orderByToSnake, parseFieldAliasParts, parseFlatWhereKey, parseTableRef, processJoinField, processJoinOn, processJoinOrderBy, processJoinWhere, whereKeysToSnake } from "./dbUtil.js";
+import { validationError } from "./error.js";
+import { isNonEmptyString, isNullable, isPlainObject, isString } from "./is.js";
+import { snakeCase } from "./util.js";
 
 function assertNonEmptyString(value, label) {
     if (!isNonEmptyString(value)) {
@@ -577,6 +577,10 @@ export class DbParse {
         this.getTableColumns = options.getTableColumns;
     }
 
+    getTableMode(table) {
+        return parseTableRef(table).table.startsWith("befly") ? "auto" : this.beflyMode;
+    }
+
     async parseRead(options, mode) {
         const label = mode === "one" ? "getOne.options" : mode === "list" ? "getList.options" : "getAll.options";
         validateQueryOptions(options, label);
@@ -609,7 +613,7 @@ export class DbParse {
         }
 
         const snakeTable = snakeCase(Array.isArray(options.table) ? options.table[0] : options.table);
-        const normalizedWhere = applyDefaultStateFilter(whereKeysToSnake(cleanWhere), snakeTable, false, this.beflyMode);
+        const normalizedWhere = applyDefaultStateFilter(whereKeysToSnake(cleanWhere), snakeTable, false, this.getTableMode(Array.isArray(options.table) ? options.table[0] : options.table));
         return {
             table: snakeTable,
             fields: [],
@@ -662,7 +666,7 @@ export class DbParse {
         const label = force ? "delForce" : "delData";
         assertNonEmptyString(options.table, `${label}.table`);
         validateWhereObject(options.where, `${label}.where`, true);
-        const deleteMode = resolveDeleteMode(options.table, this.beflyMode);
+        const deleteMode = resolveDeleteMode(options.table, this.getTableMode(options.table));
         const result = {
             table: options.table,
             snakeTable: snakeCase(options.table),
@@ -719,10 +723,11 @@ export class DbParse {
         const normalizedTableRef = normalizeTableRef(mainTableRef);
         const mainQualifier = getTableQualifier(mainTableRef);
         const joins = options.leftJoin.map((joinItem, index) => parseLeftJoinItem(joinTableRefs[index], joinItem));
-        const normalizedWhere = applyDefaultStateFilter(processJoinWhere(cleanWhere), mainQualifier, true, this.beflyMode);
+        const normalizedWhere = applyDefaultStateFilter(processJoinWhere(cleanWhere), mainQualifier, true, this.getTableMode(mainTableRef));
 
         return {
             table: normalizedTableRef,
+            codeTable: parseTableRef(mainTableRef).table,
             fields: processedFields,
             where: parseWhereObject(normalizedWhere),
             leftJoins: joins,
@@ -738,10 +743,11 @@ export class DbParse {
         const normalizedTableRef = normalizeTableRef(mainTableRef);
         const mainQualifier = getTableQualifier(mainTableRef);
         const joins = options.leftJoin.map((joinItem, index) => parseLeftJoinItem(joinTableRefs[index], joinItem));
-        const normalizedWhere = applyDefaultStateFilter(processJoinWhere(cleanWhere), mainQualifier, true, this.beflyMode);
+        const normalizedWhere = applyDefaultStateFilter(processJoinWhere(cleanWhere), mainQualifier, true, this.getTableMode(mainTableRef));
 
         return {
             table: normalizedTableRef,
+            codeTable: parseTableRef(mainTableRef).table,
             fields: [],
             where: parseWhereObject(normalizedWhere),
             leftJoins: joins,
@@ -755,10 +761,11 @@ export class DbParse {
         const tableRef = Array.isArray(options.table) ? options.table[0] : options.table;
         const snakeTable = snakeCase(tableRef);
         const processedFields = await fieldsToSnake(tableRef, classifiedFields, this.getTableColumns);
-        const normalizedWhere = applyDefaultStateFilter(whereKeysToSnake(cleanWhere), snakeTable, false, this.beflyMode);
+        const normalizedWhere = applyDefaultStateFilter(whereKeysToSnake(cleanWhere), snakeTable, false, this.getTableMode(tableRef));
 
         return {
             table: snakeTable,
+            codeTable: parseTableRef(tableRef).table,
             fields: processedFields,
             where: parseWhereObject(normalizedWhere),
             leftJoins: [],
@@ -768,7 +775,7 @@ export class DbParse {
         };
     }
 
-    prepareSingleTableWhere(table, where, useDefaultStateFilter, required, label, beflyMode = this.beflyMode) {
+    prepareSingleTableWhere(table, where, useDefaultStateFilter, required, label, beflyMode = this.getTableMode(table)) {
         const snakeTable = snakeCase(table);
         const normalizedWhere = whereKeysToSnake(clearDeep(where || {}));
         if (required) {

package/{lib → libs/mysql}/dbUtil.js

@@ -1,6 +1,6 @@
-import { validationError } from "../utils/error.js";
-import { isFiniteNumber, isNonEmptyString, isNullable, isString } from "../utils/is.js";
-import { snakeCase } from "../utils/util.js";
+import { validationError } from "./error.js";
+import { isFiniteNumber, isNonEmptyString, isNullable, isString } from "./is.js";
+import { camelCase, snakeCase } from "./util.js";
 
 export function assertNoExprField(field) {
     if (!isString(field)) {
@@ -613,45 +613,28 @@ export function whereKeysToSnake(where) {
     });
 }
 
-export function serializeArrayFields(data) {
+export function serializeArrayFields(data, tableInfo = {}) {
     const serialized = {};
     for (const [key, value] of Object.entries(data)) {
-        if (isNullable(value)) {
-            serialized[key] = value;
-            continue;
-        }
-        if (Array.isArray(value)) {
-            serialized[key] = JSON.stringify(value);
-            continue;
-        }
-        serialized[key] = value;
+        const fieldRule = tableInfo[camelCase(key)] || tableInfo[key];
+        const complexParam = ["array", "object", "record"].includes(fieldRule?.paramType);
+        serialized[key] = !isNullable(value) && fieldRule?.fieldType === "text" && complexParam && typeof value === "object" ? JSON.stringify(value) : value;
     }
     return serialized;
 }
 
-export function deserializeArrayFields(data) {
-    if (!data) {
-        return null;
-    }
-    const deserialized = {};
-    for (const [key, value] of Object.entries(data)) {
-        deserialized[key] = value;
-    }
+export function deserializeArrayFields(data, tableInfo = {}) {
+    if (!data) return null;
+    const deserialized = { ...data };
 
     for (const [key, value] of Object.entries(deserialized)) {
-        if (!isString(value)) {
+        const fieldRule = tableInfo[camelCase(key)] || tableInfo[key];
+        if (!isString(value) || fieldRule?.fieldType !== "text" || !["array", "object", "record"].includes(fieldRule.paramType)) continue;
+        try {
+            deserialized[key] = JSON.parse(value);
+        } catch {
             continue;
         }
-        if (value.startsWith("[") && value.endsWith("]")) {
-            try {
-                const parsed = JSON.parse(value);
-                if (Array.isArray(parsed)) {
-                    deserialized[key] = parsed;
-                }
-            } catch {
-                continue;
-            }
-        }
     }
 
     return deserialized;

package/libs/mysql/error.js

@@ -0,0 +1,29 @@
+export function createError(message, options = {}) {
+    const error = new Error(message, options.cause === undefined ? undefined : { cause: options.cause });
+    if (options.code) error.code = options.code;
+    if (options.subsystem) error.subsystem = options.subsystem;
+    if (options.operation) error.operation = options.operation;
+    for (const [key, value] of Object.entries(options)) {
+        if (key !== "cause" && key !== "code" && key !== "subsystem" && key !== "operation") error[key] = value;
+    }
+    return error;
+}
+
+export function validationError(message) {
+    return createError(message, { code: "validation" });
+}
+
+export function getRootCause(error) {
+    let current = error;
+    while (current?.cause instanceof Error) current = current.cause;
+    return current;
+}
+
+export class MysqlError extends Error {
+    constructor(message, options = {}) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = "MysqlError";
+        this.code = options.code || "runtime";
+        this.operation = options.operation;
+    }
+}

package/libs/mysql/index.js

@@ -0,0 +1,6 @@
+export { DbHelper } from "./dbHelper.js";
+export { DbParse, applyDefaultStateFilter, parseFieldSelection, parseJoinFieldSelection, parseLeftJoinItem } from "./dbParse.js";
+export { clearDeep, deserializeArrayFields, fieldsToSnake, parseTableRef, processJoinOn, processJoinOrderBy, processJoinWhere, serializeArrayFields, whereKeysToSnake } from "./dbUtil.js";
+export { MysqlError } from "./error.js";
+export { createMysql } from "./mysql.js";
+export { escapeField, escapeTable, resolveQuoteIdent, SqlBuilder } from "./sql/index.js";

package/libs/mysql/is.js

@@ -0,0 +1,29 @@
+export function isPlainObject(value) {
+    if (typeof value !== "object" || value === null) return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+
+export function isFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value);
+}
+
+export function isString(value) {
+    return typeof value === "string";
+}
+
+export function isNumber(value) {
+    return Object.prototype.toString.call(value) === "[object Number]";
+}
+
+export function isNullable(value) {
+    return value === null || value === undefined;
+}
+
+export function isNonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+
+export function isLowerCamelCaseName(value) {
+    return isNonEmptyString(value) && /^_?[a-z][a-z0-9]*(?:[A-Z][a-z0-9]*)*$/.test(value);
+}