db-crud-api 0.3.14 → 0.3.16

package/CHANGELOG.md

@@ -56,4 +56,9 @@
 ## v0.3.14 (2025-11-08)
 
     Bug fix:
-        - getByFilters can return an object instead of array
+        - getByFilters can return an object instead of array
+## v0.3.15 (2025-11-10)
+
+    Added:
+        - config
+        - log via callback        

package/index.js

@@ -1,11 +1,18 @@
-"use strict";
-
-import schema from "./lib/schema.js";
-import * as apiFactory from "./lib/api-factory.js";
-
-export default function(customSchema) {
-    if (customSchema && customSchema.servers) {
-        schema.servers = customSchema.servers;
-    }
-    return apiFactory;
-}
+"use strict";
+
+import schema from "./lib/schema.js";
+import * as apiFactory from "./lib/api-factory.js";
+
+export default function(customSchema, config) {
+    if (customSchema && customSchema.servers) {
+        apiFactory.setSchemaServers(customSchema.servers);
+    }
+    if (config) {
+        if (config.log) {
+            if (config.log.level) { apiFactory.setLogLevel(config.log.level) }
+            if (config.log.callback) { apiFactory.setLogCallback(config.log.callback) }
+            if (config.log.maxAsyncInstance) { apiFactory.setLogMaxAsyncInstances(config.log.maxAsyncInstance) }
+        }
+    }
+    return apiFactory;
+}

package/lib/api-factory.js

@@ -1,5 +1,6 @@
 "use strict";
 
+import schema from "./schema.js";
 import * as dbOpe from "./db-operations.js" 
 import apiFull from "./api-full.js"
 import apiRO from "./api-ro.js"
@@ -28,4 +29,22 @@ export function closeAllDbConnections() {
 
 export function testDbConnection() {
     return dbOpe.testConnection();
+}
+
+export function setLogLevel(level) {
+    if (typeof level === 'number') { schema.config.log.level = level } 
+    else if (typeof level === 'string' && Number.parseInt(level) != NaN) { schema.config.log.level = Number.parseInt(level) }
+}
+
+export function setLogCallback(callback) {
+    if (typeof callback === 'function') { schema.config.log.callback = callback }
+}
+
+export function setLogMaxAsyncInstances(maxAsyncInstance) {
+    if (typeof maxAsyncInstance === 'number') { schema.config.log.maxAsyncInstance = maxAsyncInstance } 
+    else if (typeof maxAsyncInstance === 'string' && Number.parseInt(maxAsyncInstance) != NaN) { schema.config.log.maxAsyncInstance = Number.parseInt(maxAsyncInstance) }
+}
+
+export function setSchemaServers(servers) {
+    schema.servers = servers;
 }

package/lib/log.js

@@ -0,0 +1,21 @@
+'use strict';
+
+import schema from './schema.js';
+let numberOfAsyncInstances = 0;
+
+export default function log(msg, level = 1) {
+    if (schema.config.log.level >= level && schema.config.log.callback) {
+        try {
+            const _param = {level: level, text: msg}; 
+            const _result = schema.config.log.callback(_param);
+            if (_result && typeof _result.then === 'function') {
+                // È una Promise (o un oggetto thenable)
+                if (numberOfAsyncInstances <= schema.config.log.maxAsyncInstance) {
+                    numberOfAsyncInstances++;
+                    _result.then((_param) => {}).catch(error => {}).finally(() => {numberOfAsyncInstances--;});
+                };
+            };
+        }
+        catch {}
+    }
+};

package/lib/mssql.js

@@ -1,6 +1,7 @@
 'use strict';
 
 import sql from 'mssql';
+import log from './log.js'
 
 // Regex
 const _match_LIMIT_n = /\bLIMIT\b +\d+/ig
@@ -111,14 +112,20 @@ export async function query(connection, dbOpes) {
 
     sqlString = normalizeSpecialName(sqlString);
 
+    // Log
+    log(sqlString, 50);
+    log(JSON.stringify(dbOpes), 60);
+    
     // Run query
     const sqlresult = await sqlRequest.query(sqlString);
 
+    // Log
+    log(`Query result: ${sqlresult.recordset ? sqlresult.recordset.length : 0} rows.`, 50);
+
     // normalize return object
     if (sqlresult.recordset == undefined) return;
     if (sqlresult.recordset.length === 0) return;
-    // if (sqlresult.recordset.length === 1) return sqlresult.recordset[0];
-    // else
+
     return sqlresult.recordset;
 }
 

package/lib/mysql.js

@@ -1,6 +1,7 @@
 'use strict';
 
 import sql from 'mysql2/promise';
+import log from './log.js'
 
 // Regex
 const _match_LIMIT_n = /\bLIMIT\b +\d+/ig
@@ -102,6 +103,10 @@ export async function query(connection, dbOpes) {
 
     sqlString = normalizeSpecialName(sqlString);
 
+    // Log
+    log(JSON.stringify(dbOpes), 60);
+    log(sqlString, 50);
+
     // Run query
     let sqlresult = undefined;
     let sqlconn = undefined;
@@ -112,12 +117,14 @@ export async function query(connection, dbOpes) {
     catch (err) { throw (err); } // using original error
     finally { if (sqlconn) sqlconn.release(); }
 
-    // Return single object if there is only 1 row
+    // Log
+    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;
-    // if (sqlresult[0].length === 1) return sqlresult[0][0];
-    // else
+
     return sqlresult[0];
 }
 

package/lib/schema.js

@@ -1,4 +1,11 @@
-export default {
-    servers: {
-    }
+export default {
+    servers: {
+    },
+    config: {
+        log: {
+            level: 0,
+            callback: undefined,
+            maxAsyncInstance: 50
+        }
+    }
 }

package/package.json

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