import type { ChainInfo } from '@aztec/aztec.js/account';
import { type EncryptedPayload } from '../../crypto.js';
import { type DiscoveryRequest, type KeyExchangeRequest, type WalletInfo, type WalletMessage, type WalletResponse, type WalletSdkLogger } from '../../types.js';
import { type BackgroundMessage, type MessageSender } from './internal_message_types.js';
/**
 * Status of a pending discovery request.
 */
export type DiscoveryStatus = 'pending' | 'approved' | 'rejected';
/**
 * A pending discovery request from a dApp.
 */
export interface PendingDiscovery {
    /** Unique request identifier. */
    requestId: string;
    /** Application identifier. */
    appId: string;
    /** Optional application name. */
    appName?: string;
    /** Origin URL of the requesting page. */
    origin: string;
    /** Network information. */
    chainInfo: ChainInfo;
    /** Browser tab ID. */
    tabId: number;
    /** Request timestamp. */
    timestamp: number;
    /** Current status. */
    status: DiscoveryStatus;
}
/**
 * An active session with a connected dApp.
 * Created after key exchange completes.
 */
export interface ActiveSession {
    /** Unique session identifier. */
    sessionId: string;
    /** Derived AES-GCM encryption key. */
    sharedKey: CryptoKey;
    /** Hex-encoded verification hash for visual comparison. */
    verificationHash: string;
    /** Browser tab ID. */
    tabId: number;
    /** Origin URL of the connected app. */
    origin: string;
    /** Application identifier. */
    appId: string;
    /** Connection timestamp. */
    connectedAt: number;
    /** Network information. */
    chainInfo: ChainInfo;
}
/**
 * Transport interface for background script communication.
 */
export interface BackgroundTransport {
    /**
     * Send a message to a specific tab.
     * Typically `(tabId, message) => browser.tabs.sendMessage(tabId, message)`.
     */
    sendToTab: (tabId: number, message: BackgroundMessage) => void;
    /**
     * Register a listener for messages from content scripts.
     * Typically `browser.runtime.onMessage.addListener`.
     */
    addContentListener: (handler: (message: unknown, sender: MessageSender) => void) => void;
}
/**
 * Event callbacks for the background connection handler.
 * All callbacks are optional.
 */
export interface BackgroundConnectionCallbacks {
    /**
     * Called when a new discovery request is received and stored as pending.
     */
    onPendingDiscovery?: (discovery: PendingDiscovery) => void;
    /**
     * Called when a session is established (key exchange complete).
     */
    onSessionEstablished?: (session: ActiveSession) => void;
    /**
     * Called when a session is terminated.
     */
    onSessionTerminated?: (sessionId: string) => void;
    /**
     * Called when a decrypted wallet message is received.
     */
    onWalletMessage?: (session: ActiveSession, message: WalletMessage) => void;
}
/**
 * Configuration for the background connection handler.
 */
export interface BackgroundConnectionConfig {
    /** Unique wallet identifier. */
    walletId: string;
    /** Display name for the wallet. */
    walletName: string;
    /** Wallet version string. */
    walletVersion: string;
    /** Optional wallet icon URL. */
    walletIcon?: string;
    /** Logger used for diagnostics. */
    logger: WalletSdkLogger;
}
/**
 * Handles wallet session flow in the extension background script.
 *
 * This class manages:
 * - Pending discovery requests (before user approval)
 * - Active sessions (after key exchange)
 * - Per-session ECDH key exchange
 * - Message encryption/decryption
 *
 * @example
 * ```typescript
 * const handler = new BackgroundConnectionHandler(
 *   {
 *     walletId: 'my-wallet',
 *     walletName: 'My Wallet',
 *     walletVersion: '1.0.0',
 *     logger: console,
 *   },
 *   {
 *     sendToTab: (tabId, message) => browser.tabs.sendMessage(tabId, message),
 *     addContentListener: (handler) => browser.runtime.onMessage.addListener(handler),
 *   },
 *   {
 *     onPendingDiscovery: (discovery) => updateBadge(),
 *     onSessionEstablished: (session) => console.log('Connected:', session.sessionId),
 *     onWalletMessage: (session, message) => nativePort.postMessage(message),
 *   }
 * );
 *
 * handler.initialize();
 * ```
 */
