/// <reference types="node" resolution-mode="require"/>
/// <reference types="node" resolution-mode="require"/>
import { ArrayElement, BucketName, CasInput, CollectionName, CouchbaseClusterTypes, DefaultClusterTypes, DocDef, DocDefBodyShape, DocDefMatchingBody, DocDefMatchingKey, If, IsAny, IsFuzzyDocument, IsNever, OneOf, ScopeName } from '@cbjsdev/shared';
import { AppendOptions, BinaryCollection, DecrementOptions, IncrementOptions, PrependOptions } from './binarycollection.js';
import type { CppConnection, CppDocumentId, CppRangeScanOrchestratorOptions, CppScanIterator } from './binding.js';
import type { Cluster } from './cluster.js';
import { CollectionDocDef, CollectionDocDefMatchingKey, CollectionMatchingDocDef, CollectionOptions, ExtractCollectionJsonDocDef, ExtractCollectionJsonDocKey } from './clusterTypes/clusterTypes.js';
import type { LookupInSpecResults, NarrowLookupSpecs } from './clusterTypes/kv/lookup/lookupIn.types.js';
import { MutateInSpecResults, NarrowMutationSpecs } from './clusterTypes/kv/mutation/mutateIn.types.js';
import { CounterResult, ExistsResult, GetReplicaResult, GetResult, LookupInReplicaResult, LookupInResult, MutateInResult, MutationResult, ScanResult } from './crudoptypes.js';
import { DurabilityLevel, ReadPreference, StoreSemantics } from './generaltypes.js';
import { MutationState } from './mutationstate.js';
import { CollectionQueryIndexManager } from './queryindexmanager.js';
import { PrefixScan, RangeScan, SamplingScan } from './rangeScan.js';
import type { Scope } from './scope.js';
import { MutateInSpec } from './sdspecs.js';
import { CouchbaseList, CouchbaseMap, CouchbaseQueue, CouchbaseSet } from './services/kv/dataStructures/index.js';
import { ChainableLookupIn } from './services/kv/lookupIn/ChainableLookupIn.js';
import { LookupResult } from './services/kv/lookupIn/types.js';
import type { MutateInReturnType } from './services/kv/mutateIn/types.js';
import { StreamableReplicasPromise, StreamableScanPromise } from './streamablepromises.js';
import { RequestSpan } from './tracing.js';
import type { Transcoder } from './transcoders.js';
import { NodeCallback, VoidNodeCallback } from './utilities.js';
/**
 * @category Key-Value
 */
export interface GetOptions<Def extends DocDefBodyShape, WithExpiry extends boolean = boolean, ThrowIfMissing extends boolean = boolean> {
    /**
     * Specifies a list of fields within the document which should be fetched.
     * This allows for easy retrieval of select fields without incurring the
     * overhead of fetching the whole document.
     */
    project?: string | string[];
    /**
     * Indicates that the expiry of the document should be fetched alongside
     * the data itself.
     */
    withExpiry?: WithExpiry;
    /**
     * Specifies an explicit transcoder to use for this specific operation.
     */
    transcoder?: Transcoder;
    /**
     * The timeout for this operation, represented in milliseconds.
     */
    timeout?: number;
    /**
     * When true, throws a `DocumentNotFoundError` if the document is not found.
     * When false, returns undefined.
     * @default true
     */
    throwIfMissing?: ThrowIfMissing;
    /**
     * The parent span for this operation, used to establish a trace hierarchy
     * for observability.
     */
    parentSpan?: RequestSpan;
}
/**
 * @category Key-Value
 */
export interface ExistsOptions {
    /**
     * The timeout for this operation, represented in milliseconds.
     */
    timeout?: number;
    /**
     * The parent span for this operation, used to establish a trace hierarchy
     * for observability.
     */
    parentSpan?: RequestSpan;
}
export type ClientDurabilityOptions = {
    /**
     * Specifies the number of nodes this operation should be persisted to
     * before it is considered successful.  Note that this option is mutually
     * exclusive of {@link durabilityLevel}.
     */
    durabilityPersistTo: number;
    /**
     * Specifies the number of nodes this operation should be replicated to
     * before it is considered successful.  Note that this option is mutually
     * exclusive of {@link durabilityLevel}.
     */
    durabilityReplicateTo: number;
};
export type ServerDurabilityOptions = {
    /**
     * Specifies the level of synchronous durability for this operation.
     */
    durabilityLevel: DurabilityLevel;
};
export type DurabilityOptions = OneOf<[ClientDurabilityOptions, ServerDurabilityOptions]>;
export type MutationOptions = Partial<DurabilityOptions> & {
    /**
     * Specifies the expiry time for the document.
     *
     * The expiry can be provided as:
     * - A `number` of seconds relative to the current time.
     * - A `Date` object for an absolute expiry time.
     *
     * **IMPORTANT:** To use a Unix timestamp for expiry, construct a Date from it ( new Date(UNIX_TIMESTAMP * 1000) ).
     */
    expiry?: number | Date;
    /**
     * Specifies that any existing expiry on the document should be preserved.
     */
    preserveExpiry?: boolean;
    /**
     * If specified, indicates that operation should be failed if the CAS
     * has changed from this value, indicating that the document has changed.
     */
    cas?: CasInput;
    /**
     * The timeout for this operation, represented in milliseconds.
     */
    timeout?: number;
    /**
     * Specifies an explicit transcoder to use for this specific operation.
     */
    transcoder?: Transcoder;
    /**
     * The parent span for this operation, used to establish a trace hierarchy
     * for observability.
     */
    parentSpan?: RequestSpan;
};
/**
 * @category Key-Value
 */
