🗄️ ANDRES-DB

ANDRES-DB es una interfaz simple, moderna y poderosa para trabajar con SQLite en Node.js usando better-sqlite3.

Diseñada para ofrecer respuestas JSON limpias, creación automática de tablas, operaciones CRUD intuitivas y utilidades avanzadas sin escribir SQL complejo.

✨ Características

• 📦 SQLite rápido con better-sqlite3
• ⚡ CRUD completo
• 🧠 Creación automática de tablas
• 🧩 Columnas dinámicas
• 🔎 Búsquedas avanzadas
• 🔁 Transacciones seguras
• 📤 Exportar / importar JSON
• 💾 Backups automáticos
• 📊 Estadísticas del sistema
• 🧾 Respuestas JSON estándar
• 🛠️ Consultas SQL personalizadas

📦 Instalación

npm install andres-db

Requiere Node.js v16+

🚀 Uso rápido

const db = require('andres-db');

db.create('users', {
  name: 'Juan',
  email: '[email protected]',
  age: 25
});

const users = db.read('users');
console.log(users.data);

⚙️ Configuración

const db = require('andres-db').createInstance({
  filename: './db/app.db',
  verbose: true,
  jsonResponse: true
});

🧱 Crear registros

db.create('products', {
  name: 'Laptop',
  price: 1200,
  stock: 10
});

Múltiples registros

db.create('users', [
  { name: 'Ana', age: 22 },
  { name: 'Luis', age: 30 }
]);

📖 Leer datos

db.read('users', { age: { $gte: 18 } });

db.readOne('users', { id: 1 });

✏️ Actualizar

db.update('users', { id: 1 }, { age: 26 });

❌ Eliminar

db.delete('users', { id: 1 });

🔎 Buscar texto

db.search('users', ['name', 'email'], 'juan');

🧩 Agregar columnas

db.addColumn('users', 'phone', 'TEXT');

db.addColumns('users', [
  { name: 'city', type: 'TEXT' },
  { name: 'active', type: 'INTEGER', defaultValue: 1 }
]);

🔁 Transacciones

db.transaction((db) => {
  db.create('accounts', { name: 'Cuenta A' });
  db.create('accounts', { name: 'Cuenta B' });
});

🧪 SQL personalizado

db.query('SELECT * FROM users WHERE age > ?', [20]);

📤 Exportar / 📥 Importar

db.exportToJSON();

db.importFromJSON({ users: [{ name: 'Carlos', age: 28 }] });

💾 Backup

db.backup('./backup/db_backup.db');

📊 Estadísticas

db.getStats();

🧑‍💻 Autor

ANDRES CARVAJAL

🌐 https://andres-carvajal.vercel.app
📸 Instagram: @05_carvajal

📄 Licencia

Este proyecto está bajo la licencia MIT.