minervajs-helmet 1.0.2 → 1.0.4

package/README.md

@@ -1,2 +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  
+
+Archivo: index.js  
+
+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 ";  
+
+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.js → OLD db.js }

@@ -12,7 +12,7 @@ var settings = require('../settings');
  * @function 
  * @name executeSQL
  * @param {string} sql - Sentencia SQL a ejecutar
- * @param {callback} callback - objeto, para retornar la promesa
+ * @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
  */
@@ -46,7 +46,7 @@ exports.executeSQL = function (sql, callback)
  * @function 
  * @name executeSQLarray
  * @param {string} sql - Sentencia SQL a ejecutar
- * @param {callback} callback - objeto, para retornar la promesa
+ * @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
  */

package/js/db_mysql.js

@@ -1,4 +1,10 @@
-var mysql = require('mysql');
+/**
+ * @module 
+ * @name db_mysql
+ * @description Modulo gestor de la coneccion a la base de datos, MySQL, utiliza el cliente mysql2
+ *
+ */
+ var mysql = require('mysql2');
 var settings = require('../js/settings');
 
 exports.executeSQL = function (sql, callback)

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.2",
-  "main": "src/index.js",
+  "version": "1.0.4",
+  "main": "src/db.js",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   },
@@ -16,16 +16,15 @@
   "license": "ISC",
   "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": {
-    "mysql": "^2.18.1",
+    "mysql2": "^3.14.0",
     "oracledb": "^6.6.0"
   },
-  "devDependencies": {},
   "repository": {
-	  "type": "git",
-	  "url": "https://github.com/Alexander-Escobar/MinervaJS.Helmet.git"
+    "type": "git",
+    "url": "https://github.com/Alexander-Escobar/MinervaJS.Helmet.git"
   },
   "bug": {
-	  "url": "https://github.com/Alexander-Escobar/MinervaJS.Helmet.git/issues"
+    "url": "https://github.com/Alexander-Escobar/MinervaJS.Helmet.git/issues"
   },
   "homepage": "https://github.com/Alexander-Escobar/MinervaJS.Helmet.git#readme"
 }

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,32 +0,0 @@
-/*
-	Configuracion y Parametrizacion general de la Aplicacion & Sitio Web
-	
-	Listado:
-		dbConfig	Configuracion de la Base de Datos
-		servConfig	Configuracion del Servidor
-		httpConfig	Configuracion de las Peticiones URL del Protocolo HTTP
-		Google		Configuracion para Google Ads
-		Image		Configuracion General para las imagenes
-		pagConfig	Configuracion de la Paginacion de los Mantenimientos
-*/
-
-exports.httpMsgFormat = 'HTML';
-exports.Title = "DB Smarts Docs";
-exports.Rights_Reserved = "2023 © A&C Consultoría Informática";
-
-exports.dbConfig = 
-{
-	// mysql
-    // host: "localhost",
-      user: "Owlet",
-      password: "Password01",
-    // database: "DBSisConta"
-      connectString : "(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=namehostoip)(PORT=port))(CONNECT_DATA=(SERVICE_NAME=servicename)))"
-};
-
-exports.servConfig = 
-{
-	hostname: "",	// http://localhost:9000
-	webPort: 9000,	// 80
-	debug: true
-};

package/src/index.js

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