{"id":18267,"library":"dblibrary","title":"dblibrary","description":"Internal library providing Mongoose setup, database models, and connection management for Node.js applications. Current version 1.338.0, updated frequently. Provides pre-configured schemas and utilities for MongoDB interactions. Not published on npm (likely internal Bitbucket package). Lacks documentation beyond generic README. Alternatives: Mongoose directly, Typegoose.","status":"active","version":"1.338.0","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","typescript"],"install":[{"cmd":"npm install dblibrary","lang":"bash","label":"npm"},{"cmd":"yarn add dblibrary","lang":"bash","label":"yarn"},{"cmd":"pnpm add dblibrary","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Core dependency for MongoDB ODM functionality","package":"mongoose","optional":false}],"imports":[{"note":"ESM only; package does not support CommonJS require.","wrong":"const connectDB = require('dblibrary').connectDB","symbol":"connectDB","correct":"import { connectDB } from 'dblibrary'"},{"note":"Named export, not default export.","wrong":"import User from 'dblibrary'","symbol":"User","correct":"import { User } from 'dblibrary'"},{"note":"Exports Mongoose instance, not the mongoose package.","wrong":"import mongoose from 'mongoose'","symbol":"Mongoose","correct":"import { Mongoose } from 'dblibrary'"},{"note":"Use type import for non-runtime interfaces.","wrong":"import { UserDocument } from 'dblibrary'","symbol":"types","correct":"import type { UserDocument } from 'dblibrary'"}],"quickstart":{"code":"import { connectDB, User } from 'dblibrary';\n\nasync function main() {\n  await connectDB('mongodb://localhost:27017/test');\n  const user = await User.create({ name: 'Alice' });\n  console.log(user);\n}\nmain();","lang":"typescript","description":"Connects to MongoDB and creates a user record using dblibrary models."},"warnings":[{"fix":"Pass connection string as first argument. For options, set environment variables or call mongoose.connect directly.","message":"connectDB does not accept options object; only connection string.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Call .lean() explicitly if you want plain JavaScript objects.","message":"Model.find() returns raw documents, not lean by default.","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Update imports: 'UserModel' → 'User'.","message":"Version 1.338.0 changed export names: 'User' was previously 'UserModel'.","severity":"breaking","affected_versions":">=1.338.0"},{"fix":"Use ESM imports (import syntax). Do not use require().","message":"The package does not support ESM/CJS dual packaging; only ESM.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Add 'dblibrary' to package.json from internal registry: npm install dblibrary@1.338.0 --registry=https://internal-registry.example.com","cause":"Package not installed or registry not configured.","error":"Cannot find module 'dblibrary'"},{"fix":"Change to ESM imports: import { connectDB } from 'dblibrary'","cause":"Using CommonJS require() on an ESM-only package.","error":"ERR_REQUIRE_ESM: require() of ES Module"},{"fix":"Use named import: import { connectDB } from 'dblibrary'","cause":"Importing connectDB incorrectly (e.g., as default export).","error":"TypeError: connectDB is not a function"},{"fix":"Call connectDB with a valid MongoDB connection string: connectDB('mongodb://...')","cause":"connectDB called without arguments or with non-string.","error":"MongooseError: The `uri` parameter to `openUri()` must be a string"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}