{"id":42444,"library":"bass-mongodb","title":"bass-mongodb","description":"MongoDB adapter for Bass.js ODM, version 1.0.10. Provides MongoDB-specific query building and document mapping for Bass.js, an ODM framework. Release cadence is low (single release). Differentiators: tightly coupled with Bass.js, offers MongoDB integration without adding complexity. Stable but limited in features compared to Mongoose. Not actively maintained.","status":"maintenance","version":"1.0.10","language":"javascript","source_language":"en","source_url":"git://github.com/congajs/bass-mongodb","tags":["javascript","orm","odm","mongodb"],"install":[{"cmd":"npm install bass-mongodb","lang":"bash","label":"npm"},{"cmd":"yarn add bass-mongodb","lang":"bash","label":"yarn"},{"cmd":"pnpm add bass-mongodb","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency: Bass.js ODM core required as the base ODM framework.","package":"bass","optional":false}],"imports":[{"note":"ESM default import (CJS require needs .default). TypeScript: no built-in types; may need @types/bass-mongodb or declare module.","wrong":"const BassMongo = require('bass-mongodb').default","symbol":"default","correct":"import BassMongo from 'bass-mongodb'"},{"note":"Named export also available. Check package exports for exact symbol.","wrong":"import MongoAdapter from 'bass-mongodb'","symbol":"MongoAdapter","correct":"import { MongoAdapter } from 'bass-mongodb'"},{"note":"If exporting schema helpers; verify actual exports.","wrong":"import BassSchema from 'bass-mongodb'","symbol":"BassSchema","correct":"import { BassSchema } from 'bass-mongodb'"}],"quickstart":{"code":"import Bass from 'bass';\nimport MongoAdapter from 'bass-mongodb';\n\nconst adapter = new MongoAdapter({\n  uri: process.env.MONGO_URI ?? 'mongodb://localhost:27017/test',\n  options: { useNewUrlParser: true }\n});\n\nconst bass = new Bass(adapter);\n\nconst User = bass.model('User', {\n  name: String,\n  email: { type: String, required: true }\n});\n\nasync function run() {\n  await bass.connect();\n  const user = await User.create({ name: 'Alice', email: 'alice@example.com' });\n  console.log(user);\n  await bass.disconnect();\n}\n\nrun().catch(console.error);","lang":"javascript","description":"Shows how to initialize bass-mongodb adapter, connect, define a model, and create a document."},"warnings":[{"fix":"Ensure Bass.js dependency is ^1.0.0.","message":"Requires Bass.js version ^1.0.0; incompatible with older versions.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Always provide options object with appropriate MongoDB driver options.","message":"MongoDB connection options (e.g., useNewUrlParser) must be passed explicitly; no defaults.","severity":"gotcha","affected_versions":"*"},{"fix":"Consider using Mongoose or other actively maintained ODM if issues arise.","message":"Package has low maintenance; no updates since initial release.","severity":"deprecated","affected_versions":">=1.0.0"}],"env_vars":null,"search_vec":"'1.0.10':10 'activ':51 'ad':40 'adapt':5 'bass':2 'bass-mongodb':1 'bass.js':7,21,35 'build':16 'cadenc':26 'compar':47 'complex':41 'coupl':33 'differenti':31 'document':18 'featur':46 'framework':24 'integr':38 'javascript':53 'limit':44 'low':28 'maintain':52 'map':19 'mongodb':3,4,13,37,56 'mongodb-specif':12 'mongoos':49 'odm':8,23,55 'offer':36 'orm':54 'provid':11 'queri':15 'releas':25,30 'singl':29 'specif':14 'stabl':42 'tight':32 'version':9 'without':39","created_at":"2026-06-05T16:55:00.743512+00:00","updated_at":"2026-06-05T16:55:00.743512+00:00","problems":[{"fix":"npm install bass","cause":"Missing peer dependency 'bass'.","error":"Error: Cannot find module 'bass'"},{"fix":"Check MONGO_URI environment variable or connection string. Ensure MongoDB is running.","cause":"MongoDB URI invalid or server not running.","error":"MongoError: failed to connect to server on first connect"},{"fix":"Use correct import: import MongoAdapter from 'bass-mongodb' (default) or import { MongoAdapter } from 'bass-mongodb' (named).","cause":"Incorrect import: using default import when expecting named, or vice versa.","error":"TypeError: adapter is not a constructor"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/congajs/bass-mongodb#readme","github":"git://github.com/congajs/bass-mongodb","docs":null,"changelog":null,"pypi":null,"npm":"bass-mongodb","openapi_spec":null,"status_page":null,"smithery":null,"categories":["database"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-05","next_check":"2026-09-03","install_tag":null}}