minervajs-helmet 1.0.3 → 1.0.6

package/README.md

@@ -1,30 +1,30 @@
 # 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
+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
-> npm i minervajs-helmet
+Ejemplo: Partiendo de un proyecto en blanco recien creado  
+> npm i minervajs-helmet  
 
-Archivo: index.js
+Archivo: index.js  
 
-var db = require('minervajs-helmet');
+var db = require('minervajs-helmet');  
 
-var l_sql = " SELECT P.id, " +
-					" P.titulo, " +
-					" P.subtitulo, " +
-					" DATE_FORMAT(P.publicado, '%M %d, %Y') as publicado, " +
-					" P.autor, " +
-					" P.introduccion, " +
-					" P.tags, " +
-					" P.url_imagen " +
-				" FROM publicacion P " +
-				" ORDER BY P.publicado DESC " +
-				" LIMIT 10 ";
+var l_sql = " SELECT P.id, " +  
+           " P.titulo, " +  
+           " P.subtitulo, " +  
+           " DATE_FORMAT(P.publicado, '%M %d, %Y') as publicado, " +  
+           " P.autor, " +  
+           " P.introduccion, " +  
+           " P.tags, " +  
+           " P.url_imagen " +  
+     " FROM publicacion P " +  
+     " ORDER BY P.publicado DESC " +  
+     " LIMIT 10 ";  
 
-db.executeSQL(l_sql, function(a_data, err)
-{
-	if (err)
-	{console.log(err);}
-	else
-	{console.log(a_data);}
-});
+db.executeSQL(l_sql, function(a_data, err)  
+{  
+      if (err)  
+      {console.log(err);}  
+      else  
+      {console.log(a_data);}  
+});  
 

package/config/settings.js

@@ -0,0 +1,44 @@
+/**
+ * @module 
+ * @name settings
+ * @description Modulo gestor de la coneccion a la base de datos
+ * Configuracion de la Base de Datos
+ *
+ * Se incluye un ejemplo de uso, segun el tipo de base de datos
+ */
+exports.httpMsgFormat = 'HTML';
+exports.Title = "MinervaJS - Helmet";
+exports.Rights_Reserved = "2023-2025 © A&C Consultoría Informática";
+
+module.exports = {
+/*
+ * 'mi_postgres': 
+ * {
+ *   type: 'postgres',
+ *   host: 'localhost',
+ *   port: 5432,
+ *   user: 'usuario',
+ *   password: 'contraseña',
+ *   database: 'nombre_db'
+ * },
+  */
+  'my_mysql': 
+  {
+    type: 'mysql',
+    host: 'sql3.freesqldatabase.com'	// 'localhost',
+    port: 3306,							//
+    user: 'sql3772729'					// 'usuario',
+    password: 'esUA3qpGKD'				// 'contraseña',
+    database: 'sql3772729'				// 'nombre_db'
+  },
+  'my_oracle':  {
+    type: 'oracle',
+    host: 'localhost o IP'
+    port: 5432,
+    user: 'usuario',
+    password: 'contraseña',
+    database: 'nombre_db',
+ 	connectString : '(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=namehostoip)(PORT=port))(CONNECT_DATA=(SERVICE_NAME=servicename)))'
+  },
+
+};

package/js/db_mysql.js

@@ -3,10 +3,11 @@
  * @name db_mysql
  * @description Modulo gestor de la coneccion a la base de datos, MySQL, utiliza el cliente mysql2
  *
- */
- var mysql = require('mysql2');
+ *
+var mysql = require('mysql2');
 var settings = require('../js/settings');
 
+
 exports.executeSQL = function (sql, callback)
 {
     var con = new mysql.createConnection(settings.dbConfig);
@@ -58,3 +59,42 @@ exports.executeSQLarray = function (sql, array, callback)
         });
     });
 }
+*/
+const mysql = require('mysql2/promise'); // Usamos mysql2/promise para async/await
+
+async function connect(config) {
+  try {
+    const connection = await mysql.createConnection({
+      host: config.host,
+      port: config.port,
+      user: config.user,
+      password: config.password,
+      database: config.database,
+    });
+    return connection;
+  } catch (error) {
+    console.error('Error al conectar a MySQL:', error);
+    throw error; // Re-lanzamos el error para que sea manejado por el llamador
+  }
+}
+
+async function query(connection, sql, values = []) {
+  try {
+    const [rows, fields] = await connection.execute(sql, values);
+    return rows;
+  } catch (error) {
+    console.error('Error al ejecutar la consulta MySQL:', error);
+    throw error;
+  }
+}
+
+async function close(connection) {
+  try {
+    await connection.end();
+  } catch (error) {
+    console.error('Error al cerrar la conexión MySQL:', error);
+    throw error;
+  }
+}
+
+module.exports = { connect, query, close };

package/js/db_postgres.js