export type InsertOptions = Omit<MutationOptions, 'cas' | 'preserveExpiry'>;
/**
 * @category Key-Value
 */
export type UpsertOptions = Omit<MutationOptions, 'cas'>;
/**
 * @category Key-Value
 */
export type ReplaceOptions = MutationOptions;
/**
 * @category Key-Value
 */
export type RemoveOptions = Omit<MutationOptions, 'expiry' | 'preserveExpiry' | 'transcoder'>;
/**
 * @category Key-Value
 */
export interface GetAnyReplicaOptions<ThrowIfMissing extends boolean = boolean> {
    /**
     * Specifies an explicit transcoder to use for this specific operation.
     */
    transcoder?: Transcoder;
    /**
     * The timeout for this operation, represented in milliseconds.
     */
    timeout?: number;
    /**
     * When true, throws a `DocumentNotFoundError` if the document is not found.
     * When false, returns undefined.
     * @default true
     */
    throwIfMissing?: ThrowIfMissing;
    /**
     * Specifies how replica nodes will be filtered.
     */
    readPreference?: ReadPreference;
}
/**
 * @category Key-Value
 */
export interface GetAllReplicasOptions {
    /**
     * Specifies an explicit transcoder to use for this specific operation.
     */
    transcoder?: Transcoder;
    /**
     * The timeout for this operation, represented in milliseconds.
     */
    timeout?: number;
    /**
     * Specifies how replica nodes will be filtered.
     */
    readPreference?: ReadPreference;
}
/**
 * @category Key-Value
 */
export interface TouchOptions {
    /**
     * Specifies the level of synchronous durability for this operation.
     */
    durabilityLevel?: DurabilityLevel;
    /**
     * The timeout for this operation, represented in milliseconds.
     */
    timeout?: number;
    /**
     * The parent span for this operation, used to establish a trace hierarchy
     * for observability.
     */
    parentSpan?: RequestSpan;
}
/**
 * @category Key-Value
 */
export interface GetAndTouchOptions {
    /**
     * Specifies an explicit transcoder to use for this specific operation.
     */
    transcoder?: Transcoder;
    /**
     * The timeout for this operation, represented in milliseconds.
     */
    timeout?: number;
    /**
     * The parent span for this operation, used to establish a trace hierarchy
     * for observability.
     */
    parentSpan?: RequestSpan;
}
/**
 * @category Key-Value
 */
export interface GetAndLockOptions {
    /**
     * Specifies an explicit transcoder to use for this specific operation.
     */
    transcoder?: Transcoder;
    /**
     * The timeout for this operation, represented in milliseconds.
     */
    timeout?: number;
    /**
     * The parent span for this operation, used to establish a trace hierarchy
     * for observability.
     */
    parentSpan?: RequestSpan;
}
/**
 * @category Key-Value
 */
export interface UnlockOptions {
    /**
     * The timeout for this operation, represented in milliseconds.
     */
    timeout?: number;
    /**
     * The parent span for this operation, used to establish a trace hierarchy
     * for observability.
     */
    parentSpan?: RequestSpan;
}
/**
 * @category Key-Value
 */
export interface LookupInOptions<ThrowOnSpecError extends boolean = false> {
    /**
     * The timeout for this operation, represented in milliseconds.
     */
    timeout?: number;
    /**
     * For internal use only - allows access to deleted documents that are in 'tombstone' form
     *
     * @internal
     */
    accessDeleted?: boolean;
    /**
     * When `true`, the operation will throw if any {@link LookupInSpec} fails.
     * The first spec error will be thrown.
     *
     * @default false
     */
    throwOnSpecError?: ThrowOnSpecError;
    /**
     * The parent span for this operation, used to establish a trace hierarchy
     * for observability.
     */
    parentSpan?: RequestSpan;
}
/**
 * @category Key-Value
 */
export interface LookupInAnyReplicaOptions<ThrowOnSpecError extends boolean = false> {
    /**
     * The timeout for this operation, represented in milliseconds.
     */
    timeout?: number;
    /**
     * When `true`, the operation will throw if any {@link LookupInSpec} fails.
     * The first spec error will be thrown.
     *
     * @default false
     */
    throwOnSpecError?: ThrowOnSpecError;
    /**
     * Specifies how replica nodes will be filtered.
     */
    readPreference?: ReadPreference;
    /**
     * The parent span for this operation, used to establish a trace hierarchy
     * for observability.
     */
    parentSpan?: RequestSpan;
}
/**
 * @category Key-Value
 */
