/**
 * Short URL Repository
 *
 * Data access layer for URL shortening.
 * Extends BaseRepository from @plyaz/db for consistent CRUD operations.
 *
 * @example
 * ```typescript
 * // Use with StorageBackedUrlShortener
 * const shortener = new StorageBackedUrlShortener({
 *   baseUrl: 'https://s.example.com',
 *   storage: ShortUrlRepository.createStorage(),
 * });
 *
 * // Or use repository directly for queries
 * const repo = ShortUrlRepository.create();
 * const topUrls = await repo.findTopClicked(10);
 * ```
 */
import { BaseRepository } from '@plyaz/db';
import type { DatabaseResult, PaginatedResult, QueryOptions, DatabaseServiceInterface, OperationConfig } from '@plyaz/types/db';
import type { UrlShortenerStorage, UrlAnalytics } from '@plyaz/types/notifications';
export interface ShortUrlDatabaseRow extends Record<string, unknown> {
    short_code: string;
    original_url: string;
    created_at: string;
    expires_at: string | null;
    click_count: number;
    last_clicked_at: string | null;
    metadata: Record<string, unknown> | null;
}
export declare class ShortUrlRepository extends BaseRepository<ShortUrlDatabaseRow> {
    constructor(db: DatabaseServiceInterface);
    static create(): ShortUrlRepository;
    /**
     * Create UrlShortenerStorage-compatible interface for StorageBackedUrlShortener
     */
    static createStorage(): UrlShortenerStorage;
    findMany(options?: QueryOptions<ShortUrlDatabaseRow>, config?: OperationConfig): Promise<DatabaseResult<PaginatedResult<ShortUrlDatabaseRow>>>;
    create(data: Partial<ShortUrlDatabaseRow>, config?: OperationConfig): Promise<DatabaseResult<ShortUrlDatabaseRow>>;
    store(shortCode: string, originalUrl: string, options?: {
        expiresAt?: number;
        metadata?: Record<string, unknown>;
    }): Promise<void>;
    retrieve(shortCode: string): Promise<string | null>;
    incrementClicks(shortCode: string): Promise<void>;
    getAnalytics(shortCode: string): Promise<UrlAnalytics | null>;
    cleanup(): Promise<void>;
    findByOriginalUrl(originalUrl: string): Promise<DatabaseResult<ShortUrlDatabaseRow | null>>;
    findTopClicked(limit?: number): Promise<DatabaseResult<PaginatedResult<ShortUrlDatabaseRow>>>;
}
//# sourceMappingURL=ShortUrlRepository.d.ts.map