@@ -0,0 +1,21 @@
+const { Client } = require('pg');
+
+async function connect(config) 
+{
+  const client = new Client(config);
+  await client.connect();
+  return client;
+}
+
+async function query(client, sql) 
+{
+  const result = await client.query(sql);
+  return result.rows;
+}
+
+async function close(client) 
+{
+  await client.end();
+}
+
+module.exports = { connect, query, close };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "minervajs-helmet",
-  "version": "1.0.3",
-  "main": "src/index.js",
+  "version": "1.0.6",
+  "main": "src/db.js",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   },
@@ -17,7 +17,8 @@
   "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",
-    "oracledb": "^6.6.0"
+    "oracledb": "^6.6.0",
+    "pg": "^8.14.1"
   },
   "repository": {
     "type": "git",

package/src/db.js

@@ -0,0 +1,123 @@
+/**
+ * 
+ * @name MinervaJS-Helmet
+ * @description Modulo gestor de la coneccion a la base de datos
+ *
+ */
+const postgres = require('./js/db_postgres');
+const mysql = require('./js/db_mysql');
+const oracle = require('./js/db_oracle');
+const config = require('./config/settings');
+
+const connections = {};
+
+
+/**
+ * @function 
+ * @name connect
+ * @param {string} databaseName - Perfil de la base de datos
+ * @returns {result} result/err - Devuelve un objeto con del tipo conexión
+ * @description Toma la configuracion y realiza la coneccion a la base de datos
+ */
+async function connect(databaseName) 
+{
+  const dbConfig = config[databaseName];
+  if (!dbConfig) {
+    throw new Error(`Configuración de base de datos '${databaseName}' no encontrada.`);
+  }
+
+  if (connections[databaseName]) 
+  {
+    return connections[databaseName]; // Ya existe una conexión
+  }
+
+  switch (dbConfig.type) 
+  {
+    case 'postgres':
+      connections[databaseName] = await postgres.connect(dbConfig);
+      break;
+    case 'mysql':
+      connections[databaseName] = await mysql.connect(dbConfig);
+      break;
+    case 'oracle':
+      connections[databaseName] = await oracle.connect(dbConfig);
+      break;
+    default:
+      throw new Error(`Tipo de base de datos '${dbConfig.type}' no soportado.`);
+  }
+
+  return connections[databaseName];
+}
+
+/**
+ * @function 
+ * @name query
+ * @param {string} databaseName - Perfil de la base de datos
+ * @param {string} sql - Sentencia SQL a ejecutar
+ * @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 query(databaseName, sql) 
+{
+  const connection = await connect(databaseName);
+  const dbConfig = config[databaseName];
+
+  switch (dbConfig.type) 
+  {
+    case 'postgres':
+      return postgres.query(connection, sql);
+    case 'mysql':
+      return mysql.query(connection, sql);
+    case 'oracle':
+      return oracle.query(connection, sql);
+    default:
+      throw new Error(`Tipo de base de datos '${dbConfig.type}' no soportado para la operación 'query'.`);
+  }
+}
+
+/**
+ * @function 
+ * @name close
+ * @param {string} databaseName - Perfil de la base de datos
+  * @returns NONE
+ * @description Cierra la conexion del Perfil de la base de datos pasado como parametro.
+ */
+async function close(databaseName) 
+{
+  if (connections[databaseName]) 
+  {
+    const dbConfig = config[databaseName];
+    switch (dbConfig.type) {
+      case 'postgres':
+        await postgres.close(connections[databaseName]);
+        break;
+      case 'mysql':
+        await mysql.close(connections[databaseName]);
+        break;
+      case 'oracle':
+        await oracle.close(connections[databaseName]);
+        break;
+    }
+    delete connections[databaseName];
+  }
+}
+
+
+
+/**
+ * @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
+ */
+ 
+
+module.exports = 
+{
+  connect,
+  query,
+  close,
+  // ... otras funciones comunes
+};

package/settings.js

@@ -1,20 +0,0 @@
-/**
- * @module 
- * @name db
- * @description Modulo gestor de la coneccion a la base de datos
- * dbConfig	Configuracion de la Base de Datos
- */
-exports.httpMsgFormat = 'HTML';
-exports.Title = "DB Smarts Docs";
-exports.Rights_Reserved = "2023-2025 © A&C Consultoría Informática";
-
-exports.dbConfig = 
-{
-	// mysql
-    // host: "localhost o IP",
-      user: "User",
-      password: "Password01",
-    // database: "DBSisConta"
-      connectString : "(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=namehostoip)(PORT=port))(CONNECT_DATA=(SERVICE_NAME=servicename)))"
-};
-

package/src/index.js

@@ -1,7 +0,0 @@
-/**
- * 
- * @name MinervaJS-Helmet
- * @description Modulo gestor de la coneccion a la base de datos
- *
- */
-