ags-sql-gen 1.0.2

package/README.md

@@ -0,0 +1,92 @@
+# AGS SQL Library
+
+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. 😄
+
+---
+
+## 🚀 Features
+
+- Simple MySQL query wrapper using async/await  
+- Automatic handling for:
+  - Single or multiple table queries
+  - Batch insert, update, and delete
+- Built-in JOIN methods (INNER, LEFT, RIGHT)
+- Minimal setup required — just plug in your MySQL connection
+- Fun extra: fetches a random dad joke via `curl`
+
+---
+
+## 📦 Installation
+
+```bash
+npm install ags-sql-lib mysql2
+
+## Importing
+import AGS from "ags-sql-lib";
+
+const sql = new AGS("root", "password", "localhost", "my_database");
+
+// Select all columns
+const result = await sql.select("*", "users");
+
+// Select from multiple tables
+const result = await sql.select("*", ["users", "products"]);
+
+// Single
+const user = await sql.selectWithId("id", "*", "users", 1);
+
+// Multiple
+const users = await sql.selectWithId("id", "*", "users", [1, 2, 3]);
+
+## InsertInto
+// Single insert
+await sql.insertInto("users", { name: "John", age: 25 });
+
+// Multiple inserts
+await sql.insertInto("users", [
+  { name: "Alice", age: 22 },
+  { name: "Bob", age: 30 }
+]);
+
+// Single update
+await sql.update("id", "users", { age: 26 }, 1);
+
+// Multiple updates
+await sql.update("id", "users", [{ age: 22 }, { age: 28 }], [1, 2]);
+
+## DELETE
+
+// Single delete
+await sql.delete("users", "id", 1);
+
+// Multiple delete
+await sql.delete("users", "id", [2, 3]);
+
+## Joining Table
+
+// LEFT JOIN example
+const result = await sql.selectLeftAndRightJoin(
+  "users",
+  "orders",
+  "users.name, orders.total",
+  "users.id = orders.user_id",
+  "users.id",
+  "LEFT JOIN",
+  1
+);
+
+// INNER JOIN
+const result = await sql.selectInnerJoin(
+  "users",
+  "orders",
+  "users.name, orders.total",
+  "users.id = orders.user_id"
+);
+
+## BONUS
+
+import { getDadJokes } from "ags-sql-lib";
+
+const joke = await getDadJokes();
+console.log(joke);

package/database/dbConnection.js

@@ -0,0 +1,14 @@
+import mysql from "mysql2";
+
+export const db = (user, password, host, database) => {
+  const dbConnection = mysql
+    .createPool({
+      user: user,
+      password: password,
+      host:  host,
+      database: database
+    })
+    .promise();
+
+  return dbConnection;
+};

package/index.js

@@ -0,0 +1,158 @@
+import { exec } from "child_process";
+import { db } from "./database/dbConnection.js";
+
+class AGS {
+
+  #sqlOperation;
+
+  constructor(aUser, aPassword, aHost, aDatabase) {
+    this.#sqlOperation = db(aUser, aPassword, aHost, aDatabase);
+  }
+
+  async select(columnName, tableName) {
+    try {
+      if(Array.isArray(tableName)){
+        let result = [];
+        for(let i in tableName){
+          const sql = `SELECT * FROM ${tableName[i]}`;
+          const [selectResult] = await this.#sqlOperation.query(sql);
+          result.push(selectResult);
+        }
+        return result;
+      }
+
+      const sql = `SELECT ${columnName || "*"} FROM ${tableName}`;
+      const [result] = await this.#sqlOperation.query(sql);
+      return result;
+    } catch (error) {
+      console.log(error);
+    }
+  }
+
+  async selectWithId(yourIdName, columnName, tableName, idValue) {
+    
+    try {
+      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)
+          result.push(selectResult[0]);
+        }
+        return result;
+      }
+
+      const sql = `SELECT ${columnName || "*"} FROM ${tableName} WHERE ${
+      yourIdName || "Id"
+    } = ${idValue}`;
+      const [selectResult] = await this.#sqlOperation.query(sql)
+      return selectResult[0];
+
+    } catch (error) {
+      console.log(error);
+    }
+  }
+
+  async insertInto(tableName, objectValue) {
+    try {
+     if(Array.isArray(objectValue)){
+      let result = [];
+      for(let i in objectValue){
+        const sql = `INSERT INTO ${tableName} SET ?`;
+        const [insertResult] = await this.#sqlOperation.query(sql, [objectValue[i]]);
+        result.push(insertResult);
+      }
+      return result;
+     }
+    const sql = `INSERT INTO ${tableName} SET ?`;
+    const [insertResult] = await this.#sqlOperation.query(sql, [objectValue]);
+    return insertResult;
+    } catch (error) {
+      console.log(error);
+    }
+  }
+
+  async update(yourIdName, tableName, objectValue, idValue) {
+   
+    try {
+      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]]);
+          result.push(updateResult);
+        }
+        return result;
+      }
+      const sql = `UPDATE ${tableName} SET ? WHERE ${yourIdName} = ${idValue}`;
+      const [updateResult] = await this.#sqlOperation.query(sql, [objectValue]);
+      return updateResult;
+    } catch (error) {
+      console.log(error);
+    }
+  }
+
+  async delete(tableName, yourIdName, idValue) {
+    try {
+      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);
+          result.push(deleteResult);
+        }
+        return result;
+      }
+      const sql = `DELETE FROM ${tableName} WHERE ${yourIdName || "Id"} = ${idValue}`;
+      const [deleteResult] = await this.#sqlOperation.query(sql);
+      return deleteResult;
+    } catch (error) {
+      console.log(error);
+    }
+  }
+
+  async selectLeftAndRightJoin(tbl_a, tbl_b, columnName, onCondition, yourIdName, joinType, idValue) {
+    try {
+      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);
+          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);
+      return selectResult;
+    } catch (error) {
+      console.log(error);
+    }
+  }
+
+  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);
+    return result;
+   } catch (error) {
+    console.log(error);
+   }
+  }
+}
+
+export const getDadJokes = async () => {
+  return new Promise((resolve, reject) => {
+    try {
+      exec("curl https://icanhazdadjoke.com", (error, stdout, stderr) => {
+        return resolve(stdout);
+      });
+    } catch (error) {
+      return reject(error);
+    }
+  });
+};
+
+export default AGS;

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "ags-sql-gen",
+  "version": "1.0.2",
+  "description": "preset query",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Adrian294-AGS/AGS-SQL-Template.git"
+  },
+  "keywords": [
+    "SQL"
+  ],
+  "author": "Santiago, Adrian",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/Adrian294-AGS/AGS-SQL-Template/issues"
+  },
+  "homepage": "https://github.com/Adrian294-AGS/AGS-SQL-Template#readme",
+  "dependencies": {
+    "child_process": "^1.0.2"
+  },
+  "devDependencies": {
+    "mysql2": "^3.15.2"
+  }
+}