afridho-mongodb

library1.7.71jsnpmunverified

A lightweight MongoDB client wrapper for Node.js that simplifies CRUD operations with a class-based ClientDB interface. Version 1.7.71 provides methods like insert, read, update, delete, find, and storage stats. It uses environment variables for connection and requires dotenv. Differentiators include a minimal API surface, built-in connection management, and no dependency on Mongoose. Release cadence is irregular.

database

npm install afridho-mongodb

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · AFRIDHO-MONGODB

afridho-mongodb

databasejavascriptv1.7.71

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ClientDB

✓ const ClientDB = require('afridho-mongodb')

✗ import ClientDB from 'afridho-mongodb'

Package uses CommonJS; ESM import will fail. Use require.

ClientDB

✓ import ClientDB from 'afridho-mongodb'

✗ const { ClientDB } = require('afridho-mongodb')

Default export is the constructor; named import will be undefined.

ClientDB

✓ import ClientDB from 'afridho-mongodb'

✗ const ClientDB = require('afridho-mongodb').default

No .default; it is the module.exports directly.

Create a ClientDB instance, insert a document, read all documents, then close the connection.

const ClientDB = require('afridho-mongodb'); async function main() { const users = new ClientDB('users'); await users.insert({ name: 'Alice', email: 'alice@example.com' }); const all = await users.readAll(); console.log(all); await users.close(); } main().catch(console.error);

Debug

Known issues

gotchaPackage does not support ESM imports via import statement; use CommonJS require.

fix

Use require('afridho-mongodb') instead of import.

affects: >=1.0

gotchaMust set MONGODB_URI and DB_NAME environment variables; otherwise connection fails.

fix

Create .env file with MONGODB_URI and DB_NAME, or set process.env variables before using ClientDB.

affects: >=1.0

gotchaClientDB constructor expects a collection name; omit leading slash or special characters.

fix

Pass a simple string like 'users', not 'db.users' or '/users'.

affects: >=1.0

gotchaThe update method performs a direct replacement, not partial update. Use $set operator within data parameter for partial updates.

fix

Pass data as { $set: { age: 30 } } instead of { age: 30 }.

affects: >=1.0

Errors

Common errors & fixes

TypeError: ClientDB is not a constructor

Using ESM import syntax or destructuring the require.

fix

Use const ClientDB = require('afridho-mongodb');

MongoClient must be connected before performing operations

ClientDB instance not connected; maybe missing environment variables.

fix

Ensure .env file exists with MONGODB_URI and DB_NAME.

Upgrade

Version history

1.7.71latest on npm

Audit

Dependencies

mongodbrequiredMongoDB driver for database operations

dotenvoptionalLoad environment variables

Agent activity

26 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/afridho/mongodb ↗

packageafridho-mongodb ↗

homepagehttps://github.com/afridho/mongodb#readme ↗