@xylabs/mongo 5.0.90 → 5.0.91

package/dist/browser/Base.d.ts

@@ -1,19 +1,75 @@
 import type { BulkWriteOptions, Collection, DeleteResult, Document, Filter, FindCursor, InsertOneOptions, MongoClient, OptionalUnlessRequiredId, ReplaceOptions, UpdateFilter, WithId } from 'mongodb';
 import type { BaseMongoSdkConfig } from './Config.js';
+/** Provides a typed wrapper around common MongoDB collection operations. */
 export declare class BaseMongoSdk<T extends Document> {
+    /** The MongoDB SDK configuration for this instance. */
     config: BaseMongoSdkConfig;
     constructor(config: BaseMongoSdkConfig);
+    /** Returns the MongoDB connection URI, either from the config or constructed from individual credential fields. */
     get uri(): string;
+    /**
+     * Deletes all documents matching the filter.
+     * @param filter - The query filter to match documents for deletion
+     */
     deleteMany(filter: Filter<T>): Promise<DeleteResult>;
+    /**
+     * Deletes the first document matching the filter.
+     * @param filter - The query filter to match a document for deletion
+     */
     deleteOne(filter: Filter<T>): Promise<DeleteResult>;
+    /**
+     * Finds all documents matching the filter and returns a cursor.
+     * @param filter - The query filter
+     */
     find(filter: Filter<T>): Promise<FindCursor<WithId<T>>>;
+    /**
+     * Finds a single document matching the filter.
+     * @param filter - The query filter
+     * @returns The matched document, or `null` if not found
+     */
     findOne(filter: Filter<T>): Promise<WithId<T> | null>;
+    /**
+     * Inserts multiple documents into the collection.
+     * @param items - The documents to insert
+     * @param options - Optional bulk write options
+     */
     insertMany(items: OptionalUnlessRequiredId<T>[], options?: BulkWriteOptions): Promise<import("mongodb").InsertManyResult<T>>;
+    /**
+     * Inserts a single document into the collection.
+     * @param item - The document to insert
+     * @param options - Optional insert options
+     */
     insertOne(item: OptionalUnlessRequiredId<T>, options?: InsertOneOptions): Promise<import("mongodb").InsertOneResult<T>>;
+    /**
+     * Replaces a single document matching the filter.
+     * @param filter - The query filter to match the document
+     * @param item - The replacement document
+     * @param options - Optional replace options
+     */
     replaceOne(filter: Filter<T>, item: OptionalUnlessRequiredId<T>, options?: ReplaceOptions): Promise<import("mongodb").UpdateResult<T>>;
+    /**
+     * Updates a single document matching the filter without upserting.
+     * @param filter - The query filter to match the document
+     * @param fields - The update operations to apply
+     */
     updateOne(filter: Filter<T>, fields: UpdateFilter<T>): Promise<import("mongodb").UpdateResult<T>>;
+    /**
+     * Updates a single document matching the filter, inserting it if it does not exist.
+     * @param filter - The query filter to match the document
+     * @param fields - The update operations to apply
+     */
     upsertOne(filter: Filter<T>, fields: UpdateFilter<T>): Promise<import("mongodb").UpdateResult<T>>;
+    /**
+     * Executes a callback with access to the configured MongoDB collection.
+     * @param func - A callback receiving the typed collection
+     * @returns The result of the callback
+     */
     useCollection<R>(func: (collection: Collection<T>) => Promise<R> | R): Promise<R>;
+    /**
+     * Executes a callback with a connected MongoClient, handling connection and disconnection.
+     * @param func - A callback receiving the connected MongoClient
+     * @returns The result of the callback
+     */
     useMongo<R>(func: (client: MongoClient) => Promise<R> | R): Promise<R>;
 }
 //# sourceMappingURL=Base.d.ts.map

