@nimbus-cqrs/mongodb 2.0.0-beta.0

package/esm/lib/crud/insertOne.d.ts

@@ -0,0 +1,25 @@
+import type { Collection, Document, InsertOneOptions, InsertOneResult, OptionalUnlessRequiredId } from 'mongodb';
+/**
+ * Type to define the input for the insertOne function.
+ */
+export type InsertOneInput = {
+    collection: Collection<Document>;
+    document: OptionalUnlessRequiredId<Document>;
+    options?: InsertOneOptions;
+};
+/**
+ * Type to define the insertOne function.
+ */
+export type InsertOne = (input: InsertOneInput) => Promise<InsertOneResult<Document>>;
+/**
+ * Inserts a single document into a MongoDB collection.
+ *
+ * @param {InsertOneInput} input - The input object.
+ * @param input.collection - The collection to insert into.
+ * @param input.document - The document to insert.
+ * @param [input.options] - The insert options.
+ *
+ * @returns {Promise<InsertOneResult<Document>} The result of the insert operation.
+ */
+export declare const insertOne: InsertOne;
+//# sourceMappingURL=insertOne.d.ts.map

package/esm/lib/crud/insertOne.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insertOne.d.ts","sourceRoot":"","sources":["../../../src/lib/crud/insertOne.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EAC3B,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IACjC,QAAQ,EAAE,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CACpB,KAAK,EAAE,cAAc,KACpB,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;AAExC;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,EAAE,SAYvB,CAAC"}

package/esm/lib/crud/insertOne.js

@@ -0,0 +1,22 @@
+import { handleMongoError } from '../handleMongoError.js';
+import { withSpan } from '../tracing.js';
+/**
+ * Inserts a single document into a MongoDB collection.
+ *
+ * @param {InsertOneInput} input - The input object.
+ * @param input.collection - The collection to insert into.
+ * @param input.document - The document to insert.
+ * @param [input.options] - The insert options.
+ *
+ * @returns {Promise<InsertOneResult<Document>} The result of the insert operation.
+ */
+export const insertOne = ({ collection, document, options, }) => {
+    return withSpan('insertOne', collection, async () => {
+        try {
+            return await collection.insertOne(document, options);
+        }
+        catch (error) {
+            throw handleMongoError(error);
+        }
+    });
+};

package/esm/lib/crud/replaceOne.d.ts

@@ -0,0 +1,27 @@
+import type { Collection, Document, Filter, ReplaceOptions, UpdateResult, WithoutId } from 'mongodb';
+/**
+ * Type to define the input for the replaceOne function.
+ */
+export type ReplaceOneInput = {
+    collection: Collection<Document>;
+    filter: Filter<Document>;
+    replacement: WithoutId<Document>;
+    options?: ReplaceOptions;
+};
+/**
+ * Type to define the replaceOne function.
+ */
+export type ReplaceOne = (input: ReplaceOneInput) => Promise<Document | UpdateResult<Document>>;
+/**
+ * Replaces a single document in a MongoDB collection.
+ *
+ * @param {ReplaceOneInput} input - The input object.
+ * @param input.collection - The collection to replace in.
+ * @param input.filter - The filter for the replace operation.
+ * @param input.replacement - The replacement document.
+ * @param [input.options] - The replace options.
+ *
+ * @returns {Promise<Document | UpdateResult<Document>} The result of the replace operation.
+ */
+export declare const replaceOne: ReplaceOne;
+//# sourceMappingURL=replaceOne.d.ts.map

package/esm/lib/crud/replaceOne.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replaceOne.d.ts","sourceRoot":"","sources":["../../../src/lib/crud/replaceOne.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,UAAU,EACV,QAAQ,EACR,MAAM,EACN,cAAc,EACd,YAAY,EACZ,SAAS,EACZ,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzB,WAAW,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,cAAc,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CACrB,KAAK,EAAE,eAAe,KACrB,OAAO,CAAC,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,EAAE,UAaxB,CAAC"}

