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 URL-encoded 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