minervajs-helmet 1.0.10 → 1.0.12

package/LICENSE

@@ -1,6 +1,6 @@
 BSD 2-Clause License
 
-Copyright (c) 2024, Alexander E. Escobar
+Copyright (c) 2024, 2025, Alexander Enrique Escobar O.
 
 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions are met:

package/README.md

@@ -1,26 +1,26 @@
-# MinervaJS-Helmet
+# MinervaJS.Helmet
 Modulo para la gestion de las conección a la base de datos, permite conectarse a varios tipos utilizando sobrecarga de metodos, tolera MySQL y Oracle Client  
 
-Ejemplo: Partiendo de un proyecto en blanco recien creado  
+Ejemplo: Partiendo de un proyecto NodeJS en blanco recien creado  
 `$ npm i minervajs-helmet  `
 
-###Archivo: ./config/settings.js  
+#### Archivo: ./config/settings.js  
 Adicionas una Entrada, por cada tipo y base de datos
 ```javascript
 {
-  'my_mysql':						// 'Perfil de Conexion'
+  'my_mysql':				// 'Perfil de Conexión'
   {
     type: 'mysql',
     host: 'sql3.freesqldatabase.com',	// 'localhost',
-    port: 3306, 					// 'puerto',
-    user: 'sql3772729', 			// 'usuario',
+    port: 3306, 			// 'puerto',
+    user: 'sql3772729', 		// 'usuario',
     password: 'esUA3qpGKD', 		// 'contraseña',
-    database: 'sql3772729' 			// 'nombre_db'
+    database: 'sql3772729' 		// 'nombre_db'
   }
 }
 ```
 
-###Archivo: index.js
+#### Archivo: index.js
 
 ```javascript
 var db = require('minervajs-helmet');
@@ -30,7 +30,7 @@ async function main() {
   try {
     // Conexión a MySQL
     const mysqlConnection = await db.connect('my_mysql', config);
-    const mysqlResult = await db.query('my_mysql', ' SELECT * FROM test ;', [], config); // Ejemplo con parámetros
+    const mysqlResult = await db.query('my_mysql', ' SELECT * FROM test ;', [], config); // Ejemplo sin parámetros
     console.log('Resultados de MySQL:', mysqlResult);
     await db.close('my_mysql', config);
   } catch (error) {
@@ -41,7 +41,7 @@ async function main() {
 main();
 ```
 