package/dist/browser/Base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Base.d.ts","sourceRoot":"","sources":["../../src/Base.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,MAAM,EACP,MAAM,SAAS,CAAA;AAEhB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAGrD,qBAAa,YAAY,CAAC,CAAC,SAAS,QAAQ;IAC1C,MAAM,EAAE,kBAAkB,CAAA;gBAEd,MAAM,EAAE,kBAAkB;IAItC,IAAI,GAAG,WAMN;IAEK,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAM5B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAM3B,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAMtB,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAMzB,UAAU,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAM3E,SAAS,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAMvE,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc;IAMzF,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAMpD,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAMpD,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAMpE,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;CAUhE"}
+{"version":3,"file":"Base.d.ts","sourceRoot":"","sources":["../../src/Base.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,MAAM,EACP,MAAM,SAAS,CAAA;AAEhB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAGrD,4EAA4E;AAC5E,qBAAa,YAAY,CAAC,CAAC,SAAS,QAAQ;IAC1C,uDAAuD;IACvD,MAAM,EAAE,kBAAkB,CAAA;gBAEd,MAAM,EAAE,kBAAkB;IAItC,mHAAmH;IACnH,IAAI,GAAG,WAKN;IAED;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAMlC;;;OAGG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAMjC;;;OAGG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAM5B;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAM/B;;;;OAIG;IACG,UAAU,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAMjF;;;;OAIG;IACG,SAAS,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAM7E;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc;IAM/F;;;;OAIG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAM1D;;;;OAIG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAM1D;;;;OAIG;IACG,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAM1E;;;;OAIG;IACG,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;CAUhE"}

package/dist/browser/Config.d.ts

@@ -1,14 +1,25 @@
+/** Public configuration options for the Mongo SDK, safe to expose to clients. */
 export interface BaseMongoSdkPublicConfig {
+    /** Delay in milliseconds before closing idle connections. */
     closeDelay?: number;
+    /** The MongoDB collection name to operate on. */
     collection: string;
+    /** Maximum number of connections in the connection pool. */
     maxPoolSize?: number;
 }
+/** Private configuration options for the Mongo SDK containing connection credentials. */
 export interface BaseMongoSdkPrivateConfig {
+    /** A full MongoDB connection string, used instead of individual credential fields. */
     dbConnectionString?: string;
+    /** The MongoDB Atlas cluster domain. */
     dbDomain?: string;
+    /** The database name to connect to. */
     dbName?: string;
+    /** The password for MongoDB authentication. */
     dbPassword?: string;
+    /** The username for MongoDB authentication. */
     dbUserName?: string;
 }
+/** Combined public and private MongoDB SDK configuration. */
 export type BaseMongoSdkConfig = BaseMongoSdkPublicConfig & BaseMongoSdkPrivateConfig;
 //# sourceMappingURL=Config.d.ts.map

package/dist/browser/Config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Config.d.ts","sourceRoot":"","sources":["../../src/Config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,GAAG,yBAAyB,CAAA"}
+{"version":3,"file":"Config.d.ts","sourceRoot":"","sources":["../../src/Config.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,WAAW,wBAAwB;IACvC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAA;IAClB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,yFAAyF;AACzF,MAAM,WAAW,yBAAyB;IACxC,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,GAAG,yBAAyB,CAAA"}

package/dist/browser/Wrapper.d.ts

@@ -1,11 +1,23 @@
 import { MongoClient } from 'mongodb';
+/** Manages a shared pool of MongoClient instances, reusing connections by URI. */
 export declare class MongoClientWrapper {
+    /** Global cache of wrapper instances keyed by connection URI. */
     static readonly clients: Map<string, MongoClientWrapper>;
     private client;
     constructor(uri: string, maxPoolSize?: number, closeDelay?: number);
+    /**
+     * Gets or creates a cached MongoClientWrapper for the given URI.
+     * @param uri - The MongoDB connection URI
+     * @param poolSize - Maximum connection pool size
+     * @param closeDelay - Delay in milliseconds before closing idle connections
+     * @returns A cached or newly created wrapper instance
+     */
     static get(uri: string, poolSize?: number, closeDelay?: number): MongoClientWrapper;
+    /** Connects to MongoDB and returns the underlying MongoClient. */
     connect(): Promise<MongoClient>;
+    /** Disconnects from MongoDB. */
     disconnect(): Promise<number>;
+    /** Initiates a graceful close of the connection. */
     initiateClose(): Promise<void>;
 }
 //# sourceMappingURL=Wrapper.d.ts.map

package/dist/browser/Wrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Wrapper.d.ts","sourceRoot":"","sources":["../../src/Wrapper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAErC,qBAAa,kBAAkB;IAC7B,MAAM,CAAC,QAAQ,CAAC,OAAO,kCAAwC;IAE/D,OAAO,CAAC,MAAM,CAAa;gBAEf,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAKlE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IASxD,OAAO;IAIP,UAAU;IAIV,aAAa;CAGpB"}
+{"version":3,"file":"Wrapper.d.ts","sourceRoot":"","sources":["../../src/Wrapper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAErC,kFAAkF;AAClF,qBAAa,kBAAkB;IAC7B,iEAAiE;IACjE,MAAM,CAAC,QAAQ,CAAC,OAAO,kCAAwC;IAE/D,OAAO,CAAC,MAAM,CAAa;gBAEf,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAKlE;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAS9D,kEAAkE;IAC5D,OAAO;IAIb,gCAAgC;IAC1B,UAAU;IAIhB,oDAAoD;IAC9C,aAAa;CAGpB"}

package/dist/browser/index.mjs

@@ -4,12 +4,20 @@ import { assertEx } from "@xylabs/assert";
 // src/Wrapper.ts
 import { MongoClient } from "mongodb";
 var MongoClientWrapper = class _MongoClientWrapper {
+  /** Global cache of wrapper instances keyed by connection URI. */
   static clients = /* @__PURE__ */ new Map();
   client;
   constructor(uri, maxPoolSize, closeDelay) {
     const options = { maxPoolSize, maxIdleTimeMS: closeDelay };
     this.client = new MongoClient(uri, options);
   }
+  /**
+   * Gets or creates a cached MongoClientWrapper for the given URI.
+   * @param uri - The MongoDB connection URI
+   * @param poolSize - Maximum connection pool size
+   * @param closeDelay - Delay in milliseconds before closing idle connections
+   * @returns A cached or newly created wrapper instance
+   */
   static get(uri, poolSize, closeDelay) {
     let client = this.clients.get(uri);
     if (!client) {
@@ -18,12 +26,15 @@ var MongoClientWrapper = class _MongoClientWrapper {
     }
     return client;
   }
+  /** Connects to MongoDB and returns the underlying MongoClient. */
   async connect() {
     return await Promise.resolve(this.client);
   }
+  /** Disconnects from MongoDB. */
   async disconnect() {
     return await Promise.resolve(0);
   }
+  /** Initiates a graceful close of the connection. */
   async initiateClose() {
     await Promise.resolve();
   }
@@ -31,63 +42,118 @@ var MongoClientWrapper = class _MongoClientWrapper {
 
 // src/Base.ts
 var BaseMongoSdk = class {
+  /** The MongoDB SDK configuration for this instance. */
   config;
   constructor(config) {
     this.config = config;
   }
+  /** Returns the MongoDB connection URI, either from the config or constructed from individual credential fields. */
   get uri() {
     return this.config.dbConnectionString ?? `mongodb+srv://${this.config.dbUserName}:${this.config.dbPassword}@${this.config.dbDomain}.mongodb.net/${this.config.dbName}?retryWrites=true&w=majority`;
   }
+  /**
+   * Deletes all documents matching the filter.
+   * @param filter - The query filter to match documents for deletion
+   */
   async deleteMany(filter) {
     return await this.useCollection(async (collection) => {
       return await collection.deleteMany(filter);
     });
   }
+  /**
+   * Deletes the first document matching the filter.
+   * @param filter - The query filter to match a document for deletion
+   */
   async deleteOne(filter) {
     return await this.useCollection(async (collection) => {
       return await collection.deleteOne(filter);
     });
   }
+  /**
+   * Finds all documents matching the filter and returns a cursor.
+   * @param filter - The query filter
+   */
   async find(filter) {
     return await this.useCollection((collection) => {
       return collection.find(filter);
     });
   }
+  /**
+   * Finds a single document matching the filter.
+   * @param filter - The query filter
+   * @returns The matched document, or `null` if not found
+   */
   async findOne(filter) {
     return await this.useCollection(async (collection) => {
       return await collection.findOne(filter);
     });
   }
+  /**
+   * Inserts multiple documents into the collection.
+   * @param items - The documents to insert
+   * @param options - Optional bulk write options
+   */
   async insertMany(items, options) {
     return await this.useCollection(async (collection) => {
       return await collection.insertMany(items, options);
     });
   }
+  /**
+   * Inserts a single document into the collection.
+   * @param item - The document to insert
+   * @param options - Optional insert options
+   */
   async insertOne(item, options) {
     return await this.useCollection(async (collection) => {
       return await collection.insertOne(item, options);
     });
   }
+  /**
+   * Replaces a single document matching the filter.
+   * @param filter - The query filter to match the document
+   * @param item - The replacement document
+   * @param options - Optional replace options
+   */
   async replaceOne(filter, item, options) {
     return await this.useCollection(async (collection) => {
       return await collection.replaceOne(filter, item, options);
     });
   }
+  /**
+   * Updates a single document matching the filter without upserting.
+   * @param filter - The query filter to match the document
+   * @param fields - The update operations to apply
+   */
   async updateOne(filter, fields) {
     return await this.useCollection(async (collection) => {
       return await collection.updateOne(filter, fields, { upsert: false });
     });
   }
+  /**
+   * Updates a single document matching the filter, inserting it if it does not exist.
+   * @param filter - The query filter to match the document
+   * @param fields - The update operations to apply
+   */
   async upsertOne(filter, fields) {
     return await this.useCollection(async (collection) => {
       return await collection.updateOne(filter, fields, { upsert: true });
     });
   }
+  /**
+   * Executes a callback with access to the configured MongoDB collection.
+   * @param func - A callback receiving the typed collection
+   * @returns The result of the callback
+   */
   async useCollection(func) {
     return await this.useMongo(async (client) => {
       return await func(client.db(this.config.dbName).collection(this.config.collection));
     });
   }
+  /**
+   * Executes a callback with a connected MongoClient, handling connection and disconnection.
+   * @param func - A callback receiving the connected MongoClient
+   * @returns The result of the callback
+   */
   async useMongo(func) {
     const wrapper = MongoClientWrapper.get(this.uri, this.config.maxPoolSize, this.config.closeDelay);
     const connection = await wrapper.connect();

package/dist/browser/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/Base.ts","../../src/Wrapper.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport type {\n  BulkWriteOptions,\n  Collection,\n  DeleteResult,\n  Document,\n  Filter,\n  FindCursor,\n  InsertOneOptions,\n  MongoClient,\n  OptionalUnlessRequiredId,\n  ReplaceOptions,\n  UpdateFilter,\n  WithId,\n} from 'mongodb'\n\nimport type { BaseMongoSdkConfig } from './Config.js'\nimport { MongoClientWrapper } from './Wrapper.js'\n\nexport class BaseMongoSdk<T extends Document> {\n  config: BaseMongoSdkConfig\n\n  constructor(config: BaseMongoSdkConfig) {\n    this.config = config\n  }\n\n  get uri() {\n    return (\n      this.config.dbConnectionString\n      // eslint-disable-next-line @stylistic/max-len\n      ?? `mongodb+srv://${this.config.dbUserName}:${this.config.dbPassword}@${this.config.dbDomain}.mongodb.net/${this.config.dbName}?retryWrites=true&w=majority`\n    )\n  }\n\n  async deleteMany(filter: Filter<T>) {\n    return await this.useCollection<DeleteResult>(async (collection: Collection<T>) => {\n      return await collection.deleteMany(filter)\n    })\n  }\n\n  async deleteOne(filter: Filter<T>) {\n    return await this.useCollection<DeleteResult>(async (collection: Collection<T>) => {\n      return await collection.deleteOne(filter)\n    })\n  }\n\n  async find(filter: Filter<T>) {\n    return await this.useCollection<FindCursor<WithId<T>>>((collection: Collection<T>) => {\n      return collection.find(filter)\n    })\n  }\n\n  async findOne(filter: Filter<T>) {\n    return await this.useCollection<WithId<T> | null>(async (collection: Collection<T>) => {\n      return await collection.findOne(filter)\n    })\n  }\n\n  async insertMany(items: OptionalUnlessRequiredId<T>[], options?: BulkWriteOptions) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.insertMany(items, options)\n    })\n  }\n\n  async insertOne(item: OptionalUnlessRequiredId<T>, options?: InsertOneOptions) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.insertOne(item, options)\n    })\n  }\n\n  async replaceOne(filter: Filter<T>, item: OptionalUnlessRequiredId<T>, options?: ReplaceOptions) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.replaceOne(filter, item, options)\n    })\n  }\n\n  async updateOne(filter: Filter<T>, fields: UpdateFilter<T>) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.updateOne(filter, fields, { upsert: false })\n    })\n  }\n\n  async upsertOne(filter: Filter<T>, fields: UpdateFilter<T>) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.updateOne(filter, fields, { upsert: true })\n    })\n  }\n\n  async useCollection<R>(func: (collection: Collection<T>) => Promise<R> | R) {\n    return await this.useMongo<R>(async (client: MongoClient) => {\n      return await func(client.db(this.config.dbName).collection<T>(this.config.collection))\n    })\n  }\n\n  async useMongo<R>(func: (client: MongoClient) => Promise<R> | R) {\n    const wrapper = MongoClientWrapper.get(this.uri, this.config.maxPoolSize, this.config.closeDelay)\n    const connection = await wrapper.connect()\n    assertEx(connection, () => 'Connection failed')\n    try {\n      return await func(connection)\n    } finally {\n      await wrapper.disconnect()\n    }\n  }\n}\n","import type { MongoClientOptions } from 'mongodb'\nimport { MongoClient } from 'mongodb'\n\nexport class MongoClientWrapper {\n  static readonly clients = new Map<string, MongoClientWrapper>()\n\n  private client: MongoClient\n\n  constructor(uri: string, maxPoolSize?: number, closeDelay?: number) {\n    const options: MongoClientOptions = { maxPoolSize, maxIdleTimeMS: closeDelay }\n    this.client = new MongoClient(uri, options)\n  }\n\n  static get(uri: string, poolSize?: number, closeDelay?: number) {\n    let client = this.clients.get(uri)\n    if (!client) {\n      client = new MongoClientWrapper(uri, poolSize, closeDelay)\n      this.clients.set(uri, client)\n    }\n    return client\n  }\n\n  async connect() {\n    return await Promise.resolve(this.client)\n  }\n\n  async disconnect() {\n    return await Promise.resolve(0)\n  }\n\n  async initiateClose() {\n    await Promise.resolve()\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/Base.ts","../../src/Wrapper.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport type {\n  BulkWriteOptions,\n  Collection,\n  DeleteResult,\n  Document,\n  Filter,\n  FindCursor,\n  InsertOneOptions,\n  MongoClient,\n  OptionalUnlessRequiredId,\n  ReplaceOptions,\n  UpdateFilter,\n  WithId,\n} from 'mongodb'\n\nimport type { BaseMongoSdkConfig } from './Config.js'\nimport { MongoClientWrapper } from './Wrapper.js'\n\n/** Provides a typed wrapper around common MongoDB collection operations. */\nexport class BaseMongoSdk<T extends Document> {\n  /** The MongoDB SDK configuration for this instance. */\n  config: BaseMongoSdkConfig\n\n  constructor(config: BaseMongoSdkConfig) {\n    this.config = config\n  }\n\n  /** Returns the MongoDB connection URI, either from the config or constructed from individual credential fields. */\n  get uri() {\n    return (\n      this.config.dbConnectionString\n      ?? `mongodb+srv://${this.config.dbUserName}:${this.config.dbPassword}@${this.config.dbDomain}.mongodb.net/${this.config.dbName}?retryWrites=true&w=majority`\n    )\n  }\n\n  /**\n   * Deletes all documents matching the filter.\n   * @param filter - The query filter to match documents for deletion\n   */\n  async deleteMany(filter: Filter<T>) {\n    return await this.useCollection<DeleteResult>(async (collection: Collection<T>) => {\n      return await collection.deleteMany(filter)\n    })\n  }\n\n  /**\n   * Deletes the first document matching the filter.\n   * @param filter - The query filter to match a document for deletion\n   */\n  async deleteOne(filter: Filter<T>) {\n    return await this.useCollection<DeleteResult>(async (collection: Collection<T>) => {\n      return await collection.deleteOne(filter)\n    })\n  }\n\n  /**\n   * Finds all documents matching the filter and returns a cursor.\n   * @param filter - The query filter\n   */\n  async find(filter: Filter<T>) {\n    return await this.useCollection<FindCursor<WithId<T>>>((collection: Collection<T>) => {\n      return collection.find(filter)\n    })\n  }\n\n  /**\n   * Finds a single document matching the filter.\n   * @param filter - The query filter\n   * @returns The matched document, or `null` if not found\n   */\n  async findOne(filter: Filter<T>) {\n    return await this.useCollection<WithId<T> | null>(async (collection: Collection<T>) => {\n      return await collection.findOne(filter)\n    })\n  }\n\n  /**\n   * Inserts multiple documents into the collection.\n   * @param items - The documents to insert\n   * @param options - Optional bulk write options\n   */\n  async insertMany(items: OptionalUnlessRequiredId<T>[], options?: BulkWriteOptions) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.insertMany(items, options)\n    })\n  }\n\n  /**\n   * Inserts a single document into the collection.\n   * @param item - The document to insert\n   * @param options - Optional insert options\n   */\n  async insertOne(item: OptionalUnlessRequiredId<T>, options?: InsertOneOptions) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.insertOne(item, options)\n    })\n  }\n\n  /**\n   * Replaces a single document matching the filter.\n   * @param filter - The query filter to match the document\n   * @param item - The replacement document\n   * @param options - Optional replace options\n   */\n  async replaceOne(filter: Filter<T>, item: OptionalUnlessRequiredId<T>, options?: ReplaceOptions) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.replaceOne(filter, item, options)\n    })\n  }\n\n  /**\n   * Updates a single document matching the filter without upserting.\n   * @param filter - The query filter to match the document\n   * @param fields - The update operations to apply\n   */\n  async updateOne(filter: Filter<T>, fields: UpdateFilter<T>) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.updateOne(filter, fields, { upsert: false })\n    })\n  }\n\n  /**\n   * Updates a single document matching the filter, inserting it if it does not exist.\n   * @param filter - The query filter to match the document\n   * @param fields - The update operations to apply\n   */\n  async upsertOne(filter: Filter<T>, fields: UpdateFilter<T>) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.updateOne(filter, fields, { upsert: true })\n    })\n  }\n\n  /**\n   * Executes a callback with access to the configured MongoDB collection.\n   * @param func - A callback receiving the typed collection\n   * @returns The result of the callback\n   */\n  async useCollection<R>(func: (collection: Collection<T>) => Promise<R> | R) {\n    return await this.useMongo<R>(async (client: MongoClient) => {\n      return await func(client.db(this.config.dbName).collection<T>(this.config.collection))\n    })\n  }\n\n  /**\n   * Executes a callback with a connected MongoClient, handling connection and disconnection.\n   * @param func - A callback receiving the connected MongoClient\n   * @returns The result of the callback\n   */\n  async useMongo<R>(func: (client: MongoClient) => Promise<R> | R) {\n    const wrapper = MongoClientWrapper.get(this.uri, this.config.maxPoolSize, this.config.closeDelay)\n    const connection = await wrapper.connect()\n    assertEx(connection, () => 'Connection failed')\n    try {\n      return await func(connection)\n    } finally {\n      await wrapper.disconnect()\n    }\n  }\n}\n","import type { MongoClientOptions } from 'mongodb'\nimport { MongoClient } from 'mongodb'\n\n/** Manages a shared pool of MongoClient instances, reusing connections by URI. */\nexport class MongoClientWrapper {\n  /** Global cache of wrapper instances keyed by connection URI. */\n  static readonly clients = new Map<string, MongoClientWrapper>()\n\n  private client: MongoClient\n\n  constructor(uri: string, maxPoolSize?: number, closeDelay?: number) {\n    const options: MongoClientOptions = { maxPoolSize, maxIdleTimeMS: closeDelay }\n    this.client = new MongoClient(uri, options)\n  }\n\n  /**\n   * Gets or creates a cached MongoClientWrapper for the given URI.\n   * @param uri - The MongoDB connection URI\n   * @param poolSize - Maximum connection pool size\n   * @param closeDelay - Delay in milliseconds before closing idle connections\n   * @returns A cached or newly created wrapper instance\n   */\n  static get(uri: string, poolSize?: number, closeDelay?: number) {\n    let client = this.clients.get(uri)\n    if (!client) {\n      client = new MongoClientWrapper(uri, poolSize, closeDelay)\n      this.clients.set(uri, client)\n    }\n    return client\n  }\n\n  /** Connects to MongoDB and returns the underlying MongoClient. */\n  async connect() {\n    return await Promise.resolve(this.client)\n  }\n\n  /** Disconnects from MongoDB. */\n  async disconnect() {\n    return await Promise.resolve(0)\n  }\n\n  /** Initiates a graceful close of the connection. */\n  async initiateClose() {\n    await Promise.resolve()\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/neutral/Base.d.ts

@@ -1,19 +1,75 @@
 import type { BulkWriteOptions, Collection, DeleteResult, Document, Filter, FindCursor, InsertOneOptions, MongoClient, OptionalUnlessRequiredId, ReplaceOptions, UpdateFilter, WithId } from 'mongodb';
 import type { BaseMongoSdkConfig } from './Config.js';
+/** Provides a typed wrapper around common MongoDB collection operations. */
 export declare class BaseMongoSdk<T extends Document> {
+    /** The MongoDB SDK configuration for this instance. */
     config: BaseMongoSdkConfig;
     constructor(config: BaseMongoSdkConfig);
+    /** Returns the MongoDB connection URI, either from the config or constructed from individual credential fields. */
     get uri(): string;
+    /**
+     * Deletes all documents matching the filter.
+     * @param filter - The query filter to match documents for deletion
+     */
     deleteMany(filter: Filter<T>): Promise<DeleteResult>;
+    /**
+     * Deletes the first document matching the filter.
+     * @param filter - The query filter to match a document for deletion
+     */
     deleteOne(filter: Filter<T>): Promise<DeleteResult>;
+    /**
+     * Finds all documents matching the filter and returns a cursor.
+     * @param filter - The query filter
+     */
     find(filter: Filter<T>): Promise<FindCursor<WithId<T>>>;
+    /**
+     * Finds a single document matching the filter.
+     * @param filter - The query filter
+     * @returns The matched document, or `null` if not found
+     */
     findOne(filter: Filter<T>): Promise<WithId<T> | null>;
+    /**
+     * Inserts multiple documents into the collection.
+     * @param items - The documents to insert
+     * @param options - Optional bulk write options
+     */
     insertMany(items: OptionalUnlessRequiredId<T>[], options?: BulkWriteOptions): Promise<import("mongodb").InsertManyResult<T>>;
+    /**
+     * Inserts a single document into the collection.
+     * @param item - The document to insert
+     * @param options - Optional insert options
+     */
     insertOne(item: OptionalUnlessRequiredId<T>, options?: InsertOneOptions): Promise<import("mongodb").InsertOneResult<T>>;
+    /**
+     * Replaces a single document matching the filter.
+     * @param filter - The query filter to match the document
+     * @param item - The replacement document
+     * @param options - Optional replace options
+     */
     replaceOne(filter: Filter<T>, item: OptionalUnlessRequiredId<T>, options?: ReplaceOptions): Promise<import("mongodb").UpdateResult<T>>;
+    /**
+     * Updates a single document matching the filter without upserting.
+     * @param filter - The query filter to match the document
+     * @param fields - The update operations to apply
+     */
     updateOne(filter: Filter<T>, fields: UpdateFilter<T>): Promise<import("mongodb").UpdateResult<T>>;
+    /**
+     * Updates a single document matching the filter, inserting it if it does not exist.
+     * @param filter - The query filter to match the document
+     * @param fields - The update operations to apply
+     */
     upsertOne(filter: Filter<T>, fields: UpdateFilter<T>): Promise<import("mongodb").UpdateResult<T>>;
+    /**
+     * Executes a callback with access to the configured MongoDB collection.
+     * @param func - A callback receiving the typed collection
+     * @returns The result of the callback
+     */
     useCollection<R>(func: (collection: Collection<T>) => Promise<R> | R): Promise<R>;
+    /**
+     * Executes a callback with a connected MongoClient, handling connection and disconnection.
+     * @param func - A callback receiving the connected MongoClient
+     * @returns The result of the callback
+     */
     useMongo<R>(func: (client: MongoClient) => Promise<R> | R): Promise<R>;
 }
 //# sourceMappingURL=Base.d.ts.map

package/dist/neutral/Base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Base.d.ts","sourceRoot":"","sources":["../../src/Base.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,MAAM,EACP,MAAM,SAAS,CAAA;AAEhB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAGrD,qBAAa,YAAY,CAAC,CAAC,SAAS,QAAQ;IAC1C,MAAM,EAAE,kBAAkB,CAAA;gBAEd,MAAM,EAAE,kBAAkB;IAItC,IAAI,GAAG,WAMN;IAEK,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAM5B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAM3B,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAMtB,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAMzB,UAAU,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAM3E,SAAS,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAMvE,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc;IAMzF,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAMpD,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAMpD,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAMpE,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;CAUhE"}
+{"version":3,"file":"Base.d.ts","sourceRoot":"","sources":["../../src/Base.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,MAAM,EACP,MAAM,SAAS,CAAA;AAEhB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAGrD,4EAA4E;AAC5E,qBAAa,YAAY,CAAC,CAAC,SAAS,QAAQ;IAC1C,uDAAuD;IACvD,MAAM,EAAE,kBAAkB,CAAA;gBAEd,MAAM,EAAE,kBAAkB;IAItC,mHAAmH;IACnH,IAAI,GAAG,WAKN;IAED;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAMlC;;;OAGG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAMjC;;;OAGG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAM5B;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAM/B;;;;OAIG;IACG,UAAU,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAMjF;;;;OAIG;IACG,SAAS,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAM7E;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc;IAM/F;;;;OAIG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAM1D;;;;OAIG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAM1D;;;;OAIG;IACG,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAM1E;;;;OAIG;IACG,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;CAUhE"}

package/dist/neutral/Config.d.ts

@@ -1,14 +1,25 @@
+/** Public configuration options for the Mongo SDK, safe to expose to clients. */
 export interface BaseMongoSdkPublicConfig {
+    /** Delay in milliseconds before closing idle connections. */
     closeDelay?: number;
+    /** The MongoDB collection name to operate on. */
     collection: string;
+    /** Maximum number of connections in the connection pool. */
     maxPoolSize?: number;
 }
+/** Private configuration options for the Mongo SDK containing connection credentials. */
 export interface BaseMongoSdkPrivateConfig {
+    /** A full MongoDB connection string, used instead of individual credential fields. */
     dbConnectionString?: string;
+    /** The MongoDB Atlas cluster domain. */
     dbDomain?: string;
+    /** The database name to connect to. */
     dbName?: string;
+    /** The password for MongoDB authentication. */
     dbPassword?: string;
+    /** The username for MongoDB authentication. */
     dbUserName?: string;
 }
+/** Combined public and private MongoDB SDK configuration. */
 export type BaseMongoSdkConfig = BaseMongoSdkPublicConfig & BaseMongoSdkPrivateConfig;
 //# sourceMappingURL=Config.d.ts.map

package/dist/neutral/Config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Config.d.ts","sourceRoot":"","sources":["../../src/Config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,GAAG,yBAAyB,CAAA"}
+{"version":3,"file":"Config.d.ts","sourceRoot":"","sources":["../../src/Config.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,WAAW,wBAAwB;IACvC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAA;IAClB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,yFAAyF;AACzF,MAAM,WAAW,yBAAyB;IACxC,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,GAAG,yBAAyB,CAAA"}

package/dist/neutral/Wrapper.d.ts

@@ -1,11 +1,23 @@
 import { MongoClient } from 'mongodb';
+/** Manages a shared pool of MongoClient instances, reusing connections by URI. */
 export declare class MongoClientWrapper {
+    /** Global cache of wrapper instances keyed by connection URI. */
     static readonly clients: Map<string, MongoClientWrapper>;
     private client;
     constructor(uri: string, maxPoolSize?: number, closeDelay?: number);
+    /**
+     * Gets or creates a cached MongoClientWrapper for the given URI.
+     * @param uri - The MongoDB connection URI
+     * @param poolSize - Maximum connection pool size
+     * @param closeDelay - Delay in milliseconds before closing idle connections
+     * @returns A cached or newly created wrapper instance
+     */
     static get(uri: string, poolSize?: number, closeDelay?: number): MongoClientWrapper;
+    /** Connects to MongoDB and returns the underlying MongoClient. */
     connect(): Promise<MongoClient>;
+    /** Disconnects from MongoDB. */
     disconnect(): Promise<number>;
+    /** Initiates a graceful close of the connection. */
     initiateClose(): Promise<void>;
 }
 //# sourceMappingURL=Wrapper.d.ts.map

package/dist/neutral/Wrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Wrapper.d.ts","sourceRoot":"","sources":["../../src/Wrapper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAErC,qBAAa,kBAAkB;IAC7B,MAAM,CAAC,QAAQ,CAAC,OAAO,kCAAwC;IAE/D,OAAO,CAAC,MAAM,CAAa;gBAEf,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAKlE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IASxD,OAAO;IAIP,UAAU;IAIV,aAAa;CAGpB"}
+{"version":3,"file":"Wrapper.d.ts","sourceRoot":"","sources":["../../src/Wrapper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAErC,kFAAkF;AAClF,qBAAa,kBAAkB;IAC7B,iEAAiE;IACjE,MAAM,CAAC,QAAQ,CAAC,OAAO,kCAAwC;IAE/D,OAAO,CAAC,MAAM,CAAa;gBAEf,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAKlE;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAS9D,kEAAkE;IAC5D,OAAO;IAIb,gCAAgC;IAC1B,UAAU;IAIhB,oDAAoD;IAC9C,aAAa;CAGpB"}

package/dist/neutral/index.mjs

@@ -4,12 +4,20 @@ import { assertEx } from "@xylabs/assert";
 // src/Wrapper.ts
 import { MongoClient } from "mongodb";
 var MongoClientWrapper = class _MongoClientWrapper {
+  /** Global cache of wrapper instances keyed by connection URI. */
   static clients = /* @__PURE__ */ new Map();
   client;
   constructor(uri, maxPoolSize, closeDelay) {
     const options = { maxPoolSize, maxIdleTimeMS: closeDelay };
     this.client = new MongoClient(uri, options);
   }
+  /**
+   * Gets or creates a cached MongoClientWrapper for the given URI.
+   * @param uri - The MongoDB connection URI
+   * @param poolSize - Maximum connection pool size
+   * @param closeDelay - Delay in milliseconds before closing idle connections
+   * @returns A cached or newly created wrapper instance
+   */
   static get(uri, poolSize, closeDelay) {
     let client = this.clients.get(uri);
     if (!client) {
@@ -18,12 +26,15 @@ var MongoClientWrapper = class _MongoClientWrapper {
     }
     return client;
   }
+  /** Connects to MongoDB and returns the underlying MongoClient. */
   async connect() {
     return await Promise.resolve(this.client);
   }
+  /** Disconnects from MongoDB. */
   async disconnect() {
     return await Promise.resolve(0);
   }
+  /** Initiates a graceful close of the connection. */
   async initiateClose() {
     await Promise.resolve();
   }
@@ -31,63 +42,118 @@ var MongoClientWrapper = class _MongoClientWrapper {
 
 // src/Base.ts
 var BaseMongoSdk = class {
+  /** The MongoDB SDK configuration for this instance. */
   config;
   constructor(config) {
     this.config = config;
   }
+  /** Returns the MongoDB connection URI, either from the config or constructed from individual credential fields. */
   get uri() {
     return this.config.dbConnectionString ?? `mongodb+srv://${this.config.dbUserName}:${this.config.dbPassword}@${this.config.dbDomain}.mongodb.net/${this.config.dbName}?retryWrites=true&w=majority`;
   }
+  /**
+   * Deletes all documents matching the filter.
+   * @param filter - The query filter to match documents for deletion
+   */
   async deleteMany(filter) {
     return await this.useCollection(async (collection) => {
       return await collection.deleteMany(filter);
     });
   }
+  /**
+   * Deletes the first document matching the filter.
+   * @param filter - The query filter to match a document for deletion
+   */
   async deleteOne(filter) {
     return await this.useCollection(async (collection) => {
       return await collection.deleteOne(filter);
     });
   }
+  /**
+   * Finds all documents matching the filter and returns a cursor.
+   * @param filter - The query filter
+   */
   async find(filter) {
     return await this.useCollection((collection) => {
       return collection.find(filter);
     });
   }
+  /**
+   * Finds a single document matching the filter.
+   * @param filter - The query filter
+   * @returns The matched document, or `null` if not found
+   */
   async findOne(filter) {
     return await this.useCollection(async (collection) => {
       return await collection.findOne(filter);
     });
   }
+  /**
+   * Inserts multiple documents into the collection.
+   * @param items - The documents to insert
+   * @param options - Optional bulk write options
+   */
   async insertMany(items, options) {
     return await this.useCollection(async (collection) => {
       return await collection.insertMany(items, options);
     });
   }
+  /**
+   * Inserts a single document into the collection.
+   * @param item - The document to insert
+   * @param options - Optional insert options
+   */
   async insertOne(item, options) {
     return await this.useCollection(async (collection) => {
       return await collection.insertOne(item, options);
     });
   }
+  /**
+   * Replaces a single document matching the filter.
+   * @param filter - The query filter to match the document
+   * @param item - The replacement document
+   * @param options - Optional replace options
+   */
   async replaceOne(filter, item, options) {
     return await this.useCollection(async (collection) => {
       return await collection.replaceOne(filter, item, options);
     });
   }
+  /**
+   * Updates a single document matching the filter without upserting.
+   * @param filter - The query filter to match the document
+   * @param fields - The update operations to apply
+   */
   async updateOne(filter, fields) {
     return await this.useCollection(async (collection) => {
       return await collection.updateOne(filter, fields, { upsert: false });
     });
   }
+  /**
+   * Updates a single document matching the filter, inserting it if it does not exist.
+   * @param filter - The query filter to match the document
+   * @param fields - The update operations to apply
+   */
   async upsertOne(filter, fields) {
     return await this.useCollection(async (collection) => {
       return await collection.updateOne(filter, fields, { upsert: true });
     });
   }
+  /**
+   * Executes a callback with access to the configured MongoDB collection.
+   * @param func - A callback receiving the typed collection
+   * @returns The result of the callback
+   */
   async useCollection(func) {
     return await this.useMongo(async (client) => {
       return await func(client.db(this.config.dbName).collection(this.config.collection));
     });
   }
+  /**
+   * Executes a callback with a connected MongoClient, handling connection and disconnection.
+   * @param func - A callback receiving the connected MongoClient
+   * @returns The result of the callback
+   */
   async useMongo(func) {
     const wrapper = MongoClientWrapper.get(this.uri, this.config.maxPoolSize, this.config.closeDelay);
     const connection = await wrapper.connect();

package/dist/neutral/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/Base.ts","../../src/Wrapper.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport type {\n  BulkWriteOptions,\n  Collection,\n  DeleteResult,\n  Document,\n  Filter,\n  FindCursor,\n  InsertOneOptions,\n  MongoClient,\n  OptionalUnlessRequiredId,\n  ReplaceOptions,\n  UpdateFilter,\n  WithId,\n} from 'mongodb'\n\nimport type { BaseMongoSdkConfig } from './Config.js'\nimport { MongoClientWrapper } from './Wrapper.js'\n\nexport class BaseMongoSdk<T extends Document> {\n  config: BaseMongoSdkConfig\n\n  constructor(config: BaseMongoSdkConfig) {\n    this.config = config\n  }\n\n  get uri() {\n    return (\n      this.config.dbConnectionString\n      // eslint-disable-next-line @stylistic/max-len\n      ?? `mongodb+srv://${this.config.dbUserName}:${this.config.dbPassword}@${this.config.dbDomain}.mongodb.net/${this.config.dbName}?retryWrites=true&w=majority`\n    )\n  }\n\n  async deleteMany(filter: Filter<T>) {\n    return await this.useCollection<DeleteResult>(async (collection: Collection<T>) => {\n      return await collection.deleteMany(filter)\n    })\n  }\n\n  async deleteOne(filter: Filter<T>) {\n    return await this.useCollection<DeleteResult>(async (collection: Collection<T>) => {\n      return await collection.deleteOne(filter)\n    })\n  }\n\n  async find(filter: Filter<T>) {\n    return await this.useCollection<FindCursor<WithId<T>>>((collection: Collection<T>) => {\n      return collection.find(filter)\n    })\n  }\n\n  async findOne(filter: Filter<T>) {\n    return await this.useCollection<WithId<T> | null>(async (collection: Collection<T>) => {\n      return await collection.findOne(filter)\n    })\n  }\n\n  async insertMany(items: OptionalUnlessRequiredId<T>[], options?: BulkWriteOptions) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.insertMany(items, options)\n    })\n  }\n\n  async insertOne(item: OptionalUnlessRequiredId<T>, options?: InsertOneOptions) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.insertOne(item, options)\n    })\n  }\n\n  async replaceOne(filter: Filter<T>, item: OptionalUnlessRequiredId<T>, options?: ReplaceOptions) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.replaceOne(filter, item, options)\n    })\n  }\n\n  async updateOne(filter: Filter<T>, fields: UpdateFilter<T>) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.updateOne(filter, fields, { upsert: false })\n    })\n  }\n\n  async upsertOne(filter: Filter<T>, fields: UpdateFilter<T>) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.updateOne(filter, fields, { upsert: true })\n    })\n  }\n\n  async useCollection<R>(func: (collection: Collection<T>) => Promise<R> | R) {\n    return await this.useMongo<R>(async (client: MongoClient) => {\n      return await func(client.db(this.config.dbName).collection<T>(this.config.collection))\n    })\n  }\n\n  async useMongo<R>(func: (client: MongoClient) => Promise<R> | R) {\n    const wrapper = MongoClientWrapper.get(this.uri, this.config.maxPoolSize, this.config.closeDelay)\n    const connection = await wrapper.connect()\n    assertEx(connection, () => 'Connection failed')\n    try {\n      return await func(connection)\n    } finally {\n      await wrapper.disconnect()\n    }\n  }\n}\n","import type { MongoClientOptions } from 'mongodb'\nimport { MongoClient } from 'mongodb'\n\nexport class MongoClientWrapper {\n  static readonly clients = new Map<string, MongoClientWrapper>()\n\n  private client: MongoClient\n\n  constructor(uri: string, maxPoolSize?: number, closeDelay?: number) {\n    const options: MongoClientOptions = { maxPoolSize, maxIdleTimeMS: closeDelay }\n    this.client = new MongoClient(uri, options)\n  }\n\n  static get(uri: string, poolSize?: number, closeDelay?: number) {\n    let client = this.clients.get(uri)\n    if (!client) {\n      client = new MongoClientWrapper(uri, poolSize, closeDelay)\n      this.clients.set(uri, client)\n    }\n    return client\n  }\n\n  async connect() {\n    return await Promise.resolve(this.client)\n  }\n\n  async disconnect() {\n    return await Promise.resolve(0)\n  }\n\n  async initiateClose() {\n    await Promise.resolve()\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/Base.ts","../../src/Wrapper.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport type {\n  BulkWriteOptions,\n  Collection,\n  DeleteResult,\n  Document,\n  Filter,\n  FindCursor,\n  InsertOneOptions,\n  MongoClient,\n  OptionalUnlessRequiredId,\n  ReplaceOptions,\n  UpdateFilter,\n  WithId,\n} from 'mongodb'\n\nimport type { BaseMongoSdkConfig } from './Config.js'\nimport { MongoClientWrapper } from './Wrapper.js'\n\n/** Provides a typed wrapper around common MongoDB collection operations. */\nexport class BaseMongoSdk<T extends Document> {\n  /** The MongoDB SDK configuration for this instance. */\n  config: BaseMongoSdkConfig\n\n  constructor(config: BaseMongoSdkConfig) {\n    this.config = config\n  }\n\n  /** Returns the MongoDB connection URI, either from the config or constructed from individual credential fields. */\n  get uri() {\n    return (\n      this.config.dbConnectionString\n      ?? `mongodb+srv://${this.config.dbUserName}:${this.config.dbPassword}@${this.config.dbDomain}.mongodb.net/${this.config.dbName}?retryWrites=true&w=majority`\n    )\n  }\n\n  /**\n   * Deletes all documents matching the filter.\n   * @param filter - The query filter to match documents for deletion\n   */\n  async deleteMany(filter: Filter<T>) {\n    return await this.useCollection<DeleteResult>(async (collection: Collection<T>) => {\n      return await collection.deleteMany(filter)\n    })\n  }\n\n  /**\n   * Deletes the first document matching the filter.\n   * @param filter - The query filter to match a document for deletion\n   */\n  async deleteOne(filter: Filter<T>) {\n    return await this.useCollection<DeleteResult>(async (collection: Collection<T>) => {\n      return await collection.deleteOne(filter)\n    })\n  }\n\n  /**\n   * Finds all documents matching the filter and returns a cursor.\n   * @param filter - The query filter\n   */\n  async find(filter: Filter<T>) {\n    return await this.useCollection<FindCursor<WithId<T>>>((collection: Collection<T>) => {\n      return collection.find(filter)\n    })\n  }\n\n  /**\n   * Finds a single document matching the filter.\n   * @param filter - The query filter\n   * @returns The matched document, or `null` if not found\n   */\n  async findOne(filter: Filter<T>) {\n    return await this.useCollection<WithId<T> | null>(async (collection: Collection<T>) => {\n      return await collection.findOne(filter)\n    })\n  }\n\n  /**\n   * Inserts multiple documents into the collection.\n   * @param items - The documents to insert\n   * @param options - Optional bulk write options\n   */\n  async insertMany(items: OptionalUnlessRequiredId<T>[], options?: BulkWriteOptions) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.insertMany(items, options)\n    })\n  }\n\n  /**\n   * Inserts a single document into the collection.\n   * @param item - The document to insert\n   * @param options - Optional insert options\n   */\n  async insertOne(item: OptionalUnlessRequiredId<T>, options?: InsertOneOptions) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.insertOne(item, options)\n    })\n  }\n\n  /**\n   * Replaces a single document matching the filter.\n   * @param filter - The query filter to match the document\n   * @param item - The replacement document\n   * @param options - Optional replace options\n   */\n  async replaceOne(filter: Filter<T>, item: OptionalUnlessRequiredId<T>, options?: ReplaceOptions) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.replaceOne(filter, item, options)\n    })\n  }\n\n  /**\n   * Updates a single document matching the filter without upserting.\n   * @param filter - The query filter to match the document\n   * @param fields - The update operations to apply\n   */\n  async updateOne(filter: Filter<T>, fields: UpdateFilter<T>) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.updateOne(filter, fields, { upsert: false })\n    })\n  }\n\n  /**\n   * Updates a single document matching the filter, inserting it if it does not exist.\n   * @param filter - The query filter to match the document\n   * @param fields - The update operations to apply\n   */\n  async upsertOne(filter: Filter<T>, fields: UpdateFilter<T>) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.updateOne(filter, fields, { upsert: true })\n    })\n  }\n\n  /**\n   * Executes a callback with access to the configured MongoDB collection.\n   * @param func - A callback receiving the typed collection\n   * @returns The result of the callback\n   */\n  async useCollection<R>(func: (collection: Collection<T>) => Promise<R> | R) {\n    return await this.useMongo<R>(async (client: MongoClient) => {\n      return await func(client.db(this.config.dbName).collection<T>(this.config.collection))\n    })\n  }\n\n  /**\n   * Executes a callback with a connected MongoClient, handling connection and disconnection.\n   * @param func - A callback receiving the connected MongoClient\n   * @returns The result of the callback\n   */\n  async useMongo<R>(func: (client: MongoClient) => Promise<R> | R) {\n    const wrapper = MongoClientWrapper.get(this.uri, this.config.maxPoolSize, this.config.closeDelay)\n    const connection = await wrapper.connect()\n    assertEx(connection, () => 'Connection failed')\n    try {\n      return await func(connection)\n    } finally {\n      await wrapper.disconnect()\n    }\n  }\n}\n","import type { MongoClientOptions } from 'mongodb'\nimport { MongoClient } from 'mongodb'\n\n/** Manages a shared pool of MongoClient instances, reusing connections by URI. */\nexport class MongoClientWrapper {\n  /** Global cache of wrapper instances keyed by connection URI. */\n  static readonly clients = new Map<string, MongoClientWrapper>()\n\n  private client: MongoClient\n\n  constructor(uri: string, maxPoolSize?: number, closeDelay?: number) {\n    const options: MongoClientOptions = { maxPoolSize, maxIdleTimeMS: closeDelay }\n    this.client = new MongoClient(uri, options)\n  }\n\n  /**\n   * Gets or creates a cached MongoClientWrapper for the given URI.\n   * @param uri - The MongoDB connection URI\n   * @param poolSize - Maximum connection pool size\n   * @param closeDelay - Delay in milliseconds before closing idle connections\n   * @returns A cached or newly created wrapper instance\n   */\n  static get(uri: string, poolSize?: number, closeDelay?: number) {\n    let client = this.clients.get(uri)\n    if (!client) {\n      client = new MongoClientWrapper(uri, poolSize, closeDelay)\n      this.clients.set(uri, client)\n    }\n    return client\n  }\n\n  /** Connects to MongoDB and returns the underlying MongoClient. */\n  async connect() {\n    return await Promise.resolve(this.client)\n  }\n\n  /** Disconnects from MongoDB. */\n  async disconnect() {\n    return await Promise.resolve(0)\n  }\n\n  /** Initiates a graceful close of the connection. */\n  async initiateClose() {\n    await Promise.resolve()\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/node/Base.d.ts

@@ -1,19 +1,75 @@
 import type { BulkWriteOptions, Collection, DeleteResult, Document, Filter, FindCursor, InsertOneOptions, MongoClient, OptionalUnlessRequiredId, ReplaceOptions, UpdateFilter, WithId } from 'mongodb';
 import type { BaseMongoSdkConfig } from './Config.js';
+/** Provides a typed wrapper around common MongoDB collection operations. */
 export declare class BaseMongoSdk<T extends Document> {
+    /** The MongoDB SDK configuration for this instance. */
     config: BaseMongoSdkConfig;
     constructor(config: BaseMongoSdkConfig);
+    /** Returns the MongoDB connection URI, either from the config or constructed from individual credential fields. */
     get uri(): string;
+    /**
+     * Deletes all documents matching the filter.
+     * @param filter - The query filter to match documents for deletion
+     */
     deleteMany(filter: Filter<T>): Promise<DeleteResult>;
+    /**
+     * Deletes the first document matching the filter.
+     * @param filter - The query filter to match a document for deletion
+     */
     deleteOne(filter: Filter<T>): Promise<DeleteResult>;
+    /**
+     * Finds all documents matching the filter and returns a cursor.
+     * @param filter - The query filter
+     */
     find(filter: Filter<T>): Promise<FindCursor<WithId<T>>>;
+    /**
+     * Finds a single document matching the filter.
+     * @param filter - The query filter
+     * @returns The matched document, or `null` if not found
+     */
     findOne(filter: Filter<T>): Promise<WithId<T> | null>;
+    /**
+     * Inserts multiple documents into the collection.
+     * @param items - The documents to insert
+     * @param options - Optional bulk write options
+     */
     insertMany(items: OptionalUnlessRequiredId<T>[], options?: BulkWriteOptions): Promise<import("mongodb").InsertManyResult<T>>;
+    /**
+     * Inserts a single document into the collection.
+     * @param item - The document to insert
+     * @param options - Optional insert options
+     */
     insertOne(item: OptionalUnlessRequiredId<T>, options?: InsertOneOptions): Promise<import("mongodb").InsertOneResult<T>>;
+    /**
+     * Replaces a single document matching the filter.
+     * @param filter - The query filter to match the document
+     * @param item - The replacement document
+     * @param options - Optional replace options
+     */
     replaceOne(filter: Filter<T>, item: OptionalUnlessRequiredId<T>, options?: ReplaceOptions): Promise<import("mongodb").UpdateResult<T>>;
+    /**
+     * Updates a single document matching the filter without upserting.
+     * @param filter - The query filter to match the document
+     * @param fields - The update operations to apply
+     */
     updateOne(filter: Filter<T>, fields: UpdateFilter<T>): Promise<import("mongodb").UpdateResult<T>>;
+    /**
+     * Updates a single document matching the filter, inserting it if it does not exist.
+     * @param filter - The query filter to match the document
+     * @param fields - The update operations to apply
+     */
     upsertOne(filter: Filter<T>, fields: UpdateFilter<T>): Promise<import("mongodb").UpdateResult<T>>;
+    /**
+     * Executes a callback with access to the configured MongoDB collection.
+     * @param func - A callback receiving the typed collection
+     * @returns The result of the callback
+     */
     useCollection<R>(func: (collection: Collection<T>) => Promise<R> | R): Promise<R>;
+    /**
+     * Executes a callback with a connected MongoClient, handling connection and disconnection.
+     * @param func - A callback receiving the connected MongoClient
+     * @returns The result of the callback
+     */
     useMongo<R>(func: (client: MongoClient) => Promise<R> | R): Promise<R>;
 }
 //# sourceMappingURL=Base.d.ts.map

package/dist/node/Base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Base.d.ts","sourceRoot":"","sources":["../../src/Base.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,MAAM,EACP,MAAM,SAAS,CAAA;AAEhB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAGrD,qBAAa,YAAY,CAAC,CAAC,SAAS,QAAQ;IAC1C,MAAM,EAAE,kBAAkB,CAAA;gBAEd,MAAM,EAAE,kBAAkB;IAItC,IAAI,GAAG,WAMN;IAEK,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAM5B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAM3B,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAMtB,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAMzB,UAAU,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAM3E,SAAS,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAMvE,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc;IAMzF,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAMpD,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAMpD,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAMpE,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;CAUhE"}
+{"version":3,"file":"Base.d.ts","sourceRoot":"","sources":["../../src/Base.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,MAAM,EACP,MAAM,SAAS,CAAA;AAEhB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAGrD,4EAA4E;AAC5E,qBAAa,YAAY,CAAC,CAAC,SAAS,QAAQ;IAC1C,uDAAuD;IACvD,MAAM,EAAE,kBAAkB,CAAA;gBAEd,MAAM,EAAE,kBAAkB;IAItC,mHAAmH;IACnH,IAAI,GAAG,WAKN;IAED;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAMlC;;;OAGG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAMjC;;;OAGG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAM5B;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAM/B;;;;OAIG;IACG,UAAU,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAMjF;;;;OAIG;IACG,SAAS,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAM7E;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc;IAM/F;;;;OAIG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAM1D;;;;OAIG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAM1D;;;;OAIG;IACG,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAM1E;;;;OAIG;IACG,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;CAUhE"}

package/dist/node/Config.d.ts

@@ -1,14 +1,25 @@
+/** Public configuration options for the Mongo SDK, safe to expose to clients. */
 export interface BaseMongoSdkPublicConfig {
+    /** Delay in milliseconds before closing idle connections. */
     closeDelay?: number;
+    /** The MongoDB collection name to operate on. */
     collection: string;
+    /** Maximum number of connections in the connection pool. */
     maxPoolSize?: number;
 }
+/** Private configuration options for the Mongo SDK containing connection credentials. */
 export interface BaseMongoSdkPrivateConfig {
+    /** A full MongoDB connection string, used instead of individual credential fields. */
     dbConnectionString?: string;
+    /** The MongoDB Atlas cluster domain. */
     dbDomain?: string;
+    /** The database name to connect to. */
     dbName?: string;
+    /** The password for MongoDB authentication. */
     dbPassword?: string;
+    /** The username for MongoDB authentication. */
     dbUserName?: string;
 }
+/** Combined public and private MongoDB SDK configuration. */
 export type BaseMongoSdkConfig = BaseMongoSdkPublicConfig & BaseMongoSdkPrivateConfig;
 //# sourceMappingURL=Config.d.ts.map

package/dist/node/Config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Config.d.ts","sourceRoot":"","sources":["../../src/Config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,GAAG,yBAAyB,CAAA"}
+{"version":3,"file":"Config.d.ts","sourceRoot":"","sources":["../../src/Config.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,WAAW,wBAAwB;IACvC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAA;IAClB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,yFAAyF;AACzF,MAAM,WAAW,yBAAyB;IACxC,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,GAAG,yBAAyB,CAAA"}

package/dist/node/Wrapper.d.ts

@@ -1,11 +1,23 @@
 import { MongoClient } from 'mongodb';
+/** Manages a shared pool of MongoClient instances, reusing connections by URI. */
 export declare class MongoClientWrapper {
+    /** Global cache of wrapper instances keyed by connection URI. */
     static readonly clients: Map<string, MongoClientWrapper>;
     private client;
     constructor(uri: string, maxPoolSize?: number, closeDelay?: number);
+    /**
+     * Gets or creates a cached MongoClientWrapper for the given URI.
+     * @param uri - The MongoDB connection URI
+     * @param poolSize - Maximum connection pool size
+     * @param closeDelay - Delay in milliseconds before closing idle connections
+     * @returns A cached or newly created wrapper instance
+     */
     static get(uri: string, poolSize?: number, closeDelay?: number): MongoClientWrapper;
+    /** Connects to MongoDB and returns the underlying MongoClient. */
     connect(): Promise<MongoClient>;
+    /** Disconnects from MongoDB. */
     disconnect(): Promise<number>;
+    /** Initiates a graceful close of the connection. */
     initiateClose(): Promise<void>;
 }
 //# sourceMappingURL=Wrapper.d.ts.map

package/dist/node/Wrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Wrapper.d.ts","sourceRoot":"","sources":["../../src/Wrapper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAErC,qBAAa,kBAAkB;IAC7B,MAAM,CAAC,QAAQ,CAAC,OAAO,kCAAwC;IAE/D,OAAO,CAAC,MAAM,CAAa;gBAEf,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAKlE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IASxD,OAAO;IAIP,UAAU;IAIV,aAAa;CAGpB"}
+{"version":3,"file":"Wrapper.d.ts","sourceRoot":"","sources":["../../src/Wrapper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAErC,kFAAkF;AAClF,qBAAa,kBAAkB;IAC7B,iEAAiE;IACjE,MAAM,CAAC,QAAQ,CAAC,OAAO,kCAAwC;IAE/D,OAAO,CAAC,MAAM,CAAa;gBAEf,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAKlE;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAS9D,kEAAkE;IAC5D,OAAO;IAIb,gCAAgC;IAC1B,UAAU;IAIhB,oDAAoD;IAC9C,aAAa;CAGpB"}

package/dist/node/index.mjs

@@ -4,12 +4,20 @@ import { assertEx } from "@xylabs/assert";
 // src/Wrapper.ts
 import { MongoClient } from "mongodb";
 var MongoClientWrapper = class _MongoClientWrapper {
+  /** Global cache of wrapper instances keyed by connection URI. */
   static clients = /* @__PURE__ */ new Map();
   client;
   constructor(uri, maxPoolSize, closeDelay) {
     const options = { maxPoolSize, maxIdleTimeMS: closeDelay };
     this.client = new MongoClient(uri, options);
   }
+  /**
+   * Gets or creates a cached MongoClientWrapper for the given URI.
+   * @param uri - The MongoDB connection URI
+   * @param poolSize - Maximum connection pool size
+   * @param closeDelay - Delay in milliseconds before closing idle connections
+   * @returns A cached or newly created wrapper instance
+   */
   static get(uri, poolSize, closeDelay) {
     let client = this.clients.get(uri);
     if (!client) {
@@ -18,12 +26,15 @@ var MongoClientWrapper = class _MongoClientWrapper {
     }
     return client;
   }
+  /** Connects to MongoDB and returns the underlying MongoClient. */
   async connect() {
     return await Promise.resolve(this.client);
   }
+  /** Disconnects from MongoDB. */
   async disconnect() {
     return await Promise.resolve(0);
   }
+  /** Initiates a graceful close of the connection. */
   async initiateClose() {
     await Promise.resolve();
   }
@@ -31,63 +42,118 @@ var MongoClientWrapper = class _MongoClientWrapper {
 
 // src/Base.ts
 var BaseMongoSdk = class {
+  /** The MongoDB SDK configuration for this instance. */
   config;
   constructor(config) {
     this.config = config;
   }
+  /** Returns the MongoDB connection URI, either from the config or constructed from individual credential fields. */
   get uri() {
     return this.config.dbConnectionString ?? `mongodb+srv://${this.config.dbUserName}:${this.config.dbPassword}@${this.config.dbDomain}.mongodb.net/${this.config.dbName}?retryWrites=true&w=majority`;
   }
+  /**
+   * Deletes all documents matching the filter.
+   * @param filter - The query filter to match documents for deletion
+   */
   async deleteMany(filter) {
     return await this.useCollection(async (collection) => {
       return await collection.deleteMany(filter);
     });
   }
+  /**
+   * Deletes the first document matching the filter.
+   * @param filter - The query filter to match a document for deletion
+   */
   async deleteOne(filter) {
     return await this.useCollection(async (collection) => {
       return await collection.deleteOne(filter);
     });
   }
+  /**
+   * Finds all documents matching the filter and returns a cursor.
+   * @param filter - The query filter
+   */
   async find(filter) {
     return await this.useCollection((collection) => {
       return collection.find(filter);
     });
   }
+  /**
+   * Finds a single document matching the filter.
+   * @param filter - The query filter
+   * @returns The matched document, or `null` if not found
+   */
   async findOne(filter) {
     return await this.useCollection(async (collection) => {
       return await collection.findOne(filter);
     });
   }
+  /**
+   * Inserts multiple documents into the collection.
+   * @param items - The documents to insert
+   * @param options - Optional bulk write options
+   */
   async insertMany(items, options) {
     return await this.useCollection(async (collection) => {
       return await collection.insertMany(items, options);
     });
   }
+  /**
+   * Inserts a single document into the collection.
+   * @param item - The document to insert
+   * @param options - Optional insert options
+   */
   async insertOne(item, options) {
     return await this.useCollection(async (collection) => {
       return await collection.insertOne(item, options);
     });
   }
+  /**
+   * Replaces a single document matching the filter.
+   * @param filter - The query filter to match the document
+   * @param item - The replacement document
+   * @param options - Optional replace options
+   */
   async replaceOne(filter, item, options) {
     return await this.useCollection(async (collection) => {
       return await collection.replaceOne(filter, item, options);
     });
   }
+  /**
+   * Updates a single document matching the filter without upserting.
+   * @param filter - The query filter to match the document
+   * @param fields - The update operations to apply
+   */
   async updateOne(filter, fields) {
     return await this.useCollection(async (collection) => {
       return await collection.updateOne(filter, fields, { upsert: false });
     });
   }
+  /**
+   * Updates a single document matching the filter, inserting it if it does not exist.
+   * @param filter - The query filter to match the document
+   * @param fields - The update operations to apply
+   */
   async upsertOne(filter, fields) {
     return await this.useCollection(async (collection) => {
       return await collection.updateOne(filter, fields, { upsert: true });
     });
   }
+  /**
+   * Executes a callback with access to the configured MongoDB collection.
+   * @param func - A callback receiving the typed collection
+   * @returns The result of the callback
+   */
   async useCollection(func) {
     return await this.useMongo(async (client) => {
       return await func(client.db(this.config.dbName).collection(this.config.collection));
     });
   }
+  /**
+   * Executes a callback with a connected MongoClient, handling connection and disconnection.
+   * @param func - A callback receiving the connected MongoClient
+   * @returns The result of the callback
+   */
   async useMongo(func) {
     const wrapper = MongoClientWrapper.get(this.uri, this.config.maxPoolSize, this.config.closeDelay);
     const connection = await wrapper.connect();

package/dist/node/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/Base.ts","../../src/Wrapper.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport type {\n  BulkWriteOptions,\n  Collection,\n  DeleteResult,\n  Document,\n  Filter,\n  FindCursor,\n  InsertOneOptions,\n  MongoClient,\n  OptionalUnlessRequiredId,\n  ReplaceOptions,\n  UpdateFilter,\n  WithId,\n} from 'mongodb'\n\nimport type { BaseMongoSdkConfig } from './Config.js'\nimport { MongoClientWrapper } from './Wrapper.js'\n\nexport class BaseMongoSdk<T extends Document> {\n  config: BaseMongoSdkConfig\n\n  constructor(config: BaseMongoSdkConfig) {\n    this.config = config\n  }\n\n  get uri() {\n    return (\n      this.config.dbConnectionString\n      // eslint-disable-next-line @stylistic/max-len\n      ?? `mongodb+srv://${this.config.dbUserName}:${this.config.dbPassword}@${this.config.dbDomain}.mongodb.net/${this.config.dbName}?retryWrites=true&w=majority`\n    )\n  }\n\n  async deleteMany(filter: Filter<T>) {\n    return await this.useCollection<DeleteResult>(async (collection: Collection<T>) => {\n      return await collection.deleteMany(filter)\n    })\n  }\n\n  async deleteOne(filter: Filter<T>) {\n    return await this.useCollection<DeleteResult>(async (collection: Collection<T>) => {\n      return await collection.deleteOne(filter)\n    })\n  }\n\n  async find(filter: Filter<T>) {\n    return await this.useCollection<FindCursor<WithId<T>>>((collection: Collection<T>) => {\n      return collection.find(filter)\n    })\n  }\n\n  async findOne(filter: Filter<T>) {\n    return await this.useCollection<WithId<T> | null>(async (collection: Collection<T>) => {\n      return await collection.findOne(filter)\n    })\n  }\n\n  async insertMany(items: OptionalUnlessRequiredId<T>[], options?: BulkWriteOptions) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.insertMany(items, options)\n    })\n  }\n\n  async insertOne(item: OptionalUnlessRequiredId<T>, options?: InsertOneOptions) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.insertOne(item, options)\n    })\n  }\n\n  async replaceOne(filter: Filter<T>, item: OptionalUnlessRequiredId<T>, options?: ReplaceOptions) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.replaceOne(filter, item, options)\n    })\n  }\n\n  async updateOne(filter: Filter<T>, fields: UpdateFilter<T>) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.updateOne(filter, fields, { upsert: false })\n    })\n  }\n\n  async upsertOne(filter: Filter<T>, fields: UpdateFilter<T>) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.updateOne(filter, fields, { upsert: true })\n    })\n  }\n\n  async useCollection<R>(func: (collection: Collection<T>) => Promise<R> | R) {\n    return await this.useMongo<R>(async (client: MongoClient) => {\n      return await func(client.db(this.config.dbName).collection<T>(this.config.collection))\n    })\n  }\n\n  async useMongo<R>(func: (client: MongoClient) => Promise<R> | R) {\n    const wrapper = MongoClientWrapper.get(this.uri, this.config.maxPoolSize, this.config.closeDelay)\n    const connection = await wrapper.connect()\n    assertEx(connection, () => 'Connection failed')\n    try {\n      return await func(connection)\n    } finally {\n      await wrapper.disconnect()\n    }\n  }\n}\n","import type { MongoClientOptions } from 'mongodb'\nimport { MongoClient } from 'mongodb'\n\nexport class MongoClientWrapper {\n  static readonly clients = new Map<string, MongoClientWrapper>()\n\n  private client: MongoClient\n\n  constructor(uri: string, maxPoolSize?: number, closeDelay?: number) {\n    const options: MongoClientOptions = { maxPoolSize, maxIdleTimeMS: closeDelay }\n    this.client = new MongoClient(uri, options)\n  }\n\n  static get(uri: string, poolSize?: number, closeDelay?: number) {\n    let client = this.clients.get(uri)\n    if (!client) {\n      client = new MongoClientWrapper(uri, poolSize, closeDelay)\n      this.clients.set(uri, client)\n    }\n    return client\n  }\n\n  async connect() {\n    return await Promise.resolve(this.client)\n  }\n\n  async disconnect() {\n    return await Promise.resolve(0)\n  }\n\n  async initiateClose() {\n    await Promise.resolve()\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/Base.ts","../../src/Wrapper.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport type {\n  BulkWriteOptions,\n  Collection,\n  DeleteResult,\n  Document,\n  Filter,\n  FindCursor,\n  InsertOneOptions,\n  MongoClient,\n  OptionalUnlessRequiredId,\n  ReplaceOptions,\n  UpdateFilter,\n  WithId,\n} from 'mongodb'\n\nimport type { BaseMongoSdkConfig } from './Config.js'\nimport { MongoClientWrapper } from './Wrapper.js'\n\n/** Provides a typed wrapper around common MongoDB collection operations. */\nexport class BaseMongoSdk<T extends Document> {\n  /** The MongoDB SDK configuration for this instance. */\n  config: BaseMongoSdkConfig\n\n  constructor(config: BaseMongoSdkConfig) {\n    this.config = config\n  }\n\n  /** Returns the MongoDB connection URI, either from the config or constructed from individual credential fields. */\n  get uri() {\n    return (\n      this.config.dbConnectionString\n      ?? `mongodb+srv://${this.config.dbUserName}:${this.config.dbPassword}@${this.config.dbDomain}.mongodb.net/${this.config.dbName}?retryWrites=true&w=majority`\n    )\n  }\n\n  /**\n   * Deletes all documents matching the filter.\n   * @param filter - The query filter to match documents for deletion\n   */\n  async deleteMany(filter: Filter<T>) {\n    return await this.useCollection<DeleteResult>(async (collection: Collection<T>) => {\n      return await collection.deleteMany(filter)\n    })\n  }\n\n  /**\n   * Deletes the first document matching the filter.\n   * @param filter - The query filter to match a document for deletion\n   */\n  async deleteOne(filter: Filter<T>) {\n    return await this.useCollection<DeleteResult>(async (collection: Collection<T>) => {\n      return await collection.deleteOne(filter)\n    })\n  }\n\n  /**\n   * Finds all documents matching the filter and returns a cursor.\n   * @param filter - The query filter\n   */\n  async find(filter: Filter<T>) {\n    return await this.useCollection<FindCursor<WithId<T>>>((collection: Collection<T>) => {\n      return collection.find(filter)\n    })\n  }\n\n  /**\n   * Finds a single document matching the filter.\n   * @param filter - The query filter\n   * @returns The matched document, or `null` if not found\n   */\n  async findOne(filter: Filter<T>) {\n    return await this.useCollection<WithId<T> | null>(async (collection: Collection<T>) => {\n      return await collection.findOne(filter)\n    })\n  }\n\n  /**\n   * Inserts multiple documents into the collection.\n   * @param items - The documents to insert\n   * @param options - Optional bulk write options\n   */\n  async insertMany(items: OptionalUnlessRequiredId<T>[], options?: BulkWriteOptions) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.insertMany(items, options)\n    })\n  }\n\n  /**\n   * Inserts a single document into the collection.\n   * @param item - The document to insert\n   * @param options - Optional insert options\n   */\n  async insertOne(item: OptionalUnlessRequiredId<T>, options?: InsertOneOptions) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.insertOne(item, options)\n    })\n  }\n\n  /**\n   * Replaces a single document matching the filter.\n   * @param filter - The query filter to match the document\n   * @param item - The replacement document\n   * @param options - Optional replace options\n   */\n  async replaceOne(filter: Filter<T>, item: OptionalUnlessRequiredId<T>, options?: ReplaceOptions) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.replaceOne(filter, item, options)\n    })\n  }\n\n  /**\n   * Updates a single document matching the filter without upserting.\n   * @param filter - The query filter to match the document\n   * @param fields - The update operations to apply\n   */\n  async updateOne(filter: Filter<T>, fields: UpdateFilter<T>) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.updateOne(filter, fields, { upsert: false })\n    })\n  }\n\n  /**\n   * Updates a single document matching the filter, inserting it if it does not exist.\n   * @param filter - The query filter to match the document\n   * @param fields - The update operations to apply\n   */\n  async upsertOne(filter: Filter<T>, fields: UpdateFilter<T>) {\n    return await this.useCollection(async (collection: Collection<T>) => {\n      return await collection.updateOne(filter, fields, { upsert: true })\n    })\n  }\n\n  /**\n   * Executes a callback with access to the configured MongoDB collection.\n   * @param func - A callback receiving the typed collection\n   * @returns The result of the callback\n   */\n  async useCollection<R>(func: (collection: Collection<T>) => Promise<R> | R) {\n    return await this.useMongo<R>(async (client: MongoClient) => {\n      return await func(client.db(this.config.dbName).collection<T>(this.config.collection))\n    })\n  }\n\n  /**\n   * Executes a callback with a connected MongoClient, handling connection and disconnection.\n   * @param func - A callback receiving the connected MongoClient\n   * @returns The result of the callback\n   */\n  async useMongo<R>(func: (client: MongoClient) => Promise<R> | R) {\n    const wrapper = MongoClientWrapper.get(this.uri, this.config.maxPoolSize, this.config.closeDelay)\n    const connection = await wrapper.connect()\n    assertEx(connection, () => 'Connection failed')\n    try {\n      return await func(connection)\n    } finally {\n      await wrapper.disconnect()\n    }\n  }\n}\n","import type { MongoClientOptions } from 'mongodb'\nimport { MongoClient } from 'mongodb'\n\n/** Manages a shared pool of MongoClient instances, reusing connections by URI. */\nexport class MongoClientWrapper {\n  /** Global cache of wrapper instances keyed by connection URI. */\n  static readonly clients = new Map<string, MongoClientWrapper>()\n\n  private client: MongoClient\n\n  constructor(uri: string, maxPoolSize?: number, closeDelay?: number) {\n    const options: MongoClientOptions = { maxPoolSize, maxIdleTimeMS: closeDelay }\n    this.client = new MongoClient(uri, options)\n  }\n\n  /**\n   * Gets or creates a cached MongoClientWrapper for the given URI.\n   * @param uri - The MongoDB connection URI\n   * @param poolSize - Maximum connection pool size\n   * @param closeDelay - Delay in milliseconds before closing idle connections\n   * @returns A cached or newly created wrapper instance\n   */\n  static get(uri: string, poolSize?: number, closeDelay?: number) {\n    let client = this.clients.get(uri)\n    if (!client) {\n      client = new MongoClientWrapper(uri, poolSize, closeDelay)\n      this.clients.set(uri, client)\n    }\n    return client\n  }\n\n  /** Connects to MongoDB and returns the underlying MongoClient. */\n  async connect() {\n    return await Promise.resolve(this.client)\n  }\n\n  /** Disconnects from MongoDB. */\n  async disconnect() {\n    return await Promise.resolve(0)\n  }\n\n  /** Initiates a graceful close of the connection. */\n  async initiateClose() {\n    await Promise.resolve()\n  }\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;;;ACCzB,SAAS,mBAAmB;AAGrB,IAAM,qBAAN,MAAM,oBAAmB;AAAA;AAAA,EAE9B,OAAgB,UAAU,oBAAI,IAAgC;AAAA,EAEtD;AAAA,EAER,YAAY,KAAa,aAAsB,YAAqB;AAClE,UAAM,UAA8B,EAAE,aAAa,eAAe,WAAW;AAC7E,SAAK,SAAS,IAAI,YAAY,KAAK,OAAO;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,OAAO,IAAI,KAAa,UAAmB,YAAqB;AAC9D,QAAI,SAAS,KAAK,QAAQ,IAAI,GAAG;AACjC,QAAI,CAAC,QAAQ;AACX,eAAS,IAAI,oBAAmB,KAAK,UAAU,UAAU;AACzD,WAAK,QAAQ,IAAI,KAAK,MAAM;AAAA,IAC9B;AACA,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,MAAM,UAAU;AACd,WAAO,MAAM,QAAQ,QAAQ,KAAK,MAAM;AAAA,EAC1C;AAAA;AAAA,EAGA,MAAM,aAAa;AACjB,WAAO,MAAM,QAAQ,QAAQ,CAAC;AAAA,EAChC;AAAA;AAAA,EAGA,MAAM,gBAAgB;AACpB,UAAM,QAAQ,QAAQ;AAAA,EACxB;AACF;;;ADzBO,IAAM,eAAN,MAAuC;AAAA;AAAA,EAE5C;AAAA,EAEA,YAAY,QAA4B;AACtC,SAAK,SAAS;AAAA,EAChB;AAAA;AAAA,EAGA,IAAI,MAAM;AACR,WACE,KAAK,OAAO,sBACT,iBAAiB,KAAK,OAAO,UAAU,IAAI,KAAK,OAAO,UAAU,IAAI,KAAK,OAAO,QAAQ,gBAAgB,KAAK,OAAO,MAAM;AAAA,EAElI;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,WAAW,QAAmB;AAClC,WAAO,MAAM,KAAK,cAA4B,OAAO,eAA8B;AACjF,aAAO,MAAM,WAAW,WAAW,MAAM;AAAA,IAC3C,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,UAAU,QAAmB;AACjC,WAAO,MAAM,KAAK,cAA4B,OAAO,eAA8B;AACjF,aAAO,MAAM,WAAW,UAAU,MAAM;AAAA,IAC1C,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,KAAK,QAAmB;AAC5B,WAAO,MAAM,KAAK,cAAqC,CAAC,eAA8B;AACpF,aAAO,WAAW,KAAK,MAAM;AAAA,IAC/B,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,QAAQ,QAAmB;AAC/B,WAAO,MAAM,KAAK,cAAgC,OAAO,eAA8B;AACrF,aAAO,MAAM,WAAW,QAAQ,MAAM;AAAA,IACxC,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,WAAW,OAAsC,SAA4B;AACjF,WAAO,MAAM,KAAK,cAAc,OAAO,eAA8B;AACnE,aAAO,MAAM,WAAW,WAAW,OAAO,OAAO;AAAA,IACnD,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,UAAU,MAAmC,SAA4B;AAC7E,WAAO,MAAM,KAAK,cAAc,OAAO,eAA8B;AACnE,aAAO,MAAM,WAAW,UAAU,MAAM,OAAO;AAAA,IACjD,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,WAAW,QAAmB,MAAmC,SAA0B;AAC/F,WAAO,MAAM,KAAK,cAAc,OAAO,eAA8B;AACnE,aAAO,MAAM,WAAW,WAAW,QAAQ,MAAM,OAAO;AAAA,IAC1D,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,UAAU,QAAmB,QAAyB;AAC1D,WAAO,MAAM,KAAK,cAAc,OAAO,eAA8B;AACnE,aAAO,MAAM,WAAW,UAAU,QAAQ,QAAQ,EAAE,QAAQ,MAAM,CAAC;AAAA,IACrE,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,UAAU,QAAmB,QAAyB;AAC1D,WAAO,MAAM,KAAK,cAAc,OAAO,eAA8B;AACnE,aAAO,MAAM,WAAW,UAAU,QAAQ,QAAQ,EAAE,QAAQ,KAAK,CAAC;AAAA,IACpE,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,cAAiB,MAAqD;AAC1E,WAAO,MAAM,KAAK,SAAY,OAAO,WAAwB;AAC3D,aAAO,MAAM,KAAK,OAAO,GAAG,KAAK,OAAO,MAAM,EAAE,WAAc,KAAK,OAAO,UAAU,CAAC;AAAA,IACvF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,SAAY,MAA+C;AAC/D,UAAM,UAAU,mBAAmB,IAAI,KAAK,KAAK,KAAK,OAAO,aAAa,KAAK,OAAO,UAAU;AAChG,UAAM,aAAa,MAAM,QAAQ,QAAQ;AACzC,aAAS,YAAY,MAAM,mBAAmB;AAC9C,QAAI;AACF,aAAO,MAAM,KAAK,UAAU;AAAA,IAC9B,UAAE;AACA,YAAM,QAAQ,WAAW;AAAA,IAC3B;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xylabs/mongo",
-  "version": "5.0.90",
+  "version": "5.0.91",
   "description": "Base functionality used throughout XYO TypeScript/JavaScript libraries that access Mongo DB",
   "keywords": [
     "mongo",
@@ -43,15 +43,17 @@
     "dist",
     "!**/*.bench.*",
     "!**/*.spec.*",
-    "!**/*.test.*"
+    "!**/*.test.*",
+    "README.md"
   ],
   "dependencies": {
-    "@xylabs/assert": "~5.0.89"
+    "@xylabs/assert": "~5.0.90"
   },
   "devDependencies": {
-    "@xylabs/tsconfig": "~7.5.4",
+    "@xylabs/tsconfig": "~7.6.2",
     "mongodb": "^7.1.1",
-    "typescript": "~5.9.3",
+    "typescript": "^5",
+    "vite": "^6.0.0 || ^7.0.0 || ^8.0.0",
     "vitest": "^4.1.2"
   },
   "peerDependencies": {