🚀 HighEasyDB

HighEasyDB é uma biblioteca SQLite para Node.js feita para ser
simples para iniciantes e organizada o suficiente para projetos profissionais.

Ela abstrai o SQL básico e oferece comandos fáceis, com mensagens bonitas no terminal ✨

📌 Por que usar o HighEasyDB?

• ✅ Não precisa saber SQL avançado
• 🎨 Feedback visual com cores e emojis
• 🧠 API simples e intuitiva
• ⚡ Leve e rápida (SQLite local)
• 👶 Ideal para iniciantes
• 👨‍💻 Útil também em projetos reais (bots, APIs, CLIs)

📦 Instalação

npm install higheasydb

🛠️ Requisitos

Node.js v16 ou superior Sistema compatível com SQLite (Windows, Linux, macOS)

🚀 Primeiro uso (passo a passo)

1️⃣ Importar a biblioteca

const db = new HighEasyDB("meubanco.db");

2️⃣ Criar ou abrir um banco de dados

const db = new HighEasyDB("meubanco.db");

Se o arquivo não existir, ele será criado automaticamente 📦

3️⃣ Criar uma tabela (feito uma vez)

O HighEasyDB não cria tabelas automaticamente. Você cria a tabela uma vez e depois só usa os métodos.

db.db.prepare(`
  CREATE TABLE IF NOT EXISTS users (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT,
    age INTEGER
  )
`).run();

✨ Operações básicas

➕ Adicionar dados (add)

db.add("users", {
  name: "Pedro",
  age: 20
});

📌 Insere um novo registro na tabela.

📊 Listar todos os registros (all)

const users = db.all("users");
console.log(users);

📌 Retorna um array com todos os dados da tabela.

🔍 Buscar um único registro (get)

const user = db.get("users", { id: 1 });
console.log(user);

📌 Retorna apenas um registro (ou undefined se não existir).

🗑️ Remover registros (delete)

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

📌 Remove registros que correspondem ao filtro.

📋 Ver colunas da tabela (varlist)

db.varlist("users");

📌 Útil para entender a estrutura da tabela.

🗂️ Ver todas as tabelas do banco (tables)

db.tables();

📌 Lista todas as tabelas existentes no banco.

👋 Fechar o banco (close)

db.close();

📌 Sempre feche o banco ao finalizar o programa.

📘 Exemplo completo

const HighEasyDB = require("higheasydb");

const db = new HighEasyDB("app.db");

// Criar tabela
db.db.prepare(`
  CREATE TABLE IF NOT EXISTS users (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT,
    age INTEGER
  )
`).run();

// Inserir dados
db.add("users", { name: "Ana", age: 22 });
db.add("users", { name: "João", age: 30 });

// Listar
console.log(db.all("users"));

// Buscar um
console.log(db.get("users", { name: "Ana" }));

// Ver estrutura
db.varlist("users");

// Fechar banco
db.close();

🧠 Boas práticas

✔️ Use close() ao final do programa ✔️ Use get() quando espera apenas um resultado ❌ Não use o banco aberto em vários processos ao mesmo tempo

🎯Quando usar HighEasyDB?

Ideal para:

Bots do Discord 🤖 \n Aplicações locais \n Scripts Node.js \n CLIs \n Projetos pequenos e médios \n Aprender banco de dados com SQLite \n

📜 Licença

MIT © justlopes

Você é livre para usar, modificar e distribuir 🚀