export interface LookupInAllReplicasOptions<ThrowOnSpecError extends boolean = false> {
    /**
     * The timeout for this operation, represented in milliseconds.
     */
    timeout?: number;
    /**
     * When `true`, the operation will throw if any {@link LookupInSpec} fails.
     * The first spec error will be thrown.
     *
     * @default false
     */
    throwOnSpecError?: ThrowOnSpecError;
    /**
     * Specifies how replica nodes will be filtered.
     */
    readPreference?: ReadPreference;
    /**
     * The parent span for this operation, used to establish a trace hierarchy
     * for observability.
     */
    parentSpan?: RequestSpan;
}
/**
 * @category Key-Value
 */
export type MutateInOptions = MutationOptions & {
    /**
     * Specifies the store semantics to use for this operation.
     */
    storeSemantics?: StoreSemantics;
    /**
     * Specifies whether the operation should be performed with upsert semantics,
     * creating the document if it does not already exist.
     *
     * @deprecated Use {@link MutateInOptions.storeSemantics} instead.
     */
    upsertDocument?: boolean;
};
/**
 * @category Key-Value
 */
export interface ScanOptions {
    /**
     * Specifies an explicit transcoder to use for this specific operation.
     */
    transcoder?: Transcoder;
    /**
     * The timeout for this operation, represented in milliseconds.
     */
    timeout?: number;
    /**
     * If the scan should only return document ids.
     */
    idsOnly?: boolean;
    /**
     * The limit applied to the number of bytes returned from the server
     * for each partition batch.
     */
    batchByteLimit?: number;
    /**
     * The limit applied to the number of items returned from the server
     * for each partition batch.
     */
    batchItemLimit?: number;
    /**
     * Specifies a MutationState which the scan should be consistent with.
     *
     * @see MutationState
     */
    consistentWith?: MutationState;
    /**
     * Specifies the number of vBuckets which the client should scan in parallel.
     */
    concurrency?: number;
}
/**
 * Exposes the operations which are available to be performed against a collection.
 * Namely the ability to perform KV operations.
 *
 * @category Core
 */
