@areumtecnologia/mysql-db-handler 1.0.3 → 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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@areumtecnologia/mysql-db-handler",
-  "version": "1.0.3",
+  "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": {