/// <reference types="node" resolution-mode="require"/>
/// <reference types="node" resolution-mode="require"/>
import { CasInput } from '@cbjsdev/shared';
import type { AnyCollection } from './clusterTypes/index.js';
import { CounterResult, MutationResult } from './crudoptypes.js';
import { DurabilityLevel } from './generaltypes.js';
import { RequestSpan } from './tracing.js';
import type { NodeCallback } from './utilities.js';
/**
 * @category Key-Value
 */
export interface IncrementOptions {
    /**
     * The initial value to use for the document if it does not already exist.
     * Not specifying this value indicates the operation should fail if the
     * document does not exist.
     */
    initial?: number;
    /**
     * 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 the level of synchronous durability for this operation.
     */
    durabilityLevel?: DurabilityLevel;
    /**
     * 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;
    /**
     * 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 DecrementOptions {
    /**
     * The initial value to use for the document if it does not already exist.
     * Not specifying this value indicates the operation should fail if the
     * document does not exist.
     */
    initial?: number;
    /**
     * 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 the level of synchronous durability for this operation.
     */
    durabilityLevel?: DurabilityLevel;
    /**
     * 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;
    /**
     * 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 AppendOptions {
    /**
     * Specifies the level of synchronous durability for this operation.
     */
    durabilityLevel?: DurabilityLevel;
    /**
     * 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;
    /**
     * The timeout for this operation, represented in milliseconds.
     */
    timeout?: number;
    /**
     * 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 parent span for this operation, used to establish a trace hierarchy
     * for observability.
     */
    parentSpan?: RequestSpan;
}
/**
 * @category Key-Value
 */
export interface PrependOptions {
    /**
     * Specifies the level of synchronous durability for this operation.
     */
    durabilityLevel?: DurabilityLevel;
    /**
     * 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;
    /**
     * The timeout for this operation, represented in milliseconds.
     */
    timeout?: number;
    /**
     * 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 parent span for this operation, used to establish a trace hierarchy
     * for observability.
     */
    parentSpan?: RequestSpan;
}
/**
 * Exposes a number of binary-level operations against a collection.
 * These operations do not adhere to the standard JSON-centric
 * behaviour of the SDK.
 *
 * @category Core
 */
export declare class BinaryCollection<C extends AnyCollection> {
    private _coll;
    /**
     * @internal
     */
    constructor(parent: C);
    /**
     * Increments the ASCII value of the specified key by the amount
     * indicated in the delta parameter.
     *
     * @param key The key to increment.
     * @param delta The amount to increment the key.
     * @param options Optional parameters for this operation.
     * @param callback A node-style callback to be invoked after execution.
     */
    increment(key: string, delta: number, callback?: NodeCallback<CounterResult>): Promise<CounterResult>;
    increment(key: string, delta: number, options: IncrementOptions, callback?: NodeCallback<CounterResult>): Promise<CounterResult>;
    /**
     * Decrements the ASCII value of the specified key by the amount
     * indicated in the delta parameter.
     *
     * @param key The key to increment.
     * @param delta The amount to increment the key.
     * @param options Optional parameters for this operation.
     * @param callback A node-style callback to be invoked after execution.
     */
    decrement(key: string, delta: number, callback?: NodeCallback<CounterResult>): Promise<CounterResult>;
    decrement(key: string, delta: number, options: DecrementOptions, callback?: NodeCallback<CounterResult>): Promise<CounterResult>;
    /**
     * Appends the specified value to the end of the specified key.
     *
     * @param key The key to append to.
     * @param value The value to adjoin to the end of the document.
     * @param options Optional parameters for this operation.
     * @param callback A node-style callback to be invoked after execution.
     */
    append(key: string, value: string | Buffer, callback?: NodeCallback<MutationResult>): Promise<MutationResult>;
    append(key: string, value: string | Buffer, options: AppendOptions, callback?: NodeCallback<MutationResult>): Promise<MutationResult>;
    /**
     * Prepends the specified value to the beginning of the specified key.
     *
     * @param key The key to prepend to.
     * @param value The value to adjoin to the beginning of the document.
     * @param callbackOrOptions Optional parameters for this operation or a node-style callback to be invoked after execution.
     */
    prepend(key: string, value: string | Buffer, callbackOrOptions?: PrependOptions | NodeCallback<MutationResult>): Promise<MutationResult>;
    prepend(key: string, value: string | Buffer, options: PrependOptions, callback?: NodeCallback<MutationResult>): Promise<MutationResult>;
}