/**
 * QA360 Cookie Manager Module
 *
 * P0: Cookie manipulation helpers
 * - Get/set/delete cookies with type safety
 * - Cookie filtering and searching
 * - Domain/path scoping
 * - Expiration handling
 */
import type { BrowserContext, Page } from '@playwright/test';
import type { Cookie } from '@playwright/test';
/**
 * Cookie creation options
 */
export interface CookieSetOptions {
    /** Cookie name */
    name: string;
    /** Cookie value */
    value: string;
    /** Cookie domain (defaults to current page domain) */
    domain?: string;
    /** Cookie path (defaults to /) */
    path?: string;
    /** Expiration date (Unix timestamp) or maxAge in seconds */
    expires?: number;
    /** Max age in seconds (alternative to expires) */
    maxAge?: number;
    /** Whether cookie is HTTP-only */
    httpOnly?: boolean;
    /** Whether cookie is secure (HTTPS only) */
    secure?: boolean;
    /** SameSite attribute */
    sameSite?: 'Strict' | 'Lax' | 'None';
    /** URL for setting cookie (used for domain inference) */
    url?: string;
}
/**
 * Cookie filter options
 */
export interface CookieFilterOptions {
    /** Filter by name (supports wildcards) */
    name?: string;
    /** Filter by domain */
    domain?: string;
    /** Filter by path */
    path?: string;
    /** Filter by secure flag */
    secure?: boolean;
    /** Filter by httpOnly flag */
    httpOnly?: boolean;
    /** Filter by sameSite attribute */
    sameSite?: 'Strict' | 'Lax' | 'None';
}
/**
 * Cookie Manager
 */
export declare class CookieManager {
    private context;
    constructor(context: BrowserContext);
    /**
     * Get all cookies
     */
    all(): Promise<Cookie[]>;
    /**
     * Get cookies matching filter criteria
     */
    filter(options: CookieFilterOptions): Promise<Cookie[]>;
    /**
     * Get a specific cookie by name
     */
    get(name: string): Promise<Cookie | undefined>;
    /**
     * Get a cookie value by name
     */
    getValue(name: string): Promise<string | undefined>;
    /**
     * Check if a cookie exists
     */
    has(name: string): Promise<boolean>;
    /**
     * Set a cookie
     */
    set(options: CookieSetOptions): Promise<void>;
    /**
     * Set multiple cookies at once
     */
    setMany(cookies: CookieSetOptions[]): Promise<void>;
    /**
     * Update an existing cookie
     */
    update(name: string, updates: Partial<CookieSetOptions>): Promise<void>;
    /**
     * Delete a cookie by name
     */
    delete(name: string): Promise<void>;
    /**
     * Delete multiple cookies by name
     */
    deleteMany(names: string[]): Promise<void>;
    /**
     * Delete cookies matching filter criteria
     */
    deleteFilter(options: CookieFilterOptions): Promise<void>;
    /**
     * Clear all cookies
     */
    clear(): Promise<void>;
    /**
     * Clear cookies for a specific domain
     */
    clearDomain(domain: string): Promise<void>;
    /**
     * Get cookies count
     */
    count(): Promise<number>;
    /**
     * Export cookies as JSON string
     */
    export(): Promise<string>;
    /**
     * Import cookies from JSON string or array
     */
    import(data: string | Cookie[]): Promise<void>;
    /**
     * Get cookies grouped by domain
     */
    byDomain(): Promise<Record<string, Cookie[]>>;
    /**
     * Set a session cookie (no expiration)
     */
    setSession(name: string, value: string, options?: Partial<CookieSetOptions>): Promise<void>;
    /**
     * Set a cookie with max-age (in seconds)
     */
    setWithMaxAge(name: string, value: string, maxAge: number, options?: Partial<CookieSetOptions>): Promise<void>;
    /**
     * Set a cookie that expires in days
     */
    setExpiringIn(name: string, value: string, days: number, options?: Partial<CookieSetOptions>): Promise<void>;
    /**
     * Normalize cookie options to Playwright format
     */
    private normalizeCookieOptions;
    /**
     * Check if cookie matches filter criteria
     */
    private matchesFilter;
    /**
     * Simple wildcard matching
     */
    private wildcardMatch;
}
/**
 * Convenience function to create cookie manager
 */
export declare function cookies(context: BrowserContext): CookieManager;
/**
 * Convenience function to create cookie manager from page
 */
export declare function cookiesFromPage(page: Page): CookieManager;