import { TypedKV } from "./typed-kv.js";
import type { EntriesIterable, KVEntry, KVGetResult, KVLike, KVSetResult, KeysIterable, SetOptions } from "./types.js";
export interface IndexDef<V> {
    /** Extract index key(s) from value. Return string for single-value, string[] for multi-value. */
    key: (value: V, primaryKey: string) => string | string[];
    /** Unique constraint. Default: false */
    unique?: boolean;
}
/**
 * A KV store wrapper that automatically maintains secondary indexes.
 *
 * Wraps any KVLike parent and adds index management on top of a prefixed data store.
 * Index entries are stored as siblings under `__idx/` to avoid polluting `keys()` scans.
 *
 * Orphan detection: stale index entries are detected and cleaned up on read.
 */
export declare class IndexedKV<V, M = undefined> {
    private parent;
    private store;
    private indexes;
    private prefix;
    private indexStores;
    constructor(parent: KVLike<M>, prefix: string, indexes: Record<string, IndexDef<V>>);
    get(key: string): Promise<KVGetResult<V, M>>;
    set(key: string, value: V, ...[metadata, options]: undefined extends M ? [M?, SetOptions?] : [M, SetOptions?]): Promise<KVSetResult>;
    delete(key: string): Promise<void>;
    keys(prefix?: string): KeysIterable;
    entries(prefix?: string): EntriesIterable<V, M>;
    getMany(keys: string[], concurrency?: number): Promise<Map<string, KVEntry<V, M>>>;
    /**
     * Point lookup on a unique index. Validates and cleans orphans.
     */
    getByIndex(indexName: string, indexKey: string): Promise<KVGetResult<V, M>>;
    /**
     * Prefix scan on a non-unique index. Returns primary keys.
     */
    keysByIndex(indexName: string, indexKey: string): KeysIterable;
    /**
     * Prefix scan returning full entries. Validates each result.
     */
    entriesByIndex(indexName: string, indexKey: string): EntriesIterable<V, M>;
    getStore(): TypedKV<V, M>;
}
//# sourceMappingURL=indexed-kv.d.ts.map