mongodb-queryrunner
v1.0.3
Published
MongoManager is a versatile Node.js library for MongoDB database operations, offering simplified querying and efficient data manipulation. With intuitive methods and seamless integration, MongoManager streamlines database interactions, allowing developers
Downloads
8
Maintainers
Readme
MongoDB Manager
MongoDB Manager is a lightweight JavaScript library designed to simplify interactions with MongoDB databases. It provides a high-level abstraction for common database operations, making it easier for developers to work with MongoDB in their Node.js applications.
Features
- Simplified API: Abstracts away the complexity of MongoDB operations, providing a straightforward interface for database interactions.
- Error Handling: Robust error handling mechanisms ensure that errors are caught and handled gracefully, providing informative error messages for debugging.
- Lazy Connection: Establishes connections to the MongoDB server only when required, optimizing resource usage.
- Parameter Validation: Validates input parameters to ensure data integrity and prevent common errors.
- Consistent Result Formatting: Ensures that query results are always returned as arrays, simplifying downstream data processing.
Installation
Install MongoDB Manager via npm:
npm install mongodb-queryrunner
Usage
const MongoManager = require('mongodb-queryrunner');
(async function () {
const mongoManager = new MongoManager(process.env.DB_URL, process.env.DB_NAME);
try {
// Initialize MongoDB Manager with MongoDB URL and database name
// Build query parameters
let params = mongoManager.queryParamsBuilder("app_user_data", "find", { id: "1234" });
// Execute the query
let data = await mongoManager.queryRunner(params);
// Output the result
console.log('Data:', data);
} catch (error) {
console.error(error.message);
} finally {
// Close the MongoDB connection
await mongoManager.db_close();
}
})();
Aggregation Example
const MongoManager = require('mongodb-queryrunner');
(async function () {
try {
// Initialize MongoDB Manager with MongoDB URL and database name
const mongoManager = new MongoManager(process.env.DB_URL, process.env.DB_NAME);
// Build query parameters for aggregation
let params = mongoManager.queryParamsBuilder("app_user_data", "aggregate", [{$match:{ id: "1234" }}]); // insertmany or aggregation must be an array....
// Execute the aggregation query
let data = await mongoManager.queryRunner(params);
// Output the result
console.log('Aggregation Result:', data);
} catch (error) {
console.error(error.message);
} finally {
// Close the MongoDB connection
await mongoManager.db_close();
}
})();