import { DynamoEntity } from '../core/entity.js';
import { ObjectLikeZodType, EntitySchema } from '../core/index.js';
import { ScanConfig } from './scan.js';
import { Projection } from '../projections/index.js';
import { BaseResult, BaseCommand, BasePaginatable } from './index.js';
import { ScanCommandInput, NativeAttributeValue, ScanCommandOutput } from '@aws-sdk/lib-dynamodb';

/**
 * Configuration for the ProjectedScan command.
 *
 * @template ProjectionSchema - The Zod schema defining the structure of the projected attributes.
 */
type ProjectedScanConfig<ProjectionSchema extends ObjectLikeZodType> = ScanConfig<ProjectionSchema> & {
    projection: Projection;
    projectionSchema: ProjectionSchema;
};
/**
 * Result of the ProjectedScan command.
 *
 * @template Schema - The Zod schema defining the structure of the entity.
 * @template ProjectionSchema - The Zod schema defining the structure of the projected attributes.
 */
type ProjectedScanResult<Schema extends ObjectLikeZodType, ProjectionSchema extends ObjectLikeZodType> = BaseResult & {
    items: EntitySchema<ProjectionSchema>[];
    count: number;
    scannedCount: number;
    lastEvaluatedKey?: Partial<EntitySchema<Schema>> | undefined;
};
/**
 * Command to scan entire table or index and retrieve specific attributes (expensive operation).
 *
 * @template Schema - The Zod schema defining the structure of the entity.
 * @template ProjectionSchema - The Zod schema defining the structure of the projected attributes.
 *
 * @example
 * ```typescript
 * import { DynamoTable, DynamoEntity, key, ProjectedScan } from 'dynamo-document-builder';
 *
 * const table = new DynamoTable({
 *   tableName: 'ExampleTable',
 *   documentClient,
 * });
 *
 * const todoEntity = new DynamoEntity({
 *   table,
 *   schema: z.object({
 *     userId: z.string(),
 *     todoId: z.string(),
 *     title: z.string(),
 *     description: z.string(),
 *     isComplete: z.boolean(),
 *   }),
 *   partitionKey: todo => key('USER', todo.userId),
 *   sortKey: todo => key('TODO', todo.todoId),
 * });
 *
 * const projectedScanCommand = new ProjectedScan({
 *   projection: ['title', 'isComplete'],
 *   projectionSchema: z.object({
 *     title: z.string(),
 *     isComplete: z.boolean(),
 *   }),
 *   filter: { isComplete: false },
 *   limit: 100,
 * });
 *
 * const { items, scannedCount } = await todoEntity.send(projectedScanCommand);
 * ```
 */
declare class ProjectedScan<Schema extends ObjectLikeZodType, ProjectedSchema extends ObjectLikeZodType> implements BaseCommand<ProjectedScanResult<Schema, ProjectedSchema>, Schema>, BasePaginatable<ProjectedScanResult<Schema, ProjectedSchema>, Schema> {
    #private;
    constructor(config: ProjectedScanConfig<ProjectedSchema>);
    buildCommandInput(entity: DynamoEntity<Schema>): ScanCommandInput;
    validateItems(items: Record<string, NativeAttributeValue>[] | undefined): Promise<EntitySchema<ProjectedSchema>[]>;
    buildResult(items: EntitySchema<ProjectedSchema>[], scanResult: ScanCommandOutput): ProjectedScanResult<Schema, ProjectedSchema>;
    execute(entity: DynamoEntity<Schema>): Promise<ProjectedScanResult<Schema, ProjectedSchema>>;
    executePaginated(entity: DynamoEntity<Schema>): AsyncGenerator<ProjectedScanResult<Schema, ProjectedSchema>, void, unknown>;
}

export { ProjectedScan };
export type { ProjectedScanConfig, ProjectedScanResult };