package/esm/lib/crud/replaceOne.js

@@ -0,0 +1,23 @@
+import { handleMongoError } from '../handleMongoError.js';
+import { withSpan } from '../tracing.js';
+/**
+ * Replaces a single document in a MongoDB collection.
+ *
+ * @param {ReplaceOneInput} input - The input object.
+ * @param input.collection - The collection to replace in.
+ * @param input.filter - The filter for the replace operation.
+ * @param input.replacement - The replacement document.
+ * @param [input.options] - The replace options.
+ *
+ * @returns {Promise<Document | UpdateResult<Document>} The result of the replace operation.
+ */
+export const replaceOne = ({ collection, filter, replacement, options, }) => {
+    return withSpan('replaceOne', collection, async () => {
+        try {
+            return await collection.replaceOne(filter, replacement, options);
+        }
+        catch (error) {
+            throw handleMongoError(error);
+        }
+    });
+};

package/esm/lib/crud/updateMany.d.ts

@@ -0,0 +1,27 @@
+import type { Collection, Document, Filter, UpdateFilter, UpdateOptions, UpdateResult } from 'mongodb';
+/**
+ * Type to define the input for the updateMany function.
+ */
+export type UpdateManyInput = {
+    collection: Collection<Document>;
+    filter: Filter<Document>;
+    update: UpdateFilter<Document>;
+    options?: UpdateOptions;
+};
+/**
+ * Type to define the updateMany function.
+ */
+export type UpdateMany = (input: UpdateManyInput) => Promise<UpdateResult<Document>>;
+/**
+ * Updates multiple documents in a MongoDB collection.
+ *
+ * @param {UpdateManyInput} input - The input object.
+ * @param input.collection - The collection to update in.
+ * @param input.filter - The filter for the update operation.
+ * @param input.update - The update object.
+ * @param [input.options] - The update options.
+ *
+ * @returns {Promise<UpdateResult<Document>} The result of the update operation.
+ */
+export declare const updateMany: UpdateMany;
+//# sourceMappingURL=updateMany.d.ts.map

package/esm/lib/crud/updateMany.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateMany.d.ts","sourceRoot":"","sources":["../../../src/lib/crud/updateMany.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,UAAU,EACV,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,aAAa,EACb,YAAY,EACf,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,aAAa,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CACrB,KAAK,EAAE,eAAe,KACrB,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;AAErC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,EAAE,UAaxB,CAAC"}

package/esm/lib/crud/updateMany.js

@@ -0,0 +1,23 @@
+import { handleMongoError } from '../handleMongoError.js';
+import { withSpan } from '../tracing.js';
+/**
+ * Updates multiple documents in a MongoDB collection.
+ *
+ * @param {UpdateManyInput} input - The input object.
+ * @param input.collection - The collection to update in.
+ * @param input.filter - The filter for the update operation.
+ * @param input.update - The update object.
+ * @param [input.options] - The update options.
+ *
+ * @returns {Promise<UpdateResult<Document>} The result of the update operation.
+ */
+export const updateMany = ({ collection, filter, update, options, }) => {
+    return withSpan('updateMany', collection, async () => {
+        try {
+            return await collection.updateMany(filter, update, options);
+        }
+        catch (error) {
+            throw handleMongoError(error);
+        }
+    });
+};

package/esm/lib/crud/updateOne.d.ts

@@ -0,0 +1,27 @@
+import type { Collection, Document, Filter, UpdateFilter, UpdateOptions, UpdateResult } from 'mongodb';
+/**
+ * Type to define the input for the updateOne function.
+ */
+export type UpdateOneInput = {
+    collection: Collection<Document>;
+    filter: Filter<Document>;
+    update: UpdateFilter<Document> | Document[];
+    options?: UpdateOptions;
+};
+/**
+ * Type to define the updateOne function.
+ */
+export type UpdateOne = (input: UpdateOneInput) => Promise<UpdateResult<Document>>;
+/**
+ * Updates a single document in a MongoDB collection.
+ *
+ * @param {UpdateOneInput} input - The input object.
+ * @param input.collection - The collection to update in.
+ * @param input.filter - The filter for the update operation.
+ * @param input.update - The update object.
+ * @param [input.options] - The update options.
+ *
+ * @returns {Promise<UpdateResult<Document>} The result of the update operation.
+ */
+export declare const updateOne: UpdateOne;
+//# sourceMappingURL=updateOne.d.ts.map

