@wxn0brp/db

ValtheraDB (@wxn0brp/db)

A lightweight file-based database management system that supports CRUD operations, custom queries, and graph structures.

Installation

To install the package, run:

npm install @wxn0brp/db

Usage

You can import the necessary classes from the package as follows:

import { Valthera, Graph, ValtheraRemote, GraphRemote, Relation, genId, ValtheraMemory, ValtheraAutoCreate } from "@wxn0brp/db";

Examples

import { Valthera } from '@wxn0brp/db';

// Create a new Valthera database instance
const db = new Valthera('./database');

// Add a new document to the database
const result = await db.add('users', { name: 'John Doe', age: 30 });
console.log(result); // { _id: 'xxx', name: 'John Doe', age: 30 }

// Find all documents in the collection
const results = await db.find('users', {});
console.log(results); // [{ _id: 'xxx', name: 'John Doe', age: 30 }]

// Find a single document in the collection.
const user = await db.findOne('users', { $gt: { age: 25 } });
console.log(user); // { _id: 'xxx', name: 'John Doe', age: 30 }

// Update a document in the collection
const updateResult = await db.updateOne('users', { name: 'John Doe' }, { age: 31 });
console.log(updateResult); // true

// Remove a document from the collection
const removeResult = await db.removeOne('users', { name: 'John Doe' });
console.log(removeResult); // true

Documentation

Website: https://wxn0brp.github.io/ValtheraDB/

For detailed information, refer to the following resources:

• Valthera Documentation
• Graph Documentation
• Remote Valthera and Graph Client Documentation
• Search Options Documentation
• Find Options Documentation
• Updater Options Documentation
• Relation Documentation

License

This project is released under the MIT License.

Contributing

Contributions are welcome! Please submit a pull request or open an issue on our GitHub repository.

Changelog

0.7.6 (2025-05-19)

Bug Fixes

• types (1deb8d3)