export declare class Collection<in out T extends CouchbaseClusterTypes = DefaultClusterTypes, in out B extends BucketName<T> = BucketName<T>, in out S extends ScopeName<T, B> = ScopeName<T, B>, in out C extends CollectionName<T, B, S> = CollectionName<T, B, S>> {
    /**
     * @internal
     */
    readonly DEFAULT_NAME = "_default";
    readonly scope: Scope<T, B, S>;
    readonly name: C;
    readonly conn: CppConnection;
    readonly kvScanTimeout: number;
    readonly scanBatchItemLimit: number;
    readonly scanBatchByteLimit: number;
    /**
    @internal
    */
    constructor(scope: Scope<T, B, S>, collectionName: C);
    /**
    @internal
    */
    get cluster(): Cluster<T>;
    getKeyspace(): {
        bucket: B;
        scope: S;
        collection: C;
    };
    getKeyspacePath(): `${string}.${string}.${string}`;
    /**
    @internal
    */
    get transcoder(): Transcoder;
    /**
    @internal
    */
    _mutationTimeout(durabilityLevel?: DurabilityLevel): number;
    /**
     * @internal
     */
    getDocId(key: string): CppDocumentId;
    /**
     * Invokes a C++ core KV binding function while creating, populating and ending
     * the observability span (and recording the operation metric) for the call.
     *
     * It rejects with the raw {@link CppError} — exactly like the previous
     * `promisify` calls — so each operation keeps its existing `errorFromCpp`
     * error handling unchanged.
     *
     * @internal
     */
    private _observeKvCall;
    private encodeSubDocument;
    private decodeSubDocument;
    get<const Key extends CollectionDocDef<this>['Key'], Doc extends DocDefMatchingKey<Key, T, B, S, C>['Body'], WithExpiry extends boolean = false, ThrowIfMissing extends boolean = true>(key: Key, callbackOrOptions?: GetOptions<Doc, WithExpiry, ThrowIfMissing> | NodeCallback<GetResult<Doc, WithExpiry>>): Promise<CollectionGetReturn<Doc, WithExpiry, ThrowIfMissing>>;
    get<const Key extends CollectionDocDef<this>['Key'], Doc extends DocDefMatchingKey<Key, T, B, S, C>['Body'], WithExpiry extends boolean = false, ThrowIfMissing extends boolean = true>(key: Key, options: GetOptions<Doc, WithExpiry, ThrowIfMissing>, callback: NodeCallback<GetResult<Doc, WithExpiry>>): Promise<CollectionGetReturn<Doc, WithExpiry, ThrowIfMissing>>;
    private _projectedGet;
    /**
     * Checks whether a specific document exists or not.
     *
     * @param key The document key to check for existence.
     * @param callback A node-style callback to be invoked after execution.
     */
    exists<Key extends CollectionDocDef<this>['Key']>(key: Key, callback?: NodeCallback<ExistsResult>): Promise<ExistsResult>;
    /**
     * Checks whether a specific document exists or not.
     *
     * @param key The document key to check for existence.
     * @param options Optional parameters for this operation.
     * @param callback A node-style callback to be invoked after execution.
     */
    exists<Key extends CollectionDocDef<this>['Key']>(key: Key, options: ExistsOptions, callback?: NodeCallback<ExistsResult>): Promise<ExistsResult>;
    /**
     * @internal
     */
    private _getReplica;
    /**
     * Retrieves the value of the document from any of the available replicas.  This
     * will return as soon as the first response is received from any replica node.
     *
     * @overload
     * @param key The document key to retrieve.
     * @param options Optional parameters for this operation.
     * @param callback A node-style callback to be invoked after execution.
     */
    getAnyReplica<Key extends CollectionDocDef<this>['Key'], Def extends DocDefMatchingKey<Key, T, B, S, C>, ThrowIfMissing extends boolean = true>(key: Key, options: GetAnyReplicaOptions<ThrowIfMissing>, callback?: NodeCallback<GetReplicaResult<Def['Body']>>): Promise<CollectionGetAnyReplicaReturn<Def['Body'], ThrowIfMissing>>;
    /**
     * Retrieves the value of the document from any of the available replicas.  This
     * will return as soon as the first response is received from any replica node.
     *
     * @overload
     * @param key The document key to retrieve.
     * @param callbackOrOptions A node-style callback to be invoked after execution.
     */
    getAnyReplica<Key extends CollectionDocDef<this>['Key'], Def extends DocDefMatchingKey<Key, T, B, S, C>, ThrowIfMissing extends boolean = true>(key: Key, callbackOrOptions?: GetAnyReplicaOptions<ThrowIfMissing> | NodeCallback<GetReplicaResult<Def['Body']>>): Promise<CollectionGetAnyReplicaReturn<Def['Body'], ThrowIfMissing>>;
    getAllReplicas<Key extends CollectionDocDef<this>['Key'], Def extends DocDefMatchingKey<Key, T, B, S, C>>(key: Key, callbackOrOptions?: GetAllReplicasOptions | NodeCallback<[GetReplicaResult<Def['Body']>, ...GetReplicaResult<Def['Body']>[]]>): StreamableReplicasPromise<[
        GetReplicaResult<Def['Body']>,
        ...GetReplicaResult<Def['Body']>[]
    ], GetReplicaResult<Def['Body']>>;
    /**
     * Retrieves the value of the document from all available replicas.  Note that
     * as replication is asynchronous, each node may return a different value.
     *
     * @param key The document key to retrieve.
     * @param options Optional parameters for this operation.
     * @param callback A node-style callback to be invoked after execution.
     */
    getAllReplicas<Key extends CollectionDocDef<this>['Key'], Def extends DocDefMatchingKey<Key, T, B, S, C>>(key: Key, options: GetAllReplicasOptions, callback?: NodeCallback<[
        GetReplicaResult<Def['Body']>,
        ...GetReplicaResult<Def['Body']>[]
    ]>): StreamableReplicasPromise<[
        GetReplicaResult<Def['Body']>,
        ...GetReplicaResult<Def['Body']>[]
    ], GetReplicaResult<Def['Body']>>;
    /**
     * Inserts a new document to the collection, failing if the document already exists.
     *
     * @param key The document key to insert.
     * @param value The value of the document to insert.
     * @param options Optional parameters for this operation.
     * @param callback A node-style callback to be invoked after execution.
     */
    insert<Key extends CollectionDocDef<this>['Key'], Def extends DocDefMatchingKey<Key, T, B, S, C>>(key: Key, value: Def['Body'], options: InsertOptions, callback?: NodeCallback<MutationResult>): Promise<MutationResult>;
    insert<Key extends CollectionDocDef<this>['Key'], Def extends DocDefMatchingKey<Key, T, B, S, C>>(key: Key, value: Def['Body'], callback?: NodeCallback<MutationResult>): Promise<MutationResult>;
    /**
     * Upserts a document to the collection.  This operation succeeds whether or not the
     * document already exists.
     *
     * @param key The document key to upsert.
     * @param value The new value for the document.
     * @param options Optional parameters for this operation.
     * @param callback A node-style callback to be invoked after execution.
     */
    upsert<Key extends CollectionDocDef<this>['Key'], Def extends DocDefMatchingKey<Key, T, B, S, C>>(key: Key, value: Def['Body'], options: UpsertOptions, callback?: NodeCallback<MutationResult>): Promise<MutationResult>;
    upsert<Key extends CollectionDocDef<this>['Key'], Def extends DocDefMatchingKey<Key, T, B, S, C>>(key: Key, value: Def['Body'], callback?: NodeCallback<MutationResult>): Promise<MutationResult>;
    /**
     * Replaces the value of an existing document.  Failing if the document does not exist.
     *
     * @param key The document key to replace.
     * @param value The new value for the document.
     * @param options Optional parameters for this operation.
     * @param callback A node-style callback to be invoked after execution.
     */
    replace<Key extends CollectionDocDef<this>['Key'], Def extends DocDefMatchingKey<Key, T, B, S, C>>(key: Key, value: Def['Body'], options: ReplaceOptions, callback?: NodeCallback<MutationResult>): Promise<MutationResult>;
    replace<Key extends CollectionDocDef<this>['Key'], Def extends DocDefMatchingKey<Key, T, B, S, C>>(key: Key, value: Def['Body'], callback?: NodeCallback<MutationResult>): Promise<MutationResult>;
    /**
     * Remove an existing document from the collection.
     *
     * @param key The document key to remove.
     * @param options Optional parameters for this operation.
     * @param callback A node-style callback to be invoked after execution.
     */
    remove<Key extends CollectionDocDef<this>['Key']>(key: Key, options: RemoveOptions, callback?: NodeCallback<MutationResult>): Promise<MutationResult>;
    remove<Key extends CollectionDocDef<this>['Key']>(key: Key, callback?: NodeCallback<MutationResult>): Promise<MutationResult>;
    /**
     * Retrieves the value of the document and simultaneously updates the expiry time
     * for the same document.
     *
     * @param key The document to fetch and touch.
     * @param expiry The new expiry to apply to the document.
     *   The expiry can be provided as:
     *   - A `number` of seconds relative to the current time.
     *   - A `Date` object for an absolute expiry time.
     *
     *   **IMPORTANT:** To use a Unix timestamp for expiry, construct a Date from it ( new Date(UNIX_TIMESTAMP * 1000) ).
     * @param options Optional parameters for this operation.
     * @param callback A node-style callback to be invoked after execution.
     */
    getAndTouch<Key extends CollectionDocDef<this>['Key'], Def extends DocDefMatchingKey<Key, T, B, S, C>>(key: Key, expiry: number | Date, options: GetAndTouchOptions, callback?: NodeCallback<GetResult<Def['Body']>>): Promise<GetResult<Def['Body']>>;
    getAndTouch<Key extends CollectionDocDef<this>['Key'], Def extends DocDefMatchingKey<Key, T, B, S, C>>(key: Key, expiry: number | Date, callback?: NodeCallback<GetResult<Def['Body']>>): Promise<GetResult<Def['Body']>>;
    /**
     * Updates the expiry on an existing document.
     *
     * @param key The document key to touch.
     * @param expiry The new expiry to apply to the document.
     * The expiry can be provided as:
     * - A `number` of seconds relative to the current time.
     * - A `Date` object for an absolute expiry time.
     *
     * **IMPORTANT:** To use a Unix timestamp for expiry, construct a Date from it ( new Date(UNIX_TIMESTAMP * 1000) ).
     * @param options Optional parameters for this operation.
     * @param callback A node-style callback to be invoked after execution.
     */
    touch<Key extends CollectionDocDef<this>['Key']>(key: Key, expiry: number | Date, options: TouchOptions, callback?: NodeCallback<MutationResult<undefined>>): Promise<MutationResult<undefined>>;
    touch<Key extends CollectionDocDef<this>['Key']>(key: Key, expiry: number | Date, callback?: NodeCallback<MutationResult<undefined>>): Promise<MutationResult<undefined>>;
    /**
     * Locks a document and retrieves the value of that document at the time it is locked.
     *
     * @param key The document key to retrieve and lock.
     * @param lockTime The amount of time to lock the document for, specified in seconds.
     * @param options Optional parameters for this operation.
     * @param callback A node-style callback to be invoked after execution.
     */
    getAndLock<Key extends CollectionDocDef<this>['Key'], Def extends DocDefMatchingKey<Key, T, B, S, C>>(key: Key, lockTime: number, options: GetAndLockOptions, callback?: NodeCallback<GetResult<Def['Body']>>): Promise<GetResult<Def['Body']>>;
    getAndLock<Key extends CollectionDocDef<this>['Key'], Def extends DocDefMatchingKey<Key, T, B, S, C>>(key: Key, lockTime: number, callback?: NodeCallback<GetResult<Def['Body']>>): Promise<GetResult<Def['Body']>>;
    /**
     * Unlocks a previously locked document.
     *
     * @param key The document key to unlock.
     * @param cas The CAS of the document, used to validate lock ownership.
     * @param options Optional parameters for this operation.
     * @param callback A node-style callback to be invoked after execution.
     */
    unlock<Key extends CollectionDocDef<this>['Key']>(key: Key, cas: CasInput, options: UnlockOptions, callback?: VoidNodeCallback): Promise<void>;
    unlock<Key extends CollectionDocDef<this>['Key']>(key: Key, cas: CasInput, callback?: VoidNodeCallback): Promise<void>;
    /**
     * @internal
     */
    _continueScan(iterator: CppScanIterator, transcoder: Transcoder, emitter: StreamableScanPromise<ScanResult[], ScanResult>): void;
    /**
     * @internal
     */
    _doScan(scanType: RangeScan | SamplingScan | PrefixScan, options: CppRangeScanOrchestratorOptions, transcoder: Transcoder, callback?: NodeCallback<ScanResult[]>): StreamableScanPromise<ScanResult[], ScanResult>;
    /**
     * Performs a key-value scan operation.
     *
     * Use this API for low concurrency batch queries where latency is not a critical as the system
     * may have to scan a lot of documents to find the matching documents.
     * For low latency range queries, it is recommended that you use SQL++ with the necessary indexes.
     *
     * @param scanType The type of scan to execute.
     * @param options Optional parameters for the scan operation.
     * @param callback A node-style callback to be invoked after execution.
     */
    scan<Def extends CollectionDocDef<this>>(scanType: RangeScan | SamplingScan | PrefixScan, options: ScanOptions, callback?: NodeCallback<ScanResult<Def>[]>): StreamableScanPromise<ScanResult<Def>[], ScanResult<Def>>;
    scan<Def extends CollectionDocDef<this>>(scanType: RangeScan | SamplingScan | PrefixScan, callback?: NodeCallback<ScanResult<Def>[]>): StreamableScanPromise<ScanResult<Def>[], ScanResult<Def>>;
    lookupIn<Key extends ExtractCollectionJsonDocKey<this>, SpecDefinitions, ThrowOnSpecError extends boolean = false>(key: Key, specs: NarrowLookupSpecs<CollectionOptions<this>, ExtractCollectionJsonDocDef<Collection<T, B, S, C>, Key>, SpecDefinitions>, options: LookupInOptions<ThrowOnSpecError>, callback?: NodeCallback<LookupInResult<LookupInSpecResults<CollectionOptions<this>, SpecDefinitions, ExtractCollectionJsonDocDef<Collection<T, B, S, C>, Key>>, ThrowOnSpecError>>): Promise<LookupResult<CollectionOptions<this>, 'lookupIn', SpecDefinitions, ExtractCollectionJsonDocDef<Collection<T, B, S, C>, Key>, ThrowOnSpecError>>;
    lookupIn<Key extends ExtractCollectionJsonDocKey<this>, SpecDefinitions, ThrowOnSpecError extends boolean = false>(key: Key, specs: NarrowLookupSpecs<CollectionOptions<this>, ExtractCollectionJsonDocDef<Collection<T, B, S, C>, NoInfer<Key>>, SpecDefinitions>, callback?: NodeCallback<LookupInResult<LookupInSpecResults<CollectionOptions<this>, SpecDefinitions, ExtractCollectionJsonDocDef<Collection<T, B, S, C>, NoInfer<Key>>>, ThrowOnSpecError>>): Promise<LookupResult<CollectionOptions<this>, 'lookupIn', SpecDefinitions, ExtractCollectionJsonDocDef<Collection<T, B, S, C>, Key>, ThrowOnSpecError>>;
    lookupIn<const Key extends ExtractCollectionJsonDocKey<this>, ThrowOnSpecError extends boolean = false>(key: Key, options?: LookupInOptions<ThrowOnSpecError>): ChainableLookupIn<this, 'lookupIn', Key, [
    ], ThrowOnSpecError, CollectionDocDefMatchingKey<this, Key>>;
    private _lookupIn;
    private _lookupInReplica;
    /**
     * Performs a lookup-in operation against a document, fetching individual fields or
     * information about specific fields inside the document value from any of the available
     * replicas in the cluster.
     *
     * @param key The document key to look in.
     * @param specs A list of specs describing the data to fetch from the document.
     * @param options Optional parameters for this operation.
     * @param callback A node-style callback to be invoked after execution.
     */
    lookupInAnyReplica<Key extends ExtractCollectionJsonDocKey<this>, SpecDefinitions, ThrowOnSpecError extends boolean = false>(key: Key, specs: NarrowLookupSpecs<CollectionOptions<this>, CollectionDocDefMatchingKey<this, Key>, SpecDefinitions>, options: LookupInAnyReplicaOptions<ThrowOnSpecError>, callback?: NodeCallback<LookupResult<CollectionOptions<this>, 'lookupInAnyReplica', SpecDefinitions, CollectionDocDefMatchingKey<this, Key>, ThrowOnSpecError>>): Promise<LookupResult<CollectionOptions<this>, 'lookupInAnyReplica', SpecDefinitions, CollectionDocDefMatchingKey<this, Key>, ThrowOnSpecError>>;
    lookupInAnyReplica<Key extends ExtractCollectionJsonDocKey<this>, SpecDefinitions, ThrowOnSpecError extends boolean = false>(key: Key, specs: NarrowLookupSpecs<CollectionOptions<this>, CollectionDocDefMatchingKey<this, Key>, SpecDefinitions>, callback?: NodeCallback<LookupResult<CollectionOptions<this>, 'lookupInAnyReplica', SpecDefinitions, CollectionDocDefMatchingKey<this, Key>, ThrowOnSpecError>>): Promise<LookupResult<CollectionOptions<this>, 'lookupInAnyReplica', SpecDefinitions, CollectionDocDefMatchingKey<this, Key>, ThrowOnSpecError>>;
    lookupInAnyReplica<const Key extends ExtractCollectionJsonDocKey<this>, ThrowOnSpecError extends boolean = false>(key: Key, options?: LookupInAnyReplicaOptions<ThrowOnSpecError>): ChainableLookupIn<this, 'lookupInAnyReplica', Key, [
    ], ThrowOnSpecError, CollectionDocDefMatchingKey<this, Key>>;
    /**
     * Performs a lookup-in operation against a document, fetching individual fields or
     * information about specific fields inside the document value from all available replicas.
     * Note that as replication is asynchronous, each node may return a different value.
     *
     * @param key The document key to look in.
     * @param specs A list of specs describing the data to fetch from the document.
     * @param options Optional parameters for this operation.
     * @param callback A node-style callback to be invoked after execution.
     */
    lookupInAllReplicas<Key extends ExtractCollectionJsonDocKey<this>, SpecDefinitions, ThrowOnSpecError extends boolean = false>(key: Key, specs: NarrowLookupSpecs<CollectionOptions<this>, CollectionDocDefMatchingKey<this, Key>, SpecDefinitions>, options: LookupInAllReplicasOptions<ThrowOnSpecError>, callback?: NodeCallback<LookupInReplicaResult<LookupInSpecResults<CollectionOptions<this>, SpecDefinitions, CollectionDocDefMatchingKey<this, Key>>, ThrowOnSpecError>[]>): Promise<LookupInReplicaResult<LookupInSpecResults<CollectionOptions<this>, SpecDefinitions, CollectionDocDefMatchingKey<this, Key>>, ThrowOnSpecError>[]>;
    lookupInAllReplicas<Key extends ExtractCollectionJsonDocKey<this>, SpecDefinitions, ThrowOnSpecError extends boolean = false>(key: Key, specs: NarrowLookupSpecs<CollectionOptions<this>, CollectionDocDefMatchingKey<this, Key>, SpecDefinitions>, callback?: NodeCallback<LookupInReplicaResult<LookupInSpecResults<CollectionOptions<this>, SpecDefinitions, CollectionDocDefMatchingKey<this, Key>>, ThrowOnSpecError>[]>): Promise<LookupInReplicaResult<LookupInSpecResults<CollectionOptions<this>, SpecDefinitions, CollectionDocDefMatchingKey<this, Key>>, ThrowOnSpecError>[]>;
    lookupInAllReplicas<const Key extends ExtractCollectionJsonDocKey<this>, ThrowOnSpecError extends boolean = false>(key: Key, options?: LookupInAllReplicasOptions<ThrowOnSpecError>): ChainableLookupIn<this, 'lookupInAllReplicas', Key, [
    ], ThrowOnSpecError, CollectionDocDefMatchingKey<this, Key>>;
    mutateIn<const Key extends ExtractCollectionJsonDocKey<this>, Def extends DocDefMatchingKey<Key, T, B, S, C>, SpecDefinitions extends ReadonlyArray<MutateInSpec>>(key: Key, specsOrOptions?: MutateInOptions | NarrowMutationSpecs<CollectionOptions<this>, Def, SpecDefinitions>, optionsOrCallback?: MutateInOptions | NodeCallback<MutateInResult<MutateInSpecResults<NoInfer<SpecDefinitions>>>>, callback?: NodeCallback<MutateInResult<MutateInSpecResults<NoInfer<SpecDefinitions>>>>): MutateInReturnType<this, Key, SpecDefinitions>;
    private _mutateIn;
    /**
     * Returns a CouchbaseList permitting simple list storage in a document.
     *
     * @param key The document key the data-structure resides in.
     */
    list<Key extends DocDefMatchingBody<ReadonlyArray<unknown>, T, B, S, C>['Key']>(key: Key): CollectionListReturn<T, B, S, C, Key>;
    /**
     * Returns a CouchbaseQueue permitting simple queue storage in a document.
     *
     * @param key The document key the data-structure resides in.
     */
    queue<Key extends DocDefMatchingBody<ReadonlyArray<unknown>, T, B, S, C>['Key']>(key: Key): CollectionQueueReturn<T, B, S, C, Key>;
    /**
     * Returns a CouchbaseMap permitting simple map storage in a document.
     *
     * @param key The document key the data-structure resides in.
     */
    map<Key extends DocDefMatchingBody<Record<string, unknown>, T, B, S, C>['Key'], Doc extends Extract<DocDefMatchingKey<Key, T, B, S, C>['Body'], Record<string, unknown>>, MapDoc extends If<IsAny<Doc>, Record<string, any>, Doc>, R = IsNever<CollectionMatchingDocDef<T, DocDef<Key, MapDoc>>> extends true ? CouchbaseMap<T, B, S, C, Key, MapDoc> : this extends CollectionMatchingDocDef<T, DocDef<Key, MapDoc>> ? CouchbaseMap<T, B, S, C, Key, MapDoc> : 'This collection does not contain any map.'>(key: Key): R;
    /**
     * Returns a CouchbaseSet permitting simple set storage in a document.
     *
     * @param key The document key the data-structure resides in.
     */
    set<Key extends DocDefMatchingBody<ReadonlyArray<unknown>, T, B, S, C>['Key']>(key: Key): CollectionSetReturn<T, B, S, C, Key>;
    /**
     * Returns a BinaryCollection object reference, allowing access to various
     * binary operations possible against a collection.
     */
    binary(): BinaryCollection<this>;
    /**
     * @internal
     */
    _binaryIncrement(key: string, delta: number, options: IncrementOptions, callback?: NodeCallback<CounterResult>): Promise<CounterResult>;
    _binaryIncrement(key: string, delta: number, callback?: NodeCallback<CounterResult>): Promise<CounterResult>;
    /**
     * @internal
     */
    _binaryDecrement(key: string, delta: number, options: DecrementOptions, callback?: NodeCallback<CounterResult>): Promise<CounterResult>;
    _binaryDecrement(key: string, delta: number, callback?: NodeCallback<CounterResult>): Promise<CounterResult>;
    /**
     * @internal
     */
    _binaryAppend(key: string, value: string | Buffer, options: AppendOptions, callback?: NodeCallback<MutationResult>): Promise<MutationResult>;
    _binaryAppend(key: string, value: string | Buffer, callback?: NodeCallback<MutationResult>): Promise<MutationResult>;
    /**
     * @internal
     */
    _binaryPrepend(key: string, value: string | Buffer, options: PrependOptions, callback?: NodeCallback<MutationResult>): Promise<MutationResult>;
    _binaryPrepend(key: string, value: string | Buffer, callback?: NodeCallback<MutationResult>): Promise<MutationResult>;
    /**
     * Returns a CollectionQueryIndexManager which can be used to manage the query indexes
     * of this collection.
     */
    queryIndexes(): CollectionQueryIndexManager<T, B, S, C>;
}
type CollectionSetReturn<T extends CouchbaseClusterTypes, B extends BucketName<T>, S extends ScopeName<T, B>, C extends CollectionName<T, B, S>, Key extends DocDefMatchingBody<ReadonlyArray<unknown>, T, B, S, C>['Key']> = Extract<DocDefMatchingKey<Key, T, B, S, C>['Body'], unknown[]> extends infer Doc ? IsNever<Doc> extends true ? 'This collection does not contain any set.' : If<IsFuzzyDocument<Doc>, any, ArrayElement<Doc>> extends infer Item ? CouchbaseSet<T, B, S, C, Key, Item> : never : never;
type CollectionListReturn<T extends CouchbaseClusterTypes, B extends BucketName<T>, S extends ScopeName<T, B>, C extends CollectionName<T, B, S>, Key extends DocDefMatchingBody<ReadonlyArray<unknown>, T, B, S, C>['Key']> = Extract<DocDefMatchingKey<Key, T, B, S, C>['Body'], unknown[]> extends infer Doc ? IsNever<Doc> extends true ? 'This collection does not contain any list.' : If<IsFuzzyDocument<Doc>, any, ArrayElement<Doc>> extends infer Item ? CouchbaseList<T, B, S, C, Key, Item> : never : never;
type CollectionQueueReturn<T extends CouchbaseClusterTypes, B extends BucketName<T>, S extends ScopeName<T, B>, C extends CollectionName<T, B, S>, Key extends DocDefMatchingBody<ReadonlyArray<unknown>, T, B, S, C>['Key']> = Extract<DocDefMatchingKey<Key, T, B, S, C>['Body'], unknown[]> extends infer Doc ? IsNever<Doc> extends true ? 'This collection does not contain any queue.' : If<IsFuzzyDocument<Doc>, any, ArrayElement<Doc>> extends infer Item ? CouchbaseQueue<T, B, S, C, Key, Item> : never : never;
type CollectionGetReturn<Doc, WithExpiry extends boolean, ThrowIfMissing extends boolean> = ThrowIfMissing extends true ? GetResult<Doc, WithExpiry> : GetResult<Doc, WithExpiry> | undefined;
type CollectionGetAnyReplicaReturn<Doc, ThrowIfMissing extends boolean> = ThrowIfMissing extends true ? GetReplicaResult<Doc> : GetReplicaResult<Doc> | undefined;
export {};