export declare class BackgroundConnectionHandler {
    private config;
    private transport;
    private callbacks;
    private pendingDiscoveries;
    private activeSessions;
    private log;
    constructor(config: BackgroundConnectionConfig, transport: BackgroundTransport, callbacks?: BackgroundConnectionCallbacks);
    initialize(): void;
    private handleMessage;
    /**
     * Reply to a dApp PING with a PONG. Used as a liveness probe so the dApp can
     * tell the difference between a slow request and a dead extension.
     * @param sessionId - The session that sent the PING.
     */
    private handlePing;
    getWalletInfo(): WalletInfo;
    handleDiscoveryRequest(request: DiscoveryRequest, tabId: number, origin: string): void;
    approveDiscovery(requestId: string): boolean;
    rejectDiscovery(requestId: string): boolean;
    handleKeyExchangeRequest(sessionId: string, request: KeyExchangeRequest): Promise<void>;
    handleEncryptedMessage(sessionId: string, encrypted: EncryptedPayload): Promise<void>;
    sendResponse(sessionId: string, response: WalletResponse): Promise<void>;
    terminateSession(sessionId: string): void;
    terminateForTab(tabId: number): void;
    clearAll(): void;
    getPendingDiscoveries(): PendingDiscovery[];
    getPendingDiscoveryCount(): number;
    getActiveSessions(): ActiveSession[];
    getSession(sessionId: string): ActiveSession | undefined;
    getPendingDiscovery(requestId: string): PendingDiscovery | undefined;
}
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmFja2dyb3VuZF9jb25uZWN0aW9uX2hhbmRsZXIuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9leHRlbnNpb24vaGFuZGxlcnMvYmFja2dyb3VuZF9jb25uZWN0aW9uX2hhbmRsZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsU0FBUyxFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFFekQsT0FBTyxFQUNMLEtBQUssZ0JBQWdCLEVBT3RCLE1BQU0saUJBQWlCLENBQUM7QUFDekIsT0FBTyxFQUNMLEtBQUssZ0JBQWdCLEVBQ3JCLEtBQUssa0JBQWtCLEVBRXZCLEtBQUssVUFBVSxFQUNmLEtBQUssYUFBYSxFQUVsQixLQUFLLGNBQWMsRUFDbkIsS0FBSyxlQUFlLEVBQ3JCLE1BQU0sZ0JBQWdCLENBQUM7QUFDeEIsT0FBTyxFQUNMLEtBQUssaUJBQWlCLEVBSXRCLEtBQUssYUFBYSxFQUNuQixNQUFNLDZCQUE2QixDQUFDO0FBRXJDOztHQUVHO0FBQ0gsTUFBTSxNQUFNLGVBQWUsR0FBRyxTQUFTLEdBQUcsVUFBVSxHQUFHLFVBQVUsQ0FBQztBQUVsRTs7R0FFRztBQUNILE1BQU0sV0FBVyxnQkFBZ0I7SUFDL0IsaUNBQWlDO0lBQ2pDLFNBQVMsRUFBRSxNQUFNLENBQUM7SUFDbEIsOEJBQThCO0lBQzlCLEtBQUssRUFBRSxNQUFNLENBQUM7SUFDZCxpQ0FBaUM7SUFDakMsT0FBTyxDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ2pCLHlDQUF5QztJQUN6QyxNQUFNLEVBQUUsTUFBTSxDQUFDO0lBQ2YsMkJBQTJCO0lBQzNCLFNBQVMsRUFBRSxTQUFTLENBQUM7SUFDckIsc0JBQXNCO0lBQ3RCLEtBQUssRUFBRSxNQUFNLENBQUM7SUFDZCx5QkFBeUI7SUFDekIsU0FBUyxFQUFFLE1BQU0sQ0FBQztJQUNsQixzQkFBc0I7SUFDdEIsTUFBTSxFQUFFLGVBQWUsQ0FBQztDQUN6QjtBQUVEOzs7R0FHRztBQUNILE1BQU0sV0FBVyxhQUFhO0lBQzVCLGlDQUFpQztJQUNqQyxTQUFTLEVBQUUsTUFBTSxDQUFDO0lBQ2xCLHNDQUFzQztJQUN0QyxTQUFTLEVBQUUsU0FBUyxDQUFDO0lBQ3JCLDJEQUEyRDtJQUMzRCxnQkFBZ0IsRUFBRSxNQUFNLENBQUM7SUFDekIsc0JBQXNCO0lBQ3RCLEtBQUssRUFBRSxNQUFNLENBQUM7SUFDZCx1Q0FBdUM7SUFDdkMsTUFBTSxFQUFFLE1BQU0sQ0FBQztJQUNmLDhCQUE4QjtJQUM5QixLQUFLLEVBQUUsTUFBTSxDQUFDO0lBQ2QsNEJBQTRCO0lBQzVCLFdBQVcsRUFBRSxNQUFNLENBQUM7SUFDcEIsMkJBQTJCO0lBQzNCLFNBQVMsRUFBRSxTQUFTLENBQUM7Q0FDdEI7QUFFRDs7R0FFRztBQUNILE1BQU0sV0FBVyxtQkFBbUI7SUFDbEM7OztPQUdHO0lBQ0gsU0FBUyxFQUFFLENBQUMsS0FBSyxFQUFFLE1BQU0sRUFBRSxPQUFPLEVBQUUsaUJBQWlCLEtBQUssSUFBSSxDQUFDO0lBRS9EOzs7T0FHRztJQUNILGtCQUFrQixFQUFFLENBQUMsT0FBTyxFQUFFLENBQUMsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLEVBQUUsYUFBYSxLQUFLLElBQUksS0FBSyxJQUFJLENBQUM7Q0FDMUY7QUFFRDs7O0dBR0c7QUFDSCxNQUFNLFdBQVcsNkJBQTZCO0lBQzVDOztPQUVHO0lBQ0gsa0JBQWtCLENBQUMsRUFBRSxDQUFDLFNBQVMsRUFBRSxnQkFBZ0IsS0FBSyxJQUFJLENBQUM7SUFFM0Q7O09BRUc7SUFDSCxvQkFBb0IsQ0FBQyxFQUFFLENBQUMsT0FBTyxFQUFFLGFBQWEsS0FBSyxJQUFJLENBQUM7SUFFeEQ7O09BRUc7SUFDSCxtQkFBbUIsQ0FBQyxFQUFFLENBQUMsU0FBUyxFQUFFLE1BQU0sS0FBSyxJQUFJLENBQUM7SUFFbEQ7O09BRUc7SUFDSCxlQUFlLENBQUMsRUFBRSxDQUFDLE9BQU8sRUFBRSxhQUFhLEVBQUUsT0FBTyxFQUFFLGFBQWEsS0FBSyxJQUFJLENBQUM7Q0FDNUU7QUFFRDs7R0FFRztBQUNILE1BQU0sV0FBVywwQkFBMEI7SUFDekMsZ0NBQWdDO0lBQ2hDLFFBQVEsRUFBRSxNQUFNLENBQUM7SUFDakIsbUNBQW1DO0lBQ25DLFVBQVUsRUFBRSxNQUFNLENBQUM7SUFDbkIsNkJBQTZCO0lBQzdCLGFBQWEsRUFBRSxNQUFNLENBQUM7SUFDdEIsZ0NBQWdDO0lBQ2hDLFVBQVUsQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUNwQixtQ0FBbUM7SUFDbkMsTUFBTSxFQUFFLGVBQWUsQ0FBQztDQUN6QjtBQUVEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBK0JHO0FBQ0gscUJBQWEsMkJBQTJCO0lBTXBDLE9BQU8sQ0FBQyxNQUFNO0lBQ2QsT0FBTyxDQUFDLFNBQVM7SUFDakIsT0FBTyxDQUFDLFNBQVM7SUFQbkIsT0FBTyxDQUFDLGtCQUFrQixDQUF1QztJQUNqRSxPQUFPLENBQUMsY0FBYyxDQUFvQztJQUMxRCxPQUFPLENBQUMsR0FBRyxDQUFrQjtJQUU3QixZQUNVLE1BQU0sRUFBRSwwQkFBMEIsRUFDbEMsU0FBUyxFQUFFLG1CQUFtQixFQUM5QixTQUFTLEdBQUUsNkJBQWtDLEVBR3REO0lBRUQsVUFBVSxJQUFJLElBQUksQ0FFakI7SUFFRCxPQUFPLENBQUMsYUFBYSxDQXlDbkI7SUFFRjs7OztPQUlHO0lBQ0gsT0FBTyxDQUFDLFVBQVU7SUFZbEIsYUFBYSxJQUFJLFVBQVUsQ0FPMUI7SUFFRCxzQkFBc0IsQ0FBQyxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLEVBQUUsTUFBTSxHQUFHLElBQUksQ0FhckY7SUFFRCxnQkFBZ0IsQ0FBQyxTQUFTLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FvQjNDO0lBRUQsZUFBZSxDQUFDLFNBQVMsRUFBRSxNQUFNLEdBQUcsT0FBTyxDQVUxQztJQUVLLHdCQUF3QixDQUFDLFNBQVMsRUFBRSxNQUFNLEVBQUUsT0FBTyxFQUFFLGtCQUFrQixHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0E0QzVGO0lBRUssc0JBQXNCLENBQUMsU0FBUyxFQUFFLE1BQU0sRUFBRSxTQUFTLEVBQUUsZ0JBQWdCLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQVkxRjtJQUVLLFlBQVksQ0FBQyxTQUFTLEVBQUUsTUFBTSxFQUFFLFFBQVEsRUFBRSxjQUFjLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQXFCN0U7SUFFRCxnQkFBZ0IsQ0FBQyxTQUFTLEVBQUUsTUFBTSxHQUFHLElBQUksQ0F5QnhDO0lBRUQsZUFBZSxDQUFDLEtBQUssRUFBRSxNQUFNLEdBQUcsSUFBSSxDQVduQztJQUVELFFBQVEsSUFBSSxJQUFJLENBTWY7SUFFRCxxQkFBcUIsSUFBSSxnQkFBZ0IsRUFBRSxDQUUxQztJQUVELHdCQUF3QixJQUFJLE1BQU0sQ0FFakM7SUFFRCxpQkFBaUIsSUFBSSxhQUFhLEVBQUUsQ0FFbkM7SUFFRCxVQUFVLENBQUMsU0FBUyxFQUFFLE1BQU0sR0FBRyxhQUFhLEdBQUcsU0FBUyxDQUV2RDtJQUVELG1CQUFtQixDQUFDLFNBQVMsRUFBRSxNQUFNLEdBQUcsZ0JBQWdCLEdBQUcsU0FBUyxDQUVuRTtDQUNGIn0=