package/esm/lib/crud/updateOne.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateOne.d.ts","sourceRoot":"","sources":["../../../src/lib/crud/updateOne.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,UAAU,EACV,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,aAAa,EACb,YAAY,EACf,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,QAAQ,EAAE,CAAC;IAC5C,OAAO,CAAC,EAAE,aAAa,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CACpB,KAAK,EAAE,cAAc,KACpB,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;AAErC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,EAAE,SAavB,CAAC"}

package/esm/lib/crud/updateOne.js

@@ -0,0 +1,23 @@
+import { handleMongoError } from '../handleMongoError.js';
+import { withSpan } from '../tracing.js';
+/**
+ * Updates a single document in a MongoDB collection.
+ *
+ * @param {UpdateOneInput} input - The input object.
+ * @param input.collection - The collection to update in.
+ * @param input.filter - The filter for the update operation.
+ * @param input.update - The update object.
+ * @param [input.options] - The update options.
+ *
+ * @returns {Promise<UpdateResult<Document>} The result of the update operation.
+ */
+export const updateOne = ({ collection, filter, update, options, }) => {
+    return withSpan('updateOne', collection, async () => {
+        try {
+            return await collection.updateOne(filter, update, options);
+        }
+        catch (error) {
+            throw handleMongoError(error);
+        }
+    });
+};

package/esm/lib/deployCollection.d.ts

@@ -0,0 +1,33 @@
+import type { CreateCollectionOptions, IndexDescription, MongoClient } from 'mongodb';
+/**
+ * Type to define a mongo collection.
+ */
+export type MongoCollectionDefinition = {
+    name: string;
+    options?: CreateCollectionOptions;
+    indexes?: IndexDescription[];
+};
+/**
+ * Type to define the input for the deployMongoCollection function.
+ */
+export type DeployMongoCollectionInput = {
+    mongoClient: MongoClient;
+    dbName: string;
+    collectionDefinition: MongoCollectionDefinition;
+    allowUpdateIndexes: boolean;
+};
+/**
+ * Deploys a collection to a MongoDB database.
+ *
+ * Either creates a new collection, or updates an existing collection (collMod).
+ * Indexes are created or dropped to match the input set.
+ * Indexes on existing collections are only updated if `allowUpdateIndexes` is set to `true`.
+ *
+ * @param {DeployMongoCollectionInput} input
+ * @param {MongoClient} input.mongoClient - A MongoDB client instance
+ * @param {string} input.dbName - The name of the database
+ * @param {MongoCollectionDefinition} input.collectionDefinition - The collection definition
+ * @param {boolean} input.allowUpdateIndexes - Whether to update indexes on existing collections
+ */
+export declare const deployMongoCollection: ({ mongoClient, dbName, collectionDefinition, allowUpdateIndexes, }: DeployMongoCollectionInput) => Promise<string>;
+//# sourceMappingURL=deployCollection.d.ts.map

package/esm/lib/deployCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployCollection.d.ts","sourceRoot":"","sources":["../../src/lib/deployCollection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,uBAAuB,EAEvB,gBAAgB,EAChB,WAAW,EACd,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAChC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACrC,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,EAAE,yBAAyB,CAAC;IAChD,kBAAkB,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,GAAU,oEAKzC,0BAA0B,KAAG,OAAO,CAAC,MAAM,CA2B7C,CAAC"}

package/esm/lib/deployCollection.js

