MagoDb

Uma database JSON simples, leve e fácil de usar para Node.js. Ideal para projetos pequenos e médios que precisam salvar dados localmente sem complicação.

🚀 Instalação

npm install magodb

✨ Uso Completo com Explicações

import { JsonDatabase } from "magodb";

// maxDataSize: limite opcional de registros, null = ilimitado
const db = new JsonDatabase({ databasePath: "databases/db.json", maxDataSize: null });

db.set("user1", { name: "Manofw", points: 100 });
// Cria a chave "user1" com o objeto { name, points }
// Se "user1" já existir, sobrescreve os dados

db.add("user1.points", 50);     
// Soma 50 ao valor existente em user1.points
db.substr("user1.points", 20);  
// Subtrai 20 do valor existente

console.log(db.get("user1"));
// Retorna { name: 'Manofw', points: 130 }

console.log(db.get("user1.points", 0));
// Retorna o valor numérico
// Se a chave não existir, retorna 0 (defaultValue)

db.push("players", "player1");
db.push("players", "player2");
// Cria/atualiza a chave "players" como array
// Adiciona valores no final do array

console.log(db.get("players")); 
// Saída: ["player1", "player2"]

console.log(db.type("user1.points")); // "number"
console.log(db.type("players"));      // "array"


db.delete("user1");  // Deleta a chave "user1"
db.deleteAll();      // Deleta todos os registros do banco


console.log(db.all());     
// Retorna array de objetos { ID, data }
// Ex: [{ ID: "players", data: ["player1", "player2"] }]


console.log(db.info); 
// Retorna objeto { size: 0, version: '1.0.0' }


db.destroy(); // Apaga o arquivo JSON completamente

📄 Contribuição

• Contribuições são bem-vindas!

1. Fork este repositório
2. Crie uma branch (git checkout -b feature/nova-funcionalidade)
3. Faça commits (git commit -m 'Adiciona nova funcionalidade')
4. Push para a branch (git push origin feature/nova-funcionalidade)

Abra um Pull Request

⭐ Dica

Se você gosta do MagoDb, deixe uma ⭐ no NPM ou GitHub para apoiar o projeto!