import type { AttendanceRecord, ConnectCallbacks, CreateUserInput, DeleteAttendanceCriteria, DeviceInfo, FingerprintTemplateIndex, GetUserAttendancesOptions, RealTimeLog, UpdateUserInput, User, UserSearchCriteria, ZKTecoClientOptions } from "./types.ts";
export declare class ZKTecoClient {
    readonly ip: string;
    readonly port: number;
    readonly timeout: number;
    readonly udpPort: number;
    readonly openDoorDelaySec: number;
    readonly commKey: number;
    connectionType: "tcp" | "udp" | null;
    private transport;
    private readonly tcp;
    private readonly udp;
    constructor(options: ZKTecoClientOptions);
    constructor(ip: string, port?: number, timeout?: number, udpPort?: number);
    get isConnected(): boolean;
    private get recordPacketSize();
    private run;
    connect(callbacks?: ConnectCallbacks): Promise<void>;
    private verifyDevice;
    /** @deprecated Use connect() */
    createSocket: (callbacks?: ConnectCallbacks) => Promise<void>;
    disconnect(): Promise<void>;
    getInfo(): Promise<DeviceInfo>;
    getUsers(): Promise<User[]>;
    getFingerprintTemplates(): Promise<FingerprintTemplateIndex[]>;
    getUserById(userId: string): Promise<User>;
    getUserByUid(uid: number): Promise<User>;
    /**
     * Search users by free-text query or specific fields (name, userId, uid, cardno, role).
     * Pass a string to search across name, userId, uid, and card number.
     */
    searchUsers(criteria: string | UserSearchCriteria): Promise<User[]>;
    /** Returns the first user matching the search criteria, or null. */
    searchUser(criteria: string | UserSearchCriteria): Promise<User | null>;
    private nextUid;
    private writeUserWithRefresh;
    createUser(input: CreateUserInput): Promise<User>;
    updateUser(userId: string, input: UpdateUserInput): Promise<User>;
    deleteUser(ref: number | string): Promise<void>;
    getAttendances(onProgress?: (received: number, total: number) => void): Promise<AttendanceRecord[]>;
    /**
     * Get attendance records for a specific user.
     * The device returns all logs — this method filters by userId client-side.
     */
    getUserAttendances(userId: string, options?: GetUserAttendancesOptions): Promise<AttendanceRecord[]>;
    /**
     * Get attendance records for a user by device uid.
     */
    getUserAttendancesByUid(uid: number, options?: GetUserAttendancesOptions): Promise<AttendanceRecord[]>;
    clearAttendanceLog(): Promise<void>;
    /** Wipes all device data: users, fingerprints, attendance logs, and admin settings. */
    resetDevice(): Promise<void>;
    replaceAttendanceLog(records: AttendanceRecord[]): Promise<void>;
    deleteAttendanceRecord(criteria: DeleteAttendanceCriteria): Promise<void>;
    disableDevice(): Promise<void>;
    enableDevice(): Promise<void>;
    refreshData(): Promise<void>;
    openDoor(delaySec?: number): Promise<void>;
    getTime(): Promise<Date>;
    setTime(date?: Date): Promise<void>;
    getRealTimeLogs(callback: (log: RealTimeLog) => void): Promise<void>;
    executeCmd(command: number, data?: Buffer | string): Promise<Buffer>;
    freeData(): Promise<void>;
}
export default ZKTecoClient;
//# sourceMappingURL=client.d.ts.map