/**
 * QA360 Storage Helpers Module
 *
 * P0: Simplified access to browser storage APIs
 * - LocalStorage helpers with type safety
 * - SessionStorage helpers with type safety
 * - JSON serialization/deserialization
 * - Prefix support for namespacing
 */
import type { Page } from '@playwright/test';
/**
 * Storage options
 */
export interface StorageOptions {
    /** Key prefix for namespacing */
    prefix?: string;
    /** Auto-parse JSON values */
    json?: boolean;
}
/**
 * Storage get result with metadata
 */
export interface StorageResult<T = unknown> {
    /** Whether the key exists */
    exists: boolean;
    /** The value (parsed if json=true) */
    value: T | null;
    /** The raw string value */
    rawValue: string | null;
}
/**
 * LocalStorage Helper
 */
export declare class LocalStorage {
    private page;
    private options;
    constructor(page: Page, options?: StorageOptions);
    /**
     * Get a value from localStorage
     */
    get<T = string>(key: string): Promise<StorageResult<T>>;
    /**
     * Set a value in localStorage
     */
    set(key: string, value: unknown): Promise<void>;
    /**
     * Remove a value from localStorage
     */
    remove(key: string): Promise<void>;
    /**
     * Check if a key exists
     */
    has(key: string): Promise<boolean>;
    /**
     * Get all keys (with prefix if configured)
     */
    keys(): Promise<string[]>;
    /**
     * Clear all keys (with prefix if configured)
     */
    clear(): Promise<void>;
    /**
     * Get the number of items (with prefix if configured)
     */
    size(): Promise<number>;
    /**
     * Get all items as an object (with prefix stripped if configured)
     */
    getAll<T = unknown>(): Promise<Record<string, T>>;
    /**
     * Set multiple items at once
     */
    setMany(items: Record<string, unknown>): Promise<void>;
    /**
     * Remove multiple items at once
     */
    removeMany(keys: string[]): Promise<void>;
    private getFullKey;
    private tryParseJSON;
}
/**
 * SessionStorage Helper
 */
export declare class SessionStorage {
    private page;
    private options;
    constructor(page: Page, options?: StorageOptions);
    /**
     * Get a value from sessionStorage
     */
    get<T = string>(key: string): Promise<StorageResult<T>>;
    /**
     * Set a value in sessionStorage
     */
    set(key: string, value: unknown): Promise<void>;
    /**
     * Remove a value from sessionStorage
     */
    remove(key: string): Promise<void>;
    /**
     * Check if a key exists
     */
    has(key: string): Promise<boolean>;
    /**
     * Get all keys (with prefix if configured)
     */
    keys(): Promise<string[]>;
    /**
     * Clear all keys (with prefix if configured)
     */
    clear(): Promise<void>;
    /**
     * Get the number of items (with prefix if configured)
     */
    size(): Promise<number>;
    /**
     * Get all items as an object (with prefix stripped if configured)
     */
    getAll<T = unknown>(): Promise<Record<string, T>>;
    /**
     * Set multiple items at once
     */
    setMany(items: Record<string, unknown>): Promise<void>;
    /**
     * Remove multiple items at once
     */
    removeMany(keys: string[]): Promise<void>;
    private getFullKey;
    private tryParseJSON;
}
/**
 * Convenience function to create LocalStorage helper
 */
export declare function createLocalStorage(page: Page, options?: StorageOptions): LocalStorage;
/**
 * Convenience function to create SessionStorage helper
 */
export declare function createSessionStorage(page: Page, options?: StorageOptions): SessionStorage;