@storehouse/mongodb 2.4.1 → 3.0.0

package/README.md

@@ -1,122 +1,428 @@
 # @storehouse/mongodb
-MongoDB driver manager for @storehouse/core.
 
-[Documentation](https://kisiwu.github.io/storehouse/mongodb/latest/).
+MongoDB driver manager adapter for [@storehouse/core](https://www.npmjs.com/package/@storehouse/core). Provides seamless integration with [MongoDB](https://www.mongodb.com/) using the official [Node.js driver](https://www.npmjs.com/package/mongodb).
 
+## Features
 
-## Installation
+- **Type-safe MongoDB operations** with TypeScript support
+- **Connection lifecycle management** with automatic event logging
+- **Health check utilities** for monitoring (works without admin privileges)
+- **Multi-manager support** via Storehouse registry
+- **Cross-database access** using dot notation
+
+## Prerequisites
 
-Make sure you have [@storehouse/core](https://www.npmjs.com/package/@storehouse/core) and [mongodb](https://www.npmjs.com/package/mongodb) installed.
+- **MongoDB server**
+- **Node.js** 18 or higher
+
+## Installation
 
 ```bash
-npm install @storehouse/mongodb
+npm install @storehouse/core mongodb @storehouse/mongodb
 ```
 
-## Usage
+## Quick Start
 
-### Basic
+### 1. Define Your Types
 
-movies.ts
+**models/movie.ts**
 ```ts
 export interface Movie {
   title: string;
-  rate?: number;
+  director: string;
+  year: number;
+  rating?: number;
 }
 ```
 
-index.ts
+### 2. Register the Manager
+
+**index.ts**
 ```ts
-import Storehouse from '@storehouse/core';
-import { MongoDBManager } from '@storehouse/mongodb';
+import { Storehouse } from '@storehouse/core';
+import { MongoDbManager } from '@storehouse/mongodb';
 
-// register
+// Register the manager
 Storehouse.add({
-  local: {
-    // type: '@storehouse/mongodb' if you called Storehouse.setManagerType(MongoDBManager)
-    type: MongoDBManager, 
+  mongodb: {
+    type: MongoDbManager,
     config: {
-      // string
-      url: 'mongodb://localhost:27017/database',
-      
+      url: 'mongodb://localhost:27017/mydb',
       // MongoClientOptions
       options: {
-        keepAlive: true,
+        maxPoolSize: 10,
+        minPoolSize: 5
       }
     }
   }
 });
 ```
 
-Once the manager registered, you should open the connection to get access to the database.
+### 3. Connect and Use
 
 ```ts
-import Storehouse from '@storehouse/core';
-import { MongoDBManager } from '@storehouse/mongodb';
+import { Storehouse } from '@storehouse/core';
+import { MongoDbManager } from '@storehouse/mongodb';
 import { Collection, MongoClient } from 'mongodb';
-import { Movie } from './movies';
+import { Movie } from './models/movie';
+
+// Get the manager and connect
+const manager = Storehouse.getManager<MongoDbManager>('mongodb');
 
-// open the connection by calling MongoClient.connect()
-const conn = await Storehouse.getConnection<MongoClient>('local')?.connect();
-if (conn) {
-  console.log('retrieved connection for database', conn.db().databaseName);
+if (manager) {
+  // Open the connection
+  await manager.connect();
+  
+  console.log('Connected to database:', manager.db().databaseName);
+  
+  // Get a collection
+  const moviesCollection = manager.getModel<Movie>('movies');
+  
+  // Insert a document
+  await moviesCollection.insertOne({
+    title: 'Sinners',
+    director: 'Ryan Coogler',
+    year: 2025,
+    rating: 8.5
+  });
+  
+  // Query documents
+  const movies = await moviesCollection.find({ year: { $gte: 2010 } }).toArray();
+  console.log('Movies:', movies);
+  
+  // Count documents
+  const count = await moviesCollection.countDocuments();
+  console.log('Total movies:', count);
 }
+```
 
-// manager
-const localManager = Storehouse.getManager<MongoDBManager>('local');
-if (localManager) {
-  // model
-  const moviesModel = localManager.getModel<Collection<Movie>>('movies');
-  if (moviesModel) {
-    console.log('nb movies', await moviesModel.countDocuments());
-  }
+## API Reference
+
+### Helper Functions
+
+The package provides helper functions that throw errors instead of returning undefined, making your code cleaner and safer.
+
+#### `getManager()`
+
+Retrieves a MongoDbManager instance from the registry.
+
+```ts
+import { Storehouse } from '@storehouse/core';
+import { getManager } from '@storehouse/mongodb';
+
+const manager = getManager(Storehouse, 'mongodb');
+await manager.connect();
+```
+
+**Throws:**
+- `ManagerNotFoundError` - If the manager doesn't exist
+- `InvalidManagerConfigError` - If the manager is not a MongoDbManager instance
+
+#### `getConnection()`
+
+Retrieves the underlying MongoDB client connection.
+
+```ts
+import { Storehouse } from '@storehouse/core';
+import { getConnection } from '@storehouse/mongodb';
+
+const client = getConnection(Storehouse, 'mongodb');
+await client.connect();
+
+// Access the database
+const db = client.db('mydb');
+const collections = await db.listCollections().toArray();
+```
+
+**Throws:**
+- `ManagerNotFoundError` - If the manager doesn't exist
+- `InvalidManagerConfigError` - If the manager is not a MongoClient instance
+
+#### `getModel()`
+
+Retrieves a MongoDB Collection by name.
+
+```ts
+import { Storehouse } from '@storehouse/core';
+import { getModel } from '@storehouse/mongodb';
+import { Movie } from './models/movie';
+
+// Get model from default manager
+const movies = getModel<Movie>(Storehouse, 'movies');
+
+// Get model from specific manager
+const users = getModel(Storehouse, 'mongodb', 'users');
+
+// Use the collection
+const count = await movies.countDocuments();
+console.log('Total movies:', count);
+```
+
+**Throws:**
+- `ModelNotFoundError` - If the model doesn't exist
+
+### MongoDbManager Class
+
+#### Methods
+
+##### `connect(): Promise<this>`
+
+Establishes connection to MongoDB.
+
+```ts
+await manager.connect();
+```
+
+##### `close(force?: boolean): Promise<void>`
+
+Closes the MongoDB connection.
+
+```ts
+// Graceful close
+await manager.close();
+
+// Force close
+await manager.close(true);
+```
+
+##### `closeConnection(force?: boolean): Promise<void>`
+
+Alias for `close()`. Closes the MongoDB connection.
+
+```ts
+await manager.closeConnection();
+```
+
+##### `getConnection(): MongoClient`
+
+Returns the underlying MongoDB client instance.
+
+```ts
+const client = manager.getConnection();
+const db = client.db('mydb');
+```
+
+##### `getModel<T>(name: string): Collection<T>`
+
+Retrieves a MongoDB collection by name. Supports dot notation for cross-database access.
+
+```ts
+// Get collection from default database
+const movies = manager.getModel<Movie>('movies');
+
+// Get collection from specific database
+const users = manager.getModel('otherdb.users');
+```
+
+##### `isConnected(): Promise<boolean>`
+
+Checks if the connection is currently active. Works without admin privileges.
+
+```ts
+const connected = await manager.isConnected();
+if (connected) {
+  console.log('MongoDB is connected');
 }
+```
+
+##### `healthCheck(): Promise<MongoDbHealthCheckResult>`
+
+Performs a comprehensive health check including ping test and latency measurement. Works without admin privileges.
+
+```ts
+const health = await manager.healthCheck();
 
-// model
-const Movies = Storehouse.getModel<Collection<Movie>>('movies');
-if(Movies) {
-  console.log('nb movies', await Movies.countDocuments());
+if (health.healthy) {
+  console.log(`✓ MongoDB is healthy`);
+  console.log(`  Database: ${health.details.databaseName}`);
+  console.log(`  Latency: ${health.details.latency}`);
+} else {
+  console.error(`✗ MongoDB is unhealthy: ${health.message}`);
 }
 ```
 
-### Helpers
+### Health Check Result
+
+The health check returns a detailed result object:
+
+- `healthy: boolean` - Overall health status
+- `message: string` - Descriptive message about the health status
+- `timestamp: number` - Timestamp when the health check was performed
+- `latency?: number` - Response time in milliseconds
+- `details: object` - Detailed connection information
+  - `name: string` - Manager name
+  - `isOpen: boolean` - Connection open status
+  - `isReady: boolean` - Connection ready status
+  - `pingResponse?: Document` - MongoDB ping response
+  - `latency?: string` - Response time in ms
+  - `error?: string` - Error details (if unhealthy)
+
+## Advanced Usage
+
+### Multiple Managers
+
+You can register multiple MongoDB connections:
+
+```ts
+import { Storehouse } from '@storehouse/core';
+import { MongoDbManager, getManager } from '@storehouse/mongodb';
+
+Storehouse.add({
+  primary: {
+    type: MongoDbManager,
+    config: {
+      url: 'mongodb://localhost:27017/maindb'
+    }
+  },
+  analytics: {
+    type: MongoDbManager,
+    config: {
+      url: 'mongodb://localhost:27017/analyticsdb'
+    }
+  }
+});
+
+// Access specific managers
+const primaryManager = getManager(Storehouse, 'primary');
+const analyticsManager = getManager(Storehouse, 'analytics');
+```
+
+### Using the Manager Type
+
+Set the manager type to simplify configuration and use string identifiers instead of class references:
+
+```ts
+import { Storehouse } from '@storehouse/core';
+import { MongoDbManager } from '@storehouse/mongodb';
+
+// Set default manager type
+Storehouse.setManagerType(MongoDbManager);
+
+// Now you can use type string instead of class
+Storehouse.add({
+  mongodb: {
+    type: '@storehouse/mongodb',
+    config: {
+      url: 'mongodb://localhost:27017/mydb'
+    }
+  }
+});
+```
+
+### Cross-Database Access
 
-There are methods to help you retrieve the connection, manager and models so you don't have to check if they are undefined.
-Those methods throw an error when they fail.
+Access collections from different databases sharing the same socket connection using dot notation:
 
 ```ts
-import Storehouse from '@storehouse/core';
-import { getConnection, getManager, getModel } from '@storehouse/mongodb';
-import { Collection } from 'mongodb';
-import { Movie } from './movies';
+import { Storehouse } from '@storehouse/core';
+import { getModel } from '@storehouse/mongodb';
+
+// Access collection from another database
+const otherDbMovies = getModel(Storehouse, 'mongodb', 'otherdatabase.movies');
+
+// Or using Storehouse directly
+const Movies = Storehouse.getModel('mongodb', 'otherdatabase.movies');
 
-// connection
-const conn = await getConnection(Storehouse, 'local').connect();
-console.log('retrieved connection for database', conn.db().databaseName);
+// Query the collection
+const movies = await otherDbMovies?.find({}).toArray();
+```
+
+The format is: `<database-name>.<collection-name>`
+
+### Connection Event Handling
+
+The manager automatically logs connection lifecycle events. These are logged using the `@novice1/logger` package and can be enabled with Debug mode:
 
-// manager
-const manager = getManager(Storehouse, 'local');
-manager.getModel<Collection<Movie>>('movies');
+```ts
+import { Debug } from '@novice1/logger';
 
-// model
-const Movies = getModel<Movie>(Storehouse, 'local', 'movies');
-console.log('nb movies', await Movies.countDocuments());
+Debug.enable('@storehouse/mongodb*');
 ```
 
-### Collections from another database
+**Events logged:**
+- `topologyOpening` - Connection initiated
+- `serverOpening` - Server connection established
+- `serverClosed` - Server connection closed
+- `topologyClosed` - Connection closed
+- `error` - Connection errors
+
+## TypeScript Support
 
-You can access data from another database sharing the same socket connection.
-To get access to a collection from another database with the method `getModel`, the name of the model should be in the following format: `<database-name>.<collection-name>`.
+The package is written in TypeScript and provides full type definitions for type-safe operations:
 
 ```ts
-const Movies = Storehouse.getModel<Collection<Movie>>('local', 'otherdatabase.movies');
+import { Storehouse } from '@storehouse/core';
+import { MongoClient, Collection } from 'mongodb';
+import { MongoDbManager, getManager, getConnection, getModel } from '@storehouse/mongodb';
+
+// Typed manager
+const manager = getManager<MongoDbManager>(Storehouse, 'mongodb');
+
+// Typed connection
+const client: MongoClient = getConnection(Storehouse, 'mongodb');
+
+// Typed collection with document interface
+interface User {
+  name: string;
+  email: string;
+  age: number;
+}
+
+const users = getModel<User>(Storehouse, 'mongodb', 'users');
+// users is typed as Collection<User>
+
+// Type-safe operations
+const allUsers = await users.find({}).toArray();
+// allUsers is typed as User[]
 ```
+
+## Error Handling
+
+All helper functions throw specific errors for better error handling:
+
 ```ts
-const Movies = getModel(Storehouse, 'local', 'otherdatabase.movies');
+import { Storehouse } from '@storehouse/core';
+import { getManager, getModel, getConnection } from '@storehouse/mongodb';
+import {
+  ManagerNotFoundError,
+  ModelNotFoundError,
+  InvalidManagerConfigError
+} from '@storehouse/core';
+
+try {
+  const manager = getManager(Storehouse, 'nonexistent');
+} catch (error) {
+  if (error instanceof ManagerNotFoundError) {
+    console.error('Manager not found:', error.message);
+  } else if (error instanceof InvalidManagerConfigError) {
+    console.error('Invalid manager type:', error.message);
+  }
+}
+
+try {
+  const model = getModel(Storehouse, 'nonexistent');
+} catch (error) {
+  if (error instanceof ModelNotFoundError) {
+    console.error('Model not found:', error.message);
+  }
+}
 ```
 
-## References
+## Best Practices
+
+1. **Always connect** - Call `connect()` after registering the manager to establish the connection
+2. **Use health checks** - Monitor connection health in production environments
+3. **Handle disconnections** - Implement reconnection and retry logic for critical operations
+4. **Close connections** - Always call `close()` when shutting down your application
+5. **Use TypeScript** - Leverage type definitions for safer database operations
+
+## Resources
 
 - [Documentation](https://kisiwu.github.io/storehouse/mongodb/latest/)
 - [@storehouse/core](https://www.npmjs.com/package/@storehouse/core)
-- [mongodb](https://www.npmjs.com/package/mongodb)
+- [MongoDB Node.js Driver](https://www.npmjs.com/package/mongodb)
+- [MongoDB Documentation](https://www.mongodb.com/docs/)
+
+## License
 
+MIT

package/lib/index.d.ts

@@ -1,28 +1,307 @@
-import { IManager, ManagerArg } from '@storehouse/core/lib/manager';
-import { Registry } from '@storehouse/core/lib/registry';
+import { HealthCheckResult, IManager, ManagerArg, Registry } from '@storehouse/core';
 import { MongoClient, MongoClientOptions, Document, Collection } from 'mongodb';
-export interface MongoDBManagerArg extends ManagerArg {
+/**
+ * Configuration argument for creating a MongoDbManager instance.
+ *
+ * @extends ManagerArg
+ *
+ * @example
+ * ```typescript
+ * const managerArg: MongoDbManagerArg = {
+ *   name: 'my-mongodb-manager',
+ *   config: {
+ *     url: 'mongodb://localhost:27017/mydb',
+ *     options: {
+ *       maxPoolSize: 10
+ *     }
+ *   }
+ * };
+ * ```
+ */
+export interface MongoDbManagerArg extends ManagerArg {
+    /**
+     * Configuration for the MongoDB connection.
+     */
     config?: {
+        /**
+         * MongoDB connection URL.
+         * @example 'mongodb://localhost:27017/mydb'
+         */
         url: string;
+        /**
+         * MongoDB client connection options.
+         * See MongoDB driver documentation for available options.
+         */
         options?: MongoClientOptions;
     };
 }
 /**
+ * Retrieves a MongoDB Collection (model) from the registry.
+ *
+ * This function has two overload signatures:
+ * 1. When called with 2 arguments, retrieves the model using the second argument as the model name from the default manager
+ * 2. When called with 3 arguments, retrieves the model from a specific manager
+ *
+ * @template T - The document type for the collection, defaults to Document
  *
- * @param registry
- * @param manager Manager name or model name
- * @param modelName Model name
- * @returns
+ * @param registry - The Storehouse registry containing registered managers and models
+ * @param modelName - When used with 2 arguments, this is the name of the model to retrieve
+ * @returns The requested MongoDB Collection
+ *
+ * @throws {ModelNotFoundError} If the model is not found in the registry
+ *
+ * @example
+ * ```typescript
+ * // Get model from default manager
+ * const users = getModel(registry, 'users');
+ * const allUsers = await users.find({}).toArray();
+ *
+ * // With type parameter
+ * interface User {
+ *   name: string;
+ *   email: string;
+ * }
+ * const users = getModel<User>(registry, 'users');
+ * ```
+ */
+export declare function getModel<T extends Document = Document>(registry: Registry, modelName: string): Collection<T>;
+/**
+ * Retrieves a MongoDB Collection (model) from a specific manager in the registry.
+ *
+ * @template T - The document type for the collection, defaults to Document
+ *
+ * @param registry - The Storehouse registry containing registered managers and models
+ * @param managerName - The name of the manager containing the model
+ * @param modelName - The name of the specific model to retrieve
+ * @returns The requested MongoDB Collection
+ *
+ * @throws {ModelNotFoundError} If the model is not found in the registry
+ *
+ * @example
+ * ```typescript
+ * // Get model from specific manager
+ * const users = getModel(registry, 'mongodb', 'users');
+ *
+ * // With type parameter
+ * interface Product {
+ *   title: string;
+ *   price: number;
+ * }
+ * const products = getModel<Product>(registry, 'mongodb', 'products');
+ * const allProducts = await products.find({}).toArray();
+ * ```
+ */
+export declare function getModel<T extends Document = Document>(registry: Registry, managerName: string, modelName: string): Collection<T>;
+/**
+ * Retrieves a MongoDbManager instance from the registry.
+ *
+ * @template M - The specific MongoDbManager type to return, defaults to MongoDbManager
+ *
+ * @param registry - The Storehouse registry containing registered managers
+ * @param managerName - Optional name of the manager to retrieve. If omitted, retrieves the default manager
+ *
+ * @returns The requested MongoDbManager instance
+ *
+ * @throws {ManagerNotFoundError} If the manager is not found in the registry
+ * @throws {InvalidManagerConfigError} If the manager exists but is not an instance of MongoDbManager
+ *
+ * @example
+ * ```typescript
+ * const mongoManager = getManager(registry, 'mongodb');
+ * await mongoManager.connect();
+ * ```
+ */
+export declare function getManager<M extends MongoDbManager = MongoDbManager>(registry: Registry, managerName?: string): M;
+/**
+ * Retrieves the underlying MongoDB client connection from a manager in the registry.
+ *
+ * @param registry - The Storehouse registry containing registered managers
+ * @param managerName - Optional name of the manager. If omitted, uses the default manager
+ *
+ * @returns The MongoDB client instance
+ *
+ * @throws {ManagerNotFoundError} If the manager is not found in the registry
+ * @throws {InvalidManagerConfigError} If the connection is not an instance of MongoClient
+ *
+ * @example
+ * ```typescript
+ * const client = getConnection(registry, 'mongodb');
+ * const admin = client.db().admin();
+ * const dbs = await admin.listDatabases();
+ * ```
  */
-export declare function getModel<T extends Document = Document>(registry: Registry, managerName: string, modelName?: string): Collection<T>;
-export declare function getManager<M extends MongoDBManager = MongoDBManager>(registry: Registry, managerName?: string): M;
 export declare function getConnection(registry: Registry, managerName?: string): MongoClient;
-export declare class MongoDBManager extends MongoClient implements IManager {
+/**
+ * Extended health check result specific to MongoDB managers.
+ * Includes MongoDB connection status and ping response.
+ *
+ * @extends HealthCheckResult
+ */
+export interface MongoDbHealthCheckResult extends HealthCheckResult {
+    /**
+     * Detailed information about the MongoDB connection health.
+     */
+    details: {
+        /** The name of the manager */
+        name: string;
+        /** The name of the database */
+        databaseName?: string;
+        /** Whether the MongoDB connection is currently open */
+        isOpen: boolean;
+        /** Whether the MongoDB connection is ready to accept commands */
+        isReady: boolean;
+        /** The response from the MongoDB PING command */
+        pingResponse?: Document;
+        /** Time taken to perform the health check in milliseconds */
+        latency?: string;
+        /** Error message if the health check failed */
+        error?: string;
+        /** Additional custom properties */
+        [key: string]: unknown;
+    };
+}
+/**
+ * Manager class for MongoDB integration with Storehouse.
+ * Provides connection management, model registration, and health checking for MongoDB databases.
+ *
+ * This manager extends the MongoDB MongoClient, offering a unified interface
+ * for working with MongoDB databases through the Storehouse registry system.
+ *
+ * @extends MongoClient
+ * @implements {IManager}
+ *
+ * @example
+ * ```typescript
+ * const manager = new MongoDbManager({
+ *   name: 'mongodb-main',
+ *   config: {
+ *     url: 'mongodb://localhost:27017/mydb',
+ *     options: {
+ *       maxPoolSize: 10,
+ *       minPoolSize: 5
+ *     }
+ *   }
+ * });
+ *
+ * await manager.connect();
+ *
+ * const usersCollection = manager.getModel('users');
+ * const users = await usersCollection.find({}).toArray();
+ * ```
+ */
+export declare class MongoDbManager extends MongoClient implements IManager {
+    #private;
+    /**
+     * Identifier for the manager type.
+     * @readonly
+     */
     static readonly type = "@storehouse/mongodb";
+    /**
+     * The name of this manager instance.
+     * @protected
+     */
     protected name: string;
-    constructor(settings: MongoDBManagerArg);
-    private _registerConnectionEvents;
+    /**
+     * Creates a new MongoDbManager instance.
+     *
+     * @param settings - Configuration settings for the manager
+     *
+     * @throws {InvalidManagerConfigError} If the connection URL is missing
+     *
+     * @remarks
+     * The connection is created but not opened. You must call `connect()` to establish the connection.
+     * Connection events (topologyOpening, serverOpening, serverClosed, topologyClosed, error) are automatically registered and logged.
+     */
+    constructor(settings: MongoDbManagerArg);
+    /**
+     * Gets the underlying MongoDB client connection.
+     *
+     * @returns The MongoDB client instance (this instance)
+     *
+     * @example
+     * ```typescript
+     * const client = manager.getConnection();
+     * const db = client.db('mydb');
+     * ```
+     */
     getConnection(): MongoClient;
+    /**
+     * Closes the MongoDB connection.
+     *
+     * @param force - Optional flag to force close the connection, bypassing any connection pool cleanup
+     * @returns A promise that resolves when the connection is closed
+     *
+     * @example
+     * ```typescript
+     * // Graceful close
+     * await manager.closeConnection();
+     *
+     * // Force close
+     * await manager.closeConnection(true);
+     * ```
+     */
     closeConnection(force?: boolean): Promise<void>;
+    /**
+     * Retrieves a MongoDB collection by name.
+     * Supports dot notation for database.collection format.
+     *
+     * @template T - The document type for the collection, defaults to Document
+     *
+     * @param name - The name of the collection, or database.collection format
+     * @returns The MongoDB Collection instance
+     *
+     * @example
+     * ```typescript
+     * // Get collection from default database
+     * const users = manager.getModel('users');
+     *
+     * // Get collection with specific database
+     * const users = manager.getModel('mydb.users');
+     *
+     * // With type parameter
+     * interface User {
+     *   name: string;
+     *   email: string;
+     * }
+     * const users = manager.getModel<User>('users');
+     * ```
+     */
     getModel<T extends Document = Document>(name: string): Collection<T>;
+    /**
+     * Checks if the MongoDB connection is currently active.
+     * Uses a simple ping command that doesn't require admin privileges.
+     *
+     * @returns A promise that resolves to true if connected, false otherwise
+     *
+     * @example
+     * ```typescript
+     * if (await manager.isConnected()) {
+     *   console.log('MongoDB is connected');
+     * }
+     * ```
+     */
+    isConnected(): Promise<boolean>;
+    /**
+     * Performs a comprehensive health check on the MongoDB connection.
+     * Tests connectivity by sending a PING command and gathering connection metrics.
+     * This method works with restricted database access (non-admin users).
+     *
+     * @returns A promise that resolves to a detailed health check result including:
+     * - Connection status (open/ready)
+     * - Ping response
+     * - Response latency
+     * - Error details (if unhealthy)
+     *
+     * @example
+     * ```typescript
+     * const health = await manager.healthCheck();
+     * if (health.healthy) {
+     *   console.log(`MongoDB is healthy. Latency: ${health.details.latency}`);
+     *   console.log(`Ping response:`, health.details.pingResponse);
+     * } else {
+     *   console.error(`MongoDB is unhealthy: ${health.message}`);
+     * }
+     * ```
+     */
+    healthCheck(): Promise<MongoDbHealthCheckResult>;
 }

package/lib/index.js

@@ -1,72 +1,161 @@
 "use strict";
+var _MongoDbManager_instances, _MongoDbManager_registerConnectionEvents;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MongoDBManager = void 0;
+exports.MongoDbManager = void 0;
 exports.getModel = getModel;
 exports.getManager = getManager;
 exports.getConnection = getConnection;
 const tslib_1 = require("tslib");
+const core_1 = require("@storehouse/core");
 const mongodb_1 = require("mongodb");
 const logger_1 = tslib_1.__importDefault(require("@novice1/logger"));
+const node_crypto_1 = require("node:crypto");
 const Log = logger_1.default.debugger('@storehouse/mongodb:manager');
-/**
- *
- * @param registry
- * @param manager Manager name or model name
- * @param modelName Model name
- * @returns
- */
 function getModel(registry, managerName, modelName) {
     const model = registry.getModel(managerName, modelName);
     if (!model) {
-        throw new ReferenceError(`Could not find model "${modelName || managerName}"`);
+        throw new core_1.ModelNotFoundError(modelName || managerName, modelName ? managerName : undefined);
     }
     return model;
 }
+/**
+ * Retrieves a MongoDbManager instance from the registry.
+ *
+ * @template M - The specific MongoDbManager type to return, defaults to MongoDbManager
+ *
+ * @param registry - The Storehouse registry containing registered managers
+ * @param managerName - Optional name of the manager to retrieve. If omitted, retrieves the default manager
+ *
+ * @returns The requested MongoDbManager instance
+ *
+ * @throws {ManagerNotFoundError} If the manager is not found in the registry
+ * @throws {InvalidManagerConfigError} If the manager exists but is not an instance of MongoDbManager
+ *
+ * @example
+ * ```typescript
+ * const mongoManager = getManager(registry, 'mongodb');
+ * await mongoManager.connect();
+ * ```
+ */
 function getManager(registry, managerName) {
     const manager = registry.getManager(managerName);
     if (!manager) {
-        throw new ReferenceError(`Could not find manager "${managerName || registry.defaultManager}"`);
+        throw new core_1.ManagerNotFoundError(managerName || registry.defaultManager);
     }
-    if (!(manager instanceof MongoDBManager)) {
-        throw new TypeError(`Manager "${managerName || registry.defaultManager}" is not instance of MongoDBManager`);
+    if (!(manager instanceof MongoDbManager)) {
+        throw new core_1.InvalidManagerConfigError(`Manager "${managerName || registry.defaultManager}" is not instance of MongoDbManager`);
     }
     return manager;
 }
+/**
+ * Retrieves the underlying MongoDB client connection from a manager in the registry.
+ *
+ * @param registry - The Storehouse registry containing registered managers
+ * @param managerName - Optional name of the manager. If omitted, uses the default manager
+ *
+ * @returns The MongoDB client instance
+ *
+ * @throws {ManagerNotFoundError} If the manager is not found in the registry
+ * @throws {InvalidManagerConfigError} If the connection is not an instance of MongoClient
+ *
+ * @example
+ * ```typescript
+ * const client = getConnection(registry, 'mongodb');
+ * const admin = client.db().admin();
+ * const dbs = await admin.listDatabases();
+ * ```
+ */
 function getConnection(registry, managerName) {
     const conn = registry.getConnection(managerName);
     if (!conn) {
-        throw new ReferenceError(`Could not find connection "${managerName || registry.defaultManager}"`);
+        throw new core_1.ManagerNotFoundError(managerName || registry.defaultManager);
+    }
+    if (!(conn instanceof mongodb_1.MongoClient)) {
+        throw new core_1.InvalidManagerConfigError(`Connection "${managerName || registry.defaultManager}" is not instance of MongoClient`);
     }
     return conn;
 }
-class MongoDBManager extends mongodb_1.MongoClient {
+/**
+ * Manager class for MongoDB integration with Storehouse.
+ * Provides connection management, model registration, and health checking for MongoDB databases.
+ *
+ * This manager extends the MongoDB MongoClient, offering a unified interface
+ * for working with MongoDB databases through the Storehouse registry system.
+ *
+ * @extends MongoClient
+ * @implements {IManager}
+ *
+ * @example
+ * ```typescript
+ * const manager = new MongoDbManager({
+ *   name: 'mongodb-main',
+ *   config: {
+ *     url: 'mongodb://localhost:27017/mydb',
+ *     options: {
+ *       maxPoolSize: 10,
+ *       minPoolSize: 5
+ *     }
+ *   }
+ * });
+ *
+ * await manager.connect();
+ *
+ * const usersCollection = manager.getModel('users');
+ * const users = await usersCollection.find({}).toArray();
+ * ```
+ */
+class MongoDbManager extends mongodb_1.MongoClient {
+    /**
+     * Creates a new MongoDbManager instance.
+     *
+     * @param settings - Configuration settings for the manager
+     *
+     * @throws {InvalidManagerConfigError} If the connection URL is missing
+     *
+     * @remarks
+     * The connection is created but not opened. You must call `connect()` to establish the connection.
+     * Connection events (topologyOpening, serverOpening, serverClosed, topologyClosed, error) are automatically registered and logged.
+     */
     constructor(settings) {
         var _a;
         if (!((_a = settings.config) === null || _a === void 0 ? void 0 : _a.url)) {
-            throw new TypeError('Missing connection url');
+            throw new core_1.InvalidManagerConfigError('Missing connection url');
         }
         super(settings.config.url, settings.config.options);
-        this.name = settings.name || `MongoDB ${Date.now()}_${Math.ceil(Math.random() * 10000) + 10}`;
-        this._registerConnectionEvents();
-        Log.info('[%s] MongoClient created. Must call "MongoClient.connect()".', this.name);
-    }
-    _registerConnectionEvents() {
-        this.on('topologyOpening', () => {
-            Log.info('[%s] connecting ...', this.name);
-        });
-        this.on('serverOpening', () => {
-            Log.info('[%s] connected!', this.name);
-        });
-        this.on('serverClosed', () => {
-            Log.info('[%s] disconnected!', this.name);
-        });
-        this.on('topologyClosed', () => {
-            Log.info('[%s] connection closed!', this.name);
-        });
+        _MongoDbManager_instances.add(this);
+        this.name = settings.name || `MongoDB ${Date.now()}_${(0, node_crypto_1.randomBytes)(3).toString('hex')}`;
+        tslib_1.__classPrivateFieldGet(this, _MongoDbManager_instances, "m", _MongoDbManager_registerConnectionEvents).call(this);
+        Log.info(`[${this.name}] MongoClient created. Must call "MongoClient.connect()".`);
     }
+    /**
+     * Gets the underlying MongoDB client connection.
+     *
+     * @returns The MongoDB client instance (this instance)
+     *
+     * @example
+     * ```typescript
+     * const client = manager.getConnection();
+     * const db = client.db('mydb');
+     * ```
+     */
     getConnection() {
         return this;
     }
+    /**
+     * Closes the MongoDB connection.
+     *
+     * @param force - Optional flag to force close the connection, bypassing any connection pool cleanup
+     * @returns A promise that resolves when the connection is closed
+     *
+     * @example
+     * ```typescript
+     * // Graceful close
+     * await manager.closeConnection();
+     *
+     * // Force close
+     * await manager.closeConnection(true);
+     * ```
+     */
     closeConnection(force) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
             if (force) {
@@ -77,6 +166,31 @@ class MongoDBManager extends mongodb_1.MongoClient {
             }
         });
     }
+    /**
+     * Retrieves a MongoDB collection by name.
+     * Supports dot notation for database.collection format.
+     *
+     * @template T - The document type for the collection, defaults to Document
+     *
+     * @param name - The name of the collection, or database.collection format
+     * @returns The MongoDB Collection instance
+     *
+     * @example
+     * ```typescript
+     * // Get collection from default database
+     * const users = manager.getModel('users');
+     *
+     * // Get collection with specific database
+     * const users = manager.getModel('mydb.users');
+     *
+     * // With type parameter
+     * interface User {
+     *   name: string;
+     *   email: string;
+     * }
+     * const users = manager.getModel<User>('users');
+     * ```
+     */
     getModel(name) {
         const conn = this.getConnection();
         let model;
@@ -89,7 +203,115 @@ class MongoDBManager extends mongodb_1.MongoClient {
         }
         return model;
     }
+    /**
+     * Checks if the MongoDB connection is currently active.
+     * Uses a simple ping command that doesn't require admin privileges.
+     *
+     * @returns A promise that resolves to true if connected, false otherwise
+     *
+     * @example
+     * ```typescript
+     * if (await manager.isConnected()) {
+     *   console.log('MongoDB is connected');
+     * }
+     * ```
+     */
+    isConnected() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                // Use a simple ping command on the database
+                yield this.db().command({ ping: 1 });
+                return true;
+            }
+            catch (_a) {
+                return false;
+            }
+        });
+    }
+    /**
+     * Performs a comprehensive health check on the MongoDB connection.
+     * Tests connectivity by sending a PING command and gathering connection metrics.
+     * This method works with restricted database access (non-admin users).
+     *
+     * @returns A promise that resolves to a detailed health check result including:
+     * - Connection status (open/ready)
+     * - Ping response
+     * - Response latency
+     * - Error details (if unhealthy)
+     *
+     * @example
+     * ```typescript
+     * const health = await manager.healthCheck();
+     * if (health.healthy) {
+     *   console.log(`MongoDB is healthy. Latency: ${health.details.latency}`);
+     *   console.log(`Ping response:`, health.details.pingResponse);
+     * } else {
+     *   console.error(`MongoDB is unhealthy: ${health.message}`);
+     * }
+     * ```
+     */
+    healthCheck() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const start = Date.now();
+            const timestamp = start;
+            try {
+                // Use ping command on the database
+                const db = this.db();
+                const pingResult = yield db.command({ ping: 1 });
+                const latency = Date.now() - start;
+                return {
+                    healthy: true,
+                    message: 'MongoDB connection is healthy',
+                    details: {
+                        name: this.name,
+                        databaseName: db.databaseName,
+                        isOpen: true,
+                        isReady: pingResult.ok === 1,
+                        pingResponse: pingResult,
+                        latency: `${latency}ms`
+                    },
+                    latency,
+                    timestamp
+                };
+            }
+            catch (error) {
+                return {
+                    healthy: false,
+                    message: `MongoDB health check failed: ${error instanceof Error ? error.message : String(error)}`,
+                    details: {
+                        name: this.name,
+                        isOpen: false,
+                        isReady: false,
+                        error: error instanceof Error ? error.stack : String(error)
+                    },
+                    latency: Date.now() - start,
+                    timestamp
+                };
+            }
+        });
+    }
 }
-exports.MongoDBManager = MongoDBManager;
-MongoDBManager.type = '@storehouse/mongodb';
+exports.MongoDbManager = MongoDbManager;
+_MongoDbManager_instances = new WeakSet(), _MongoDbManager_registerConnectionEvents = function _MongoDbManager_registerConnectionEvents() {
+    this.on('topologyOpening', () => {
+        Log.info(`[${this.name}] connecting ...`);
+    });
+    this.on('serverOpening', () => {
+        Log.info(`[${this.name}] connected!`);
+    });
+    this.on('serverClosed', () => {
+        Log.warn(`[${this.name}] disconnected!`);
+    });
+    this.on('topologyClosed', () => {
+        Log.info(`[${this.name}] connection closed!`);
+    });
+    this.on('error', (err) => {
+        Log.error(`[${this.name}] connection error: ${err.message}`);
+    });
+};
+/**
+ * Identifier for the manager type.
+ * @readonly
+ */
+MongoDbManager.type = '@storehouse/mongodb';
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AA2BA,4BAMC;AAED,gCASC;AAED,sCAMC;;AAlDD,qCAKiB;AACjB,qEAAqC;AAGrC,MAAM,GAAG,GAAG,gBAAM,CAAC,QAAQ,CAAC,6BAA6B,CAAC,CAAC;AAS3D;;;;;;GAMG;AACH,SAAgB,QAAQ,CAAgC,QAAkB,EAAE,WAAmB,EAAE,SAAkB;IACjH,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAgB,WAAW,EAAE,SAAS,CAAC,CAAC;IACvE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,cAAc,CAAC,yBAAyB,SAAS,IAAI,WAAW,GAAG,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,UAAU,CAA4C,QAAkB,EAAE,WAAoB;IAC5G,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAI,WAAW,CAAC,CAAC;IACpD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,cAAc,CAAC,2BAA2B,WAAW,IAAI,QAAQ,CAAC,cAAc,GAAG,CAAC,CAAC;IACjG,CAAC;IACD,IAAI,CAAC,CAAC,OAAO,YAAY,cAAc,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,SAAS,CAAC,YAAY,WAAW,IAAI,QAAQ,CAAC,cAAc,qCAAqC,CAAC,CAAC;IAC/G,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,aAAa,CAAC,QAAkB,EAAE,WAAoB;IACpE,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAc,WAAW,CAAC,CAAC;IAC9D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,cAAc,CAAC,8BAA8B,WAAW,IAAI,QAAQ,CAAC,cAAc,GAAG,CAAC,CAAC;IACpG,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAa,cAAe,SAAQ,qBAAW;IAK7C,YAAY,QAA2B;;QACrC,IAAI,CAAC,CAAA,MAAA,QAAQ,CAAC,MAAM,0CAAE,GAAG,CAAA,EAAE,CAAC;YAC1B,MAAM,IAAI,SAAS,CAAC,wBAAwB,CAAC,CAAC;QAChD,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAEpD,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAI,WAAW,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC;QAE9F,IAAI,CAAC,yBAAyB,EAAE,CAAC;QAEjC,GAAG,CAAC,IAAI,CAAC,8DAA8D,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACtF,CAAC;IAEO,yBAAyB;QAC/B,IAAI,CAAC,EAAE,CAAC,iBAAiB,EAAE,GAAG,EAAE;YAC9B,GAAG,CAAC,IAAI,CAAC,qBAAqB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,eAAe,EAAE,GAAG,EAAE;YAC5B,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;YAC3B,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,gBAAgB,EAAE,GAAG,EAAE;YAC7B,GAAG,CAAC,IAAI,CAAC,yBAAyB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAEK,eAAe,CAAC,KAAe;;YACnC,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;QACH,CAAC;KAAA;IAED,QAAQ,CAAgC,IAAY;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QAClC,IAAI,KAAoB,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACtB,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,UAAU,CAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;;AAxDH,wCAyDC;AAxDiB,mBAAI,GAAG,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storehouse/mongodb",
-  "version": "2.4.1",
+  "version": "3.0.0",
   "description": "MongoDB manager for @storehouse/core",
   "main": "lib/index.js",
   "scripts": {
@@ -8,9 +8,9 @@
     "build": "tsc",
     "lint": "eslint .",
     "test": "env TS_NODE_COMPILER_OPTIONS='{\"module\": \"commonjs\", \"noUnusedParameters\": false}' kaukau --require ts-node/register --config kaukau-src.mjs",
-    "testlib": "kaukau --config kaukau-lib.mjs",
+    "test:lib": "kaukau --config kaukau-lib.mjs",
     "test:local": "dotenvx run -f .env.test -- kaukau --require ts-node/register --config kaukau-src.mjs",
-    "testlib:local": "dotenvx run -f .env.test -- kaukau --config kaukau-lib.mjs"
+    "test:lib:local": "dotenvx run -f .env.test -- kaukau --config kaukau-lib.mjs"
   },
   "repository": {
     "type": "git",
@@ -27,28 +27,28 @@
   },
   "homepage": "https://kisiwu.github.io/storehouse/mongodb/latest/",
   "devDependencies": {
-    "@dotenvx/dotenvx": "^1.51.0",
-    "@eslint/eslintrc": "^3.3.1",
-    "@eslint/js": "^9.36.0",
-    "@stylistic/eslint-plugin": "^5.4.0",
-    "@types/chai": "^5.2.2",
+    "@dotenvx/dotenvx": "^1.52.0",
+    "@eslint/eslintrc": "^3.3.3",
+    "@eslint/js": "^9.39.2",
+    "@stylistic/eslint-plugin": "^5.7.1",
+    "@types/chai": "^5.2.3",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^24.6.2",
-    "@typescript-eslint/eslint-plugin": "^8.45.0",
-    "@typescript-eslint/parser": "^8.45.0",
-    "chai": "^6.2.0",
-    "eslint": "^9.36.0",
+    "@types/node": "^25.2.1",
+    "@typescript-eslint/eslint-plugin": "^8.54.0",
+    "@typescript-eslint/parser": "^8.54.0",
+    "chai": "^6.2.2",
+    "eslint": "^9.39.2",
     "eslint-plugin-mocha": "^11.2.0",
-    "kaukau": "^4.1.6",
+    "kaukau": "^4.2.1",
     "ts-node": "^10.9.2",
-    "typedoc": "^0.28.13",
+    "typedoc": "^0.28.16",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.45.0"
+    "typescript-eslint": "^8.54.0"
   },
   "dependencies": {
-    "@novice1/logger": "^1.6.0",
-    "@storehouse/core": "^1.2.1",
-    "mongodb": "^6.20.0",
+    "@novice1/logger": "^1.6.1",
+    "@storehouse/core": "^2.1.0",
+    "mongodb": "^7.1.0",
     "tslib": "^2.8.1"
   }
 }