db-crud-api 0.1.6 → 0.1.7

package/lib/db-operations.js

@@ -1,354 +1,439 @@
-'use strict';
-
-// import modules
-import schema from './schema.js'
-import * as mssql from './mssql.js';
-
-// Common
-const defautlFields = ['*'];
-const c_ServerType_mssql = "ms-sql";
-
-// Exported functions 
-export function idField(tSchema) {
-    return tSchema.table?.idField ?? 'id';
-}
-
-export async function runQuery(connection, dbOpes) {
-    if (connection.serverType === c_ServerType_mssql) {
-        const sqlresult = await mssql.query(connection, dbOpes);
-        ////mssql.closeConnection(connection);
-        if (sqlresult.recordsets.length === 0) { return; }
-        if (sqlresult.recordsets.length === 1) { return sqlresult.recordsets[0]; }
-        else { return sqlresult.recordsets; }
-    }
-    throw new TypeError('server type not supported');
-}
-
-export function prepareConnection(tSchema) {
-    if (!tSchema.server.type || tSchema.server.type === c_ServerType_mssql) {  // mssql is also the default
-        let _return = mssql.prepareConnection(tSchema);
-        _return.serverType = c_ServerType_mssql;  // append 'serverType' to connection
-        return _return;
-    }
-    throw new TypeError('server type not supported');
-}
-
-export function closeConnection(connection) {
-    if (connection.serverType === c_ServerType_mssql) { return mssql.closeConnection(connection); }
-}
-
-export function closeAllConnections() {
-    return mssql.closeAllConnections();
-}
-
-export function toStringValue(value) {
-    if (!value) return 'null';
-    if (value.trimStart().charAt(0) === '\'') return value;
-    return `\'${value}\'`;
-}
-
-export function prepareTableSchema(tablePath) {
-    // eg. tablePath = 'systemName.dbName.tableName' or 'dbName.tableName' or 'tablename' or 'systemNme..tableName'
-    if (!tablePath || typeof tablePath !== 'string') throw new TypeError('wrong tablePath');
-
-    // split tablePath to serverName,dbName,tableName
-    let serverName = undefined;
-    let dbName = undefined;
-    let tableName = undefined;
-    const tablePathArray = tablePath.split('.');
-    if (tablePathArray.length > 2) {
-        serverName = tablePathArray[0]
-        dbName = tablePathArray[1]
-        tableName = tablePathArray[2]
-    }
-    else if (tablePathArray.length > 1) {
-        dbName = tablePathArray[0]
-        tableName = tablePathArray[1]
-    }
-    else if (tablePathArray.length > 0) {
-        tableName = tablePathArray[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 (!tableName || tableName.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');
-        tableName = 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[tableName]) { schema.servers[serverName].databases[dbName].tables[tableName] = {} }
-    }
-    if (!schema.servers[serverName].databases[dbName].tables[tableName].realName) { schema.servers[serverName].databases[dbName].tables[tableName].realName = tableName } // add realName
-
-    // return tSchema
-    return {
-        table: schema.servers[serverName].databases[dbName].tables[tableName],
-        database: schema.servers[serverName].databases[dbName],
-        server: schema.servers[serverName]
-    }
-
-}
-
-export function prepareRun(tSchema, reqOpe) {
-    let _reqOpe = [];
-    let _result = [];
-    if (Array.isArray(reqOpe)) _reqOpe.push(...reqOpe);
-    else _reqOpe.push(reqOpe);
-    _reqOpe.forEach(function (_ope) {
-        if (_ope?.get) _result.push(prepareGet(tSchema, _ope));
-        else if (_ope?.patch) _result.push(preparePatch(tSchema, _ope));
-        else if (_ope?.put) _result.push(preparePut(tSchema, _ope));
-        else if (_ope?.delete) _result.push(prepareDelete(tSchema, _ope));
-        else if (_ope?.execute) _result.push(prepareExecute(_ope));
-        else if (_ope?.begin) _result.push(prepareBegin(_ope));
-        else if (_ope?.commit) _result.push(prepareCommit(_ope));
-        else if (_ope?.rollback) _result.push(prepareRollback(_ope));
-        else if (_ope?.passthrough) _result.push(preparePassthrough(_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, idValue, reqOpe) {
-    if (reqOpe?.get) return prepareGetById(tSchema, idValue, reqOpe);
-    if (reqOpe?.patch) return preparePatchById(tSchema, idValue, reqOpe);
-    if (reqOpe?.put) return preparePutById(tSchema, idValue, reqOpe);
-    if (reqOpe?.delete) return prepareDeleteById(tSchema, idValue, reqOpe);
-    else throw new Error('Request sintax error, missing property get/patch/put/delete...');
-}
-
-export function prepareGet(tSchema, reqOpe) {
-    let _reqOpe = [];
-    let _result = [];
-    if (Array.isArray(reqOpe)) _reqOpe.push(...reqOpe);
-    else _reqOpe.push(reqOpe);
-    _reqOpe.forEach(function (_ope) {
-        // if ( !_ope?.get) { _ope = { get: { options: 'top 1000' } } }
-        _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
-            }
-        });
-    });
-    if (_result.length > 1) return _result;
-    if (_result.length = 1) return _result[0];
-    return undefined;
-};
-
-export function prepareGetById(tSchema, idValue, reqOpe) {
-    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
-        }
-    }
-};
-
-export function preparePatch(tSchema, reqOpe) {
-    let _reqOpe = [];
-    let _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
-                }
-            });
-        }
-        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, idValue, reqOpe) {
-    if (!reqOpe?.patch) throw new Error('Request sintax error, missing "patch" property.')
-    if (!reqOpe.patch.sets) throw new Error('Missing "patch.sets" in operation.')
-    let _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
-        }
-    }
-};
-
-export function preparePut(tSchema, reqOpe) {
-    let _reqOpe = [];
-    let _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: reqOpe.put.sets,
-                    params: reqOpe?.put.params
-                }
-            });
-        }
-        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, idValue, reqOpe) {
-    if (!reqOpe?.put) throw new Error('Request sintax error, missing "put" property.')
-    if (!reqOpe.put.sets) throw new Error('Missing "put.sets" in operation.')
-    reqOpe.put.sets[idField(tSchema)] = idValue;
-    return {
-        put: {
-            schema: tSchema,
-            sets: reqOpe.put.sets,
-            params: reqOpe?.put?.params
-        }
-    }
-};
-
-export function prepareDelete(tSchema, reqOpe) {
-    let _reqOpe = [];
-    let _result = [];
-    if (Array.isArray(reqOpe)) _reqOpe.push(...reqOpe);
-    else _reqOpe.push(reqOpe);
-    _reqOpe.forEach(function (_ope) {
-        if (_ope?.delete) {
-            if (!_ope.delete.sets) throw new Error('Request sintax error, missing "delete.sets" property.')
-            _result.push({
-                delete: {
-                    schema: tSchema,
-                    filters: _ope.delete.filters,
-                    params: _ope.delete.params
-                }
-            });
-        }
-        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, idValue) {
-    return {
-        delete: {
-            schema: tSchema,
-            filters: [idField(tSchema) + ' = ' + toStringValue(idValue)]
-        }
-    }
-};
-
-export function prepareExecute(reqOpe) {
-    let _reqOpe = [];
-    let _result = [];
-    if (Array.isArray(reqOpe)) _reqOpe.push(...reqOpe);
-    else _reqOpe.push(reqOpe);
-    _reqOpe.forEach(function (_ope) {
-        if (_ope?.execute) {
-            if (!_ope.execute.command) throw new Error('Request sintax error, missing "execute.command" property.')
-            _result.push({
-                execute: {
-                    command: _ope.execute.command,
-                    params: _ope.execute.params
-                }
-            });
-        }
-        else throw new Error('Request sintax error, missing "execute" property.');
-    });
-    if (_result.length > 1) return _result;
-    if (_result.length = 1) return _result[0];
-    return undefined;
-};
-
-export function preparePassthrough(reqOpe) {
-    let _reqOpe = [];
-    let _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
-                }
-            });
-        }
-        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(reqOpe) {
-    return {
-        begin: {}
-    }
-};
-
-export function prepareCommit(reqOpe) {
-    return {
-        commit: {}
-    }
-};
-
-export function prepareRollback(reqOpe) {
-    return {
-        rollback: {}
-    }
-};
+'use strict';
+
+// import modules
+import schema from './schema.js'
+import * as mssql from './mssql.js';
+
+// Common
+const defautlFields = ['*'];
+const c_ServerType_mssql = "ms-sql";
+
+// Exported functions 
+export function idField(tSchema) {
+    return tSchema.table?.idField ?? 'id';
+}
+
+export async function runQuery(connection, dbOpes) {
+    if (connection.serverType === c_ServerType_mssql) {
+        const sqlresult = await mssql.query(connection, dbOpes);
+        ////mssql.closeConnection(connection);
+        if (sqlresult.recordsets.length === 0) { return; }
+        if (sqlresult.recordsets.length === 1) { return sqlresult.recordsets[0]; }
+        else { return sqlresult.recordsets; }
+    }
+    throw new TypeError('server type not supported');
+}
+
+export function prepareConnection(tSchema) {
+    if (!tSchema.server.type || tSchema.server.type === c_ServerType_mssql) {  // mssql is also the default
+        let _return = mssql.prepareConnection(tSchema);
+        _return.serverType = c_ServerType_mssql;  // append 'serverType' to connection
+        return _return;
+    }
+    throw new TypeError('server type not supported');
+}
+
+export function closeConnection(connection) {
+    if (connection.serverType === c_ServerType_mssql) { return mssql.closeConnection(connection); }
+}
+
+export function closeAllConnections() {
+    return mssql.closeAllConnections();
+}
+
+export function toStringValue(value) {
+    if (!value) return 'null';
+    if (value.trimStart().charAt(0) === '\'') return value;
+    return `\'${value}\'`;
+}
+
+export function prepareSchema(obj, objType) {
+    // eg. obj = 'systemName.dbName.tableName' or 'dbName.tableName' or 'tablename' or 'systemNme..tableName'
+    //     obj = 'systemName.dbName.spName @param1, @param2 ' or 'dbName.speName @param1' or 'spName' or 'systemNme..spName'
+    // objType = "T" or "SP"  (Table or StoreProcedure)
+
+    if (obj == undefined || typeof obj !== 'string') throw new TypeError('prepareSchema: wrong obj');
+    if (objType !== undefined && objType !== 'T' && objType !== 'SP') throw new TypeError('prepareSchema: wrong objType, must be "T" or "SP"');
+    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 === "T" || 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 === "SP") {
+        if (!objName || objName.length == 0) {
+            if (!schema.servers[serverName].databases[dbName] || !Object.keys(schema.servers[serverName].databases[dbName].storeprocedures)[0]) throw new TypeError('missing default storeprocedure in dbSchema');
+            objName = Object.keys(schema.servers[serverName].databases[dbName].storeprocedures)[0];
+        }
+        else { // add storeprocedure to schema
+            if (!schema.servers[serverName].databases[dbName].storeprocedures) { schema.servers[serverName].databases[dbName].storeprocedures = {} };
+            if (!schema.servers[serverName].databases[dbName].storeprocedures[objName]) { schema.servers[serverName].databases[dbName].storeprocedures[objName] = {} }
+        }
+        if (!schema.servers[serverName].databases[dbName].storeprocedures[objName].realName) { schema.servers[serverName].databases[dbName].storeprocedures[objName].realName = objName } // add realName
+    }
+
+    // return tSchema
+    return {
+        table: (objType == undefined || objType === 'T') ? schema.servers[serverName].databases[dbName].tables[objName] : undefined,
+        command:  (objType === 'SP') ? schema.servers[serverName].databases[dbName].storeprocedure[objName] : undefined,
+        database: schema.servers[serverName].databases[dbName],
+        server: schema.servers[serverName]
+    }
+
+}
+
+export function prepareTableSchema(tablePath) {
+    // eg. tablePath = 'systemName.dbName.tableName' or 'dbName.tableName' or 'tablename' or 'systemNme..tableName'
+    if (!tablePath || typeof tablePath !== 'string') throw new TypeError('wrong tablePath');
+
+    // split tablePath to serverName,dbName,tableName
+    let serverName = undefined;
+    let dbName = undefined;
+    let tableName = undefined;
+    const tablePathArray = tablePath.split('.');
+    if (tablePathArray.length > 2) {
+        serverName = tablePathArray[0]
+        dbName = tablePathArray[1]
+        tableName = tablePathArray[2]
+    }
+    else if (tablePathArray.length > 1) {
+        dbName = tablePathArray[0]
+        tableName = tablePathArray[1]
+    }
+    else if (tablePathArray.length > 0) {
+        tableName = tablePathArray[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 (!tableName || tableName.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');
+        tableName = 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[tableName]) { schema.servers[serverName].databases[dbName].tables[tableName] = {} }
+    }
+    if (!schema.servers[serverName].databases[dbName].tables[tableName].realName) { schema.servers[serverName].databases[dbName].tables[tableName].realName = tableName } // add realName
+
+    // return tSchema
+    return {
+        table: schema.servers[serverName].databases[dbName].tables[tableName],
+        database: schema.servers[serverName].databases[dbName],
+        server: schema.servers[serverName]
+    }
+
+}
+
+export function prepareRun(tSchema, reqOpe) {
+    let _reqOpe = [];
+    let _result = [];
+    if (Array.isArray(reqOpe)) _reqOpe.push(...reqOpe);
+    else _reqOpe.push(reqOpe);
+    _reqOpe.forEach(function (_ope) {
+        if (_ope?.get) _result.push(prepareGet(tSchema, _ope));
+        else if (_ope?.patch) _result.push(preparePatch(tSchema, _ope));
+        else if (_ope?.put) _result.push(preparePut(tSchema, _ope));
+        else if (_ope?.delete) _result.push(prepareDelete(tSchema, _ope));
+        else if (_ope?.execute) _result.push(prepareExecute(_ope));
+        else if (_ope?.begin) _result.push(prepareBegin(_ope));
+        else if (_ope?.commit) _result.push(prepareCommit(_ope));
+        else if (_ope?.rollback) _result.push(prepareRollback(_ope));
+        else if (_ope?.passthrough) _result.push(preparePassthrough(_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, idValue, reqOpe) {
+    if (reqOpe?.get) return prepareGetById(tSchema, idValue, reqOpe);
+    if (reqOpe?.patch) return preparePatchById(tSchema, idValue, reqOpe);
+    if (reqOpe?.put) return preparePutById(tSchema, idValue, reqOpe);
+    if (reqOpe?.delete) return prepareDeleteById(tSchema, idValue, reqOpe);
+    else throw new Error('Request sintax error, missing property get/patch/put/delete...');
+}
+
+export function prepareGet(tSchema, reqOpe) {
+    let _reqOpe = [];
+    let _result = [];
+    if (Array.isArray(reqOpe)) _reqOpe.push(...reqOpe);
+    else _reqOpe.push(reqOpe);
+    _reqOpe.forEach(function (_ope) {
+        // if ( !_ope?.get) { _ope = { get: { options: 'top 1000' } } }
+        _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
+            }
+        });
+    });
+    if (_result.length > 1) return _result;
+    if (_result.length = 1) return _result[0];
+    return undefined;
+};
+
+export function prepareGetById(tSchema, idValue, reqOpe) {
+    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
+        }
+    }
+};
+
+export function preparePatch(tSchema, reqOpe) {
+    let _reqOpe = [];
+    let _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
+                }
+            });
+        }
+        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, idValue, reqOpe) {
+    if (!reqOpe?.patch) throw new Error('Request sintax error, missing "patch" property.')
+    if (!reqOpe.patch.sets) throw new Error('Missing "patch.sets" in operation.')
+    let _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
+        }
+    }
+};
+
+export function preparePut(tSchema, reqOpe) {
+    let _reqOpe = [];
+    let _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: reqOpe.put.sets,
+                    params: reqOpe?.put.params
+                }
+            });
+        }
+        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, idValue, reqOpe) {
+    if (!reqOpe?.put) throw new Error('Request sintax error, missing "put" property.')
+    if (!reqOpe.put.sets) throw new Error('Missing "put.sets" in operation.')
+    reqOpe.put.sets[idField(tSchema)] = idValue;
+    return {
+        put: {
+            schema: tSchema,
+            sets: reqOpe.put.sets,
+            params: reqOpe?.put?.params
+        }
+    }
+};
+
+export function prepareDelete(tSchema, reqOpe) {
+    let _reqOpe = [];
+    let _result = [];
+    if (Array.isArray(reqOpe)) _reqOpe.push(...reqOpe);
+    else _reqOpe.push(reqOpe);
+    _reqOpe.forEach(function (_ope) {
+        if (_ope?.delete) {
+            if (!_ope.delete.sets) throw new Error('Request sintax error, missing "delete.sets" property.')
+            _result.push({
+                delete: {
+                    schema: tSchema,
+                    filters: _ope.delete.filters,
+                    params: _ope.delete.params
+                }
+            });
+        }
+        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, idValue) {
+    return {
+        delete: {
+            schema: tSchema,
+            filters: [idField(tSchema) + ' = ' + toStringValue(idValue)]
+        }
+    }
+};
+
+export function prepareExecute(reqOpe) {
+    let _reqOpe = [];
+    let _result = [];
+    if (Array.isArray(reqOpe)) _reqOpe.push(...reqOpe);
+    else _reqOpe.push(reqOpe);
+    _reqOpe.forEach(function (_ope) {
+        if (_ope?.execute) {
+            if (!_ope.execute.command) throw new Error('Request sintax error, missing "execute.command" property.')
+            _result.push({
+                execute: {
+                    command: _ope.execute.command,
+                    params: _ope.execute.params
+                }
+            });
+        }
+        else throw new Error('Request sintax error, missing "execute" property.');
+    });
+    if (_result.length > 1) return _result;
+    if (_result.length = 1) return _result[0];
+    return undefined;
+};
+
+export function preparePassthrough(reqOpe) {
+    let _reqOpe = [];
+    let _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
+                }
+            });
+        }
+        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(reqOpe) {
+    return {
+        begin: {}
+    }
+};
+
+export function prepareCommit(reqOpe) {
+    return {
+        commit: {}
+    }
+};
+
+export function prepareRollback(reqOpe) {
+    return {
+        rollback: {}
+    }
+};