{"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,"search_vec":"'1.338.0':17 'altern':43 'applic':14 'beyond':40 'bitbucket':36 'configur':23 'connect':10 'current':15 'databas':7 'dblibrari':1 'direct':45 'document':39 'frequent':19 'generic':41 'interact':29 'intern':2,35 'javascript':47 'lack':38 'librari':3 'like':34 'manag':11 'model':8 'mongodb':28 'mongoos':5,44 'node.js':13 'npm':33 'packag':37 'pre':22 'pre-configur':21 'provid':4,20 'publish':31 'readm':42 'schema':24 'setup':6 'typegoos':46 'typescript':48 'updat':18 'util':26 'version':16","created_at":"2026-04-25T07:37:20.245439+00:00","updated_at":"2026-04-25T07:37:20.245439+00:00","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,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"","cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":null,"npm":"https://www.npmjs.com/package/dblibrary","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-17","next_check":"2026-07-24","install_tag":null}}