import { Item } from "../item";
import { PriKey } from "../key";
import { ItemQuery } from "../query/ItemQuery";
import { AffectedKeys, AllOperationResult, AllOptions, CreateOptions, FindOperationResult, FindOptions, OperationParams, Operations } from "./Operations";
/**
 * Primary Operations interface - specialized for primary (top-level) items only.
 *
 * This interface narrows the generic Operations interface to work exclusively
 * with PriKey. All operations accept only PriKey, never ComKey or locations.
 *
 * Primary items are top-level entities that don't belong to a location hierarchy.
 * Examples: Users, Organizations, Products, Documents
 *
 * Use this for:
 * - Libraries that store primary items
 * - Caches for primary items
 * - API clients for primary endpoints
 * - Any operations that work with non-hierarchical data
 *
 * @example
 * ```typescript
 * // Define a primary item type
 * interface User extends Item<'user'> {
 *   name: string;
 *   email: string;
 * }
 *
 * // Create operations for primary items
 * const userOps: PrimaryOperations<User, 'user'> = createUserOperations();
 *
 * // Only PriKey allowed - no locations
 * await userOps.get({ kt: 'user', pk: '123' });
 * await userOps.update({ kt: 'user', pk: '123' }, { name: 'Updated' });
 *
 * // No locations parameter on collection methods
 * await userOps.all({});
 * await userOps.find('byEmail', { email: 'test@example.com' });
 * await userOps.allAction('deactivate', { reason: 'inactive' });
 * ```
 */
export interface PrimaryOperations<V extends Item<S>, S extends string> extends Omit<Operations<V, S>, 'all' | 'one' | 'create' | 'get' | 'update' | 'upsert' | 'remove' | 'find' | 'findOne' | 'action' | 'allAction' | 'facet' | 'allFacet'> {
    all(query?: ItemQuery, locations?: [], allOptions?: AllOptions): Promise<AllOperationResult<V>>;
    one(query?: ItemQuery): Promise<V | null>;
    find(finder: string, params?: OperationParams, locations?: [], options?: FindOptions): Promise<FindOperationResult<V>>;
    findOne(finder: string, params?: OperationParams): Promise<V | null>;
    create(item: Partial<Item<S>>, options?: CreateOptions<S>): Promise<V>;
    get(key: PriKey<S>): Promise<V | null>;
    update(key: PriKey<S>, item: Partial<Item<S>>): Promise<V>;
    upsert(key: PriKey<S>, item: Partial<Item<S>>): Promise<V>;
    remove(key: PriKey<S>): Promise<V | void>;
    action(key: PriKey<S>, action: string, params?: OperationParams): Promise<[V, AffectedKeys]>;
    allAction(action: string, params?: OperationParams): Promise<[V[], AffectedKeys]>;
    facet(key: PriKey<S>, facet: string, params?: OperationParams): Promise<any>;
    allFacet(facet: string, params?: OperationParams): Promise<any>;
}