mongodb-ops

library0.11.0jsnpmunverified

MongoDB Ops is a lightweight Node.js library (v0.11.0, updated irregularly) that provides a simple static-level MongoDB client wrapper for CRUD operations. It automatically manages connection reuse and exposes methods like getData, writeData, and writeBulkData. Unlike the official MongoDB driver, it offers a higher-level API with built-in connection pooling, but lacks advanced features like transactions or change streams. Key differentiators include its minimal setup and direct static methods that require only collection name and connection string.

database

npm install mongodb-ops

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · MONGODB-OPS

mongodb-ops

databasejavascriptv0.11.0

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.

MongoDBOps

✓ const { MongoDBOps } = require('mongodb-ops');

✗ import { MongoDBOps } from 'mongodb-ops';

Package does not support ESM imports. Only CommonJS require is supported.

MongoDBToolSet

✓ const { MongoDBToolSet } = require('mongodb-ops');

✗ import MongoDBToolSet from 'mongodb-ops';

MongoDBToolSet is a named export, not default. Use destructured require.

MongoDBOps writeData

✓ MongoDBOps.writeData('insertOne', 'collection', doc, filter, connString);

Static method. Required parameters: operation, collectionName, doc, filter (optional), connString.

Shows how to create a subclass of MongoDBOps with static methods for querying a MongoDB collection using a connection string.

const { MongoDBOps } = require('mongodb-ops'); const connString = 'mongodb+srv://user:pass@cluster.mongodb.net/mydb?retryWrites=true&w=majority'; class CustomOps extends MongoDBOps { constructor() { super(connString); } static async getUser(id) { return MongoDBOps.getData('users', { _id: id }, false, { name: 1, email: 1 }, undefined, undefined, undefined, connString); } } CustomOps.getUser('123').then(console.log).catch(console.error);

Debug

Known issues

breakingThe MongoDBOps class should be instantiated only once or used statically. Multiple instances will create duplicate connections.

fix

Use static methods as shown in documentation; avoid constructing multiple MongoDBOps objects.

affects: >=0.0.0

deprecatedThe writeData method argument order changed? Not documented. Check source for current parameter order.

fix

Refer to source code or test files for exact parameter signature.

affects: >=0.1.0

gotchaConnection string must be passed explicitly to every static method if not stored in the class instance.

fix

Store connection string in a constant or pass it each time.

affects: >=0.0.0

gotchawriteData does not perform schema validation; malformed documents may cause runtime errors.

fix

Validate documents before inserting or updating.

affects: >=0.0.0

Errors

Common errors & fixes

Cannot find module 'mongodb-ops'

Package not installed or incorrect path.

fix

Run: npm install mongodb-ops

TypeError: MongoDBOps is not a constructor

Importing as default when it's a named export.

fix

Use: const { MongoDBOps } = require('mongodb-ops');

MongoServerError: E11000 duplicate key error collection

Inserting a document with an existing _id or unique index.

fix

Check for duplicates or use update with upsert.

Upgrade

Version history

0.11.0latest on npm

Audit

Dependencies

mongodbrequiredCore dependency for MongoDB driver functionality

Agent activity

11 hits · last 30 days

node

Amazon

Resources

githubhttps://github.com/CompAndSave/mongodb-ops ↗

packagemongodb-ops ↗

homepagehttps://github.com/CompAndSave/mongodb-ops#readme ↗