ags-sql-gen 1.0.3 → 1.0.5

package/README.md

@@ -3,6 +3,8 @@
 
 AGS is a lightweight Node.js MySQL helper library that simplifies database operations such as **SELECT**, **INSERT**, **UPDATE**, **DELETE**, and **JOIN** queries.  
 It also includes a fun bonus function: `getDadJokes()` — because debugging is better with a laugh. 😄
+`AGS-SQL-Template` is a ready-to-use SQL helper class designed for developers who frequently interact with MySQL databases in Node.js.  
+It provides easy methods for `SELECT`, `INSERT`, `UPDATE`, `DELETE`, `JOIN`, and aggregation queries (`SUM`, `MIN`, `MAX`, `AVG`) without needing to manually write long SQL statements every time.
 
 
 ## 🚀 Features
@@ -27,7 +29,7 @@ npm install mysql2
 ```js
 import AGS from "ags-sql-lib";
 
-const sql = new AGS("root", "password", "localhost", "my_database");
+const sql = new AGS.connect("root", "password", "localhost", "my_database");
 ```
 ### select
 Select all columns
@@ -95,6 +97,27 @@ const result = await sql.selectInnerJoin(
   "tblusers.id = tblorders.user_id"
 );
 ```
+### Aggregation queries
+
+```js
+Calculate the total of all 'grade' values in one table
+const totalGrades = await sql.sum("grade", "tbl_grades");
+
+Get the lowest grade
+const lowestGrade = await sql.min("grade", "tbl_grades");
+
+Get the highest grade
+const highestGrade = await sql.max("grade", "tbl_grades");
+
+Get the average grade
+const averageGrade = await sql.avg("grade", "tbl_grades");
+
+multiple tables
+const totalResults = await db.sum("amount", ["tbl_sales", "tbl_purchases"]);
+const minResults = await db.min("score", ["tbl_quiz1", "tbl_quiz2"]);
+const maxResults = await db.max("salary", ["tbl_teachers", "tbl_admin"]);
+const avgResults = await db.avg("grade", ["tbl_midterm", "tbl_final"]);
+```
 ### BONUS
 ```js
 import { getDadJokes } from "ags-sql-lib";

package/connection.js

@@ -1,6 +1,6 @@
-const connection = require("./database/dbConnection");
+import connection from "./database/dbConnection.js";
 
-module.exports = class {
+export default class {
     #sqlOperation;
 
     constructor(user, password, host, database) {
@@ -18,12 +18,11 @@ module.exports = class {
         }
         return result;
       }
-
       const sql = `SELECT ${columnName || "*"} FROM ${tableName}`;
       const [result] = await this.#sqlOperation.query(sql);
       return result;
     } catch (error) {
-      console.log(error);
+      throw new Error(error.message);
     }
   }
 
@@ -33,23 +32,19 @@ module.exports = class {
       if(Array.isArray(idValue)){
         let result = [];
         for(let i in idValue){
-          const sql = `SELECT ${columnName || "*"} FROM ${tableName} WHERE ${
-      yourIdName || "Id"
-    } = ${idValue[i]}`;
-          const [selectResult] = await this.#sqlOperation.query(sql)
+          const sql = `SELECT ${columnName || "*"} FROM ?? WHERE ?? = ?`;
+          const [selectResult] = await this.#sqlOperation.query(sql, [tableName, yourIdName, idValue[i]]);
           result.push(selectResult[0]);
         }
         return result;
       }
 
-      const sql = `SELECT ${columnName || "*"} FROM ${tableName} WHERE ${
-      yourIdName || "Id"
-    } = ${idValue}`;
-      const [selectResult] = await this.#sqlOperation.query(sql)
+      const sql = `SELECT ${columnName || "*"} FROM ?? WHERE ?? = ?`;
+      const [selectResult] = await this.#sqlOperation.query(sql, [tableName, yourIdName, idValue]);
       return selectResult[0];
 
     } catch (error) {
-      console.log(error);
+      throw new Error(error.message);
     }
   }
 
