Simple-DB

Banco de dados TXT leve para Node.js
Simples. Rápido. Sem dependências.

Site oficial: https://simpledb.xyz/

📦 Instalação

Via npm:

npm install simple-txt-db

🚀 Começando Rápido

const { SimpleDB } = require("simple-txt-db")

const db = new SimpleDB({
  SimplePATH: "./database/users.txt"
})

db.set("Mensagem", "Olá")
db.push("users", "user1")
db.add("totalde_Users", 1)

console.log(db.get("users"))

📄 Formato do Banco

Seu arquivo .txt ficará assim:

Mensagem="Olá"
totalde_Users=2
users=["user1","user2"]

Formato simples baseado em chave=valor com suporte a JSON.

🧠 Recursos

• ✅ Armazenamento chave-valor
• ✅ Suporte a arrays
• ✅ Suporte a números, strings e objetos
• ✅ Criação automática do arquivo
• ✅ Sistema de escrita segura (anti-corrupção)
• ✅ Extremamente leve
• ❌ Sem dependências externas

📚 Métodos Disponíveis

set(chave, valor)

Define um valor.

db.set("nome", "Inbiza")

get(chave)

Obtém um valor.

db.get("nome")

has(chave)

Verifica se a chave existe.

db.has("nome")

delete(chave)

Remove uma chave.

db.delete("nome")

clear()

Limpa todo o banco.

db.clear()

push(chave, valor)

Adiciona um valor em um array.

db.push("users", { userid: 1 })

Resultado no arquivo:

users=[{ "userid": 1 }]

pull(chave, callback)

Remove itens de um array com base em uma condição.

db.pull("users", user => user === "user1")

add(chave, número)

Incrementa um valor numérico.

db.add("totalde_Users", 1)

array(chave, valor)

Adiciona um valor em um array.

db.push("users", "user1")

Resultado no arquivo:

users=["user1"]

🔐 Sistema de Escrita Segura

O Simple-DB grava primeiro em um arquivo temporário antes de substituir o original, reduzindo o risco de corrupção de dados.

🏗️ Quando usar o Simple-DB?

Ideal para:

• 🤖 Bots de Discord
• 🌐 APIs pequenas
• 📚 Projetos de estudo
• 🧪 Protótipos rápidos
• 🚀 Sistemas simples que não precisam de banco pesado

⚠️ Limitações

O Simple-DB é recomendado para aplicações pequenas e médias.
Para sistemas de grande escala, considere usar MongoDB, PostgreSQL ou outro banco robusto.

🛣️ Roadmap

• [ ] Versão totalmente assíncrona
• [ ] Suporte a chaves aninhadas (ex: users.0.nome)
• [ ] Suporte a múltiplos bancos
• [ ] Watch mode (atualização automática)
• [ ] Suporte oficial a TypeScript

📄 Licença

MIT License

👑 Autor

Criado por inbiza
https://simpledb.xyz/