-###Salida de resultados
+#### Salida de resultados
 ```javascript
 Resultados de MySQL: [
   {

package/js/db_mysql.js

@@ -19,8 +19,10 @@ const mysql = require('mysql2/promise'); // Usamos mysql2/promise para async/awa
  * @param {object} config - Configuración de la conexión.
  * @returns {Promise<mysql.Connection>} Objeto de conexión de MySQL.
  */
-async function connect(config) {
-  try {
+async function connect(config) 
+{
+  try 
+  {
     const connection = await mysql.createConnection({
       host: config.host,
       port: config.port,
@@ -29,7 +31,9 @@ async function connect(config) {
       database: config.database,
     });
     return connection;
-  } catch (error) {
+  } 
+  catch (error) 
+  {
     console.error('Error al conectar a MySQL:', error);
     throw error; // Re-lanzamos el error para que sea manejado por el llamador
   }
@@ -45,11 +49,15 @@ async function connect(config) {
  * @param {Array} [values] - Parámetros para la consulta.
  * @returns {Promise<Array>} Filas resultantes de la consulta.
  */
-async function query(connection, sql, values = []) {
-  try {
+async function query(connection, sql, values = []) 
+{
+  try 
+  {
     const [rows, fields] = await connection.execute(sql, values);
     return rows;
-  } catch (error) {
+  } 
+  catch (error) 
+  {
     console.error('Error al ejecutar la consulta MySQL:', error);
     throw error;
   }
@@ -63,10 +71,12 @@ async function query(connection, sql, values = []) {
  * @param {mysql.Connection} connection - Objeto de conexión de MySQL.
  * @returns {Promise<void>}
  */
-async function close(connection) {
-  try {
-    await connection.end();
-  } catch (error) {
+async function close(connection) 
+{
+  try 
+  { await connection.end(); }
+  catch (error) 
+  {
     console.error('Error al cerrar la conexión MySQL:', error);
     throw error;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minervajs-helmet",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "main": "src/db.js",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
@@ -10,10 +10,12 @@
     "Multi DataBase",
     "connect",
     "MySQL",
-    "Oracle Client"
+    "Oracle Client",
+	"PostGres",
+	"MinervaJS"
   ],
   "author": "alexander.enrique.escobar@gmail.com",
-  "license": "ISC",
+  "license": "BSD-2-Clause",
   "description": "Modulo para la gestion de coneccion a la base de datos, de diferentes tipos mediante el uso de sobre Carga y Herencia de clases",
   "dependencies": {
     "mysql2": "^3.14.0",

package/src/db.js

@@ -27,39 +27,37 @@ const connections = {};
  */
 async function connect(databaseName, config) 
 {
-  const dbConfig = config[databaseName];
-  
-  if (!dbConfig) {
-    throw new Error(`Configuración de base de datos '${databaseName}' no encontrada.`);
-  }
+	const dbConfig = config[databaseName];
 
-  if (connections[databaseName]) 
-  {
-    return connections[databaseName]; // Ya existe una conexión
-  }
+	if (!dbConfig) 
+	{ throw new Error(`Configuración de base de datos '${databaseName}' no encontrada.`); }
 
-  switch (dbConfig.type) 
-  {
-    case 'postgres':
-      connections[databaseName] = await postgres.connect(dbConfig);
-      break;
-    case 'mysql':
-      connections[databaseName] = await mysql.connect(dbConfig);
-      break;
-    // case 'mariadb':
-    //   connections[databaseName] = await mariadb.connect(dbConfig);
-    //   break;
-    case 'oracle':
-      connections[databaseName] = await oracle.connect(dbConfig);
-      break;
-    // case 'mongodb':
-    //  connections[databaseName] = await mongodb.connect(dbConfig);
-    //  break;
-    default:
-      throw new Error(`Tipo de base de datos '${dbConfig.type}' no soportado.`);
-  }
+	// Ya existe una conexión 
+	if (connections[databaseName]) 
+	{ return connections[databaseName]; }
+
+	switch (dbConfig.type) 
+	{
+		case 'postgres':
+			connections[databaseName] = await postgres.connect(dbConfig);
+			break;
+		case 'mysql':
+			connections[databaseName] = await mysql.connect(dbConfig);
+			break;
+		// case 'mariadb':
+		//   connections[databaseName] = await mariadb.connect(dbConfig);
+		//   break;
+		case 'oracle':
+			connections[databaseName] = await oracle.connect(dbConfig);
+			break;
+		// case 'mongodb':
+		//  connections[databaseName] = await mongodb.connect(dbConfig);
+		//  break;
+		default:
+			throw new Error(`Tipo de base de datos '${dbConfig.type}' no soportado.`);
+	}
 
-  return connections[databaseName];
+	return connections[databaseName];
 }
 
 /**
@@ -140,12 +138,36 @@ async function close(databaseName, config)
 
 /**
  * @function 
- * @name executeSQL
+ * @name execute
  * @param {string} sql - Sentencia SQL a ejecutar
  * @param {Promise<callback>} callback - objeto, para retornar la promesa
  * @returns {result} result/err - Devuelve un objeto con el set de datos o un objeto err con la respuesta del error
  * @description Ejecuta una sentencia SQL y devuelve un objeto en un set de datos
  */
+async function execute(databaseName, sql, values = [], config) 
+{
+	const connection = await connect(databaseName, config);
+	const dbConfig = config[databaseName];
+	
+	switch (dbConfig.type) 
+	{
+		case 'postgres':
+			return postgres.query(connection, sql);
+		case 'mysql':
+			return mysql.query(connection, sql, values);
+	// case 'mariadb': // agregamos el caso MariaDB
+	//   return mariadb.query(connection, sql, binds);
+	//   break;
+		case 'oracle':
+			return oracle.query(connection, sql);
+	// case 'mongodb':
+	//  // Adaptar la consulta SQL a la sintaxis de MongoDB
+	//  console.warn("La función 'query' no es directamente aplicable a MongoDB con sintaxis SQL.");
+	//  return null; // O lanzar un error
+		default:
+			throw new Error(`Tipo de base de datos '${dbConfig.type}' no soportado para la operación 'query'.`);
+	}
+}
 
  
 
@@ -153,6 +175,7 @@ module.exports =
 {
   connect,
   query,
+  execute,
   close,
   // ... otras funciones comunes
 };

package/js/OLD db.js

@@ -1,76 +0,0 @@
-/**
- * @module 
- * @name db_mysql
- * @description Modulo gestor de la coneccion a la base de datos, MySQL, utiliza el cliente mysql2
- */
-
-var mysql = require('mysql');
-var settings = require('../settings');
-
-/**
- * @function 
- * @name executeSQL
- * @param {string} sql - Sentencia SQL a ejecutar
- * @param {Promise<callback>} callback - objeto, para retornar la promesa
- * @returns {result} result/err - Devuelve un objeto con el set de datos o un objeto err con la respuesta del error
- * @description Ejecuta una sentencia SQL y devuelve un objeto en un set de datos
- */
-exports.executeSQL = function (sql, callback)
-{
-    var con = new mysql.createConnection(settings.dbConfig);
-    
-    con.connect(function(err) 
-	{
-        if (err) 
-        {
-            callback(null, err);
-            //throw err;
-        }
-        if (settings.servConfig.debug){console.log("Connected!");}
-        con.query(sql, function (err, result) {
-          if (err) 
-          {
-            callback(null, err);
-            //throw err;
-          }
-		  if (settings.servConfig.debug){console.log("Sentencia Ejecutada:"+sql);}
-          callback(result);
-		  
-		  con.end();
-        });
-    });
-};
-
-/**
- * @function 
- * @name executeSQLarray
- * @param {string} sql - Sentencia SQL a ejecutar
- * @param {Promise<callback>} callback - objeto, para retornar la promesa
- * @returns {result} result/err - Devuelve un objeto con el set de datos o un objeto err con la respuesta del error
- * @description Ejecuta una sentencia SQL, basado en una serie de argumentos y devuelve un objeto en un set de datos
- */
-exports.executeSQLarray = function (sql, array, callback)
-{
-	var con = new mysql.createConnection(settings.dbConfig);
-    
-    con.connect(function(err) 
-	{
-        if (err) 
-        {
-            callback(null, err);
-            //throw err;
-        }
-        if (settings.servConfig.debug){console.log("Connected!");}
-        con.query(sql, array, function (err, result) {
-          if (err) 
-          {
-            callback(null, err);
-            //throw err;
-          }
-          if (settings.servConfig.debug){console.log("Sentencia Ejecutada:"+sql);}
-          callback(result);
-		  
-		  con.end();
-        });
-    });
-}