@@ -68,7 +63,7 @@ module.exports = class {
     const [insertResult] = await this.#sqlOperation.query(sql, [objectValue]);
     return insertResult;
     } catch (error) {
-      console.log(error);
+     throw new Error(error.message);
     }
   }
 
@@ -78,17 +73,17 @@ module.exports = class {
       if(Array.isArray(objectValue) && Array.isArray(idValue)){
         let result = [];
         for(let i in objectValue){
-          const sql = `UPDATE ${tableName} SET ? WHERE ${yourIdName} = ${idValue[i]}`;
-          const [updateResult] = await this.#sqlOperation.query(sql, [objectValue[i]]);
+          const sql = `UPDATE ?? SET ? WHERE ?? = ?`;
+          const [updateResult] = await this.#sqlOperation.query(sql, [tableName, objectValue[i], yourIdName, idValue[i]]);
           result.push(updateResult);
         }
         return result;
       }
-      const sql = `UPDATE ${tableName} SET ? WHERE ${yourIdName} = ${idValue}`;
-      const [updateResult] = await this.#sqlOperation.query(sql, [objectValue]);
+      const sql = `UPDATE ?? SET ? WHERE ?? = ?`;
+      const [updateResult] = await this.#sqlOperation.query(sql, [tableName, objectValue, yourIdName, idValue]);
       return updateResult;
     } catch (error) {
-      console.log(error);
+      throw new Error(error.message);
     }
   }
 
@@ -97,17 +92,17 @@ module.exports = class {
       if(Array.isArray(idValue)){
         let result = [];
         for(let i in idValue){
-          const sql = `DELETE FROM ${tableName} WHERE ${yourIdName || "Id"} = ${idValue[i]}`;
-          const [deleteResult] = await this.#sqlOperation.query(sql);
+          const sql = `DELETE FROM ?? WHERE ?? = ?`;
+          const [deleteResult] = await this.#sqlOperation.query(sql, [tableName, yourIdName, idValue[i]]);
           result.push(deleteResult);
         }
         return result;
       }
-      const sql = `DELETE FROM ${tableName} WHERE ${yourIdName || "Id"} = ${idValue}`;
-      const [deleteResult] = await this.#sqlOperation.query(sql);
+      const sql = `DELETE FROM ?? WHERE ?? = ?`;
+      const [deleteResult] = await this.#sqlOperation.query(sql, [tableName, yourIdName, idValue]);
       return deleteResult;
     } catch (error) {
-      console.log(error);
+      throw new Error(error.message);
     }
   }
 
@@ -116,27 +111,103 @@ module.exports = class {
       if(Array.isArray(idValue)){
         let result = [];
         for(let i in idValue){
-          const sql = `SELECT ${columnName || "*"} FROM ${tbl_a} ${joinType} ${tbl_b} ON ${onCondition} WHERE ${yourIdName} = ${idValue[i]}`;
-          const [selectResult] = await this.#sqlOperation.query(sql);
+          const sql = `SELECT ${columnName || "*"} FROM ?? ${joinType} ?? ON ${onCondition} WHERE ?? = ?`;
+          const [selectResult] = await this.#sqlOperation.query(sql, [tbl_a, tbl_b, yourIdName, idValue[i]]);
           result.push(selectResult[0]);
         }
         return result;
       }
-      const sql = `SELECT ${columnName || "*"} FROM ${tbl_a} ${joinType} ${tbl_b} ON ${onCondition} WHERE ${yourIdName} = ${idValue}`;
-      const [selectResult] = await this.#sqlOperation.query(sql);
+      const sql = `SELECT ${columnName || "*"} FROM ?? ${joinType} ?? ON ${onCondition} WHERE ?? = ?`;
+      const [selectResult] = await this.#sqlOperation.query(sql, [tbl_a, tbl_b, yourIdName, idValue]);
       return selectResult;
     } catch (error) {
-      console.log(error);
+      throw new Error(error.message);
     }
   }
 
   async selectInnerJoin(tbl_a, tbl_b, columnName, onCondition){
    try {
-    const sql = `SELECT ${columnName || "*"} FROM ${tbl_a} INNER JOIN ${tbl_b} ON ${onCondition}`;
-    const [result] = await this.#sqlOperation.query(sql);
+    const sql = `SELECT ${columnName || "*"} FROM ?? INNER JOIN ?? ON ${onCondition}`;
+    const [result] = await this.#sqlOperation.query(sql, [tbl_a, tbl_b]);
     return result;
    } catch (error) {
-    console.log(error);
+    throw new Error(error.message);
    }
   }
