@xylabs/mongo 5.1.1 → 5.1.3

package/dist/browser/index.mjs

@@ -169,4 +169,4 @@ export {
   BaseMongoSdk,
   MongoClientWrapper
 };
-//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/browser/index.mjs.map

@@ -1 +1,7 @@
-{"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":[]}
+{
+  "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/index.mjs

@@ -169,4 +169,4 @@ export {
   BaseMongoSdk,
   MongoClientWrapper
 };
-//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/neutral/index.mjs.map

@@ -1 +1,7 @@
-{"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":[]}
+{
+  "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/index.mjs

@@ -169,4 +169,4 @@ export {
   BaseMongoSdk,
   MongoClientWrapper
 };
-//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/node/index.mjs.map

@@ -1 +1,7 @@
-{"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":[]}
+{
+  "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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xylabs/mongo",
-  "version": "5.1.1",
+  "version": "5.1.3",
   "description": "Base functionality used throughout XYO TypeScript/JavaScript libraries that access Mongo DB",
   "keywords": [
     "mongo",
@@ -45,17 +45,18 @@
     "README.md"
   ],
   "dependencies": {
-    "@xylabs/assert": "~5.1.1"
+    "@xylabs/assert": "~5.1.3"
   },
   "devDependencies": {
-    "@xylabs/tsconfig": "~7.13.2",
+    "@types/node": "^25.8.0",
+    "@xylabs/tsconfig": "~8.0.4",
     "mongodb": "^7.2.0",
-    "typescript": "^5.9.3",
-    "vite": "^8.0.10",
-    "vitest": "^4.1.5"
+    "typescript": "^6.0.3",
+    "vite": "^8.0.13",
+    "vitest": "^4.1.6"
   },
   "peerDependencies": {
-    "mongodb": ">=7.2.0 <8"
+    "mongodb": "^7.2"
   },
   "engines": {
     "node": ">=18"