import { SmrtCollection } from '@happyvertical/smrt-core';
import { UsersMagicLinkToken } from '../models/MagicLinkToken.js';
/**
 * Collection for managing smrt-users magic link token records
 */
export declare class UsersMagicLinkTokenCollection extends SmrtCollection<UsersMagicLinkToken> {
    static readonly _itemClass: typeof UsersMagicLinkToken;
    /**
     * Find a token by its nonce
     */
    findByNonce(nonce: string): Promise<UsersMagicLinkToken | null>;
    /**
     * Atomically mark a token as used (single-use enforcement).
     *
     * Returns true if the nonce was successfully claimed (transitioned from
     * unused to used). Returns false if the nonce was already used, expired,
     * or doesn't exist — preventing race conditions in concurrent verify() calls.
     */
    markUsed(nonce: string): Promise<boolean>;
    /**
     * Delete expired tokens (cleanup job)
     *
     * Scheduled by the framework retention sweep (#2375); `expiresAt` carries an
     * index for this predicate.
     *
     * @param options.dryRun - Count the tokens the predicate selects without
     *   deleting them.
     * @returns Number of tokens deleted (or, under `dryRun`, matched)
     */
    deleteExpired(options?: {
        dryRun?: boolean;
    }): Promise<number>;
}
export { UsersMagicLinkTokenCollection as MagicLinkTokenCollection };
//# sourceMappingURL=MagicLinkTokenCollection.d.ts.map