+
+  async sum(columnName, tableName){
+    try {
+      if(Array.isArray(tableName)){
+        let result = [];
+        for(let i in tableName){
+          const sql = `SELECT SUM(${columnName}) FROM ??`;
+          const [selectResult] = await this.#sqlOperation.query(sql, [tableName[i]]);
+          result.push(selectResult);
+        }
+        return result;
+      }
+      const sql = `SELECT SUM(${columnName}) FROM ??`;
+      const [result] = await this.#sqlOperation.query(sql, [tableName]);
+      return result;
+    } catch (error) {
+      throw new Error(error.message);
+    }
+  }
+
+  async max(columnName, tableName){
+    try {
+      if(Array.isArray(tableName)){
+        let result = [];
+        for(let i in tableName){
+          const sql = `SELECT MAX(${columnName}) FROM ??`;
+          const [selectResult] = await this.#sqlOperation.query(sql, [tableName[i]]);
+          result.push(selectResult);
+        }
+        return result;
+      }
+      const sql = `SELECT MAX(${columnName}) FROM ??`;
+      const [result] = await this.#sqlOperation.query(sql, [tableName]);
+      return result;
+    } catch (error) {
+      throw new Error(error.message);
+    }
+  }
+
+  async min(columnName, tableName){
+    try {
+      if(Array.isArray(tableName)){
+        let result = [];
+        for(let i in tableName){
+          const sql = `SELECT MIN(${columnName}) FROM ??`;
+          const [selectResult] = await this.#sqlOperation.query(sql, [tableName[i]]);
+          result.push(selectResult);
+        }
+        return result;
+      }
+      const sql = `SELECT MIN(${columnName}) FROM ??`;
+      const [result] = await this.#sqlOperation.query(sql, [tableName]);
+      return result;
+    } catch (error) {
+     throw new Error(error.message);
+    }
+  }
+
+  async avg(columnName, tableName){
+    try {
+      if(Array.isArray(tableName)){
+        let result = [];
+        for(let i in tableName){
+          const sql = `SELECT AVG(${columnName}) FROM ??`;
+          const [selectResult] = await this.#sqlOperation.query(sql, [tableName[i]]);
+          result.push(selectResult);
+        }
+        return result;
+      }
+      const sql = `SELECT AVG(${columnName}) FROM ??`;
+      const [result] = await this.#sqlOperation.query(sql, [tableName]);
+      return result;
+    } catch (error) {
+      throw new Error(error.message);
+    }
+  }
 };

package/database/dbConnection.js

@@ -1,6 +1,6 @@
-const mysql = require("mysql2");
+import mysql from "mysql2";
 
-module.exports = (user, password, host, database) => {
+export default (user, password, host, database) => {
   const dbConnection = mysql
     .createPool({
       user: user,

package/getJokes.js

@@ -1,6 +1,6 @@
-const { exec } = require("child_process");
+import { exec } from "child_process";
 
-module.exports = async () => {
+export default async () => {
   return new Promise((resolve, reject) => {
     try {
       exec("curl https://icanhazdadjoke.com", (error, stdout, stderr) => {

package/index.js

@@ -1,4 +1,7 @@
-module.exports = {
-  connect: require("./connection"),
-  getJokes: require("./getJokes")
-};
+import connect from "./connection.js";
+import getJokes from "./getJokes.js";
+
+export default {
+  connect,
+  getJokes
+};

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "ags-sql-gen",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "lightweight Node.js MySQL helper library",
   "main": "index.js",
-  "type": "commonjs",
+  "type": "module",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   },