@@ -0,0 +1,125 @@
+import { getLogger } from '../deps/jsr.io/@nimbus/core/2.0.0/src/index.js';
+/**
+ * Deploys a collection to a MongoDB database.
+ *
+ * Either creates a new collection, or updates an existing collection (collMod).
+ * Indexes are created or dropped to match the input set.
+ * Indexes on existing collections are only updated if `allowUpdateIndexes` is set to `true`.
+ *
+ * @param {DeployMongoCollectionInput} input
+ * @param {MongoClient} input.mongoClient - A MongoDB client instance
+ * @param {string} input.dbName - The name of the database
+ * @param {MongoCollectionDefinition} input.collectionDefinition - The collection definition
+ * @param {boolean} input.allowUpdateIndexes - Whether to update indexes on existing collections
+ */
+export const deployMongoCollection = async ({ mongoClient, dbName, collectionDefinition, allowUpdateIndexes, }) => {
+    const db = mongoClient.db(dbName);
+    const collectionName = collectionDefinition.name;
+    getLogger().info({
+        category: 'Nimbus',
+        message: `Deploying collection "${collectionName}" on database "${dbName}" ...`,
+    });
+    if (await collectionExists(db, collectionDefinition)) {
+        getLogger().info({
+            category: 'Nimbus',
+            message: `Collection "${collectionName}" exists. Updating collection ...`,
+        });
+        await updateCollection(db, allowUpdateIndexes, collectionDefinition);
+    }
+    else {
+        getLogger().info({
+            category: 'Nimbus',
+            message: `Collection "${collectionName}" does not exist. Creating collection ...`,
+        });
+        await createCollection(db, collectionDefinition);
+    }
+    return 'OK';
+};
+/**
+ * Checks if a collection exists in a database.
+ *
+ * @param {Db} db - The database to check.
+ * @param {MongoCollectionDefinition} collectionDefinition - The collection definition
+ * @returns {Promise<boolean>} Whether the collection exists.
+ */
+const collectionExists = async (db, { name }) => {
+    const collections = await db
+        .listCollections({ name: name }, { nameOnly: true })
+        .toArray();
+    return collections.some((item) => item.name === name);
+};
+/**
+ * Creates a collection in a database.
+ *
+ * @param {Db} db - The database to create the collection in.
+ * @param {MongoCollectionDefinition} collectionDefinition - The collection definition
+ */
+const createCollection = async (db, { name, options, indexes }) => {
+    await db.createCollection(name, options);
+    getLogger().info({
+        category: 'Nimbus',
+        message: `Collection "${name}" created.`,
+    });
+    if (indexes?.length) {
+        await db.collection(name).createIndexes(indexes);
+        getLogger().info({
+            category: 'Nimbus',
+            message: `Added ${indexes.length} indexes for collection "${name}".`,
+        });
+    }
+};
+/**
+ * Updates a collection in a database.
+ *
+ * @param {Db} db - The database to update the collection in.
+ * @param {boolean} allowUpdateIndexes - Whether to update indexes on existing collections
+ * @param {MongoCollectionDefinition} collectionDefinition - The collection definition
+ */
+const updateCollection = async (db, allowUpdateIndexes, { name, options, indexes }) => {
+    await db.command({ collMod: name, ...options });
+    getLogger().info({
+        category: 'Nimbus',
+        message: `Collection "${name}" updated.`,
+    });
+    if (allowUpdateIndexes) {
+        const indexesWithNames = (indexes ?? []).map((index) => {
+            if (index.name) {
+                return index;
+            }
+            return {
+                ...index,
+                name: Object.entries(index.key)
+                    .reduce((acc, [k, v]) => {
+                    return [...acc, `${k}_${String(v)}`];
+                }, [])
+                    .join('_'),
+            };
+        });
+        const existingIndexes = await (await db.collection(name).listIndexes().toArray())
+            .map((obj) => obj.name)
+            .filter((i) => i !== '_id_');
+        const indexesToAdd = indexesWithNames.filter((index) => {
+            return !existingIndexes.includes(index.name);
+        });
+        const indexesToDelete = existingIndexes.filter((existingIndex) => {
+            return !indexesWithNames.some((i) => i.name === existingIndex);
+        });
+        if (indexesToAdd.length) {
+            await db.collection(name).createIndexes(indexesToAdd);
+            getLogger().info({
+                category: 'Nimbus',
+                message: `Added ${indexesToAdd.length} indexes for collection "${name}".`,
+            });
+        }
+        if (indexesToDelete.length) {
+            await Promise.all(indexesToDelete?.map((index) => {
+                console.log(`Dropping ${index}`);
+                return db.collection(name).dropIndex(index);
+            }));
+            getLogger().info({
+                category: 'Nimbus',
+                message: `Deleted ${indexesToDelete.length} indexes for collection "${name}".`,
+            });
+        }
+    }
+};

