@areumtecnologia/mysql-db-handler 1.0.2 → 1.0.4

package/README.md

@@ -66,6 +66,27 @@ const activeCustomers = await customers.selectBy({ status: 1 });
 
 ## Advanced Usage & Examples
 
+### Inserting Records (`insert`)
+
+The `insert` method adds a new row to the table.
+
+**Parameters:**
+*   `params` (Object): An object where keys match the column names and values are the data to insert.
+
+**Example:**
+
+```javascript
+const logs = new DataBaseHandler(db, 'app_logs');
+
+const result = await logs.insert({
+    level: 'info',
+    message: 'User logged in',
+    timestamp: new Date()
+});
+// Executes: INSERT INTO app_logs SET `level` = ?, `message` = ?, `timestamp` = ?
+console.log(`Inserted Row ID: ${result.insertId}`);
+```
+
 ### Flexible Selection (`select`)
 
 The `select` method allows you to build complex queries using an array of parameters and a clauses object.
@@ -74,7 +95,7 @@ The `select` method allows you to build complex queries using an array of parame
 *   `params` (Array): An array where each element is either a condition object or a logical string ('AND', 'OR').
     *   Simple condition: `{ column: value }` (defaults to `=`)
     *   Condition with operator: `{ column: value, operator: '>' }`
-*   `clauses` (Object): Optional keys like `ORDER BY`, `LIMIT`, `OFFSET`, `GROUP BY`, `HAVING`.
+*   `clauses` (Object): Optional keys like `ORDERBY`, `DESC`, `LIMIT`, `OFFSET`, `GROUP BY`, `HAVING`.
 
 **Example:**
 
@@ -90,7 +111,8 @@ const results = await products.select(
     ],
     // 2. Clauses: SQL Modifiers
     {
-        'ORDER BY': 'price DESC',
+        'ORDERBY': 'price',
+        'DESC': true,
         'LIMIT': 10,
         'OFFSET': 0
     }

package/lib/databaseHandler.js

@@ -199,10 +199,11 @@ class DatabaseHandler {
         const groupByClause = clauses['GROUPBY'] ? ` GROUP BY ${clauses['GROUPBY']}` : '';
         const havingClause = clauses['HAVING'] ? ` HAVING ${clauses['HAVING']}` : '';
         const orderClause = clauses['ORDERBY'] ? ` ORDER BY ${clauses['ORDERBY']}` : '';
+        const descClause = clauses['DESC'] ? ` DESC ` : '';
         const limitClause = clauses['LIMIT'] ? ` LIMIT ${clauses['LIMIT']}` : '';
         const offsetClause = clauses['OFFSET'] ? ` OFFSET ${clauses['OFFSET']}` : '';
 
-        const sql = `SELECT *${this.expression ?? ''} FROM ${this.table}${whereClause}${groupByClause}${havingClause}${orderClause}${limitClause}${offsetClause}`;
+        const sql = `SELECT *${this.expression ?? ''} FROM ${this.table}${whereClause}${groupByClause}${havingClause}${orderClause}${descClause}${limitClause}${offsetClause}`;
 
         const rows = await this.executeQuery(sql, values);
         return rows;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@areumtecnologia/mysql-db-handler",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "A powerful MySQL wrapper with connection pooling, singleton support, and advanced query handling for Node.js.",
   "main": "index.js",
   "scripts": {