import type { CatalogId, ItemId } from "@x12i/catalox-contracts/ids.js";
import type { NativeCatalogItemRecord } from "@x12i/catalox-contracts/items.js";
import type { CatalogDescriptor } from "@x12i/catalox-contracts/descriptors.js";
import type { NativeItemStore } from "../firebase/native-item-store.js";
type NativeItemLookup = Pick<NativeItemStore, "findByLogicalItemId" | "get">;
/**
 * Resolve physical native rows for a logical item id.
 * Uses indexed `itemId` query, then encoded storage doc id (`id~…`), then legacy raw doc id when path-safe.
 */
export declare function resolveNativeRowsByLogicalItemId(nativeItems: NativeItemLookup, catalogId: CatalogId, logicalItemId: ItemId): Promise<NativeCatalogItemRecord[]>;
export type NativeListFilterPlan = {
    filterEq: Record<string, unknown>;
    filterArrayContains: Record<string, string>;
    invalidFilterKeys: string[];
};
type NativeListFilterDescriptor = Pick<CatalogDescriptor, "queryableFields" | "smartProperties">;
/** Split list filters into equality vs array-contains based on descriptor field shape. */
export declare function planNativeListFilters(descriptor: NativeListFilterDescriptor, filter: Record<string, unknown> | undefined): NativeListFilterPlan;
export {};
//# sourceMappingURL=native-item-resolve.d.ts.map