import { Condition } from '../conditions/index.js';
import { DynamoEntity } from '../core/entity.js';
import { ObjectLikeZodType, EntitySchema, TransactWriteOperation } from '../core/index.js';
import { ReturnValuesOnConditionCheckFailure, ItemCollectionMetrics } from '@aws-sdk/client-dynamodb';
import { PutConfig } from './put.js';
import { BaseResult, BaseCommand, WriteTransactable } from './index.js';

/**
 * Configuration for the ConditionalPut command.
 *
 * @template Schema - The Zod schema defining the structure of the entity.
 */
type ConditionalPutConfig<Schema extends ObjectLikeZodType> = PutConfig<Schema> & {
    condition: Condition;
    returnValuesOnConditionCheckFailure?: ReturnValuesOnConditionCheckFailure;
};
/**
 * Result of the ConditionalPut command.
 *
 * @template Schema - The Zod schema defining the structure of the entity.
 */
type ConditionalPutResult<Schema extends ObjectLikeZodType> = BaseResult & {
    returnItem: EntitySchema<Schema> | undefined;
    itemCollectionMetrics: ItemCollectionMetrics | undefined;
};
/**
 * Command to create or replace an item with a condition expression.
 *
 * @template Schema - The Zod schema defining the structure of the entity.
 *
 * @example
 * ```typescript
 * import { DynamoTable, DynamoEntity, key, ConditionalPut, notExists } from 'dynamo-document-builder';
 *
 * const table = new DynamoTable({
 *   tableName: 'ExampleTable',
 *   documentClient,
 * });
 *
 * const userEntity = new DynamoEntity({
 *   table,
 *   schema: z.object({
 *     userId: z.string(),
 *     name: z.string(),
 *     status: z.string(),
 *   }),
 *   partitionKey: user => key('USER', user.userId),
 *   sortKey: () => 'METADATA',
 * });
 *
 * const conditionalPutCommand = new ConditionalPut({
 *   item: { userId: 'user123', name: 'John', status: 'active' },
 *   condition: { status: 'draft' },
 *   returnValuesOnConditionCheckFailure: 'ALL_OLD',
 * });
 *
 * await userEntity.send(conditionalPutCommand);
 * ```
 */
declare class ConditionalPut<Schema extends ObjectLikeZodType> implements BaseCommand<ConditionalPutResult<Schema>, Schema>, WriteTransactable<Schema> {
    #private;
    constructor(config: ConditionalPutConfig<Schema>);
    buildItem(entity: DynamoEntity<Schema>): Promise<{
        [x: string]: unknown;
    }>;
    execute(entity: DynamoEntity<Schema>): Promise<ConditionalPutResult<Schema>>;
    prepareWriteTransaction(entity: DynamoEntity<Schema>): Promise<TransactWriteOperation>;
}

export { ConditionalPut };
export type { ConditionalPutConfig, ConditionalPutResult };