package/esm/lib/handleMongoError.d.ts

@@ -0,0 +1,10 @@
+import { type Exception } from '../deps/jsr.io/@nimbus/core/2.0.0/src/index.js';
+/**
+ * Handles MongoDB errors and converts them
+ * to Nimbus exceptions based on the error code.
+ *
+ * @param {any} error - The error to handle.
+ * @returns {Exception} The Nimbus exception.
+ */
+export declare const handleMongoError: (error: any) => Exception;
+//# sourceMappingURL=handleMongoError.d.ts.map

package/esm/lib/handleMongoError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleMongoError.d.ts","sourceRoot":"","sources":["../../src/lib/handleMongoError.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,SAAS,EAGjB,MAAM,gDAAgD,CAAC;AAExD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,GAAG,KAAG,SAuB7C,CAAC"}

package/esm/lib/handleMongoError.js

@@ -0,0 +1,29 @@
+import { GenericException, InvalidInputException, } from '../deps/jsr.io/@nimbus/core/2.0.0/src/index.js';
+/**
+ * Handles MongoDB errors and converts them
+ * to Nimbus exceptions based on the error code.
+ *
+ * @param {any} error - The error to handle.
+ * @returns {Exception} The Nimbus exception.
+ */
+export const handleMongoError = (error) => {
+    if (error.code && error.code === 121) {
+        return new InvalidInputException(error.message, {
+            code: error.code,
+            ...(error.errInfo?.['details'] && {
+                details: error.errInfo?.['details'],
+            }),
+            ...(error.writeErrors && { writeErrors: error.writeErrors }),
+            ...(error.result && { result: error.result }),
+        }).fromError(error);
+    }
+    if (error.code && error.code === 2) {
+        return new InvalidInputException().fromError(error);
+    }
+    if (error.code && error.code === 11000) {
+        return new InvalidInputException(error.message, {
+            keyValue: error['keyValue'],
+        }).fromError(error);
+    }
+    return new GenericException().fromError(error);
+};

package/esm/lib/mongoConnectionManager.d.ts

