db-crud-api 0.3.25 → 0.3.26

package/lib/mssql.js

@@ -40,7 +40,7 @@ function stringifyValue(fieldName, value, tSchema) {
     // if string or uuid
     if (_fieldType == 'string' || _fieldType == 'uuid') {
         if (value.trimStart().charAt(0) !== '\'' && value.trimStart().charAt(0) !== '\"') {
-            return `\'${value}\'`;
+            return `\'${value.replace(/'/g, "''")}\'`;
         }
     }
 
@@ -51,7 +51,7 @@ function stringifyValue(fieldName, value, tSchema) {
         if (typeof value == 'boolean') 
             return `\'${value}\'`;
         if (typeof value == 'string' && value.trimStart().charAt(0) !== '\'' && value.trimStart().charAt(0) !== '\"') 
-            return `\'${value}\'`;
+            return `\'${value.replace(/'/g, "''")}\'`;
     }
 
     return value;

package/lib/mysql.js

@@ -42,7 +42,8 @@ function stringifyValue(fieldName, value, tSchema) {
     // if string or uuid
     if (_fieldType == 'string' || _fieldType == 'uuid') {
         if (value.trimStart().charAt(0) !== '\'' && value.trimStart().charAt(0) !== '\"') {
-            return `\'${value}\'`;
+            // return `\'${value}\'`;
+            return sql.escape(`${value}`);
         }
     }
 
@@ -53,7 +54,7 @@ function stringifyValue(fieldName, value, tSchema) {
         if (typeof value == 'boolean') 
             return `\'${value}\'`;
         if (typeof value == 'string' && value.trimStart().charAt(0) !== '\'' && value.trimStart().charAt(0) !== '\"') 
-            return `\'${value}\'`;
+            return sql.escape(`${value}`);
     }
 
     return value;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "db-crud-api",
-  "version": "0.3.25",
+  "version": "0.3.26",
   "type": "module",
   "description": "CRUD api for database tables",
   "main": "index.js",

package/lib/db-operations.js.bak

@@ -1,486 +0,0 @@
-'use strict';
-
-// import modules
-import schema from './schema.js'
-import * as mssql from './mssql.js';
-import * as mysql from './mysql.js';
-
-// Common
-const defautlFields = ['*'];
-export const serverType = Object.freeze({ mssql:  'ms-sql', mysql: 'my-sql', mongodb: 'mongo-db' });
-export const objectType = Object.freeze({ table:  'T', procedure: 'P' });
-
-// Exported functions 
-export function idField(tSchema) {
-    return tSchema.table?.idField ?? 'id';
-}
-
-export function autoId(tSchema) {
-    return tSchema.table?.autoId;
-}
-
-export function getProperty(obj, keyToFind) {
-    if (typeof obj !== 'object' || obj === null || !keyToFind) {
-        return undefined;
-    }
-
-    const lowerKeyToFind = keyToFind.toLowerCase();
-
-    for (const key in obj) {
-        // Usa hasOwnProperty per escludere le proprietà ereditate
-        if (Object.prototype.hasOwnProperty.call(obj, key)) {
-
-            if (key.toLowerCase() === lowerKeyToFind) {
-                return obj[key];
-            }
-        }
-    }
-
-    return undefined;
-}
-
-export function upsertProperty(obj, keyToUpdate, newValue) {
-    if (typeof obj !== 'object' || obj === null) {
-        // Non è un oggetto valido
-        return false;
-    }
-
-    const lowerKeyToUpdate = keyToUpdate.toLowerCase();
-    let propertyFound = false;
-
-    for (const key in obj) {
-        if (Object.prototype.hasOwnProperty.call(obj, key)) {
-            if (key.toLowerCase() === lowerKeyToUpdate) {
-                obj[key] = newValue;
-                propertyFound = true;
-                break;
-            }
-        }
-    }
-
-    if (!propertyFound) {
-        obj[keyToUpdate] = newValue;
-    }
-
-    return true;
-}
-
-export async function runQuery(dbOpes) {
-
-    // all connections must have same id
-    const _connection = Array.isArray(dbOpes) ? dbOpes[0].connection : dbOpes.connection;
-    if (Array.isArray(dbOpes)) {
-        for (let i = 1; i < dbOpes.length; i++) {
-            if (dbOpes[i].connection?.id !== _connection.id) throw new TypeError('runQuery: for multiple operations, connection must be the same');
-        }
-    }
-    
-    // MSSQL
-    if (_connection.serverType === serverType.mssql) {
-        return await mssql.query(_connection, dbOpes);
-    }
-
-    // MySQL
-    else if (_connection.serverType === serverType.mysql) {
-        return await mysql.query(_connection, dbOpes);
-    }
-    
-    // server type not supported
-    else throw new TypeError('server type not supported');
-    
-}
-
-export function prepareConnection(schema) {
-    // MySQL
-    if (schema.server.type === serverType.mysql) {
-        const _return = mysql.prepareConnection(schema);
-        _return.serverType = serverType.mysql;  // append 'serverType' to connection
-        return _return;
-    }
-    // MSSQL is also the default
-    if (!schema.server.type || schema.server.type === serverType.mssql) { 
-        const _return = mssql.prepareConnection(schema);
-        _return.serverType = serverType.mssql;  // append 'serverType' to connection
-        return _return;
-    }
-    throw new TypeError('server type not supported');
-}
-
-export function closeConnection(connection) {
-    // MSSQL
-    if (connection.serverType === serverType.mssql) { return mssql.closeConnection(connection); }
-    // MySQL
-    if (connection.serverType === serverType.mysql) { return mysql.closeConnection(connection); }
-}
-
-export function closeAllConnections() {
-    // MSSQL
-    mssql.closeAllConnections();
-    // MySQL
-    mysql.closeAllConnections();
-
-    return;
-}
-
-export function testConnection() {
-    const _connection = prepareConnection(prepareSchema("test", objectType.procedure));
-    // MSSQL
-    if (_connection.serverType === serverType.mssql) { return mssql.testConnection(_connection); }
-    // MySQL
-    if (_connection.serverType === serverType.mysql) { return mysql.testConnection(_connection); }
-    // server type not supported
-    throw new TypeError('server type not supported');
-}
-
-export function toStringValue(value) {
-    if (!value) return 'null';
-    if (value.trimStart().charAt(0) === '\'') return value;
-    return `\'${value}\'`;
-}
-
-export function prepareSchema(obj, objType) {
-    // objType = 'objectType.' (Table or StoreProcedure)
-    //     obj = 'systemName.dbName.objName' or 'dbName.objName' or 'objName' or 'systemNme..objName'
-
-    if (obj == undefined || typeof obj !== 'string') throw new TypeError('prepareSchema: wrong obj');
-    if (objType !== undefined && objType !== objectType.table && objType !== objectType.procedure) throw new TypeError(`prepareSchema: wrong objType, must be ${objectType.join(', ')}`);
-    const objPath = obj.trimStart().split(' ')[0];
-
-    // split objPath to serverName,dbName,objName
-    let serverName = undefined;
-    let dbName = undefined;
-    let objName = undefined;
-    const objPathArray = objPath.split('.');
-    if (objPathArray.length > 2) {
-        serverName = objPathArray[0]
-        dbName = objPathArray[1]
-        objName = objPathArray[2]
-    }
-    else if (objPathArray.length > 1) {
-        dbName = objPathArray[0]
-        objName = objPathArray[1]
-    }
-    else if (objPathArray.length > 0) {
-        objName = objPathArray[0]
-    }
-
-    // server
-    if (!serverName || serverName.length == 0) {
-        if (!schema.servers || !Object.keys(schema.servers)[0]) throw new TypeError('missing default server in dbSchema');
-        serverName = Object.keys(schema.servers)[0];
-    }
-    else { // add server to schema 
-        if (!schema.servers) { schema.servers = {} };
-        if (!schema.servers[serverName]) { schema.servers[serverName] = {} };
-    }
-    if (!schema.servers[serverName].realName) { schema.servers[serverName].realName = serverName } // add realName
-
-    // database
-    if (!dbName || dbName.length == 0) {
-        if (!schema.servers[serverName].databases || !Object.keys(schema.servers[serverName].databases)[0]) throw new TypeError('missing default database in dbSchema');
-        dbName = Object.keys(schema.servers[serverName].databases)[0];
-    }
-    else { // add db to schema
-        if (!schema.servers[serverName].databases) { schema.servers[serverName].databases = {} };
-        if (!schema.servers[serverName].databases[dbName]) { schema.servers[serverName].databases[dbName] = {} };
-    }
-    if (!schema.servers[serverName].databases[dbName].realName) { schema.servers[serverName].databases[dbName].realName = dbName } // add realName
-
-    // table
-    if (objType === objectType.table || objType == undefined) {
-        if (!objName || objName.length == 0) {
-            if (!schema.servers[serverName].databases[dbName] || !Object.keys(schema.servers[serverName].databases[dbName].tables)[0]) throw new TypeError('missing default table in dbSchema');
-            objName = Object.keys(schema.servers[serverName].databases[dbName].tables)[0];
-        }
-        else { // add table to schema
-            if (!schema.servers[serverName].databases[dbName].tables) { schema.servers[serverName].databases[dbName].tables = {} };
-            if (!schema.servers[serverName].databases[dbName].tables[objName]) { schema.servers[serverName].databases[dbName].tables[objName] = {} }
-        }
-        if (!schema.servers[serverName].databases[dbName].tables[objName].realName) { schema.servers[serverName].databases[dbName].tables[objName].realName = objName } // add realName
-    }
-
-    // store procedure
-    if (objType === objectType.procedure) {
-        if (!objName || objName.length == 0) {
-            if (!schema.servers[serverName].databases[dbName] || !Object.keys(schema.servers[serverName].databases[dbName].procedures)[0]) throw new TypeError('missing default procedure in dbSchema');
-            objName = Object.keys(schema.servers[serverName].databases[dbName].procedures)[0];
-        }
-        else { // add storeprocedure to schema
-            if (!schema.servers[serverName].databases[dbName].procedures) { schema.servers[serverName].databases[dbName].procedures = {} };
-            if (!schema.servers[serverName].databases[dbName].procedures[objName]) { schema.servers[serverName].databases[dbName].procedures[objName] = {command: obj} }
-        }
-        if (!schema.servers[serverName].databases[dbName].procedures[objName].realName) { schema.servers[serverName].databases[dbName].procedures[objName].realName = objName } // add realName
-    }
-
-    // return Schema
-    return {
-        table: (objType == undefined || objType === objectType.table) ? schema.servers[serverName].databases[dbName].tables[objName] : undefined,
-        procedure:  (objType === objectType.procedure) ? schema.servers[serverName].databases[dbName].procedures[objName] : undefined,
-        database: schema.servers[serverName].databases[dbName],
-        server: schema.servers[serverName]
-    }
-
-}
-
-export function prepareRun(tSchema, connection, reqOpe) {
-    const _reqOpe = [];
-    const _result = [];
-    if (Array.isArray(reqOpe)) _reqOpe.push(...reqOpe);
-    else _reqOpe.push(reqOpe);
-    _reqOpe.forEach(function (_ope) {
-        if (_ope?.get) _result.push(prepareGet(tSchema, connection, _ope));
-        else if (_ope?.patch) _result.push(preparePatch(tSchema, connection, _ope));
-        else if (_ope?.put) _result.push(preparePut(tSchema, connection, _ope));
-        else if (_ope?.delete) _result.push(prepareDelete(tSchema, connection, _ope));
-        else if (_ope?.execute) _result.push(prepareExecute(connection, _ope));
-        else if (_ope?.begin) _result.push(prepareBegin(connection, _ope));
-        else if (_ope?.commit) _result.push(prepareCommit(connection, _ope));
-        else if (_ope?.rollback) _result.push(prepareRollback(connection, _ope));
-        else if (_ope?.passthrough) _result.push(preparePassthrough(connection, _ope));
-        else throw new Error('Request sintax error, missing property get/patch/put/delete/...');
-    });
-    if (_result.length > 1) return _result;
-    if (_result.length = 1) return _result[0];
-    return undefined;
-}
-
-export function prepareRunById(tSchema, connection, reqOpe, idValue) {
-    if (reqOpe?.get) return prepareGetById(tSchema, connection, reqOpe, idValue);
-    if (reqOpe?.patch) return preparePatchById(tSchema, connection, reqOpe, idValue);
-    if (reqOpe?.put) return preparePutById(tSchema, connection, reqOpe, idValue);
-    if (reqOpe?.delete) return prepareDeleteById(tSchema, connection, reqOpe, idValue);
-    else throw new Error('Request sintax error, missing property get/patch/put/delete...');
-}
-
-export function prepareGet(tSchema, connection, reqOpe) {
-    const _reqOpe = [];
-    const _result = [];
-    if (Array.isArray(reqOpe)) _reqOpe.push(...reqOpe);
-    else _reqOpe.push(reqOpe);
-    _reqOpe.forEach(function (_ope) {
-        _result.push({
-            get: {
-                schema: tSchema,
-                options: _ope?.get?.options,
-                fields: _ope?.get?.fields ?? defautlFields,
-                filters: _ope?.get?.filters,
-                groups: _ope?.get?.groups,
-                groupsFilters: _ope?.get?.groupsFilters,
-                orderBy: _ope?.get?.orderBy,
-                params: _ope?.get?.params
-            },
-            connection: connection,
-            appLog: _ope?.hasOwnProperty('appLog') ? _ope.appLog : undefined
-        });
-    });
-    if (_result.length > 1) return _result;
-    if (_result.length = 1) return _result[0];
-    return undefined;
-};
-
-export function prepareGetById(tSchema, connection, reqOpe, idValue) {
-    const _filters = [idField(tSchema) + ' = ' + toStringValue(idValue)];
-    if (reqOpe?.get?.filters && reqOpe?.get?.filters.length > 0) {
-        _filters.push('and');
-        Array.isArray(reqOpe.get.filters) ? _filters.push(...reqOpe.get.filters) : _filters.push(reqOpe.get.filters);
-    }
-    return {
-        get: {
-            schema: tSchema,
-            options: reqOpe?.get?.options,
-            fields: reqOpe?.get?.fields ?? defautlFields,
-            filters: _filters
-        },
-        connection: connection,
-        appLog: reqOpe?.hasOwnProperty('appLog') ? reqOpe.appLog : undefined
-    }
-};
-
-export function preparePatch(tSchema, connection, reqOpe) {
-    const _reqOpe = [];
-    const _result = [];
-    if (Array.isArray(reqOpe)) _reqOpe.push(...reqOpe);
-    else _reqOpe.push(reqOpe);
-    _reqOpe.forEach(function (_ope) {
-        if (_ope?.patch) {
-            if (!_ope.patch.sets) throw new Error('Request sintax error, missing "patch.sets" property.')
-            _result.push({
-                patch: {
-                    schema: tSchema,
-                    sets: _ope.patch.sets,
-                    filters: _ope.patch.filters,
-                    params: _ope.patch.params
-                },
-                connection: connection,
-                appLog: _ope.hasOwnProperty('appLog') ? _ope.appLog : undefined
-            });
-        }
-        else throw new Error('Request sintax error, missing "patch" property.');
-    });
-    if (_result.length > 1) return _result;
-    if (_result.length = 1) return _result[0];
-    return undefined;
-};
-
-export function preparePatchById(tSchema, connection, reqOpe, idValue) {
-    if (!reqOpe?.patch) throw new Error('Request sintax error, missing "patch" property.')
-    if (!reqOpe.patch.sets) throw new Error('Missing "patch.sets" in operation.')
-    const _filters = [idField(tSchema) + ' = ' + toStringValue(idValue)];
-    if (reqOpe?.patch?.filters && reqOpe?.patch?.filters.length > 0) {
-        _filters.push('and');
-        Array.isArray(reqOpe.patch.filters) ? _filters.push(...reqOpe.patch.filters) : _filters.push(reqOpe.patch.filters);
-    }
-    return {
-        patch: {
-            schema: tSchema,
-            sets: reqOpe.patch.sets,
-            filters: _filters
-        },
-        connection: connection,
-        appLog: reqOpe.hasOwnProperty('appLog') ? reqOpe.appLog : undefined
-    }
-};
-
-export function preparePut(tSchema, connection, reqOpe) {
-    const _reqOpe = [];
-    const _result = [];
-    if (Array.isArray(reqOpe)) _reqOpe.push(...reqOpe);
-    else _reqOpe.push(reqOpe);
-    _reqOpe.forEach(function (_ope) {
-        if (_ope?.put) {
-            if (!_ope.put.sets) throw new Error('Request sintax error, missing "put.sets" property.')
-            _result.push({
-                put: {
-                    schema: tSchema,
-                    sets: _ope.put.sets,
-                    params: _ope.put.params
-                },
-                connection: connection,
-                appLog: _ope.hasOwnProperty('appLog') ? _ope.appLog : undefined
-            });
-        }
-        else throw new Error('Request sintax error, missing "put" property.');
-    });
-    if (_result.length > 1) return _result;
-    if (_result.length = 1) return _result[0];
-    return undefined;
-};
-
-export function preparePutById(tSchema, connection, reqOpe, idValue) {
-    if (!reqOpe?.put) throw new Error('Request sintax error, missing "put" property.')
-    if (!reqOpe.put.sets) throw new Error('Missing "put.sets" in operation.')
-    upsertProperty(reqOpe.put.sets, idField(tSchema), idValue);
-    return {
-        put: {
-            schema: tSchema,
-            sets: reqOpe.put.sets,
-            params: reqOpe.put.params
-        },
-        connection: connection,
-        appLog: reqOpe.hasOwnProperty('appLog') ? reqOpe.appLog : undefined
-    }
-};
-
-export function prepareDelete(tSchema, connection, reqOpe) {
-    const _reqOpe = [];
-    const _result = [];
-    if (Array.isArray(reqOpe)) _reqOpe.push(...reqOpe);
-    else _reqOpe.push(reqOpe);
-    _reqOpe.forEach(function (_ope) {
-        if (_ope?.delete) {
-            _result.push({
-                delete: {
-                    schema: tSchema,
-                    filters: _ope.delete.filters,
-                    params: _ope.delete.params
-                },
-                connection: connection,
-                appLog: _ope.hasOwnProperty('appLog') ? _ope.appLog : undefined
-            });
-        }
-        else throw new Error('Request sintax error, missing "delete" property.');
-    });
-    if (_result.length > 1) return _result;
-    if (_result.length = 1) return _result[0];
-    return undefined;
-};
-
-export function prepareDeleteById(tSchema, connection, reqOpe, idValue) {
-    return {
-        delete: {
-            schema: tSchema,
-            filters: [idField(tSchema) + ' = ' + toStringValue(idValue)]
-        },
-        connection: connection,
-        appLog: reqOpe.hasOwnProperty('appLog') ? reqOpe.appLog : undefined
-    }
-};
-
-export function prepareExecute(pSchema, connection, reqOpe) {
-    const _reqOpe = [];
-    const _result = [];
-    if (Array.isArray(reqOpe)) _reqOpe.push(...reqOpe);
-    else _reqOpe.push(reqOpe);
-    _reqOpe.forEach(function (_ope) {
-        _result.push({
-            execute: {
-                schema: pSchema,
-                arguments: _ope.execute?.arguments,
-                params: _ope.execute?.params
-            },
-            connection: connection,
-            appLog: _ope.hasOwnProperty('appLog') ? _ope.appLog : undefined
-        });
-    });
-    if (_result.length > 1) return _result;
-    if (_result.length = 1) return _result[0];
-    return undefined;
-};
-
-export function preparePassthrough(connection, reqOpe) {
-    const _reqOpe = [];
-    const _result = [];
-    if (Array.isArray(reqOpe)) _reqOpe.push(...reqOpe);
-    else _reqOpe.push(reqOpe);
-    _reqOpe.forEach(function (_ope) {
-        if (_ope?.passthrough) {
-            if (!_ope.passthrough.command) throw new Error('Request sintax error, missing "passthrough.command" property.')
-            _result.push({
-                passthrough: {
-                    command: _ope.passthrough.command,
-                    params: _ope.passthrough.params
-                },
-                connection: connection,
-                appLog: _ope.hasOwnProperty('appLog') ? _ope.appLog : undefined
-            });
-        }
-        else throw new Error('Request sintax error, missing "passthrough" property.');
-    });
-    if (_result.length > 1) return _result;
-    if (_result.length = 1) return _result[0];
-    return undefined;
-};
-
-export function prepareBegin(connection, reqOpe) {
-    return {
-        begin: {},
-        connection: connection,
-        appLog: reqOpe.hasOwnProperty('appLog') ? reqOpe.appLog : undefined
-    }
-};
-
-export function prepareCommit(connection, reqOpe) {
-    return {
-        commit: {},
-        connection: connection,
-        appLog: reqOpe.hasOwnProperty('appLog') ? reqOpe.appLog : undefined
-    }
-};
-
-export function prepareRollback(connection, reqOpe) {
-    return {
-        rollback: {},
-        connection: connection,
-        appLog: reqOpe.hasOwnProperty('appLog') ? reqOpe.appLog : undefined
-    }
-};

package/lib/mysql.js.bak

@@ -1,404 +0,0 @@
-'use strict';
-
-import sql from 'mysql2/promise';
-import log from './log.js'
-
-// Regex
-const _match_LIMIT_n = /\bLIMIT\b +\d+/ig
-const _match_TOP_n = /\bTOP\b +\d+/ig
-const _match_TOP = /\bTOP\b/ig
-
-const pools = {};
-
-// Common
-function stringifyValue(fieldName, value, tSchema) {
-
-    // null or undefined
-    if (value == undefined)  
-        return 'null';
-
-    // detect field type
-    let _fieldType = undefined;
-    if (tSchema.table.fields && tSchema.table.fields[fieldName] && tSchema.table.fields[fieldName].type) {
-        _fieldType = tSchema.table.fields[fieldName].type;
-    }
-
-    // if datetime
-    if (_fieldType == 'datetime') {
-        // my-sql not accepts 'Z' at end of ISO string
-        if (value instanceof Date) 
-            return `\'${value.toISOString().slice(0, -1)}\'`;
-        if (typeof value == 'string') {
-            const valueDate = new Date(Date.parse(value));
-            return `\'${valueDate.toISOString().slice(0, -1)}\'`;
-        }
-        return value;
-    }
-                
-    // if boolean
-    if (_fieldType == 'boolean' && typeof value == 'boolean') 
-        return `\'${value}\'`;
-
-    // if string or uuid
-    if (_fieldType == 'string' || _fieldType == 'uuid') {
-        if (value.trimStart().charAt(0) !== '\'' && value.trimStart().charAt(0) !== '\"') {
-            return `\'${value}\'`;
-        }
-    }
-
-    // field not in schema
-    if (_fieldType == undefined) {
-        if (value instanceof Date) 
-            return `\'${value.toISOString().slice(0, -1)}\'`;
-        if (typeof value == 'boolean') 
-            return `\'${value}\'`;
-        if (typeof value == 'string' && value.trimStart().charAt(0) !== '\'' && value.trimStart().charAt(0) !== '\"') 
-            return `\'${value}\'`;
-    }
-
-    return value;
-}
-
-
-
-// Create config object for pool
-export function prepareConnection(tSchema) {
-    return {
-        id: `${tSchema.server.realName}-${tSchema.database.realName}-${tSchema.server.user}`,
-        host: ((tSchema.server.instance && tSchema.server.instance != 'DEFAULT') ? (tSchema.server.realName + '\\' + tSchema.server.instance) : tSchema.server.realName) ?? 'localhost',
-        port: tSchema.server.port,
-        user: tSchema.server.user,
-        password: tSchema.server.password,
-        database: tSchema.database.realName,
-        ssl: {
-            rejectUnauthorized: false
-        },
-        multipleStatements: true,
-        connectionLimit: tSchema.server.connectionLimit
-    };
-};
-
-// Close connection
-export async function closeConnection(connection) {
-    let pool = pools[connection.id];
-    if (pool) {
-        pool.releaseConnection();
-        connection.end();
-        pools[connection.id] = undefined;  // remove pool from pools
-    }
-}
-
-// Close all connections
-export async function closeAllConnections() {
-    for (let poolId in pools) {
-        if (!pools.hasOwnProperty(poolId)) continue;
-        let pool = pools[poolId];
-        if (pool) {
-            pool.end();
-            pool = undefined;  // remove pool from pools
-        }
-    }
-}
-
-// Test connection
-export async function testConnection(connection) {
-  try {
-    const _connection = await sql.createConnection(connection);
-    await _connection.end();
-    return true;
-  } 
-  catch (error) 
-  {
-    throw (error);
-  }
-}
-
-// Query
-export async function query(connection, dbOpes) {
-
-    // Prepare pool
-    let pool = pools[connection.id];  // Try to get an existing pool
-    if (!pool) {
-        pool = new sql.createPool(connection);  // Create new pool
-        pools[connection.id] = pool;  // add new pool to pools
-    }
-
-    // Prepare sql statement
-    let sqlString = '';
-    let appLog = true;
-    // if exists, input params will be added to request
-    if (Array.isArray(dbOpes)) {
-        dbOpes.forEach((dbOpe, index) => { 
-            sqlString += ToSql(dbOpe, pool);
-            if (dbOpe?.hasOwnProperty('appLog') && dbOpe.appLog === false) appLog = false; 
-        });
-    }
-    else {
-        sqlString += ToSql(dbOpes, pool);
-        if (dbOpes?.hasOwnProperty('appLog') && dbOpes.appLog === false) appLog = false; 
-    }
-
-    sqlString = normalizeSpecialName(sqlString);
-
-    // Log
-    if (appLog) {
-        log(JSON.stringify(dbOpes), 60);
-        log(sqlString, 50);
-    }
-
-    // Run query
-    let sqlresult = undefined;
-    let sqlconn = undefined;
-    try {
-        sqlconn = await pool.getConnection();
-        sqlresult = await sqlconn.query(sqlString);
-    }
-    catch (err) { throw (err); } // using original error
-    finally { if (sqlconn) sqlconn.release(); }
-
-    // Log
-    if (appLog) {
-        log(`Query result: ${(sqlresult && sqlresult.length > 0) ? sqlresult[0].length : 0} rows.`, 50);
-    }
-
-    // normalize return object
-    if (sqlresult == undefined) return;
-    if (sqlresult.length === 0) return;
-    if (sqlresult[0].length === 0) return;
-
-    return sqlresult[0];
-}
-
-// Normalize special name to replace square brackets with backticks, considering quoted strings
-function normalizeSpecialName(sql) {
-    let result = "";
-    let inSingleQuote = false;
-    let inDoubleQuote = false;
-
-    for (let i = 0; i < sql.length; i++) {
-        const char = sql[i];
-
-        // Gestione delle virgolette singole '
-        if (char === "'" && !inDoubleQuote) {
-            inSingleQuote = !inSingleQuote;
-        } 
-        // Gestione delle virgolette doppie "
-        else if (char === '"' && !inSingleQuote) {
-            inDoubleQuote = !inDoubleQuote;
-        }
-
-        // Se non siamo all'interno di una stringa, sostituiamo le quadre
-        if (!inSingleQuote && !inDoubleQuote) {
-            if (char === '[' || char === ']') {
-                result += '`';
-                continue;
-            }
-        }
-
-        result += char;
-    }
-
-    return result;
-}
-
-// Compose fully qualified table name
-function fullyQualifiedTableName(tSchema) {
-    return (tSchema.database.realName + '.' + tSchema.table.realName);
-}
-
-function containLIMIT(s) {
-    const _return = s?.match(_match_LIMIT_n);
-    if (_return) return _return[0];
-    else return undefined;
-};
-
-function containTOP(s) {
-    const _return = s?.match(_match_TOP_n);
-    if (_return) return _return[0];
-    else return undefined;
-};
-
-function replaceTOPToLIMIT(s) {
-    const _replace = containTOP(s);
-    if (_replace) { return s.replace(_match_TOP_n, _replace.replace(_match_TOP, 'LIMIT')); }
-    else return s;
-}
-
-// Parse oprations object to sql string
-function ToSql(dbOpe, sqlRequest) {
-    if (dbOpe.get) return getToSql(dbOpe, sqlRequest);
-    if (dbOpe.patch) return patchToSql(dbOpe, sqlRequest);
-    if (dbOpe.put) return putToSql(dbOpe, sqlRequest);
-    if (dbOpe.delete) return deleteToSql(dbOpe, sqlRequest);
-    if (dbOpe.execute) return executeToSql(dbOpe, sqlRequest);
-    if (dbOpe.begin) return beginToSql(dbOpe, sqlRequest);
-    if (dbOpe.commit) return commitToSql(dbOpe, sqlRequest);
-    if (dbOpe.passthrough) return passthroughToSql(dbOpe, sqlRequest);
-}
-
-// Parse operation object to sql string without any trasformation.
-function passthroughToSql(dbOpe, sqlRequest) {
-
-    let result = "";
-
-    if (dbOpe.passthrough.command) {
-        result += dbOpe.passthrough.command;
-    }
-    else { throw new Error('command is missing.'); }
-
-    if (dbOpe.passthrough.params) addParams(dbOpe.passthrough.params, sqlRequest);
-
-    return result;
-}
-
-// Parse get operation object to sql string
-function getToSql(dbOpe, sqlRequest) {
-    let _first = true;
-
-    let result = 'select'
-
-    // omit 'limit' or 'top'
-    if (dbOpe.get.options && dbOpe.get.options.length > 0) {
-        if (Array.isArray(dbOpe.get.options)) {
-            for (const s of dbOpe.get.options) { if (!containLIMIT(s) && !containTOP(s)) result += ' ' + s; }
-        }
-        else if (!containLIMIT(dbOpe.get.options) && !containTOP(dbOpe.get.options)) result += ' ' + dbOpe.get.options;
-    }
-
-    if (dbOpe.get.fields && dbOpe.get.fields.length > 0) {
-        if (Array.isArray(dbOpe.get.fields)) result += ' ' + dbOpe.get.fields.join(',')
-        else result += ' ' + dbOpe.get.fields;
-    }
-    else { throw new Error('fields is missing.'); }
-
-    result += ' from ' + fullyQualifiedTableName(dbOpe.get.schema);
-
-    if (dbOpe.get.filters && dbOpe.get.filters.length > 0) {
-        if (Array.isArray(dbOpe.get.filters)) result += ' where ' + dbOpe.get.filters.join(' ');
-        else result += ' where ' + dbOpe.get.filters;
-    }
-
-    if (dbOpe.get.groups && dbOpe.get.groups.length > 0) {
-        if (Array.isArray(dbOpe.get.groups)) result += ' group by ' + dbOpe.get.groups.join(', ');
-        else result += ' group by ' + dbOpe.get.groups;
-    }
-
-    if (dbOpe.get.groupsFilters && dbOpe.get.groupsFilters.length > 0) {
-        if (Array.isArray(dbOpe.get.groupsFilters)) result += ' having ' + dbOpe.get.groupsFilters.join(' ');
-        else result += ' having ' + dbOpe.get.groupsFilters;
-    }
-
-    if (dbOpe.get.orderBy && dbOpe.get.orderBy.length > 0) {
-        if (Array.isArray(dbOpe.get.orderBy)) result += ' order by ' + dbOpe.get.orderBy.join(', ');
-        else result += ' order by ' + dbOpe.get.orderBy;
-    }
-
-    // search if 'limit' or 'top'
-    if (dbOpe.get.options && dbOpe.get.options.length > 0) {
-        if (Array.isArray(dbOpe.get.options)) {
-            for (const s of dbOpe.get.options) { if (containLIMIT(s) || containTOP(s)) result += ' ' + replaceTOPToLIMIT(s); }
-        }
-        else if (containLIMIT(dbOpe.get.options) || containTOP(dbOpe.get.options)) result += ' ' + replaceTOPToLIMIT(dbOpe.get.options);
-    }
-
-    if (dbOpe.get.params) addParams(dbOpe.get.params, sqlRequest);
-
-    result += ';'
-
-    return result;
-}
-
-// Parse patch operation object to sql string
-function patchToSql(dbOpe, sqlRequest) {
-    let result = 'update ' + fullyQualifiedTableName(dbOpe.patch.schema);
-
-    if (dbOpe.patch.sets) { result += ' set ' + Object.entries(dbOpe.patch.sets).map(e => { return e[0] + '=' + stringifyValue(e[0], e[1], dbOpe.patch.schema) }).join(', '); }
-    else { throw new Error('sets is missing.'); }
-
-    if (dbOpe.patch.filters && dbOpe.patch.filters.length > 0) {
-        if (Array.isArray(dbOpe.patch.filters)) result += ' where ' + dbOpe.patch.filters.join(' ');
-        else result += ' where ' + dbOpe.patch.filters;
-    }
-
-    if (dbOpe.patch.params) addParams(dbOpe.patch.params, sqlRequest);
-
-    result += ';'
-
-    return result;
-}
-
-// Parse put (add) operation object to sql string
-function putToSql(dbOpe, sqlRequest) {
-    let result = 'insert into ' + fullyQualifiedTableName(dbOpe.put.schema);
-
-    if ((dbOpe.put.sets) && (Object.keys(dbOpe.put.sets).length > 0)) {
-        let result_f = ' ('; let result_v = ' values (';
-        let _first = true;
-        for (const [key, value] of Object.entries(dbOpe.put.sets)) {
-            if (!_first) { result_f += ', '; result_v += ', '; } else { _first = false }
-            if (key || value) { result_f += key; result_v += stringifyValue(key, value, dbOpe.put.schema); }
-        }
-        result_f += ')'; result_v += ')';
-        result += result_f + result_v;
-    }
-    else { throw new Error('sets is missing.'); }
-
-    if (dbOpe.put.params) addParams(dbOpe.put.params, sqlRequest);
-
-    result += ';'
-
-    return result;
-}
-
-// Parse delete operation object to sql string
-function deleteToSql(dbOpe, sqlRequest) {
-    let result = 'delete from ' + fullyQualifiedTableName(dbOpe.delete.schema);
-
-    if (dbOpe.delete.filters && dbOpe.delete.filters.length > 0) {
-        if (Array.isArray(dbOpe.delete.filters)) result += ' where ' + dbOpe.delete.filters.join(' ');
-        else result += ' where ' + dbOpe.delete.filters;
-    }
-
-    if (dbOpe.delete.params) addParams(dbOpe.delete.params, sqlRequest);
-
-    result += ';'
-
-    return result;
-}
-
-// Parse execute operation object to sql string
-function executeToSql(dbOpe, sqlRequest) {
-    let result = "CALL ";
-
-    if (dbOpe.execute.schema.procedure) {
-        result += dbOpe.execute.schema.procedure.command;
-        if (dbOpe.execute.arguments) { result += ('(' + dbOpe.execute.arguments) + ')'; }
-    }
-    else { throw new Error('missing procedure/function name.'); }
-
-    if (dbOpe.execute.params) addParams(dbOpe.execute.params, sqlRequest);
-
-    result += ';'
-
-    return result;
-}
-
-// Parse begin operation object to sql string
-function beginToSql(dbOpe, sqlRequest) {
-    return "START TRANSACTION; ";
-}
-
-// Parse commit operation object to sql string
-function commitToSql(dbOpe, sqlRequest) {
-    return " COMMIT;";
-}
-
-// Add input parameters to pool.request
-function addParams(params, sqlRequest) {
-    if (params) {
-        for (const [key, value] of Object.entries(params)) {
-            sqlRequest.input(key, value)
-        }
-    }
-    return;
-}