@@ -0,0 +1,107 @@
+import { type Collection, type Db, MongoClient, type MongoClientOptions } from 'mongodb';
+/**
+ * Singleton wrapper around a single long-lived `MongoClient`.
+ *
+ * The MongoDB Node driver already handles connection pooling, server
+ * monitoring (SDAM), automatic reconnection, retryable reads/writes and
+ * per-socket idle eviction via `maxIdleTimeMS`. This class therefore does
+ * the minimum on top of the driver: hold one `MongoClient` for the lifetime
+ * of the application and provide typed `getDatabase` / `getCollection`
+ * convenience methods.
+ *
+ * Call {@link MongoConnectionManager#close} on graceful shutdown
+ * (e.g. on `SIGTERM` / `SIGINT`) to drain the pool.
+ *
+ * @example
+ * ```ts
+ * import { MongoConnectionManager } from '@nimbus/mongodb';
+ * import { ServerApiVersion } from 'mongodb';
+ *
+ * export const mongoManager = MongoConnectionManager.getInstance(
+ *     process.env['MONGO_URL'] ?? '',
+ *     {
+ *         appName: 'my-app',
+ *         serverApi: {
+ *             version: ServerApiVersion.v1,
+ *             strict: false,
+ *             deprecationErrors: true,
+ *         },
+ *     },
+ * );
+ *
+ * process.on('SIGTERM', () => {
+ *     mongoManager.close().catch(console.error);
+ * });
+ * ```
+ */
+export declare class MongoConnectionManager {
+    private static _instance;
+    private _client;
+    private _connecting;
+    private readonly _uri;
+    private readonly _options?;
+    /**
+     * Initialize the MongoConnectionManager.
+     *
+     * @param {string} uri - The MongoDB connection URI
+     * @param {MongoClientOptions} [options] - Options forwarded to the underlying `MongoClient`
+     */
+    private constructor();
+    /**
+     * Get the singleton instance of the MongoConnectionManager.
+     *
+     * Subsequent calls return the existing instance and ignore the arguments.
+     *
+     * @param {string} uri - The MongoDB connection URI
+     * @param {MongoClientOptions} [options] - Options forwarded to the underlying `MongoClient`
+     *
+     * @returns {MongoConnectionManager} The singleton instance of the MongoConnectionManager
+     */
+    static getInstance(uri: string, options?: MongoClientOptions): MongoConnectionManager;
+    /**
+     * Get the connected MongoDB client.
+     *
+     * Lazily creates and connects a single `MongoClient` on the first call.
+     * Concurrent first-callers share the same in-flight `connect()` promise
+     * so only one connection is established.
+     *
+     * @returns {Promise<MongoClient>} The MongoDB client instance
+     */
+    getClient(): Promise<MongoClient>;
+    /**
+     * Get a database instance from the connected MongoDB client.
+     *
+     * @param {string} dbName - The name of the database
+     * @returns {Promise<Db>} The database instance
+     */
+    getDatabase(dbName: string): Promise<Db>;
+    /**
+     * Get a collection instance from the connected MongoDB client.
+     *
+     * @param {string} dbName - The name of the database
+     * @param {string} collectionName - The name of the collection
+     * @returns {Promise<Collection>} The collection instance
+     */
+    getCollection(dbName: string, collectionName: string): Promise<Collection>;
+    /**
+     * Check the health of the MongoDB connection by issuing a `ping` against
+     * the `admin` database.
+     *
+     * @returns {Promise<{ status: 'healthy' | 'error'; details?: string }>} The health status and optional error details
+     */
+    healthCheck(): Promise<{
+        status: 'healthy' | 'error';
+        details?: string;
+    }>;
+    /**
+     * Close the underlying MongoDB client and drain its connection pool.
+     *
+     * Intended for graceful shutdown handlers. After `close()` resolves, the
+     * next call to {@link MongoConnectionManager#getClient} establishes a
+     * fresh connection.
+     *
+     * @returns {Promise<void>}
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=mongoConnectionManager.d.ts.map

package/esm/lib/mongoConnectionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongoConnectionManager.d.ts","sourceRoot":"","sources":["../../src/lib/mongoConnectionManager.ts"],"names":[],"mappings":"AACA,OAAO,EACH,KAAK,UAAU,EACf,KAAK,EAAE,EACP,WAAW,EACX,KAAK,kBAAkB,EAC1B,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAuC;IAC/D,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,WAAW,CAAqC;IACxD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAqB;IAE/C;;;;;OAKG;IACH,OAAO;IAKP;;;;;;;;;OASG;WACW,WAAW,CACrB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,kBAAkB,GAC7B,sBAAsB;IAWzB;;;;;;;;OAQG;IACI,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC;IAqCxC;;;;;OAKG;IACU,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC;IAKrD;;;;;;OAMG;IACU,aAAa,CACtB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,GACvB,OAAO,CAAC,UAAU,CAAC;IAKtB;;;;;OAKG;IACU,WAAW,IAAI,OAAO,CAC/B;QAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CACpD;IAeD;;;;;;;;OAQG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAqCtC"}